Nome
bash , alias, bg , bind, break, builtin, cd , command, compgen, complete, continue, declare, dirs, disown, echo, enable, eval, exec, exit, export, fc, fg, getopts, hash , historial , emprego, matar , deixar, local, logout, popd , printf , pushd, pwd , read, readonly, return , set, shift, shopt, fonte, suspender, test, times, trap, type, typeset, ulimit, umask, unalias , unset, wait - bash built-in commands, vexa bash (1)
Comando embutido Bash
A menos que se indique o contrario, cada comando builtin documentado nesta sección como aceptar opcións precedidas por - acepta - para significar o fin das opcións.
: [ argumentos ]
Ningún efecto; o comando non fai máis que expandir os argumentos e realizar calquera redirección especificada. Engádese un código de saída cero.
. nome de ficheiro [ argumentos ]
nome de ficheiro de orixe [ argumentos ]
Ler e executar comandos do nome do ficheiro no contorno actual e devolver o estado de saída do último comando executado desde o nome do ficheiro . Se o nome de ficheiro non contén unha barra, os nomes de ficheiro en PATH úsanse para atopar o directorio que contén o nome do ficheiro . O ficheiro buscado en PATH non necesita ser executable. Cando bash non está en modo posix , procúrase o directorio actual se non se atopa ningún ficheiro en PATH . Se a opción sourcepath para o comando built-in está desactivada, non se busca o PATH . Se se proporcionan algúns argumentos , fanse os parámetros de posición cando se executa o nome do ficheiro . Se non, os parámetros de posición non se modifican. O estado de retorno é o estado do último comando que sae do script (0 se non se executan comandos) e falso se o nome do ficheiro non se atopa ou non se pode ler.
alias [ -p ] [ nome [= valor ] ...]
Alias sen argumentos ou coa opción -p imprime a lista de alias no alias name = value na saída estándar. Cando se fornezan os argumentos, definirase un alias para cada nome cuxo valor se dá. Un espazo final en valor fai que se verifique a seguinte palabra para a substitución de alias cando o alias se expande. Para cada nome da lista de argumentos para os que non se fornece ningún valor , imprímese o nome eo valor do alias. O alias volve verdadeiro a menos que se indique un nome para o cal non se definiu ningún alias.
bg [ jobspec ]
Reprenda a tarefa de emprego suspendida en segundo plano, coma se fose iniciada con & . Se o workspec non está presente, úsase a noción de shell do traballo actual . bg jobspec devolve 0 a menos que se execute cando o control de traballo estea desactivado ou, cando se executa co control de traballo activado, se o traballo de traballo non se atopou ou se iniciou sen control de traballo.
ligar [ -m mapa de teclado ] [ -lpsvPSV ]
ligar [ -m teclado numérico ] [ función -q ] [ -u función ] [ -r keyseq ]
ligar [ -m mapa de teclado ] -f nome de ficheiro
bind [ -m keymap ] -x keyseq : shell-command
ligar [ -m keymap ] keyseq : función-nome
ligar readline-command
Mostra a ligazón da ligazón actual e as ligazóns de funcións, ligan unha secuencia de teclas a unha función de lerline ou a macro, ou establecen unha variable readline . Cada argumento non opcional é un comando tal e como aparecería en .inputrc , pero cada unión ou comando debe pasarse como un argumento separado; por exemplo, "" \ Cx \ Cr ": re-read-init-file '. As opcións, se fornecidas, teñen os seguintes significados:
-m Mapa de teclado
Use o mapa de teclado como o mapa de teclado que se verá afectado polas ligazóns posteriores. Os nomes de tecla aceptables son emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move, vi-command e vi-insert . vi é equivalente a vi-command ; emacs é equivalente a emacs-standard .
-l
Lista os nomes de todas as funcións de readline .
-p
Mostrar nomes e ligazóns de funcións de readline de tal forma que poidan volver ler.
-P
Lista nomes de funcións actuais e ligazóns actuais.
-v
Amosar os nomes e os valores das variables readline de tal xeito que poidan volver ler.
-V
Lista os nomes e valores das variables de readline actuais.
-s
Mostra secuencias de teclas de readline ligadas a macros e as cadeas que saen de tal forma que se poidan volver ler.
-S
Mostra secuencias de teclas de readline ligadas a macros e as cadeas que saen .
-f nome de ficheiro
Lea os atallos de teclas do nome do ficheiro .
función -q
Consulta sobre que teclas invocan a función nomeada.
-U función
Desbloquea todas as teclas ligadas á función nomeada.
-r keyseq
Elimina calquera ligazón actual para keyseq .
-x keyseq : shell-command
Causa o comando shell para ser executado sempre que se introduce o keyseq .
O valor de retorno é 0 a menos que se dea unha opción non recoñecida ou se ocorre un erro.
romper [ n ]
Saia dentro dun for , while , until , ou loop select . Se se especifica n , rompe n niveis. n debe ser> 1. Se n é maior que o número de bucles de enganche, saen todos os bucles de enganche. O valor de retorno é 0 a menos que o shell non execute un ciclo cando se executa o descanso .
builtin shell-builtin [ argumentos ]
Executa o shell especificado incorporado, pasando argumentos e devolve o seu estado de saída. Isto é útil cando se define unha función cuxo nome é o mesmo que un shell integrado, mantendo a funcionalidade do builtin dentro da función. O builtin de cd normalmente redefínase deste xeito. O estado de retorno é falso se shell-builtin non é un shell builtin.
cd [ -L | -P ] [ dir ]
Cambia o directorio actual a dir . A variable HOME é o dir por defecto. A variábel CDPATH define a ruta de busca do directorio que contén dir . Os nomes de directorio alternativos en CDPATH están separados por dous puntos (:). O nome de directorio nulo en CDPATH é o mesmo que o directorio actual, é dicir, `` . ''. Se dir comeza cunha barra (/), entón non se usa o CDPATH . A opción -P di usar a estrutura de directorio físico en vez de seguir ligazóns simbólicas (vexa tamén a opción -P ao comando set builtin); a opción -L forza as ligazóns simbólicas a seguir. Un argumento de - é equivalente a $ OLDPWD . O valor de retorno é certo se o directorio foi modificado con éxito; falso doutra forma.
comando [ -pVv ] comando [ arg ...]
Executa o comando con args suprimindo a procura da función shell normal. Só se executan comandos ou comandos incorporados atopados no PATH . Se se dá a opción -p , a procura do comando realízase empregando un valor predeterminado para PATH que está garantido para atopar todas as utilidades estándar. Se se fornece a opción -V ou -v , imprímese unha descrición do comando . A opción -v fai que unha única palabra que indique o comando ou nome de ficheiro usado para invocar o comando a mostrar; a opción -V produce unha descrición máis detallada. Se se fornece a opción -V ou -v , o estado de saída é 0 se se atopou o comando e 1 se non. Se non se fornece ningunha opción e non se pode atopar un erro ou non se pode atopar o comando , o estado de saída é 127. Se non, o estado de saída do comando builtin é o estado de saída do comando .
compgen [ option ] [ word ]
Xera posibles conxuntos de conclusión para a palabra de acordo coa opción s, que pode ser calquera opción aceptada pola construída completa, con excepción de -p e -r , e escriba as coincidencias coa saída estándar. Ao usar as opcións -F ou -C , as varias variábeis de conxuntos definidas polas instalacións programables de finalización, mentres estean dispoñibles, non terán valores útiles.
Os xogos serán xerados do mesmo xeito que se o código de finalización programable xeraraos directamente desde unha especificación de conclusión coas mesmas bandeiras. Se se especifica a palabra , só se mostrarán as palabras correspondentes.
O valor de retorno é verdadeiro a menos que se forneza unha opción non válida ou non se xeraron coincidencias.
completar [ -abcdefgjksuv ] [ -o comp-option ] [ -A acción ] [ -G globpat ] [ -W lista de palabras ] [ -P prefix ] [ -S sufixo ]
[ -X filterpat ] [ -F función ] [ -C comandar ] nome [ nome ... ]
completar -pr [ nome ...]
Especifique como se deben completar os argumentos a cada nome . Se se fornece a opción -p , ou se non se fornecen ningunha opción, as especificacións de finalización existentes imprímense de forma que lles permita ser reutilizado como entrada. A opción -r elimina unha especificación de conclusión para cada nome ou, se non se proporcionan nomes , todas as especificacións de finalización.
O proceso de aplicar estas especificacións de conclusión cando se intenta completar a palabra descríbese debaixo da Comprobación programable .
Outras opcións, se se especifica, teñen os seguintes significados. Os argumentos para as opcións -G , -W e -X (e, se fose necesario, as opcións -P e -S ) deberían cotizarse para protexelos da expansión antes de invocar o builtin completo .
-o comp-option
A comp-option controla varios aspectos do comportamento do compspec máis aló da simple xeración de terminacións. comp-option pode ser unha das seguintes:
por defecto
Use a finalización do nome de ficheiro predeterminado do readline se o compspec non xera coincidencias.
dirnames
Realiza a conclusión do nome do directorio se o compspec non xera coincidencias.
nomes de ficheiro
Indique que o compspec xera nomes de ficheiro, polo que pode executar calquera procesamento específico de nome de ficheiro (como engadir unha barra para nomes de directorio ou eliminar espazos finais). Destinado a ser usado con funcións shell.
espazo nos espazos
Diga a lerline para non engadir un espazo (por defecto) ás palabras completas ao final da liña.
-A acción
A acción pode ser unha das seguintes para xerar unha lista de conclusións posibles:
alias
Nomes de alias. Tamén se pode especificar como -a .
arrayvar
Nomes de variables de matriz.
vinculante
Nomes de ligazón de chave de lectura .
construído
Nomes dos comandos builtin shell. Tamén se pode especificar como -b .
comando
Nomes de comandos. Tamén se poden especificar como nomes. Tamén se pode especificar como -c .
directorio
Nomes de directorio . Tamén se pode especificar como -d .
desactivado
Nomes de builtins con shell desactivados.
activado
Nomes de builtins habilitados con shell.
exportación
Nomes das variables de shell exportadas. Tamén se pode especificar como -e .
ficheiro
Nomes dos ficheiros. Tamén se pode especificar como -f .
función
Nomes das funcións de shell .
grupo
Nomes de grupo. Tamén se pode especificar como -g .
heptópico
Asuntos de axuda como aceptados pola axuda integrada.
Os nomes de servidor, tomados do ficheiro especificado pola variable Shell HOSTFILE .
traballo
Nomes de traballo, se o control de traballo está activo. Tamén se pode especificar como -j .
palabra clave
Concha palabras reservadas. Tamén pode especificarse como -k .
correndo
Nomes dos traballos en execución, se o control de traballo está activo.
servizo
Nomes de servizo. Tamén se pode especificar como -s .
setopt
Argumentos válidos para a opción -o ao conxunto integrado.
shopt
Nomes de opcións de Shell aceptados polo shopt integrado.
sinal
Nomes de sinal.
parado
Nomes de traballos parados, se o control de traballo está activo.
usuario
Nomes de usuario. Tamén se pode especificar como -u .
variable
Nomes de todas as variables de shell. Tamén se pode especificar como -v .
-G globpat
O globpat do patrón de expansión do ficheiro expandirase para xerar as conclusións posibles.
-W lista de palabras
A lista de palabras está dividida utilizando os caracteres da variable especial de IFS como delimitadores e cada palabra resultante é ampliada. As conclusións posibles son os membros da lista resultante que coinciden coa palabra que se completa.
Comando C
O comando execútase nun ambiente de subsolo e a súa saída úsase como conclusións posibles.
-F función
A función de función shell execútase no contorno shell actual. Cando remate, as conclusións posibles obtéñense do valor da variábel COMPREPLY array.
-X filtrado
filterpat é un patrón usado para a expansión do nome do ficheiro. Aplícase á lista de posibles complementos xerados polas opcións e argumentos anteriores, e cada complementación que se corresponde con filterpat é eliminada da lista. Un líder ! en filterpat nega o patrón; neste caso, elimináronse todas as conclusións non compatibles con filterpat .
Prefixo -P
O prefixo engádese ao comezo de cada conclusión posible despois de que se aplicaron todas as outras opcións.
Sufijo -S
O sufijo engádese a cada posible conclusión despois de que se aplicaron todas as outras opcións.
O valor de retorno é verdadeiro a menos que se forneza unha opción non válida, unha opción distinta de -p ou -r subministrada sen un argumento de nome , inténtase eliminar unha especificación de finalización dun nome para o cal non existe ningunha especificación ou se produce un erro. engadindo unha especificación de conclusión.
continuar [ n ]
Reprenda a seguinte iteración do encerado para , mentres , ata , ou seleccione loop. Se n especifícase, retomase no n º ciclo que inclúe. n debe ser> 1. Se n é maior que o número de loops, engádese o último loop (o ciclo `` top-level ''). O valor de retorno é 0 a menos que o shell non execute un ciclo cando se continúa executando.
declarar [ -afFirtx ] [ -p ] [ nome [= valor ]]
typeset [ -afFirtx ] [ -p ] [ nome [= valor ]]
Declarar variables e / ou atribuirlles atributos. Se non se nomean os nomes , móstranse os valores das variables. A opción -p mostrará os atributos e valores de cada nome . Cando se usa -p , ignóranse opcións adicionais. A opción -F inhibe a visualización de definicións de funcións; só se imprimen o nome e os atributos da función. A opción -F implica -f . As seguintes opcións pódense empregar para restrinxir a saída ás variables co atributo especificado ou para atribuír variables:
-a
Cada nome é unha variábel (ver Arrays de arriba).
-f
Use nomes de funcións soamente.
-i
A variábel é tratada como un número enteiro; A avaliación aritmética (ver EVALUACIÓN ARITMÉTICA) realízase cando a variable ten asignado un valor.
-r
Faga que o nome sexa só de lectura. Estes nomes non poden ser asignados valores por instrucións posteriores de asignación ou non establecidas.
-t
Dálle a cada nome o atributo de seguimento . As funcións trazadas herdan a trampa DEBUG da shell shell. O atributo de seguimento non ten un significado especial para as variables.
-x
Marca o nome s para exportar a comandos posteriores a través do medio.
Usando `+ 'no canto de` -', desactívase o atributo, coa excepción de que + a non se pode usar para destruír unha variable de matriz. Cando se usa nunha función, fai que cada nome sexa local, como co comando local . O valor de retorno é 0 a menos que se encontre unha opción non válida, inténtase definir unha función usando `` -f foo = bar '', inténtase asignar un valor a unha única variable de só lectura; faise un intento para asignar un valor a unha variable de matriz sen usar a sintaxe de asignación composta (vexa Arrays de arriba), un dos nomes non é un nome de variable de shell válido, inténtase desactivar o estado só de lectura para unha variable de só lectura, faise un intento para desactivar o estado da matriz dunha variábel de matriz ou se intenta amosar unha función inexistente con -f .
dirs [-clv ] [+ n ] [- n ]
Sen opcións, amosa a lista de directorios actualmente recordados. A visualización predeterminada está nunha única liña con nomes de directorio separados por espazos. Os directorios engádense á lista co comando pushd ; o comando popd elimina entradas da lista.
+ n
Mostra a conta de n ª entrada a partir da esquerda da lista mostrada por dirs cando se invoca sen opcións, comezando con cero.
- n
Mostra a conta de n ª entrada a partir da dereita da lista mostrada por dirs cando se invoca sen opcións, comezando con cero.
-c
Limpa a pila de directorios ao eliminar todas as entradas.
-l
Produce unha lista máis longa; o formato de lista predeterminada usa unha tilde para denotar o directorio persoal.
-p
Imprime a pila de directorios cunha entrada por liña.
-v
Imprime a pila de directorios cunha entrada por liña, prefixando cada entrada co seu índice na pila.
O valor de retorno é 0 a menos que se forneza unha opción non válida ou n indexa máis aló do final da pila de directorios.
disown [ -ar ] [ -h ] [ jobspec ...]
Sen opcións, cada peza de traballo elimínase da táboa de traballos activos. Se se dá a opción -h , cada workspec non se elimina da táboa, pero está marcado para que SIGHUP non se envíe ao traballo se o shell recibe un SIGHUP . Se ningún punto de traballo está presente e non se fornece a opción -a nin a -r , empregarase o traballo actual . Se non se fornece ningún punto de traballo, a opción -a significa eliminar ou marcar todos os traballos; a opción -r sen un argumento workspec restrinxe a operación ás tarefas en execución. O valor de retorno é 0 a menos que un workspec non especifique un traballo válido.
eco [ -neE ] [ arg ...]
Saída da arg , separada por espazos, seguida dunha nova liña. O estado de retorno sempre é 0. Se -n está especificado, a nova liña final elimínase. Se se dá a opción -e , está habilitada a interpretación dos seguintes caracteres escapados por barra invertida. A opción -E deshabilita a interpretación destes personaxes de escape, incluso en sistemas onde se interpretan por defecto. A opción shell shell de xpg_echo pode usarse para determinar dinamicamente se echo expande estes caracteres de escape de forma predeterminada. O eco non interpreta - significa o final das opcións. echo interpreta as seguintes secuencias de escape:
\ a
alerta (campá)
\ b
retroceso
\ c
Eliminar a nova liña final
\ e
un personaxe de escape
\ f
alimentación de formulario
\ n
nova liña
\ r
retorno de carro
\ t
pestana horizontal
\ v
pestaña vertical
\\
barra invertida
\ 0 nnn
o carácter de oito bits cuxo valor é o valor octal nnn (cero a tres díxitos octales)
\ nnn
o carácter de oito bits cuxo valor é o valor octal nnn (un a tres díxitos octales)
\ x HH
o carácter de oito bits cuxo valor é o valor hexadecimal HH (un ou dous díxitos hexadecimales)
habilitar [ -adnps ] [ -f nome de ficheiro ] [ nome ...]
Habilitar e desactivar comandos builtin shell. Deshabilitar un builtin permite que se execute un comando de disco que teña o mesmo nome que un intérprete de comandos sen especificar un nome de ruta completo, aínda que o shell normalmente procure builtins antes de comandos de disco. Se -n se usa, cada nome está desactivado; doutro xeito, os nomes están habilitados. Por exemplo, para usar o binario de probas atopado a través do PATH no canto da versión integrada do shell, execute `` enable -n test ''. A opción -f significa cargar o novo nome de comando incorporado do nome de ficheiro de obxecto compartido, en sistemas que admitan a carga dinámica. A opción -d borrará un ficheiro previamente cargado con -f . Se non se proporcionan argumentos de nome , ou se a opción -p é subministrada, imprímese unha lista de compoñentes integrados. Sen outros argumentos de opción, a lista consta de todas as construcións de shell habilitadas. Se se fornece -n , só se imprimen as construídas con discapacidade. Se-a se fornece, a lista impresa inclúe todos os elementos incorporados, cunha indicación de se cada un está habilitado. Se se fornece -s , a saída está restrinxida ás construcións especiais POSIX.
O valor de retorno é 0 a menos que un nome non estexa integrado nun shell ou se hai un erro ao cargar un novo builtin dun obxecto compartido.
eval [ arg ...]
Os argumentos son lidos e concatenados xuntos nun único comando. Este comando é entón lido e executado polo intérprete de comandos, eo seu estado de saída é devolto como o valor de eval . Se non hai args , ou só argumentos nulos, eval devuelve 0.
exec [ -cl ] [ -a nome ] [ comando [ argumentos ]]
Se se especifica o comando , substitúe ao shell. Non se crea ningún novo proceso. Os argumentos fanse os argumentos para comandar . Se a opción -l se fornece, a casca pon un guión ao comezo do arg zeroth pasou ao comando . Isto é o que fai o login (1). A opción -c fai que o comando sexa executado cun ambiente baleiro. Se-a se fornece, o shell transcende o nome como argumento zeroth ao comando executado. Se o comando non pode ser executado por algún motivo, sae unha casilla non interactiva, a menos que a opción shell está executada , en cuxo caso devolve o fallo. Unha shell interactiva devolve un fallo se o ficheiro non se pode executar. Se o comando non está especificado, as redireccións terán efecto no shell actual e o estado de retorno é 0. Se hai un erro de redirección, o estado de retorno é 1.
saír [ n ]
Causa que o shell saia cun estado de n . Se omítese n , o estado de saída é o do último comando executado. Unha trampa en EXIT execútase antes de que finalice o shell.
exportar [ -fn ] [ nome [= palabra ]] ...
exportación -p
Os nomes subministrados están marcados para a exportación automática ao ambiente de comandos posteriormente executado. Se a opción -f está dada, os nomes refírense a funcións. Se non se proporcionan nomes , ou se a opción -p é subministrada, imprímese unha lista de todos os nomes exportados neste intérprete. A opción -n fai que se elimine a propiedade de exportación das variables nomeadas. a exportación retorna un estado de saída de 0 a non ser que se encontre unha opción non válida, un dos nomes non é un nome de variable de intérprete válido, ou -f fornece cun nome que non é unha función.
fc [ -e ename ] [ -nlr ] [ primeiro ] [ último ]
fc -s [ pat = rep ] [ cmd ]
Comando Fix. Na primeira forma, unha selección de comandos de primeiro a último son seleccionados na lista de historial. A primeira e a última poden especificarse como unha cadea (para localizar o último comando que comeza con esa cadea) ou como un número (un índice na lista de historials, onde se usa un número negativo como compensación do número de comando actual). Se non se especifica o último , configúrase no comando actual para a listaxe (de xeito que `` fc -l -10 '' imprime os últimos 10 comandos) e en primeiro lugar o contrario. Se primeiro non se especifica, configúrase no comando anterior para a edición e -16 para a listaxe.
A opción -n suprime os números de comando ao indicar. A opción -r invierte a orde dos comandos. Se se dá a opción -l , os comandos están listados na saída estándar. En caso contrario, o editor proporcionado por ename invócase nun ficheiro que contén eses comandos. Se non se dá o nome, emprégase o valor da variable FCEDIT eo valor de EDITOR se FCEDIT non está configurado. Se non se establece ningunha variable, úsase. Ao completar a edición, os comandos editados repítense e executáronse.
No segundo formulario, o comando é executado de novo despois de cada instancia de pat substituída por representante . Un alias útil para usar con isto é `` r = fc -s '', de xeito que escribir `` r cc '' executa o último comando que comeza con `` cc '' e escribindo `` r '' volve executar o último comando.
Se se usa o primeiro formulario, o valor de retorno é 0 a menos que se encontre unha opción non válida ou que especifique primeiro ou último as liñas de historial fóra do alcance. Se se fornece a opción -e , o valor de retorno é o valor do último comando executado ou o fallo se se produce un erro co ficheiro temporal de comandos. Se se usa o segundo formulario, o estado de retorno é o do comando executado de novo, a non ser que o cmd non especifique unha liña de historial válida, en cuxo caso o ficheiro devolve o fallo.
fg [ jobspec ]
Reprenda workspec en primeiro plano e faino o traballo actual. Se o workspec non está presente, úsase a noción de shell do traballo actual . O valor de retorno é o do comando colocado no primeiro plano ou a falla se se executa cando o control de traballo está desactivado ou, cando se executa co control de traballo activado, se workspec non especifica un traballo válido ou workspec especifica un traballo que se iniciou sen control de traballo .
getopts optstring name [ args ]
getopts é usado polos procedementos shell para analizar parámetros de posición. optstring contén os caracteres de opción a recoñecer; se un carácter é seguido por dous puntos, espérase que a opción teña un argumento, que debe ser separado do espazo branco. Non se poden empregar os caracteres de puntos e signos de interrogación como caracteres de opción. Cada vez que se invoca, getopts coloca a seguinte opción no nome da variable shell, inicializando o nome se non existe eo índice do seguinte argumento a procesar na variable OPTIND . OPTIND está inicializado a 1 cada vez que se invoca o shell ou o shell. Cando unha opción require un argumento, getopts coloca ese argumento na variable OPTARG . O shell non restablece OPTIND automaticamente; debe ser restablecido manualmente entre varias chamadas a getopts dentro da mesma invocación de shell se se vai usar un novo conxunto de parámetros.
Cando se atopa o final das opcións, getopts sae cun valor de retorno superior a cero. OPTIND está establecido no índice do primeiro argumento non opcional e o nome está configurado?
os getopts normalmente analizan os parámetros posicionais, pero se hai máis argumentos dados en args , os getopts analizan estes.
Os getopts poden reportar erros de dous xeitos. Se o primeiro carácter de optstring é un punto de coma, úsase un informe de erro silencioso . En mensaxes de diagnóstico de operación normais imprímense cando se atopan opcións non válidas ou argumentos de opción faltantes. Se a variable OPTERR está configurada en 0, non se mostrarán mensaxes de erro, aínda que o primeiro carácter de optstring non sexa de dous puntos.
Se se ve unha opción non válida, obtense lugares? no nome e, se non silencioso, imprime unha mensaxe de erro e desactiva OPTARG . Se getopts está en silencio, o carácter de opción atopado colócase en OPTARG e non se imprime ningunha mensaxe de diagnóstico.
Se non se atopa un argumento obrigatorio e os getopts non son silenciosos, engádese un nome de interrogación ( ? ) No nome , OPTARG está desactivado e imprímese unha mensaxe de diagnóstico. Se os getopts están en silencio, colócanse dous puntos ( :) e OPTARG está definido no carácter de opción atopado.
getopts volve verdadeiro se se atopa unha opción, especificada ou non especificada. Devolve falsa se se atopa o final das opcións ou ocorre un erro.
hash [ -lr ] [ -p nome de ficheiro ] [ -dt ] [ nome ]
Para cada nome , o nome completo do ficheiro do comando está determinado buscando os directorios en $ PATH e recordado. Se se fornece a opción -p non se realiza ningunha procura de camiño e o nome de ficheiro úsase como o nome de ficheiro completo do comando. A opción -r fai que o shell para esquecer todas as localizacións recordadas. A opción -d fai que o shell para esquecer a localización recordada de cada nome . Se se fornece a opción -t , imprímese o nome de ruta completo ao que corresponde cada nome . Se se fornecen varios argumentos de nome con -t , o nome imprimirase antes do nome completo de ruta completa. A opción -l fai que a saída se mostre nun formato que pode ser reutilizado como entrada. Se non se fornece ningún argumento, ou se -l se fornece, imprímese a información sobre comandos recordados. O estado de retorno é verdadeiro agás se non se atopa un nome ou se fornece unha opción non válida.
axuda [ -s ] [ patrón ]
Amosar información útil sobre comandos integrados. Se o patrón está especificado, axuda axuda detallada en todos os comandos que coinciden co patrón ; de outra forma imprimirase a axuda para todas as construcións e as estruturas de control do shell. A opción -s restrinxe a información que se amosa nunha breve sinopse de uso. O estado de retorno é 0 a menos que ningún comando coincida co estándar .
historia [ n ]
historia -c
historial -d compensación
historia -anrw [ nome de ficheiro ]
historia -p arg [ arg ... ]
historia -s arg [ arg ... ]
Sen opcións, amosa a lista de historial de comando con números de liña. Engadíronse as liñas enumeradas con * . Un argumento de n enumera só as últimas n liñas. Se se fornece o nome de ficheiro, úsase como o nome do ficheiro de historial; se non, emprégase o valor de HISTFILE . As opcións, se fornecidas, teñen os seguintes significados:
-c
Borrar a lista de historias eliminando todas as entradas.
-d compensación
Elimine a entrada de historial na posición de compensación .
-a
Engada as liñas do historial `` novo '' (liñas de historiales introducidas desde o inicio da sesión bash actual) ao ficheiro de historial.
-n
Lea as liñas de historial que xa non leu do ficheiro de historial na lista de historial actual. Estas son liñas anexadas ao ficheiro de historia desde o inicio da sesión de bash actual.
-r
Lea o contido do ficheiro de historial e utilízaos como o historial actual.
-w
Escribe o historial actual no ficheiro de historial, sobreescribindo os contidos do arquivo de historial.
-p
Realiza a substitución do historial nos seguintes argumentos e mostra o resultado na saída estándar. Non almacena os resultados na lista de historial. Cada arg debe ser citado para desactivar a expansión normal do historial.
-s
Garda os argumentos da lista de historias como unha única entrada. O último comando na lista de historial elimínase antes de engadir os argumentos .
O valor de retorno é 0 a menos que se encontre unha opción non válida, ocorre un erro ao ler ou escribir o ficheiro de historial, un compensado non válido é fornecido como argumento para -d , ou a expansión do historial proporcionada como argumento a -p falla.
traballos [ -lnprs ] [ jobspec ...]
jobs -x command [ args ...]
O primeiro formulario enumera os traballos activos. As opcións teñen os seguintes significados:
-l
Lista os ID do proceso ademais da información normal.
-p
Indique só o ID do proceso do líder do grupo de procesos do traballo.
-n
Mostrar información só sobre traballos que cambiaron de estado desde que o usuario foi notificado por última vez do seu estado.
-r
Restrinxir a saída ás tarefas en execución.
-s
Restrinxir a saída aos traballos detidos.
Se se dá workspec , a saída está restrinxida á información sobre ese traballo. O estado de retorno é 0 a menos que se atopa unha opción non válida ou se fornece un punto de traballo non válido.
Se se fornece a opción -x , os traballos substitúen calquera emprego atopado no comando ou argumentos co ID do grupo de procesos correspondente e executa o comando que o pasa, e retorna o seu estado de saída.
matar [ -s sigspec | -n sinal | - sigspec ] [ pid | jobspec ] ...
matar -l [ sigspec | sort_status ]
Envía o sinal chamado sigspec ou signum aos procesos chamados pid ou jobspec . sigspec é un nome de sinal como SIGKILL ou un número de sinal; signum é un número de sinal. Se sigspec é un nome de sinal, o nome pode darse con ou sen o prefixo SIG . Se sigspec non está presente, entón asúmese SIGTERM . Un argumento de -l enumera os nomes de sinal. Se se fornecen algún argumento cando -l está indicado, os nomes dos sinais correspondentes aos argumentos están listados e o estado de retorno é 0. O argumento exit_status a -l é un número que indica un número de sinal ou o estado de saída dun proceso terminado por un sinal. kill volve verdadeiro se se emitiu con éxito un sinal, ou falso se se produce un erro ou se atopa unha opción non válida.
deixe arg [ arg ...]
Cada arg é unha expresión aritmética para ser avaliada (vexa AVALIACIÓN ARITÉMICA ). Se o último arg evalúa a 0, deixe os retorno 1; Devolve o 0 contrario.
local [ opción ] [ nome [= valor ] ...]
Para cada argumento, créase unha variable local denominada nome e valor asignado. A opción pode ser calquera das opcións aceptadas por declarar . Cando se usa local dentro dunha función, fai que o nome da variable teña un alcance visible restrinxido a esa función e aos seus fillos. Sen operandos, local escribe unha lista de variables locais para a saída estándar. É un erro usar o local cando non está dentro dunha función. O estado de retorno é 0 a non ser que o local se use fóra dunha función, fornécese un nome non válido ou o nome é unha variable lexítima.
pechar sesión
Sae dun shell de inicio de sesión.
popd [- n ] [+ n ] [- n ]
Elimina entradas da pila de directorios. Sen argumentos, elimina o cartafol superior da pila e executa un cd no directorio novo superior. Argumentos, se fornecidos, teñen os seguintes significados:
+ n
Elimina a conta de n ª entrada a partir da esquerda da lista que mostra dirs , comezando con cero. Por exemplo: `` popd +0 '' elimina o primeiro directorio, `` popd +1 '' o segundo.
- n
Elimina a conta de n ª entrada a partir da dereita da lista que mostra dirs , comezando con cero. Por exemplo: `` popd -0 '' elimina o último directorio, `` popd -1 '' o próximo ao último.
-n
Suprime o cambio normal do directorio ao eliminar os directorios da pila, polo que só se manipula a pila.
Se o comando popd é exitoso, tamén se realiza un dirs e o estado de retorno é 0. popd devolve falso se se atopa unha opción non válida, a pila de directorios está baleira, especifícase unha entrada de pila de directorio inexistente ou o directorio o cambio falla.
formato printf [ argumentos ]
Escribe os argumentos formatados na saída estándar baixo o control do formato . O formato é unha cadea de caracteres que contén tres tipos de obxectos: caracteres simples, que simplemente están copiados a saída estándar, secuencias de escape de caracteres, que se converten e copian na saída estándar e as especificacións de formato, cada unha das cales fai que a impresión do próximo argumento sucesivo. Ademais dos formatos estándar printf (1), % b fai que printf para expandir as secuencias de escape de barra invertidas no argumento correspondente, e % q fai que printf poida enviar o argumento correspondente nun formato que pode ser reutilizado como entrada de shell.
O formato é reutilizado como necesario para consumir todos os argumentos . Se o formato require máis argumentos do que se fornece, as especificacións de formato extra compórtanse coma se fose subministrado un valor cero ou unha cadea nula, segundo corresponda. O valor de retorno é cero no éxito, non cero no fallo.
pushd [ -n ] [ dir ]
pushd [ -n ] [+ n ] [- n ]
Engade un directorio á parte superior da pila de directorios, ou xira a pila, facendo que a nova parte superior da pila sexa o directorio de traballo actual. Sen argumentos, intercambia os dous primeiros directorios e devolve 0, a menos que a pila de directorios estea baleira. Argumentos, se fornecidos, teñen os seguintes significados:
+ n
Xira a pila de xeito que o n º directorio (que contén desde a esquerda da lista que mostra dirs , comezando por cero) está na parte superior.
- n
Xira a pila para que o n º directorio (que contén desde a dereita da lista que mostra dirs , comezando por cero) está na parte superior.
-n
Suprime o cambio normal do directorio ao engadir directorios á pila, polo que só se manipula a pila.
dir
Engade dir ao pila de directorios na parte superior, converténdoo no novo directorio de traballo actual.
Se o comando pushd é exitoso, tamén se realiza un dirs . Se se usa o primeiro formulario, pushd retorna 0 a non ser que falla o cd a dir . Coa segunda forma, pushd retorna 0 a menos que a pila de directorios estea baleira, especifícase un elemento de pila de directorios inexistente ou o directorio cambia ao directorio actual novo especificado falla.
pwd [ -LP ]
Imprime a ruta de acceso absoluta do directorio de traballo actual. O nome de ruta impreso non contén ligazóns simbólicas se se fornece a opción -P ou a opción -o física do comando set builtin está habilitado. Se se usa a opción -L , o camiño impreso pode conter ligazóns simbólicas. O estado de retorno é 0 a menos que se produza un erro ao ler o nome do directorio actual ou unha opción non válida.
ler [ -ers ] [ -u fd ] [ -t tempo de espera ] [ -a aname ] [ -p prompt ] [ -n nchars ] [ -d delim ] [ nome ...]
Unha liña é lida desde a entrada estándar, ou desde o descriptor de ficheiro fd subministrado como un argumento á opción -u , ea primeira palabra está asignada ao primeiro nome , a segunda palabra ao segundo nome , etc., con sobra palabras e os seus separadores intermedios asignados ao apelido . Se hai menos palabras leídas desde a liña de entrada que nomes, os nomes restantes asignaranse valores baleiros. Os caracteres de IFS úsanse para dividir a liña en palabras. O carácter de barra invertida ( \ ) pode usarse para eliminar calquera significado especial para a seguinte lectura de caracteres e para a continuación da liña. As opcións, se fornecidas, teñen os seguintes significados:
-un aname
As palabras están asignadas a índices secuenciales da variable de matriz aname , a partir de 0. aname descárgase antes de asignar novos valores. Ignóranse outros argumentos de nome .
-d delim
O primeiro carácter de delim úsase para finalizar a liña de entrada, en vez de liña nova.
-e
Se a entrada estándar vén dun terminal, úsase a liña recta (ver READLINE arriba) para obter a liña.
-n nchars
lea retorna despois de ler os caracteres nchars en lugar de agardar por unha liña de entrada completa.
-p
Indicación de visualización no erro estándar, sen unha nova liña final, antes de tentar ler calquera entrada. O indicador só se amosará se a entrada vén dun terminal.
-r
A barra invertida non actúa como un personaxe de escape. A barra invertida considérase parte da liña. En particular, non se pode usar un par de versións invertidas como unha continuación de liña.
-s
Modo silencioso. Se a entrada vén dun terminal, os caracteres non se fixeron eco.
-t tempo de espera
Causa ler o tempo de espera e devolver o fallo se a liña de entrada completa non se leu dentro dos segundos de tempo de espera . Esta opción non ten ningún efecto se a lectura non está a ler a entrada desde o terminal ou un tubo.
-u fdFP
Ler a entrada do descriptor de ficheiro fd .
Se non se fornece ningún nome , a liña leída está asignada á variable REPLY . O código de retorno é cero, a non ser que se encontre o final do ficheiro, leve veces, ou un descriptor de ficheiro non válido se fornece como argumento a -u .
readonly [ -apf ] [ name ...]
Os nomes indicados están marcados de forma lexíbel; os valores destes nomes non se poden cambiar mediante unha asignación posterior. Se se fornece a opción -f , as funcións correspondentes aos nomes están tan marcadas. A opción -a restrinxe as variables ás matrices. Se non se proporcionan argumentos de nome ou se a opción -p é subministrada, imprímese unha lista de todos os nomes de lectura. A opción -p fai que a saída se mostre nun formato que pode ser reutilizado como entrada. O estado de retorno é 0 a menos que se encontre unha opción non válida, un dos nomes non é un nome de variable de intérprete válido, ou -f inclúese cun nome que non é unha función.
volver [ n ]
Fai que unha función saia co valor de retorno especificado por n . Se omítese n , o estado de retorno é o último comando executado no corpo da función. Se se usa fóra dunha función, pero durante a execución dun script polo . ( fonte ), provoca que o shell para deixar de executar ese script e devolver n ou o estado de saída do último comando executado dentro do script como o estado de saída do script. Se se usa fóra dunha función e non durante a execución dun script por . , o estado de retorno é falso.
establecer [ --abefhkmnptuvxBCHP ] [ -o opción ] [ arg ...]
Sen opcións, o nome eo valor de cada variábel de casilla móstranse nun formato que pode ser reutilizado como entrada. A saída ordenarase de acordo coa localización actual. Cando se especifican as opcións, configuran ou descartan atributos de shell. Os argumentos restantes despois de procesar as opcións son tratados como valores para os parámetros de posición e son asignados, por orde, a $ 1 , $ 2 , ... $ n . As opcións, se se especifica, teñen os seguintes significados:
-a
Marca automáticamente variables e funcións que se modifican ou crean para a exportación ao ambiente dos comandos posteriores.
-b
Informe o estado dos traballos de fondo rematados de inmediato, en vez de antes do seguinte indicador primario. Isto só é efectivo cando o control de traballo está activado.
-e
Sae inmediatamente se un comando simple (vexa SHELL GRAMMAR arriba) sae cun estado non cero. O shell non sae se o comando que falla forma parte dun ciclo de ata ou de un tempo , parte dunha instrución if , parte dun && ou || lista, ou se o valor de retorno do comando está a ser invertido vía ! . Unha trampa en ERR , se está configurada, execútase antes de que saia o shell.
-f
Desactivar a expansión do nome da ruta.
-h
Lembre a localización dos comandos mentres se busca a execución. Esta opción está habilitada por defecto.
-k
Todos os argumentos en forma de declaracións de asignación colócanse no contorno dun comando, non só aqueles que preceden ao nome do comando.
-m
Modo monitor. O control de traballo está activado. Esta opción está activada de xeito predeterminado para as cunchas interactivas nos sistemas que o soportan (consulte CONTROL DE TRABALL arriba). Os procesos de fondo executáronse nun grupo de procesos por separado e unha liña que contén o seu estado de saída impártese ao finalizar.
-n
Ler comandos pero non executalos. Isto pode usarse para comprobar un script shell para erros de sintaxe. Isto é ignorado por cunchas interactivas.
-o nome de opción
O nome de opción pode ser un dos seguintes:
allexport
Igual que -a .
braceexpand
Igual que -B .
emacs
Use unha interface de edición de liña de comandos de estilo emacs. Esta opción está habilitada por defecto cando o shell é interactivo, a menos que o shell se inicie coa opción --no edición .
éxito
Igual que -e .
hashall
Igual que -h .
histexpand
Igual que -H .
historia
Habilita o historial de comandos, como descrito anteriormente en HISTORIA . Esta opción está activada de forma predeterminada en conchas interactivas.
ignoreeof
O efecto é coma se o comando shell `` IGNOREEOF = 10 '' fora executado (consulte as versións Shell anteriores).
palabra clave
Igual que -k .
monitor
Igual que -m .
noclobber
Igual que -C .
noexec
Igual que -n .
noglob
Igual que -f . ignorante Actualmente ignorado.
notificar
Igual que -b .
nome
Igual que -u .
onecmd
Igual que -t .
físico
Igual que -P .
posix
Cambia o comportamento de bash onde a operación predeterminada difiere do estándar POSIX 1003.2 para coincidir co estándar ( modo posix ).
privilexiado
Igual que -p .
verbose
Igual que -v .
vi
Use unha interface de edición de liña de comando vi-style.
xtrace
Igual que -x .
Se -o non se fornece ningún nome de opción , imprímense os valores das opcións actuais. Se se fornece + o sen nomes de opción, móstrase unha serie de comandos definidos para recrear a configuración da opción actual na saída estándar.
-p
Activar o modo privilexiado . Neste modo, os ficheiros de $ ENV e $ BASH_ENV non se procesan, as funcións do shell non se herdan do ambiente e ignórase a variable SHELLOPTS , se aparece no ambiente. Se a shell se inicia co usuario efectivo (grupo) id non idéntico á identificación do usuario real (grupo), ea opción -p non se fornece, estas accións tómanse e a identificación do usuario efectivo está configurada na ID de usuario real. Se a opción -p se fornece no inicio, a ID de usuario efectiva non se restablece. Desactivar esta opción provoca que os identificadores de usuario e de grupo efectivos se axusten aos auténticos identificadores de usuario e grupo.
-t
Sae despois de ler e executar un comando.
-u
Trata as variables non establecidas como un erro ao realizar a expansión de parámetros. Se se intenta a expansión nunha variable non establecida, o shell imprime unha mensaxe de erro e, se non é interactivo, sae cun estado non cero.
-v
Imprime as liñas de entrada de shell cando se len.
-x
Despois de expandir cada comando simple , amosa o valor expandido de PS4 , seguido polo comando e os seus argumentos expandidos.
-B
O shell realiza unha expansión de fiestras (consulte Expansión de engate anterior). Isto funciona de xeito predeterminado.
-C
Se se establece, bash non sobrescribe un ficheiro existente cos operadores de redirección > , > & e <> . Isto pode ser anulado cando se crean ficheiros de saída empregando o operador de redirección > | en vez de > .
-H
Activar ! substitución do historial de estilo. Esta opción está activada por defecto cando o shell é interactivo.
-P
Se está definido, o shell non segue ligazóns simbólicas cando se executan comandos como o cd que cambia o directorio de traballo actual. Utiliza a estrutura de directorio físico no seu lugar. Por defecto, bash segue a cadea lóxica de directorios ao executar comandos que modifican o directorio actual.
-
Se ningún argumento segue esta opción, entón os parámetros de posición non se atopan. De non ser así, os parámetros de posición están axustados á arg , aínda que algúns deles comecen por.
-
Sinale o final das opcións, porque todos os args restantes sexan asignados aos parámetros de posición. As opcións -x e -v están desactivadas. Se non hai args, os parámetros de posición permanecen inalterados.
As opcións están desactivadas por defecto a menos que se indique o contrario. Usar + en vez de - fai que estas opcións sexan desactivadas. As opcións tamén se poden especificar como argumentos para unha invocación do shell. O conxunto actual de opcións pódese atopar en $ - . O estado de retorno sempre é certo salvo que se encontre unha opción non válida.
cambio [ n ]
Os parámetros de posición de n +1 ... renomeáronse a $ 1 ... Non se atopan os parámetros representados polos números $ $ ata $ # - n +1. n debe ser un número non negativo inferior ou igual a $ $ . Se n é 0, non se modifican parámetros. Se n non se dá, suponse que é 1. Se n é superior a $ $ , os parámetros de posición non se modifican. O estado de retorno é superior a cero se n é maior que $ # ou inferior a cero; doutro xeito 0.
shopt [ -pqsu ] [ -o ] [ optname ...]
Cambia os valores das variables que controlan o comportamento opcional da shell. Sen opcións ou coa opción -p , móstrase unha lista de todas as opcións configurables, cunha indicación de se cada un está configurado ou non. A opción -p fai que a saída se mostre nun formulario que pode ser reutilizado como entrada. Outras opcións teñen os seguintes significados:
-s
Activar (definir) cada optname .
-u
Desactivar (desactivar) cada optname .
-q
Elimina a saída normal (modo silencioso); o estado de retorno indica se o nome de opción está configurado ou non establecido. Se se fornecen varios argumentos de optname con -q , o estado de retorno é cero se todos os optnames están habilitados; Non cero doutra forma.
-o
Restrinxe os valores de optname para ser os definidos para a opción -o ao conxunto integrado.
Se se usa -s ou -u sen argumentos de optname , a pantalla limítase a aquelas opcións que están configuradas ou desfasadas, respectivamente. A non ser que se indique o contrario, as opcións de shopt están desactivadas (sen configurar) de forma predeterminada.
O estado de retorno cando as opcións de listaxe son cero se todos os optnames están habilitados, non cero. Ao configurar ou desactivar as opcións, o estado de retorno é cero a menos que un optname non sexa unha opción de shell válida.
A lista de opcións de shopt é:
cdable_vars
Se se establece, un asento ao comando builtin de cd que non é un directorio asúmese que é o nome dunha variable cuxo valor é o directorio para cambiar.
cdspell
Se se establece, corrixiranse erros menores na ortografía dun compoñente de directorio nun comando cd . Os erros marcados son transposicións de caracteres, un carácter perdido e un carácter demasiado. Se se atopa unha corrección, imprímese o nome de ficheiro corrixido e procede o comando. Esta opción só se usa por intérpretes interactivos.
checkhash
Se está definido, bash comproba que existe un comando atopado na táboa hash antes de tentar executalo. Se o comando hashed xa non existe, realízase unha busca de camiño normal.
checkwinsize
Se se establece, bash verifica o tamaño da fiestra despois de cada comando e, se é necesario, actualiza os valores de LINES e COLUMNS .
cmdhist
Se se establece, bash intenta gardar todas as liñas dun comando de liña múltiple na mesma entrada de historia. Isto permite unha fácil reedición de comandos de varias liñas.
dotglob
Se está definido, bash inclúe nomes de ficheiro que comezan cun `. ' nos resultados da expansión do nome da ruta.
execfail
Se está definido, un intérprete non interactivo non sairá se non se pode executar o ficheiro especificado como argumento para o comando exec builtin. Un shell interactivo non sae se falla o exec .
expand_aliases
Se está definido, os alias se expanden como se describe arriba en ALIASES . Esta opción está habilitada de forma predeterminada para conchas interactivas.
extensión
Se está configurado, as funcionalidades de correspondencia estándar estendidas descritas anteriormente na Expansión de nome de Path están habilitadas.
histappend
Se está definido, a lista de historial engádese ao ficheiro nomeado polo valor da variable HISTFILE cando a shell sae, en vez de sobrescribir o ficheiro.
histreedit
Se está definido e readline está a ser usado, un usuario ten a oportunidade de volver editar unha substitución do historial que falla.
histverify
Se está definido e readline está a ser usado, os resultados da substitución do historial non se pasan inmediatamente ao analizador do shell. En vez diso, a liña resultante é cargada no buffer de edición de readline , permitindo unha modificación adicional.
hostcomplete
Se está configurado e readline está a ser usado, bash tentará executar a conclusión do nome do servidor cando se complete unha palabra que contén un @ (vexa Completa en READLINE arriba). Esta opción está habilitada por defecto.
huponexit
Se está definido, bash enviará SIGHUP a todos os traballos cando unha shell de inicio interactiva saia.
comentarios_interactivos
Se está definido, permita que unha palabra que inicie con # para causar esa palabra e que todos os caracteres restantes na mesma liña sexan ignorados nun shell interactivo (consulte COMMENTS arriba). Esta opción está habilitada por defecto.
lítico
Se está definido e a opción cmdhist está activada, os comandos de varias liñas gardaranse no historial con novas liñas incorporadas en lugar de empregar separadores de punto e coma se fose posíbel.
login_shell
O shell estabelece esta opción se se inicia como un intérprete de inicio de sesión (consulte INVOCATION arriba). Non se pode cambiar o valor.
mailwarn
Se está configurado, e un arquivo que bash está comprobando o correo foi acceder desde a última vez que se verificou, a mensaxe `` O correo no ficheiro de correo foi lido '' móstrase.
non_empty_cmd_completion
Se está configurado e readline está a ser usado, bash non tentará buscar o PATH para obter as conclusións posibles cando se intente realizar unha liña baleira.
nocaseglob
Se se establece, bash coincide cos nomes dos ficheiros de xeito case sensible ao executar a expansión do nome de ruta (ver Expansión de nomes de ruta anterior).
nuloglob
Se se establece, bash permite patróns que non coinciden con ningún ficheiro (ver Expansión de nomes de ruta anterior) para expandirse a unha cadea nula, en vez de a eles mesmos.
progcomp
Se está configurado, as instalacións programables para a finalización (ver Compleción programable anterior) están habilitadas. Esta opción está habilitada por defecto.
promptvars
Se está configurado, as cadeas de avisos experimentan unha expansión de parámetros e variables despois de ser