Pangalan
bash , alias, bg , bind, break, builtin, cd , command, compgen, kumpleto, magpatuloy, magpahayag, dirs, disown, echo, paganahin, eval, exec, exit, export, fc, fg, getopts, hash , kasaysayan , trabaho, pumatay , ipaalam, lokal, mag-logout, popd , printf , pushd, pwd , mabasa, readonly, return , set, shift, shopt, source, suspindihin, unalias , unset, maghintay - bash built-in na mga utos, tingnan ang bash (1)
Bash Builtin Command
Maliban kung nabanggit, ang bawat command na builtin ay dokumentado sa seksyon na ito bilang pagtanggap ng mga opsyon na sinundan ng - tumatanggap - upang ipahiwatig ang dulo ng mga pagpipilian.
: [ argumento ]
Walang epekto; ang utos ay walang lampas na pagpapalawak ng mga argumento at pagsasagawa ng anumang tinukoy na mga redirect. Ang zero zero exit code ay ibinalik.
. filename [ argumento ]
source filename [ argumento ]
Basahin at mag-execute ng mga command mula sa filename sa kasalukuyang kapaligiran ng shell at ibalik ang exit status ng huling command na isinagawa mula sa filename . Kung ang filename ay hindi naglalaman ng isang slash, ang mga pangalan ng file sa PATH ay ginagamit upang hanapin ang direktoryo na naglalaman ng filename . Ang paghahanap ng file sa PATH ay hindi kailangang maipapatupad. Kapag ang bash ay wala sa posix mode , hinahanap ang kasalukuyang direktoryo kung walang file ay matatagpuan sa PATH . Kung ang opsyon na sourcepath sa built - in na command ay naka-off, ang PATH ay hindi hinanap. Kung ang anumang mga argumento ay ibinibigay, sila ay naging positional parameter kapag ang filename ay pinaandar. Kung hindi, ang positional parameter ay hindi nagbabago. Ang katayuan ng pagbabalik ay ang kalagayan ng huling utos na lumabas sa loob ng script (0 kung walang mga utos ang naisakatuparan), at maling kung ang filename ay hindi natagpuan o hindi mababasa.
alias [ -p ] [ pangalan [= value ] ...]
Alias na walang mga argumento o may pagpipilian sa -p ang nagpapalimbag ng listahan ng mga alias sa anyo ng alias na pangalan = halaga sa karaniwang output. Kapag ang mga argumento ay ibinibigay, ang isang alias ay tinukoy para sa bawat pangalan na ang halaga ay ibinigay. Ang isang trailing space sa halaga ay nagiging sanhi ng susunod na salita na siniyasat para sa pagpapalit ng alias kapag ang alias ay pinalawak. Para sa bawat pangalan sa listahan ng argumento kung saan walang ibinigay na halaga , ang pangalan at halaga ng alias ay nakalimbag. Ang pagbalik ng alias ay totoo maliban kung ang isang pangalan ay ibinigay na kung saan walang alias ang natukoy.
bg [ jobspec ]
Ipagpatuloy ang nasuspinde na jobspec ng trabaho sa background, na parang nagsimula ito sa & . Kung wala ang jobspec , ang kuru-kuro ng shell ng kasalukuyang trabaho ay ginagamit. bg jobspec returns 0 maliban kung tumakbo kapag ang kawalan ng trabaho ay hindi pinagana o, kapag tumakbo sa kontrol ng trabaho pinagana, kung ang jobspec ay hindi natagpuan o nagsimula nang walang kontrol sa trabaho.
Pagsamahin ang [ -m keymap ] [ -lpsvPSV ]
magbuklod [ -m keymap ] [ -q function ] [ -u function ] [ -r keyseq ]
ikabit ang [ -m keymap ] -f filename
Itaguyod ang [ -m keymap ] -x keyseq : shell-command
Itaguyod ang [ -m keymap ] keyseq : function-name
magbigkis readline-command
Ipakita ang kasalukuyang readline key at pag-andar bindings, magbigkis ng isang susi pagkakasunod-sunod sa isang function ng readline o macro, o itakda ang isang readline variable. Ang bawat di-opsiyon na argument ay isang utos na lilitaw sa .inputrc , ngunit ang bawat umiiral o utos ay dapat na ipasa bilang isang hiwalay na argumento; halimbawa, '"\ Cx \ Cr": muling mabasa-init-file'. Ang mga pagpipilian, kung ibinigay, ay may mga sumusunod na kahulugan:
-m keymap
Gamitin ang keymap bilang ang keymap na maapektuhan ng mga kasunod na bindings. Ang mga tanggap na keymap ay mga emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move, vi-command , at vi-insert . vi ay katumbas ng vi-command ; Ang emacs ay katumbas ng emacs-standard .
-l
Ilista ang mga pangalan ng lahat ng mga function ng readline .
-p
Ipakita ang mga pangalan ng pag-andar ng readline at mga bindings sa isang paraan na maaari silang muling mabasa.
-P
Ilista ang mga kasalukuyang mga function ng readline at mga bindings.
-v
Ipakita ang mga variable ng pangalan ng pagbabasa at mga halaga sa isang paraan na maaari silang muling mabasa.
-V
Ilista ang mga kasalukuyang pangalan ng readline variable at mga halaga.
-s
Ipakita ang mga susing key ng readline na nakatali sa mga macro at ang mga string na inilalabas nila sa paraan na maaari silang muling mabasa.
-S
Ipakita ang mga susunuging key ng readline na nakatali sa mga macro at ang mga string na kanilang output.
-f filename
Basahin ang mga pangunahing bindings mula sa filename .
-q function
Ang query tungkol sa kung aling mga key ay tumatawag sa pinangalanang function .
-u function
Buksan ang lahat ng mga key na nakatali sa pinangalanang function .
-r keyseq
Alisin ang anumang umiiral na umiiral para sa keyseq .
-x keyseq : shell-command
Maging sanhi ng shell-command na papatayin kapag ipinasok ang keyseq .
Ang halaga ng pagbalik ay 0 maliban kung ang isang hindi nakikilalang opsyon ay ibinigay o naganap ang isang error.
break [ n ]
Lumabas mula sa loob ng isang para sa , habang , hanggang , o piliin ang loop. Kung n ay tinukoy, masira ang mga antas ng n . n ay dapat> 1. Kung ang n ay mas malaki kaysa sa bilang ng mga nakapaloob na mga loop, ang lahat ng nakapaloob na mga loop ay lumabas. Ang halaga ng pagbalik ay 0 maliban kung ang shell ay hindi nagsasagawa ng isang loop kapag ang break ay pinaandar.
builtin shell-builtin [ argumento ]
Ipatupad ang tinukoy na shell builtin, ipinapasa ito ng mga argumento , at ibalik ang katayuan ng exit nito. Ito ay kapaki-pakinabang kapag tinutukoy ang isang function na ang pangalan ay pareho ng isang shell builtin, napananatili ang pag-andar ng builtin sa loob ng function. Ang cd builtin ay karaniwang tinutukoy sa ganitong paraan. Ang katayuan ng return ay hindi totoo kung ang shell-builtin ay hindi isang shell builtin command.
cd [ -L | -P ] [ dir ]
Baguhin ang kasalukuyang direktoryo sa dir . Ang variable HOME ay ang default dir . Tinutukoy ng variable na CDPATH ang path ng paghahanap para sa direktoryo na naglalaman ng dir . Ang mga alternatibong pangalan ng direktoryo sa CDPATH ay pinaghiwalay ng isang colon (:). Ang isang null na pangalan ng direktoryo sa CDPATH ay pareho ng kasalukuyang direktoryo, ibig sabihin, `` . ''. Kung dir nagsisimula sa isang slash (/), pagkatapos ay hindi ginagamit ang CDPATH . Sinasabi ng pagpipilian ng -P na gamitin ang istraktura ng pisikal na direktoryo sa halip ng pagsunod sa mga simbolikong mga link (tingnan din ang pagpipiliang -P sa hanay na command na builtin); ang pagpipiliang -L ay nagpapalakas ng mga simbolikong link upang sumunod. Ang argumento ng - ay katumbas ng $ OLDPWD . Ang halaga ng pagbalik ay totoo kung ang direktoryo ay matagumpay na nabago; kung hindi man.
command [ -pVv ] command [ arg ...]
Patakbuhin ang command na may args na pinipigilan ang normal na lookup function ng shell. Ang mga builtin command o command lamang na matatagpuan sa PATH ay pinaandar. Kung ang pagpipilian na -p ay ibinigay, ang paghahanap para sa command ay gumanap gamit ang isang default na halaga para sa PATH na garantisadong upang mahanap ang lahat ng karaniwang mga utility. Kung ang alinman sa -V o -v na opsyon ay ibinibigay, isang paglalarawan ng command ay nakalimbag. Ang -v na pagpipilian ay nagdudulot ng isang salita na nagpapahiwatig ng command o pangalan ng file na ginamit upang magamit ang command na ipapakita; ang -V na opsyon ay gumagawa ng isang mas malalaswang paglalarawan. Kung ang pagpipilian na -V o -v ay ibinigay, ang katayuan ng exit ay 0 kung ang command ay natagpuan, at 1 kung hindi. Kung alinman sa pagpipilian ay ibinigay at ang isang error na naganap o command ay hindi matagpuan, ang exit status ay 127. Kung hindi, ang exit status ng command builtin ay ang exit status ng command .
compgen [ opsyon ] [ salita ]
Bumuo ng posibleng mga posporo ng pagkumpleto para sa salita ayon sa opsyon s, na maaaring anumang pagpipilian na tinanggap ng kumpletong builtin na may pagbubukod ng -p at -r , at isulat ang mga tugma sa karaniwang output. Kapag gumagamit ng -F o -C na mga opsyon, ang iba't ibang mga variable ng shell na itinakda ng mga pasilidad ng programmable na pagkumpleto, habang magagamit, ay walang kapaki-pakinabang na mga halaga.
Ang mga tugma ay mabubuo sa parehong paraan na kung ang Programmable pagkumpleto code ay nabuo ang mga ito nang direkta mula sa isang detalye ng pagkumpleto na may parehong mga flag. Kung tinukoy ang salita , tanging ang mga pagkumpleto ng pagtutugma ng salita ang ipapakita.
Ang halaga ng return ay totoo maliban kung ang isang di-wastong opsyon ay ibinibigay, o walang mga tugma na nabuo.
kumpleto [ -abcdefgjksuv ] [ -o comp-option ] [ -A aksyon ] [ -G globpat ] [ -W wordlist ] [ -P prefix ] [ -S suffix ]
[ -X filterpat ] [ -F function ] [ -C command ] name [ name ... ]
kumpleto -pr [ pangalan ...]
Tukuyin kung paano dapat makumpleto ang mga argumento sa bawat pangalan . Kung ang opsiyon ng -p ay ibinibigay, o kung walang mga pagpipilian ang ibinibigay, ang mga pagtutukoy ng umiiral na pagkumpleto ay naka-print sa isang paraan na nagpapahintulot sa kanila na magamit muli bilang input. Ang -r na opsiyon ay nagtanggal ng detalye ng pagkumpleto para sa bawat pangalan , o, kung walang ibinigay na pangalan, lahat ng mga detalye ng pagkumpleto.
Ang proseso ng paglalapat ng mga detalye ng pagkumpleto kapag natapos ang pagkumpleto ng salita ay inilarawan sa itaas sa ilalim ng Programmable Completion .
Ang iba pang mga opsyon, kung tinukoy, ay may mga sumusunod na kahulugan. Ang mga argumento sa -G , -W , at -X na mga pagpipilian (at, kung kinakailangan, ang -P at -S mga pagpipilian) ay dapat na naka-quote upang protektahan ang mga ito mula sa paglawak bago ang kumpletong builtin ay mahihingi.
-o comp-option
Kinokontrol ng comp-option ang ilang aspeto ng pag-uugali ng compspec na lampas sa simpleng henerasyon ng mga pagkumpleto. Ang comp-option ay maaaring isa sa:
default
Gamitin ang default na filename complet completion kung ang compspec ay walang mga tugma.
dirnames
Magsagawa ng pagkumpleto ng pangalan ng direktoryo kung ang compspec ay walang mga tugma.
mga filename
Sabihin sa readline na ang compspec ay bumubuo ng mga filename, kaya maaari itong magsagawa ng anumang pagproseso na partikular sa filename (tulad ng pagdaragdag ng slash sa mga pangalan ng direktoryo o pagsupil sa mga sumusunod na puwang). Nilayon na gamitin sa mga function ng shell.
nospace
Sabihin sa readline na huwag ilakip ang espasyo (ang default) sa mga salita na nakumpleto sa dulo ng linya.
-A aksyon
Ang pagkilos ay maaaring isa sa mga sumusunod upang bumuo ng isang listahan ng mga posibleng pagkumpleto:
alias
Mga pangalan ng alias. Maaari ring tinukoy bilang -a .
arrayvar
Mga variable na pangalan ng array.
umiiral
Readline key binding names.
builtin
Pangalan ng shell builtin command . Maaari ring tinukoy bilang -b .
utos
Mga pangalan ng command. Maaari ring tinukoy bilang mga pangalan. Maaari ring tinukoy bilang -c .
direktoryo
Mga pangalan ng direktoryo . Maaari ring tinukoy bilang -d .
hindi pinagana
Mga pangalan ng builtins shell na nabuo.
pinagana
Mga pangalan ng mga naka-enable na shell builtins.
i-export
Mga pangalan ng mga nai-export na mga variable ng shell. Maaari ring tinukoy bilang -e .
file
Mga pangalan ng file. Maaari ring tinukoy bilang -f .
function
Mga pangalan ng mga function ng shell .
grupo
Mga pangalan ng grupo. Maaari ring tinukoy bilang -g .
helptopic
Tulungan ang mga paksa tulad ng tinatanggap ng builtin ng tulong .
Ang mga hostname, gaya ng kinuha mula sa file na tinukoy ng HOSTFILE shell variable.
trabaho
Mga pangalan ng trabaho, kung ang kontrol ng trabaho ay aktibo. Maaari ring tinukoy bilang -j .
keyword
Nakareserba ang mga salita. Maaari ring tinukoy bilang -k .
tumatakbo
Mga pangalan ng pagpapatakbo ng trabaho, kung ang kontrol ng trabaho ay aktibo.
serbisyo
Mga pangalan ng serbisyo. Maaari ring tinukoy bilang -s .
setopt
Ang mga wastong argumento para sa -o opsyon sa set builtin.
mamili
Mga opsyon ng Shell na tinatanggap bilang tinanggap ng built-in na shop.
signal
Mga pangalan ng signal.
tumigil
Ang mga pangalan ng huminto sa mga trabaho, kung ang kontrol ng trabaho ay aktibo.
user
Mga pangalan ng user. Maaari ring tinukoy bilang -u .
variable
Mga pangalan ng lahat ng mga variable ng shell. Maaari ring tinukoy bilang -v .
-G globpat
Ang pagpapalawak ng filename na globpat ay pinalawak upang makabuo ng mga posibleng pagkumpleto.
-W wordlist
Ang wordlist ay nahati gamit ang mga character sa espesyal na variable ng IFS bilang mga delimiter, at ang bawat resultant na salita ay pinalawak. Ang mga posibleng pagkumpleto ay ang mga miyembro ng nagresultang listahan na tumutugma sa salita na nakumpleto.
-C command
Ang utos ay isinasagawa sa isang subshell na kapaligiran, at ang output nito ay ginagamit bilang posibleng pagkumpleto.
-F function
Ang function ng pag- andar ng shell ay isinagawa sa kasalukuyang kapaligiran ng shell. Kapag natapos na ito, ang mga posibleng pagkumpleto ay nakuha mula sa halaga ng variable ng COMPREPLY array.
-X filter
Ang filterpat ay isang pattern na ginamit para sa pagpapalawak ng filename. Ito ay inilalapat sa listahan ng mga posibleng pagkumpleto na binuo ng naunang mga pagpipilian at mga argumento, at ang bawat pagtutugma na filter na filter ay tinanggal mula sa listahan. Isang nangungunang ! sa filterpat negates ang pattern; sa kasong ito, ang anumang pagkumpleto na hindi tumutugma sa filterpat ay aalisin.
-P prefix
prefix ay idinagdag sa simula ng bawat posibleng pagkumpleto pagkatapos ng lahat ng iba pang mga pagpipilian na na-apply.
-S suffix
Ang suffix ay nakadugtong sa bawat posibleng pagkumpleto pagkatapos na magamit ang lahat ng iba pang mga pagpipilian.
Ang halaga ng return ay totoo maliban kung ang isang di-wastong opsyon ay ibinibigay, ang isang pagpipilian bukod sa -p o -r ay ibinigay nang walang argumento ng pangalan , isang pagtatangka ang ginawa upang alisin ang detalye ng pagkumpleto para sa isang pangalan kung saan walang umiiral na detalye, o nangyayari ang error pagdaragdag ng detalye ng pagkumpleto.
magpatuloy [ n ]
Ipagpatuloy ang susunod na pag-ulit ng kalakip para sa , habang , hanggang , o piliin ang loop. Kung ang n ay tinukoy, ipagpatuloy ang loop na nakapaloob sa n . n ay dapat> 1. Kung ang n ay mas malaki kaysa sa bilang ng mga nakapaloob na mga loop, ang huling nakapaloob na loop (ang "top-level" loop) ay ipagpatuloy. Ang halaga ng pagbalik ay 0 maliban kung ang shell ay hindi nagsasagawa ng isang loop kapag patuloy na naisakatuparan.
ipahayag ang [ -afFirtx ] [ -p ] [ pangalan [= value ]]
typeset [ -afFirtx ] [ -p ] [ pangalan [= value ]]
Ipahayag ang mga variable at / o bigyan sila ng mga katangian. Kung walang ibinigay na pangalan pagkatapos ipakita ang mga halaga ng mga variable. Ang pagpipiliang -p ay magpapakita ng mga katangian at halaga ng bawat pangalan . Kapag -p ay ginagamit, ang mga karagdagang pagpipilian ay binabalewala. Ang pagpipiliang -F ay nagpipigil sa pagpapakita ng mga kahulugan sa pag-andar; lamang ang pangalan at katangian ng pag-andar ay nakalimbag. Ang -F na opsiyon ay nagpapahiwatig -f . Ang mga sumusunod na opsyon ay maaaring gamitin upang paghigpitan ang output sa mga variable na may tinukoy na katangian o upang magbigay ng mga katangian ng variable:
-a
Ang bawat pangalan ay isang array variable (tingnan ang Mga Arrays sa itaas).
-f
Gumamit lamang ng mga pangalan ng function.
-i
Ang variable ay ginagamot bilang isang integer; Ang pagsusuri ng aritmetika (tingnan ang ARITHMETIC EVALUATION) ay ginaganap kapag ang variable ay nakatalaga ng halaga.
-r
Gumawa lamang ng pangalan ng pangalan . Ang mga pangalan na ito ay hindi maaring italaga ng mga halaga sa pamamagitan ng mga kasunod na pahayag ng pagtatalaga o hindi nakalagay.
-t
Bigyan ang bawat pangalan ng trace attribute. Sinusubaybayan ng mga function magmana ang bitag DEBUG mula sa shell ng pagtawag. Ang trace attribute ay walang espesyal na kahulugan para sa mga variable.
-x
Markahan ang pangalan para sa pag-export sa kasunod na mga utos sa pamamagitan ng kapaligiran.
Ang paggamit ng `+ 'sa halip na` -' ay patayin ang katangian sa halip, maliban na ang isang + ay hindi maaaring gamitin upang sirain ang isang array variable. Kapag ginamit sa isang function, gumagawa ng bawat pangalan ng lokal, tulad ng sa lokal na utos. Ang halaga ng pagbalik ay 0 maliban kung ang isang di-wastong opsyon ay nakatagpo, isang pagtatangka ay ginawa upang tukuyin ang isang function gamit ang `` -f foo = bar '', isang pagtatangka ay ginawa upang magtalaga ng isang halaga sa isang read-only variable, isang pagtatangka ay ginawa upang magtalaga ng isang halaga sa isang variable ng array nang hindi ginagamit ang syntax ng compound na assignment (tingnan ang Mga Array sa itaas), isa sa mga pangalan ay hindi isang wastong pangalan ng variable na shell, isang pagtatangka ang ginawa upang i-off ang read-only na katayuan para sa isang read-only na variable, isang pagtatangka ay ginawa upang i-off ang katayuan ng array para sa isang array variable, o isang pagtatangka ay ginawa upang ipakita ang isang hindi umiiral na function na may -f .
dirs [-clpv ] [+ n ] [- n ]
Walang mga pagpipilian, ipinapakita ang listahan ng kasalukuyang naaalala na mga direktoryo. Ang default na display ay nasa isang linya na may mga pangalan ng direktoryo na pinaghihiwalay ng mga puwang. Ang mga direktoryo ay idinagdag sa listahan kasama ang pushd command; ang popd command ay nag-aalis ng mga entry mula sa listahan.
+ n
Nagpapakita ng pagbibilang ng n entry mula sa kaliwa ng listahan na ipinakita ng dirs kapag sinasabing walang mga pagpipilian, na nagsisimula sa zero.
- n
Nagpapakita ng pagbibilang ng n entry mula sa kanan ng listahan na ipinakita ng dirs kapag sinasabing walang mga pagpipilian, na nagsisimula sa zero.
-c
Nililimas ang direktoryo ng stack sa pamamagitan ng pagtanggal sa lahat ng mga entry.
-l
Gumagawa ng mas mahabang listahan; ang format ng default na listahan ay gumagamit ng isang tilde upang tukuyin ang home directory.
-p
I-print ang direktoryo ng stack na may isang entry sa bawat linya.
-v
I-print ang direktoryo ng stack na may isang entry sa bawat linya, prefix ng bawat entry sa index nito sa stack.
Ang halaga ng return ay 0 maliban kung ang isang di-wastong opsyon ay ibinibigay o n index na lampas sa dulo ng direktoryo stack.
itakwil [ -ar ] [ -h ] [ jobspec ...]
Walang mga pagpipilian, ang bawat jobspec ay tinanggal mula sa talahanayan ng mga aktibong trabaho. Kung ang pagpipilian na -h ay ibinigay, ang bawat jobspec ay hindi tinanggal mula sa talahanayan, ngunit minarkahan upang ang SIGHUP ay hindi ipapadala sa trabaho kung ang shell ay tumatanggap ng SIGHUP . Kung walang jobspec ang naroroon, at hindi rin ang -a o ang pagpipilian na -r ay ibinibigay, ang kasalukuyang trabaho ay ginagamit. Kung walang jobspec ang ibinigay, ang ibig sabihin ng isang -isang pagpipilian upang alisin o markahan ang lahat ng mga trabaho; ang pagpipiliang -r na walang isang jobspec na argumento ay nagbabawal sa pagpapatakbo sa pagpapatakbo ng mga trabaho. Ang halaga ng pagbalik ay 0 maliban kung ang isang jobspec ay hindi tumutukoy sa wastong trabaho.
echo [ -neE ] [ arg ...]
I-output ang arg s, na pinaghihiwalay ng mga puwang, na sinusundan ng isang bagong linya. Ang katayuan ng pagbabalik ay laging 0. Kung tinukoy ang -n , pinipigilan ang sumusunod na bagong linya. Kung ang pagpipilian na -e ay ibinigay, ang interpretasyon ng sumusunod na mga backslash-escaped na mga character ay pinagana. Pinipigilan ng pagpipilian ng -E ang pagpapakahulugan ng mga character na makatakas, kahit na sa mga system kung saan ang mga ito ay binigyang-kahulugan bilang default. Ang opsyon na xpg_echo shell ay maaaring gamitin upang magaling na matukoy kung o hindi echo ang nagpapalawak ng mga character na makatakas sa pamamagitan ng default. echo ay hindi nagpapakahulugan - upang sabihin ang dulo ng mga pagpipilian. echo kahulugan ng mga sumusunod na mga pagkakasunod-sunod ng escape:
\ a
alerto (kampanilya)
\ b
backspace
\ c
sugpuin ang trailing newline
\ e
isang escape character
\ f
form feed
\ n
bagong linya
\ r
bumalik ang karwahe
\ t
pahalang na tab
\ v
vertical na tab
\\
backslash
\ 0 nnn
ang walong-bit na character na ang halaga ay ang halaga ng octal nnn (zero sa tatlong octal digit)
\ nnn
ang walong-bit na character na ang halaga ay ang halaga ng octal nnn (isa o tatlong octal digit)
\ x HH
ang walong-bit na character na ang halaga ay ang hexadecimal value HH (isa o dalawang hex digit)
paganahin ang [ -adnps ] [ -f filename ] [ pangalan ...]
Paganahin at huwag paganahin ang mga builtin shell command. Ang hindi pagpapagana ng isang builtin ay nagbibigay-daan sa isang command na disk na may parehong pangalan bilang isang shell builtin upang maisagawa nang hindi tumutukoy sa isang buong pathname, kahit na ang shell ay normal na paghahanap para sa mga builtins bago ang mga utos ng disk. Kung -n ginagamit, ang bawat pangalan ay hindi pinagana; kung hindi, pinagana ang mga pangalan . Halimbawa, gamitin ang test binary na natagpuan sa pamamagitan ng PATH sa halip na ang shell builtin na bersyon, patakbuhin ang `` enable -n test ''. Ang ibig sabihin ng -f ay ang pag -load ng bagong builtin command name mula sa shared object filename , sa mga system na sumusuporta sa dynamic loading. Ang -d na opsiyon ay magtatanggal ng builtin na dati-load na -f . Kung walang mga argumento ng pangalan ay ibinibigay, o kung ang pagpipilian na -p ay ibinibigay, isang listahan ng mga builtin ng shell ay nakalimbag. Nang walang iba pang mga argumento ng pagpipilian, ang listahan ay binubuo ng lahat ng mga naka-enable na builtins shell. Kung ibinigay ang -n , naka-imprenta lamang ang mga builtin na pinagana. Kung -isang ay ibinigay, ang listahan ng mga nakalimbag kasama ang lahat ng builtins, na may isang indikasyon ng kung o hindi ang bawat ay pinagana. Kung tinustusan ang, ang output ay pinaghihigpitan sa POSIX special builtins.
Ang halaga ng pagbalik ay 0 maliban kung ang isang pangalan ay hindi isang shell builtin o may isang error na naglo-load ng isang bagong builtin mula sa isang ibinahaging bagay.
eval [ arg ...]
Ang arg s ay binabasa at isinama nang magkakasama sa iisang utos. Pagkatapos ay basahin at isagawa ang command na ito ng shell, at ang katayuan ng exit nito ay ibinalik bilang halaga ng eval . Kung walang args , o lamang null argumento, eval ay nagbabalik ng 0.
exec [ -cl ] [ -a name ] [ command [ arguments ]]
Kung tinukoy ang utos , pinapalitan nito ang shell. Walang bagong proseso ang nalikha. Ang argumento ay ang mga argumento na utos . Kung ang pagpipilian na -l ay ibinibigay, ang shell ay naglalagay ng isang dash sa simula ng zeroth arg passed sa command . Ito ang ginagawa ng login (1). Ang -c na opsiyon ay nagiging sanhi ng command na maisagawa sa isang walang laman na kapaligiran. Kung -a ay ibinibigay, ang shell ay pumasa sa pangalan bilang ang argumento ng zeroth sa ipinapatupad na utos. Kung ang utos ay hindi maisagawa para sa ilang kadahilanan, isang di-interactive na mga labasan ng shell, maliban kung ang shell option ay pinapagana, kung saan ang kaso ay nagbabalik ng kabiguan. Ang isang interactive na shell ay nagbabalik ng kabiguan kung ang file ay hindi maisagawa. Kung ang utos ay hindi tinukoy, ang anumang mga redirections ay magkakabisa sa kasalukuyang shell, at ang return status ay 0. Kung may error sa redirection, ang return status ay 1.
exit [ n ]
Maging sanhi ng shell upang lumabas sa isang katayuan ng n . Kung n ay tinanggal, ang kalagayan sa exit ay ang huling ipinapatupad na command. Ang bitag sa EXIT ay papatayin bago matapos ang shell.
i-export ang [ -fn ] [ pangalan [= salita ]] ...
export -p
Ang mga ibinigay na mga pangalan ay minarkahan para sa awtomatikong pag-export sa kapaligiran ng kasunod na naisakatuparan na mga utos. Kung ang pagpipilian na -f ay ibinigay, ang mga pangalan ay tumutukoy sa mga function. Kung walang ibinigay na mga pangalan , o kung ang pagpipilian na -p ay ibinibigay, isang listahan ng lahat ng mga pangalan na nai-export sa shell na ito ay nakalimbag. Ang -n na pagpipilian ay nagiging sanhi ng pag-export ng ari-arian upang maalis mula sa mga nagngangalang variable. ang pag-export ay nagbabalik ng isang exit status ng 0 maliban kung ang isang di-wastong opsyon ay nakatagpo, ang isa sa mga pangalan ay hindi isang wastong pangalan ng variable ng shell, o -f ay ibinibigay sa isang pangalan na hindi isang function.
fc [ -e ename ] [ -nlr ] [ unang ] [ huling ]
fc -s [ pat = rep ] [ cmd ]
Ayusin ang Command. Sa unang form, ang isang hanay ng mga utos mula sa una hanggang sa huling ay pinili mula sa listahan ng kasaysayan. Una at huling maaaring itukoy bilang isang string (upang hanapin ang huling utos simula sa string na iyon) o bilang isang numero (isang index sa listahan ng kasaysayan, kung saan ang isang negatibong bilang ay ginagamit bilang isang offset mula sa kasalukuyang command number). Kung huling hindi tinukoy ito ay naka-set sa kasalukuyang command para sa listahan (upang ang `` fc -l -10 '' ay naka-print sa huling 10 utos) at sa una kung hindi man. Kung una ay hindi tinukoy ito ay naka-set sa nakaraang command para sa pag-edit at -16 para sa listahan.
Ang -n pagpipilian suppresses ang mga numero ng utos kapag listahan. Binabago ng pagpipilian -r ang pagkakasunud-sunod ng mga utos. Kung ang pagpipilian na -l ay ibinigay, ang mga command ay nakalista sa karaniwang output. Kung hindi, ang editor na ibinigay ng ename ay sinasabing sa isang file na naglalaman ng mga utos na iyon. Kung hindi ibinigay ang ename , ang halaga ng FCEDIT variable ay ginagamit, at ang halaga ng EDITOR kung FCEDIT ay hindi nakatakda. Kung hindi nakatakda ang variable, gagamitin. Kapag kumpleto na ang pag-edit, ang mga na-edit na command ay echoed at pinaandar.
Sa ikalawang form, ang utos ay muling ipatupad matapos ang bawat pagkakataon ng pat ay papalitan ng rep . Ang isang kapaki-pakinabang na alyas na gagamitin dito ay `` r = fc -s '', kaya ang pag-type ng `` r cc '' ay nagpapatakbo sa huling utos na nagsisimula sa `` cc '' at ang pag-type ng `` r ' utos.
Kung ang unang form ay ginagamit, ang halaga ng pagbalik ay 0 maliban kung ang isang hindi wastong pagpipilian ay nakatagpo o una o huling tumutukoy sa mga linya ng kasaysayan sa labas ng saklaw. Kung ang pagpipilian na -e ay ibinibigay, ang halaga ng pagbalik ay ang halaga ng huling utos na isinagawa o kabiguan kung ang isang error ay nangyayari sa pansamantalang file ng mga utos. Kung ginamit ang ikalawang form, ang katayuan ng pagbabalik ay ang muling pagpapatupad ng command, maliban kung ang cmd ay hindi tumutukoy sa wastong linya ng kasaysayan, kung saan ang fc ay nagbabalik ng kabiguan.
fg [ jobspec ]
Ipagpatuloy ang jobspec sa harap, at gawin itong kasalukuyang trabaho. Kung wala ang jobspec , ang kuru-kuro ng shell ng kasalukuyang trabaho ay ginagamit. Ang halaga ng pagbalik ay ang utos na inilagay sa harapan, o kabiguan kung tumakbo kapag ang kontrol ng trabaho ay hindi pinagana o, kapag tumakbo sa kontrol ng trabaho na pinagana, kung ang jobspec ay hindi tumutukoy sa wastong trabaho o jobspec ay tumutukoy sa isang trabaho na nagsimula nang walang kontrol sa trabaho .
getopts opt ng pangalan [ args ]
Ang mga getopts ay ginagamit ng mga pamamaraan ng shell upang mai-parse positional parameter. Ang pagpipili sa opts ay naglalaman ng mga character na opsyon upang makilala; kung ang isang character ay sinusundan ng isang colon, ang pagpipilian ay inaasahang magkaroon ng isang argument, na dapat na hiwalay mula sa ito sa pamamagitan ng puting espasyo. Ang mga colon at mga marka ng tandang pananong ay hindi maaaring gamitin bilang mga character na opsyon. Sa bawat oras na ito ay mahihingi, ang mga getopts ay naglalagay ng susunod na opsyon sa pangalan ng variable ng shell, nagsisimulang pangalan kung wala ito, at ang index ng susunod na argument ay naproseso sa variable na OPTIND . Ang OPTIND ay sinimulan sa 1 sa bawat oras na ang shell o isang script ng shell ay mahihingi. Kapag ang isang pagpipilian ay nangangailangan ng isang argument, getopts naglalagay ng argumento sa variable OPTARG . Ang shell ay hindi awtomatikong i-reset ang OPTIND ; dapat itong manu-manong i-reset sa pagitan ng maramihang mga tawag sa mga getopt sa loob ng parehong invocation shell kung ang isang bagong hanay ng mga parameter ay gagamitin.
Kapag ang dulo ng mga pagpipilian ay nakatagpo, ang mga getopts labasan na may halaga ng pagbalik na mas malaki kaysa sa zero. Ang OPTIND ay naka-set sa index ng unang argumento ng hindi pang-opsyon, at ang pangalan ay nakatakda sa?.
Ang mga getopts ay karaniwang nagsasabing ang mga posisyong parameter, ngunit kung higit pang mga argumento ang ibinibigay sa mga args , ang mga getopts ay pina-parse sa mga iyon.
Ang mga getopts ay maaaring mag-ulat ng mga error sa dalawang paraan. Kung ang unang character ng optstring ay isang colon, ang tahimik na pag- uulat ng error ay ginagamit. Sa normal na operasyon ng mga diagnostic na mensahe ay naka-print kapag ang mga di-wastong mga pagpipilian o nawawalang mga argumento ng pagpipilian ay nakatagpo. Kung ang variable na OPTERR ay nakatakda sa 0, walang mga mensaheng error ang ipapakita, kahit na ang unang character ng optstring ay hindi isang colon.
Kung nakita ang isang di-wastong pagpipilian, nakakakuha ng mga lugar? sa pangalan at, kung hindi tahimik, nag-print ng isang mensahe ng error at mga unseta OPTARG . Kung ang mga getopts ay tahimik, ang opsyon na character na natagpuan ay nakalagay sa OPTARG at walang naka-print na mensahe ng diagnostic.
Kung ang isang kinakailangang argumento ay hindi natagpuan, at ang getopts ay hindi tahimik, ang isang tandang pananong ( ? ) Ay inilagay sa pangalan , ang OPTARG ay hindi nakalagay , at ang isang diagnostic na mensahe ay nakalimbag. Kung ang mga getopts ay tahimik, pagkatapos ay ang colon (:) ay inilagay sa pangalan at ang OPTARG ay naka-set sa opsyon na character na natagpuan.
Ang mga getopt ay totoo kung ang isang pagpipilian, tinukoy o hindi tinukoy, ay natagpuan. Ito ay nagbabalik ng mali kapag natapos na ang dulo ng mga pagpipilian o nangyayari ang isang error.
hash [ -lr ] [ -p filename ] [ -dt ] [ pangalan ]
Para sa bawat pangalan , ang buong pangalan ng file ng command ay natutukoy sa pamamagitan ng paghahanap sa mga direktoryo sa $ PATH at remembered. Kung ang pagpipilian na -p ay ibinibigay, walang paghahanap sa landas ang gumanap, at ang filename ay ginagamit bilang buong pangalan ng file ng command. Ang -r na pagpipilian ay nagiging sanhi ng shell upang malimutan ang lahat ng mga remembered lokasyon. Ang -d na pagpipilian ay nagiging sanhi ng shell upang makalimutan ang remembered lokasyon ng bawat pangalan . Kung ang pagpipilian na -t ay ibinibigay, ang buong pathname kung saan naka-print ang bawat pangalan ay naka-print. Kung ang maraming mga argumento ng pangalan ay ibinigay sa -t , ang pangalan ay naka-print bago ang hashed full pathname. Ang -l na pagpipilian ay nagiging sanhi ng output na ipapakita sa isang format na maaaring magamit muli bilang input. Kung walang mga argumento ang ibinibigay, o kung ibigay lamang -l , ang impormasyong tungkol sa mga naalaang utos ay nakalimbag. Totoo ang katayuan ng pagbalik maliban kung ang isang pangalan ay hindi natagpuan o isang di-wastong pagpipilian ang ibinibigay.
tulungan ang [ -s ] [ pattern ]
Ipakita ang kapaki-pakinabang na impormasyon tungkol sa mga builtin command. Kung tinukoy ang pattern , ang tulong ay nagbibigay ng detalyadong tulong sa lahat ng pagtutugma ng mga pattern ng command; kung hindi ay makakatulong para sa lahat ng mga builtins at shell control istraktura ay naka-print. Ang pagpipiliang s -s ay nagbabawal sa impormasyong ipinapakita sa isang maikling synopsis ng paggamit. Ang katayuan ng return ay 0 maliban kung walang utos na tumutugma sa pattern .
kasaysayan [ n ]
kasaysayan -c
kasaysayan-d offset
kasaysayan -anrw [ filename ]
kasaysayan -p arg [ arg ... ]
kasaysayan -s arg [ arg ... ]
Walang mga pagpipilian, ipakita ang listahan ng kasaysayan ng command na may mga numero ng linya. Ang mga linya na nakalista sa isang * ay nabago. Ang argumento ng n ay naglilista lamang ng mga huling linya n . Kung ibinigay ang pangalan ng filename , ginagamit ito bilang pangalan ng file ng kasaysayan; kung hindi, ang halaga ng HISTFILE ay ginagamit. Ang mga pagpipilian, kung ibinigay, ay may mga sumusunod na kahulugan:
-c
I-clear ang listahan ng kasaysayan sa pamamagitan ng pagtanggal sa lahat ng mga entry.
-d ng offset
Tanggalin ang entry sa kasaysayan sa posisyon offset .
-a
Ilagay ang mga linya ng kasaysayan ng `` bagong '' (mga linya ng kasaysayan na naipasok mula noong simula ng kasalukuyang bash session) sa file ng kasaysayan.
-n
Basahin ang mga linya ng kasaysayan na hindi na nabasa mula sa file ng kasaysayan sa kasalukuyang listahan ng kasaysayan. Ang mga ito ay mga linya na nakadugtong sa file ng kasaysayan mula noong simula ng kasalukuyang bash session.
-r
Basahin ang mga nilalaman ng file ng kasaysayan at gamitin ang mga ito bilang kasalukuyang kasaysayan.
-w
Isulat ang kasalukuyang kasaysayan sa file ng kasaysayan, i-overwrite ang mga nilalaman ng file ng kasaysayan.
-p
Magsagawa ng pagpapalit ng kasaysayan sa mga sumusunod na arg at ipakita ang resulta sa karaniwang output. Hindi nag-iimbak ng mga resulta sa listahan ng kasaysayan. Ang bawat arg ay dapat na naka-quote upang huwag paganahin ang normal na pagpapalawak ng kasaysayan.
-s
Iimbak ang args sa listahan ng kasaysayan bilang isang solong entry. Ang huling utos sa listahan ng kasaysayan ay aalisin bago idagdag ang mga arg .
Ang halaga ng pagbalik ay 0 maliban kung ang isang di-wastong opsyon ay nakatagpo, ang isang error ay nangyayari habang nagbabasa o nagsusulat ng file ng kasaysayan, ang isang di-wastong offset ay ibinibigay bilang argumento sa -d , o ang pagpapalawak ng kasaysayan na ibinigay bilang argumento sa -p nabigo.
trabaho [ -lnprs ] [ jobspec ...]
trabaho -x utos [ args ...]
Inililista ng unang form ang mga aktibong trabaho. Ang mga pagpipilian ay may mga sumusunod na kahulugan:
-l
Ilista ang mga ID ng proseso bilang karagdagan sa normal na impormasyon.
-p
Ilista lamang ang ID ng proseso ng pinuno ng pangkat ng proseso ng trabaho.
-n
Ipakita lamang ang impormasyon tungkol sa mga trabaho na nagbago ng katayuan dahil ang huling user ay naabisuhan sa kanilang katayuan.
-r
Limitahan ang output sa pagpapatakbo ng mga trabaho.
-s
Limitahan ang output upang huminto sa mga trabaho.
Kung ang jobspec ay ibinigay, ang output ay limitado sa impormasyon tungkol sa trabaho na iyon. Ang katayuan ng return ay 0 maliban kung ang isang hindi wastong pagpipilian ay nakatagpo o isang hindi wastong jobspec ay ibinibigay.
Kung ang opsyon na -x ay ibinibigay, ang mga trabaho ay pumapalit sa anumang jobspec na natagpuan sa command o args na may katumbas na grupo ng ID ng proseso, at nagpapatupad ng command na nagpapasa ito args , na bumabalik sa katayuan ng exit nito.
pumatay [ -s sigspec | -n signum | - sigspec ] [ pid | jobspec ] ...
patayin -l [ sigspec | exit_status ]
Ipadala ang senyas na pinangalanang sigspec o signum sa mga proseso na pinangalan ng pid o jobspec . Ang sigspec ay alinman sa isang senyas na pangalan tulad ng SIGKILL o isang numero ng signal; Ang signum ay isang numero ng signal. Kung ang sigspec ay isang senyas na pangalan, ang pangalan ay maaaring ibigay kasama o wala ang prefix ng SIG . Kung wala ang sigspec , ipagpalagay na ang SIGTERM . Ang argumento ng -l ay naglilista ng mga pangalan ng signal. Kung ang anumang mga argumento ay ibinigay kapag -l ay ibinigay, ang mga pangalan ng mga signal na naaayon sa mga argumento ay nakalista, at ang katayuan ng return ay 0. Ang exit_status argument sa -l ay isang numero na tumutukoy sa alinman sa isang numero ng signal o exit status ng isang Ang proseso ay tinapos ng isang senyas. Patayin ang pagbalik ay totoo kung ang isang signal ay matagumpay na naipadala, o hindi totoo kung may naganap na error o hindi wastong opsyon ang nakatagpo.
hayaan arg [ arg ...]
Ang bawat arg ay isang ekspresyon ng aritmetika upang masuri (tingnan ang ARITHMETIC EVALUATION ). Kung ang huling arg ay sinusuri sa 0, ipaubaya ang 1; 0 ay ibinalik kung hindi.
lokal na [ opsyon ] [ pangalan [= value ] ...]
Para sa bawat argument, isang lokal na variable na pinangalanang pangalan ay nilikha, at itinalaga na halaga . Ang opsyon ay maaaring maging alinman sa mga pagpipilian na tinanggap sa pamamagitan ng ipinapahayag . Kapag ginagamit ang lokal sa loob ng isang function, nagiging sanhi ito ng variable na pangalan upang magkaroon ng isang nakikitang saklaw na pinaghihigpitan sa function na at mga anak nito. Na walang operands, lokal na nagsusulat ng isang listahan ng mga lokal na variable sa karaniwang output. Ito ay isang error na gumamit ng lokal kapag hindi sa isang function. Ang katayuan ng return ay 0 maliban kung ang lokal ay ginagamit sa labas ng isang function, ang isang di-wastong pangalan ay ibinibigay, o ang pangalan ay isang readonly variable.
logout
Lumabas sa isang shell ng pag-login.
popd [- n ] [+ n ] [- n ]
Tinatanggal ang mga entry mula sa direktoryo ng stack. Walang mga argumento, inaalis ang tuktok na direktoryo mula sa stack, at gumaganap ng isang cd sa bagong nangungunang direktoryo. Ang mga argumento, kung ibinigay, ay may mga sumusunod na kahulugan:
+ n
Tinatanggal ang entry na n th mula sa kaliwa ng listahan na ipinakita ng mga dirs , na nagsisimula sa zero. Halimbawa: `` popd +0 '' inaalis ang unang direktoryo, `` popd +1 '' ang pangalawang.
- n
Tinatanggal ang entry na n th mula sa kanan ng listahan na ipinakita ng dirs , simula sa zero. Halimbawa: `` popd -0 '' inaalis ang huling direktoryo, `` popd -1 '' sa susunod na huling.
-n
Sinusupil ang normal na pagbabago ng direktoryo kapag nag-aalis ng mga direktoryo mula sa stack, kaya na ang stack lamang ang ginagamit.
Kung ang popd command ay matagumpay, ang isang dirs ay gumanap din, at ang return status ay 0. popd ay bumalik false kung ang isang di-wastong opsyon ay nakatagpo, ang directory stack ay walang laman, isang tinukoy na direktoryo ng stack entry ay tinukoy, o ang direktoryo nabigo ang pagbabago.
printf format [ argumento ]
Isulat ang mga format na argumento sa karaniwang output sa ilalim ng kontrol ng format . Ang format ay isang character na string na naglalaman ng tatlong uri ng mga bagay: mga simpleng character, na kinopya lamang sa karaniwang output, pagkakasunod-sunod ng pagkakasunod ng character, na na-convert at kinopya sa karaniwang output, at mga pagtutukoy ng format, bawat isa ay nagiging sanhi ng pag-print ng susunod sunud-sunod na argumento . Bilang karagdagan sa karaniwang mga format ng printf (1), ang b ay nagdudulot ng printf upang mapalawak ang mga pagkakasunod-sunod ng backslash escape sa kaukulang argument , at % q ay nagdudulot ng printf upang output ang kaukulang argument sa isang format na maaaring magamit muli bilang shell input.
Ang format ay muling ginagamit kung kinakailangan upang ubusin ang lahat ng mga argumento . Kung ang format ay nangangailangan ng higit pang mga argumento kaysa ibinibigay, ang mga dagdag na detalye ng format ay kumikilos na parang zero value o null string, kung naaangkop, ay ibinigay. Ang halaga ng pagbalik ay zero sa tagumpay, di-zero sa kabiguan.
pushd [ -n ] [ dir ]
pushd [ -n ] [+ n ] [- n ]
Nagdaragdag ng direktoryo sa tuktok ng direktoryo ng stack, o umiikot sa stack, na ginagawang bagong tuktok ng stack sa kasalukuyang gumaganang direktoryo. Walang mga argumento, palitan ang dalawang nangungunang mga direktoryo at babalik 0, maliban kung ang directory stack ay walang laman. Ang mga argumento, kung ibinigay, ay may mga sumusunod na kahulugan:
+ n
Ang rotates ang stack upang ang direktoryo ng n th (pagbibilang mula sa kaliwa ng listahan na ipinakita ng dirs , simula sa zero) ay nasa itaas.
- n
Ini-rotate ang stack upang ang direktoryo ng n th (pagbibilang mula sa kanan ng listahan na ipinakita ng dirs , simula sa zero) ay nasa itaas.
-n
Pinipigilan ang normal na pagbabago ng direktoryo kapag nagdadagdag ng mga direktoryo sa stack, upang tanging ang stack ay manipulahin.
dir
Nagdaragdag ng dir sa direktoryo ng stack sa itaas, ginagawa itong bagong kasalukuyang gumaganang direktoryo.
Kung ang command na pushd ay matagumpay, ang isang dirs ay ginaganap rin. Kung ang unang form ay ginagamit, pushd nagbabalik 0 maliban kung ang cd sa dir nabigo. Sa pangalawang form, ang pushd ay nagbabalik ng 0 maliban kung ang directory stack ay walang laman, isang di-umiiral na elementong stack ng direktoryo ay tinukoy, o ang pagbabago ng direktoryo sa nabigong bagong kasalukuyang direktoryo ay nabigo.
pwd [ -LP ]
I-print ang absolute pathname ng kasalukuyang direktoryo ng nagtatrabaho. Ang naka-print na pathname ay hindi naglalaman ng mga symbolic link kung ang opsiyon -P ay ibinibigay o ang -o pisikal na opsyon sa naka- set na builtin command ay pinagana. Kung ang pagpipilian na -L ay ginagamit, ang naka-print na pathname ay maaaring maglaman ng mga symbolic na link. Ang katayuan ng pagbabalik ay 0 maliban kung ang isang error ay nangyayari habang binabasa ang pangalan ng kasalukuyang direktoryo o isang hindi wastong pagpipilian ay ibinibigay.
basahin ang [ -ers ] [ -u fd ] [ -t timeout ] [ -a aname ] [ -p prompt ] [ -n nchars ] [ -d delim ] [ pangalan ...]
Ang isang linya ay binabasa mula sa karaniwang input, o mula sa file descriptor fd na ibinigay bilang isang argumento sa pagpipilian na -u , at ang unang salita ay itinalaga sa unang pangalan , ang pangalawang salita sa pangalawang pangalan , at iba pa, na may natitirang mga salita at ang kanilang mga intervening separators na nakatalaga sa huling pangalan . Kung may mas kaunting mga salitang binabasa mula sa input stream kaysa sa mga pangalan, ang mga natitirang pangalan ay nakatalaga ng walang laman na mga halaga. Ang mga character sa IFS ay ginagamit upang hatiin ang linya sa mga salita. Ang backslash character ( \ ) ay maaaring gamitin upang alisin ang anumang espesyal na kahulugan para sa susunod na character na basahin at para sa pagpapatuloy ng linya. Ang mga pagpipilian, kung ibinigay, ay may mga sumusunod na kahulugan:
-isang aname
Ang mga salita ay nakatalaga sa mga sunud-sunod na mga indeks ng array variable na aname , simula sa 0. aname ay hindi naitakda bago ang anumang mga bagong halaga ay itinalaga. Ang ibang argumento ng pangalan ay hindi pinansin.
-d delim
Ang unang karakter ng delim ay ginagamit upang tapusin ang input line, sa halip na newline.
-e
Kung ang karaniwang input ay nagmumula sa isang terminal, ang readline (tingnan ang READLINE sa itaas) ay ginagamit upang makuha ang linya.
-n nchars
basahin ang pagbalik pagkatapos ng pagbabasa ng mga character nchars sa halip na maghintay para sa isang kumpletong linya ng input.
-p prompt
Ipakita ang prompt sa karaniwang error, nang walang isang trailing newline, bago tangkaing basahin ang anumang input. Ang prompt ay ipinapakita lamang kung ang input ay nagmumula sa isang terminal.
-r
Ang Backslash ay hindi kumikilos bilang isang character na makatakas. Ang backslash ay itinuturing na bahagi ng linya. Sa partikular, ang isang backslash-newline pair ay hindi maaaring gamitin bilang isang pagpapatuloy ng linya.
-s
Tahimik na mode. Kung ang input ay nagmumula sa isang terminal, ang mga character ay hindi echoed.
-t timeout
Maging sanhi ng pagbabasa sa oras at pagbalik ng kabiguan kung ang isang kumpletong linya ng input ay hindi mabasa sa loob ng mga segundo sa oras ng segundo. Ang opsyon na ito ay walang epekto kung ang pagbabasa ay hindi nagbabasa ng input mula sa terminal o ng isang pipe.
-u fdFP
Basahin ang input mula sa file descriptor fd .
Kung walang ibinigay na mga pangalan , ang line read ay itinalaga sa variable na REPLY . Ang return code ay zero, maliban kung ang end-of-file ay nakatagpo, nagbabasa ng beses, o isang di-wastong tagapaglarawan ng file ay ibinibigay bilang argumento sa -u .
readonly [ -apf ] [ pangalan ...]
Ang mga ibinigay na pangalan ay minarkahan ng readonly; ang mga halaga ng mga pangalan na ito ay maaaring hindi mabago sa pamamagitan ng kasunod na pagtatalaga. Kung ang ibinigay na -f ay ibinibigay, ang mga pag-andar na naaayon sa mga pangalan ay minarkahan. Ang -isang opsyon ay naghihigpit sa mga variable sa arrays. Kung walang ibinigay na argumento ng pangalan , o kung ang pagpipilian na -p ay ibinibigay, isang listahan ng lahat ng mga readonly na pangalan ay nakalimbag. Ang pagpipilian sa -p ay nagiging sanhi ng output na ipapakita sa isang format na maaaring magamit muli bilang input. Ang katayuan ng return ay 0 maliban kung ang isang hindi wastong opsyon ay nakatagpo, ang isa sa mga pangalan ay hindi isang wastong pangalan ng variable ng shell, o -f ay ibinibigay sa isang pangalan na hindi isang function.
bumalik [ n ]
Nagiging sanhi ng isang function upang lumabas sa return value na tinukoy ng n . Kung n ay tinanggal, ang katayuan ng pagbabalik ay ang huling utos na isinagawa sa katawan ng pag-andar. Kung gagamitin sa labas ng isang function, ngunit sa panahon ng pagpapatupad ng isang script ng . ( pinagmulan ) na utos, ito ay nagiging sanhi ng shell na huminto sa pagpapatupad ng script na iyon at babalik ang alinman sa n o ang exit status ng huling command na isinagawa sa loob ng script bilang exit status ng script. Kung ginamit sa labas ng isang function at hindi sa panahon ng pagpapatupad ng isang script sa pamamagitan ng . , ang katayuan ng return ay hindi totoo.
itakda ang [ --abefhkmnptuvxBCHP ] [ -o opsyon ] [ arg ...]
Walang mga pagpipilian, ang pangalan at halaga ng bawat variable ng shell ay ipinapakita sa isang format na maaaring magamit muli bilang input. Ang output ay pinagsunod-sunod ayon sa kasalukuyang locale. Kapag tinukoy ang mga pagpipilian, itinakda o nilalagyan nila ang mga katangian ng shell. Ang anumang mga argumento na natitira pagkatapos maproseso ang mga pagpipilian ay itinuturing bilang mga halaga para sa positional parameter at itinalaga, sa pagkakasunud-sunod, sa $ 1 , $ 2 , ... $ n . Ang mga pagpipilian, kung tinukoy, ay may mga sumusunod na kahulugan:
-a
Awtomatikong markahan ang mga variable at pag-andar na binago o nilikha para i-export sa kapaligiran ng kasunod na mga utos.
-b
Iulat ang kalagayan ng tinapos na mga trabaho sa background agad, sa halip na bago ang susunod na pangunahing prompt. Ito ay epektibo lamang kapag pinagana ang control ng trabaho.
-e
Lumabas kaagad kung ang isang simpleng utos (tingnan ang SHELL GRAMMAR sa itaas) lumabas sa isang hindi-zero na kalagayan. Ang shell ay hindi lumabas kung ang command na nabigo ay bahagi ng isang hanggang o habang loop, bahagi ng isang kung pahayag, bahagi ng isang && o || listahan, o kung ang halaga ng return ng utos ay inverted sa pamamagitan ng ! . Ang bitag sa ERR , kung itinakda, ay papatayin bago lumabas ang shell.
-f
Huwag paganahin ang expansion ng pathname.
-h
Tandaan ang lokasyon ng mga utos habang tinitingnan sila para sa pagpapatupad. Ito ay pinagana sa pamamagitan ng default.
-k
Ang lahat ng mga argumento sa anyo ng mga pahayag ng pagtatalaga ay inilalagay sa kapaligiran para sa isang utos, hindi lamang ang mga nauuna sa pangalan ng utos.
-m
Monitor mode. Pinagana ang control ng trabaho. Ang opsyon na ito ay sa pamamagitan ng default para sa mga interactive na shell sa mga system na sumusuporta dito (tingnan ang KONTROL SA PAGGAMIT sa itaas). Ang mga proseso sa background ay tumatakbo sa isang hiwalay na pangkat ng proseso at isang linya na naglalaman ng kanilang exit status ay naka-print sa kanilang pagkumpleto.
-n
Basahin ang mga utos ngunit huwag isagawa ang mga ito. Maaaring gamitin ito upang suriin ang isang shell script para sa mga error sa syntax. Ito ay hindi pinansin ng mga interactive shell.
-o opsyon-pangalan
Ang opsyon-pangalan ay maaaring isa sa mga sumusunod:
allexport
Same as- a .
braceexpand
Pareho ng -B .
emacs
Gumamit ng isang emacs-style na command line editing interface. Ito ay pinagana sa pamamagitan ng default kapag ang shell ay interactive, maliban kung ang shell ay nagsimula sa - walang opsyon sa pag-edit .
errexit
Same as -e .
hashall
Kapareho ng -h .
histexpand
Pareho ng -H .
kasaysayan
Paganahin ang kasaysayan ng command, tulad ng inilarawan sa itaas sa ilalim ng KASAYSAYAN . Ang opsyon na ito ay sa pamamagitan ng default sa interactive shell.
huwag pansinin
Ang epekto ay parang ang command shell na `` IGNOREEOF = 10 '' ay naisakatuparan (tingnan ang Mga Variable Shell sa itaas).
keyword
Kapareho ng -k .
monitor
Kapareho ng -m .
noclobber
Kapareho ng -C .
noexec
Kapareho ng -n .
noglob
Pareho ng -f . nolog Sa kasalukuyan binabalewala.
abisuhan
Parehong bilang -b .
nounset
Same as -u .
onecmd
Same as -t .
pisikal
Kapareho ng -P .
posix
Baguhin ang pag-uugali ng Bash kung saan ang default na operasyon ay naiiba sa pamantayan ng POSIX 1003.2 upang tumugma sa standard ( posix mode ).
pribilehiyo
Pareho ng -p .
masalita
Pareho ng -v .
vi
Gumamit ng interface ng pag-edit ng linya ng vi-style na command.
xtrace
Kapareho ng -x .
Kung -o ay ibinigay na walang pagpipilian-pangalan , ang mga halaga ng kasalukuyang mga pagpipilian ay naka-print. Kung ang + o ay ibinigay na walang pagpipilian-pangalan , ang isang serye ng mga set command upang muling likhain ang mga kasalukuyang setting ng opsyon ay ipinapakita sa karaniwang output.
-p
I-on ang privileged mode. Sa mode na ito, ang mga $ ENV at $ BASH_ENV na mga file ay hindi naproseso, ang mga function ng shell ay hindi minana mula sa kapaligiran, at ang SHELLOPTS variable, kung ito ay lumilitaw sa kapaligiran, ay hindi pinansin. Kung ang shell ay nagsimula sa epektibong user (grupo) id hindi katumbas ng tunay na user (grupo) id, at ang pagpipilian na -p ay hindi ibinibigay, ang mga aksyon na ito ay kinuha at ang epektibong user id ay naka-set sa real user id. Kung ang pagpipilian na -p ay ibinibigay sa startup, ang hindi epektibong pag-reset ng user id. Ang pag-off sa pagpipiliang ito ay nagiging sanhi ng epektibong user at group id upang itakda sa tunay na user at group id.
-t
Lumabas pagkatapos basahin at isagawa ang isang utos.
-u
Tratuhin ang mga variable ng unset bilang isang error kapag gumaganap ng pagpapalawak ng parameter. Kung ang paglawak ay sinubukan sa isang variable na hindi nakatakda, ang kopya ay nagpapalabas ng isang mensahe ng error, at, kung hindi interactive, lumabas sa isang hindi-zero na kalagayan.
-v
I-print ang mga linya ng input ng shell habang binabasa ang mga ito.
-x
Matapos palawakin ang bawat simpleng utos , ipakita ang pinalawak na halaga ng PS4 , na sinusundan ng command at ang pinalawak na mga argumento nito.
-B
Ang shell ay nagsasagawa ng pagpapalawak (tingnan ang Pagpapalawak ng Brace sa itaas). Ito ay sa pamamagitan ng default.
-C
Kung naka-set, ang bash ay hindi pa-overwrite ang isang umiiral nang file gamit ang operator ng pag-redirect > , > & , at > . Maaaring i-override ito kapag lumilikha ng mga file ng output sa pamamagitan ng paggamit ng redirection operator > | sa halip ng > .
-H
Paganahin ! estilo ng pagpapalit ng estilo. Ang opsyon na ito ay sa pamamagitan ng default kapag ang shell ay interactive.
-P
Kung nakatakda, ang shell ay hindi sumusunod sa mga simbolikong link kapag nagsasagawa ng mga utos tulad ng cd na nagbabago sa kasalukuyang nagtatrabaho na direktoryo. Ginagamit nito ang istraktura ng pisikal na direktoryo sa halip. Bilang default, ang bash ay sumusunod sa lohikal na kadena ng mga direktoryo kapag gumagawa ng mga utos na nagbabago sa kasalukuyang direktoryo.
-
Kung walang mga argumento ang sumusunod sa opsyon na ito, ang positional parameter ay hindi maitatakda. Kung hindi man, ang posisyonal na mga parameter ay nakatakda sa arg s, kahit na ang ilan sa mga ito ay nagsisimula sa isang - .
-
Signal sa dulo ng mga opsyon, maging sanhi ng lahat ng natitirang arg s na itatalaga sa positional parameter. Ang -x at -v na mga pagpipilian ay naka-off. Kung walang args, ang positional parameter ay mananatiling hindi nagbabago.
Ang mga pagpipilian ay off sa pamamagitan ng default maliban kung nabanggit. Paggamit + sa halip na - nagiging sanhi ng mga pagpipiliang ito na naka-off. Ang mga pagpipilian ay maaari ding tinukoy bilang argumento sa isang invocation ng shell. Ang kasalukuyang hanay ng mga pagpipilian ay maaaring matagpuan sa $ - . Ang katayuan ng pagbabalik ay laging totoo maliban kung ang isang di-wastong pagpipilian ay nakatagpo.
shift [ n ]
Ang positional parameter mula sa n +1 ... ay pinalitan ng pangalan sa $ 1 .... Mga Parameter na kinakatawan ng mga numero $ # hanggang sa $ # - n +1 ay hindi naitakda. n ay dapat na isang di-negatibong numero na mas mababa sa o katumbas ng $ # . Kung n ay 0, walang mga parameter na binago. Kung n ay hindi ibinigay, ito ay ipinapalagay na 1. Kung ang n ay mas malaki sa $ # , ang positional parameter ay hindi nabago. Ang katayuan ng pagbabalik ay mas malaki kaysa sa zero kung n ay mas malaki sa $ # o mas mababa sa zero; kung hindi man 0.
shopt [ -pqsu ] [ -o ] [ optname ...]
I-toggle ang mga halaga ng mga variable na kinokontrol ang opsyonal na pag-uugali ng shell. Na walang mga pagpipilian, o sa pagpipiliang -p , isang listahan ng lahat ng mga pagpipilian sa pag-aayos ay ipinapakita, na may pahiwatig kung ang bawat isa ay nakatakda. Ang pagpipilian sa -p ay nagiging sanhi ng output na ipapakita sa isang form na maaaring magamit muli bilang input. Ang iba pang mga pagpipilian ay may mga sumusunod na kahulugan:
-s
Paganahin (itakda) ang bawat optname .
-u
Huwag paganahin (i-unset) ang bawat optname .
-q
Suppresses normal na output (tahimik na mode); ang katayuan ng return ay nagpapahiwatig kung ang optname ay nakatakda o hindi naka-set. Kung ang maraming mga argumento sa pagpili ay binibigyan ng -q , ang katayuan ng return ay zero kung ang lahat ng mga optnames ay pinagana; non-zero kung hindi man.
-o
Pinipigilan ang mga halaga ng optname upang maging mga tinukoy para sa -o opsyon sa set builtin.
Kung alinman sa -s o -u ay ginagamit nang walang mga argumento ng optname , ang display ay limitado sa mga opsyon na itinakda o hindi naitakda, ayon sa pagkakabanggit. Maliban kung nabanggit, ang mga pagpipilian sa shopt ay hindi pinagana (hindi maitakda) sa pamamagitan ng default.
Ang katayuan ng pagbabalik kapag ang mga pagpipilian ng listahan ay zero kung ang lahat ng mga optnames ay pinagana, di-zero kung hindi man. Kapag nagse-set o hindi pinipili ang mga opsyon, ang return status ay zero maliban kung ang isang optname ay hindi isang wastong opsyon sa shell.
Ang listahan ng mga pagpipilian sa shopt ay:
cdable_vars
Kung nakatakda, ang isang argumento sa cd builtin command na hindi isang direktoryo ay ipinapalagay na ang pangalan ng isang variable na ang halaga ay ang direktoryo na baguhin.
cdspell
Kung nakatakda, ang mga menor de edad na mga error sa spelling ng isang bahagi ng direktoryo sa isang cd command ay itatama. Ang mga error na naka-check para sa mga transposed character, nawawalang character, at isang character na masyadong maraming. Kung ang isang pagwawasto ay natagpuan, ang naitama na pangalan ng file ay naka-print, at ang command na nalikom. Ang pagpipiliang ito ay ginagamit lamang ng mga interactive shell.
checkhash
Kung nakatakda, ang mga tseke ay may isang command na natagpuan sa hash table na umiiral bago sinusubukan na maisagawa ito. Kung wala nang command na hashed, isang normal na paghahanap sa landas ang gumanap.
checkwinsize
Kung naka-set, ang bash ay sumusuri sa laki ng window pagkatapos ng bawat command at, kung kinakailangan, ina-update ang mga halaga ng mga LINES at COLUMNS .
cmdhist
Kung nakatakda, ang mga pagtatangka upang i-save ang lahat ng mga linya ng isang maramihang-line na utos sa parehong entry sa kasaysayan. Pinapayagan nito ang madaling muling pag-edit ng mga command na multi-line.
dotglob
Kung nakatakda, ang bash ay may mga filename na nagsisimula sa isang `. ' sa mga resulta ng pagpapalawak ng pathname.
execfail
Kung nakatakda, ang isang di-interactive na shell ay hindi makakalabas kung hindi ito maaaring isagawa ang file na tinukoy bilang isang argument sa exec builtin command. Ang isang interactive na shell ay hindi lumabas kung nabigo ang pagpapatupad .
expand_aliases
Kung nakatakda, ang mga alyas ay pinalawak gaya ng inilarawan sa itaas sa ilalim ng ALIASES . Pinagana ang opsyon na ito bilang default para sa mga interactive na shell.
extglob
Kung nakatakda, ang pinalawig na mga tampok ng pagtutugma ng pattern na inilarawan sa itaas sa ilalim ng Pagpapalawak ng Pathname ay pinagana.
histappend
Kung nakatakda, ang listahan ng kasaysayan ay nakadugtong sa file na pinangalanan ng halaga ng variable na HISTFILE kapag lumabas ang shell, sa halip na i-overwrite ang file.
histreedit
Kung naka-set, at readline ang ginagamit, ang isang user ay binibigyan ng pagkakataon na muling i-edit ang isang nabigong kasaysayan ng pagpapalit.
histverify
Kung naka-set, at readline ang ginagamit, ang mga resulta ng pagpapalit ng kasaysayan ay hindi agad naipasa sa parser ng shell. Sa halip, ang resultang linya ay ikinarga sa readline na pag-edit ng buffer, na nagpapahintulot sa karagdagang pagbabago.
hostcomplete
Kung naka-set, at readline ay ginagamit, ang bash ay magtatangka upang maisagawa ang pagkumpleto ng hostname kapag ang isang salita na naglalaman ng isang @ ay nakumpleto (tingnan ang Pagkumpleto sa ilalim ng READLINE sa itaas). Ito ay pinagana sa pamamagitan ng default.
huponexit
Kung nakatakda, ipapadala ng bash si SIGHUP sa lahat ng mga trabaho kapag lumabas ang isang interactive na shell ng pag-login.
interactive_comments
Kung nakatakda, payagan ang isang salita na nagsisimula sa # upang maging sanhi ng salitang iyon at lahat ng natitirang mga character sa linya na iyon na hindi papansinin sa isang interactive na shell (tingnan ang MGA KOMENTARYO sa itaas). Pinagana ang opsyon na ito bilang default.
lithist
Kung nakatakda, at ang opsiyon ng cmdhist ay pinagana, ang mga command ng multi-line ay naka-save sa kasaysayan na may naka-embed na mga bagong linya kaysa sa paggamit ng mga separator ng halimaw kung posible.
login_shell
Itinatakda ng shell ang pagpipiliang ito kung ito ay nagsimula bilang isang shell ng pag-login (tingnan ang INVOCATION sa itaas). Ang halaga ay maaaring hindi mabago.
mailwarn
Kung naka-set, at ang isang file na bash ay checking para sa mail ay na-access mula sa huling oras na ito ay naka-check, ang mensahe `` Ang mail sa mailfile ay read '' ay ipinapakita.
no_empty_cmd_completion
Kung naka-set, at readline ang ginagamit, hindi pagtatangka ng bash na hanapin ang PATH para sa mga posibleng pagkumpleto kapag natapos na ang pagkumpleto sa walang laman na linya.
nocaseglob
Kung nakatakda, ang mga bash ay tumutugma sa mga filename sa isang case-insensitive fashion kapag nagpapalabas ng expansion ng pathname (tingnan ang Pagpapalawak ng Pathname sa itaas).
nullglob
Kung itinakda, ang bash ay nagpapahintulot sa mga pattern na tumutugma sa walang mga file (tingnan ang Expansion ng Pathname sa itaas) upang palawakin sa isang null string, sa halip na sa kanilang sarili.
progcomp
Kung nakatakda, ang mga programmable na pagkumpleto ng mga pasilidad (tingnan Programmable Completion sa itaas) ay pinagana. Pinagana ang opsyon na ito bilang default.
promptvars
Kung nakatakda, ang mga prompt string ay sumasailalim sa pagbabago ng variable at parameter matapos na