име
bg , bind, alias, bg , bind, пауза, вграден, cd , команда, compgen, пълен, продължаване, декларира, dirs, отхвърляне, ехо, история , работни места, убий , нека, локален, излизане, поп , printf , pushd, pwd , read, readonly, връщане , unalias , unset, wait - bash вградени команди, вижте bash (1)
Командване на басите
Освен ако не е отбелязано друго, всяка вградена команда, документирана в този раздел като приемаща опции, предшествана от - приема - означава края на опциите.
: [ аргументи ]
Без ефект; командата не прави нищо отвъд разширяването на аргументите и извършването на определени пренасочвания. Извежда се нулев код за излизане.
, име на файл [ аргументи ]
име на файла на източника [ аргументи ]
Прочитате и изпълнявате команди от името на файла в текущата среда на shell и връщате изходното състояние на последната изпълнена команда от името на файла . Ако името на файла не съдържа наклонена черта, имената на файловете в PATH се използват за намиране на директорията, съдържаща името на файла . Файлът, който се търси в PATH, не е задължително да бъде изпълним. Когато bash не е в posix режим , текущата директория се търси, ако в PATH не се намери файл. Ако опцията sourcepath на вградената команда е изключена, PATH не се търси. Ако се предоставят някакви аргументи , те се превръщат в позиционни параметри при изпълнение на името на файла . В противен случай позиционните параметри остават непроменени. Състоянието на връщане е състоянието на последната команда, излязла в скрипта (0, ако не се изпълняват команди) и false, ако името на файла не е намерено или не може да бъде прочетено.
псевдоним [ -p ] [ име [= стойност ] ...]
Псевдонимът без аргументи или с опцията -p отпечатва списъка с псевдоними във формата псевдоним име = стойност на стандартния изход. Когато се предоставят аргументи, се определя псевдоним за всяко име, чиято стойност е дадена. Стойността на крайното поле води до проверка на следващата дума за подмяна на псевдоними, когато псевдонимът се разшири. За всяко име в списъка с аргументи, за които не е предоставена стойност , името и стойността на псевдонима се отпечатват. Псевдонимът се връща вярно, освен ако не е дадено име , за което не е дефиниран псевдоним.
bg [ jobspec ]
Възстановете временно заданието jobpec във фонов режим, сякаш е стартирано с & . Ако jobpec не присъства, използва се понятието "shell" за текущата задача . bg jobspec връща 0, освен ако не се изпълни, когато контролът на заданието е деактивиран или ако е активиран контрола на заданието, ако jobpep не е открит или не е започнал без контрол на работното място.
свързване [ -m клавиатура ] [ -lpsvPSV ]
свързване [ -m ключова карта ] [ -q функция ] [ -u функция ] [ -r keyseq ]
свържете [ -m клавиатурата ] -f името на файла
свързване [ -m клавиатура ] -x keyseq : shell-команда
свържете [ -m ключова карта ] keyseq : функция-име
свързване readline-команда
Показване на текущите клавишни комбинации и функционалните връзки, свързване на последователността на клавишите с функция за четене или макрос или задаване на променлива за четене . Всеки аргумент, който не е опция, е команда, както би се появила в .inputrc , но всяко свързване или команда трябва да се предаде като отделен аргумент; напр. "" \ Cx \ Cr ": read-init-file". Опциите, ако са предоставени, имат следните значения:
-м ключова карта
Използвайте клавишната карта, тъй като ключовата карта ще бъде повлияна от последващите свързвания. Приемливите имена на клавишни комбинации са emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-move, vi-command и vi-insert . vi е еквивалентно на vi-command ; emacs е еквивалентно на стандарт emacs .
-l
Посочете имената на всички функции за readline .
-p
Показване на имената на функциите за четене и връзките по такъв начин, че да могат да се четат отново.
-Р
Посочете текущите имена на функциите за четене и свързванията.
-V
Дисплеят чете имената на променливите и техните стойности по такъв начин, че да могат да се четат отново.
-V
Да се изброят текущите имена и стойности на променливите за четене
-с
Показване на ключовите последователности за readline , свързани с макроси и низовете, които извеждат по такъв начин, че да могат да бъдат преизчислени отново.
-С
Показване на ключовите секвенции за четене, свързани с макросите и низовете, които те извеждат.
-f името на файла
Четене на ключови свързвания от името на файла .
-q функция
Заявка за кои клавиши извикват назованата функция .
-u функция
Освободете всички клавиши, свързани към посочената функция .
-r keyseq
Премахнете текущото свързване за keyseq .
-keyseq : shell-команда
Причината е командата shell да бъде изпълнена при въвеждането на keyseq .
Стойността на връщането е 0, освен ако не е дадена неразпозната опция или е възникнала грешка.
прекъсване [ n ]
Излезте от рамките на, докато , докато изберете или изберете линия. Ако n е посочено, разбийте нивата n . n трябва да бъде> 1. Ако n е по-голямо от броя на затворените цикли, всички затворени цикли се излизат. Стойността на връщането е 0, освен ако черупката не изпълнява цикъл при изпълнение на пауза .
вграден в корпус [ аргументи ]
Изпълнява посочената вградена черупка, предава я аргументи и връща изходното си състояние. Това е полезно, когато дефинирате функция, чието име е същата като вградена черупка, запазвайки функционалността на вградената функция. Вграденият cd е често предефиниран по този начин. Състоянието на връщане е невярно, ако shell-builtin не е shell builtin команда.
cd [ -L | -P ] [ dir ]
Променете текущата директория в директория . Променливата HOME е по подразбиране. Променливата CDPATH дефинира пътя за търсене на директорията, съдържаща dir . Алтернативните имена на директории в CDPATH са разделени с двоеточие (:). Името на null директория в CDPATH е същото като текущата директория, т.е. `` . ''. Ако началото започва с наклонена черта (/), CDPATH не се използва. Опцията -P казва, че да използва структурата на физическите директории, вместо да следва символните връзки (виж също опцията -P към настроената вградена команда); опцията -L налага символни връзки, които да се следват. Аргументът на - е еквивалентен на $ OLDPWD . Връщащата се стойност е вярна, ако директорията е променена успешно; в противен случай.
команда [ -pVv ] команда [ arg ...]
Стартирайте командата с арги, като потискате търсенето на нормална функция на черупката. Включени са само вградени команди или команди, намерени в PATH . Ако е дадена опцията -p , търсенето на команда се изпълнява, като се използва стойност по подразбиране за PATH, която гарантира, че ще намери всички стандартни помощни програми. Ако е предоставена опцията -V или -v , се отпечатва описание на командата . Опцията -v причинява една дума, показваща командата или името на файла, използвани за извикване на команда, която да се показва; опцията -V дава по - подробно описание. Ако опцията -V или -v е предоставена, изходният статус е 0, ако е намерена команда и 1, ако не е. Ако не е предоставена нито една от опциите и не е намерена грешка или командата не може да бъде намерена, изходното състояние е 127. В противен случай, изходното състояние на вградената команда е изходното състояние на командата .
комген [ опция ] [ дума ]
Генериране на възможни съвпадения за думата според опцията s, което може да бъде всяка опция, приета от пълния вграден, с изключение на -p и -r , и да напише съвпаденията със стандартния изход. Когато използвате опциите -F или -C , различните променливи на обвивката, зададени от програмиращите се устройства за завършване, ако са налични, няма да имат полезни стойности.
Мачовете ще бъдат генерирани по същия начин, както ако програмируемия код за завършване ги е генерирал директно от спецификацията за завършване със същите флагове. Ако е зададена дума, ще се показват само тези изпълнения, съответстващи на думата .
Върховата стойност е вярна, освен ако не е предоставена невалидна опция или не са генерирани съвпадения.
пълен [ -abcdefgjksuv ] [ -o comp-опция ] [ -А действие ] [ -G globpat ] [ -W списък с думи ] [ -P префикс ] [ -S наставка ]
[ -X filterpat ] [ -F функция ] [ -К команда ] име [ име ... ]
пълен -pr [ име ...]
Посочете как трябва да бъдат завършени аргументите за всяко име . Ако опцията -p е предоставена или не са предоставени опции, съществуващите спецификации за завършване са отпечатани по начин, който им позволява да бъдат използвани повторно като вход. Опцията -r премахва спецификацията за завършване за всяко име или, ако няма име s, всички спецификации за завършване.
Процесът на прилагане на тези спецификации за завършване при опита за завършване на дума е описан по-горе в Програмируемото изпълнение .
Другите опции, ако са посочени, имат следните значения. Аргументите за опциите -G , -W и -X (и, ако е необходимо, опциите -P и -S ) трябва да бъдат цитирани, за да ги предпазят от разширяване, преди да се извикат всички вградени.
-о ком-опция
Компютърната опция контролира няколко аспекта от поведението на compspec извън простото поколение на завършванията. Comp-опцията може да бъде една от следните:
по подразбиране
Използвайте стандартното име на файла на readline, ако compspec не генерира съвпадения.
dirnames
Изпълнете попълването на името на директорията, ако compspec не генерира съвпадения.
имена на файлове
Кажете на readline, че compspec генерира имена на файлове, така че може да извършва всяка обработка, специфична за имена на файлове (като добавяне на наклонена черта към имена на директории или потискане на крайните интервали). Предназначена за използване с функции на черупки.
няма място
Кажете на readline да не добавяте интервал (по подразбиране) към думите, завършени в края на реда.
- Действие
Действието може да бъде едно от следните, за да се генерира списък с възможни завършвания:
псевдоним
Имената на псевдонимите. Може да се посочи и като -а .
arrayvar
Име на променливи на масива.
подвързване
Ключовите имена за четене .
Вградената
Имена на команди вградени в Shell. Може да се посочи и като -b .
команда
Командни имена. Могат също да бъдат посочени като имена. Може да се посочи и като -c .
указател
Име на директорията . Може да се посочи и като -d .
хора с увреждания
Имена на забранени вградени черупки.
активиран
Имената на вградените вградени черупки.
износ
Имената на експортираните черупки променливи. Може да се посочи и като -e .
досие
Име на файловете. Може да се посочи и като -f .
функция
Имена на функциите на обвивката .
група
Име на групата. Може да се посочи и като -g .
HELPTOPIC
Помощните теми се приемат от вградената помощ .
Имена на хостове, взети от файла, определен от HOSTFILE shell променливата.
работа
Имената на заданията, ако е активен контрол на задачите. Може да се посочи и като -j .
ключова дума
Shell запази думи. Може да се посочи и като -k .
бягане
Имената на изпълняваните задания, ако е активен контрол на задачите.
обслужване
Име на услугата. Може да се посочи и като -s .
setopt
Валидни аргументи за опцията -o към вградения набор .
shopt
Shell имената на опциите, приети от вградения шап .
сигнал
Име на сигнали.
спряна
Имената на спряните задания, ако е активен контрол на задачите.
потребител
Потребителски имена. Може да се посочи и като -u .
променлив
Имена на всички променливи на обвивката. Може да се посочи и като -v .
-G гробар
Шаблонът за разширение на името на файла globpat се разширява, за да генерира възможните завършвания.
-W списък с думи
Списъкът с думите се разделя с помощта на символите в специалната променлива IFS като разделители и всяка получена дума се разширява. Възможните завършвания са членовете на резултантния списък, които отговарят на думата, която е завършена.
-C команда
командата се изпълнява в среда на подсистема и нейната продукция се използва като евентуално завършване.
-F функция
Функцията за функция на черупката се изпълнява в текущата среда на обвивката. Когато завърши, евентуалните завършвания се извличат от стойността на променливата COMPREPLY масив.
-X filterpat
filterpat е модел, използван за разширяване на файла. Прилага се в списъка с възможни завършвания, генерирани от предходните опции и аргументи, и всяко завършване на съответстващия filterpat се премахва от списъка. Водещ ! в filterpat отрича образеца; в този случай всяко премахване, което не съответства на filterpat, се премахва.
-P префикс
се добавя префикс в началото на всяко възможно завършване, след като са били приложени всички други опции.
-S наставка
Приставката се прибавя към всяко възможно завършване, след като са били приложени всички други опции.
Връщащата се стойност е вярна, освен ако не е предоставена невалидна опция, опция различна от -p или -r се предоставя без аргумент за име , опитва се да се премахне спецификацията за завършване на име, за което не съществува спецификация или се появява грешка добавяне на спецификация за завършване.
продължаване [ n ]
Възобновете следващата итерация на обвивката за , докато , до или изберете линия. Ако е указано n , възобновете в n -та заграждаща линия. n трябва да бъде> 1. Ако n е по-голямо от броя на затворените цикли, последната затворена линия (цикълът "top-level") се възобновява. Връщащата се стойност е 0, освен ако черупката не изпълнява цикъл, когато се изпълни продължението .
декларирам [ -afFirtx ] [ -p ] [ име [= стойност ]]
задава [ -afFirtx ] [ -p ] [ име [= стойност ]]
Декларирайте променливи и / или им дайте атрибути. Ако няма дадени имена, тогава се показват стойностите на променливите. Опцията -p ще покаже атрибутите и стойностите на всяко име . Когато се използва -p , допълнителни опции се игнорират. Опцията -F спира показването на дефинициите на функциите; се отпечатват само името на функцията и атрибутите. Опцията -F означава -f . Следните опции могат да се използват за ограничаване на изхода до променливи с посочения атрибут или за даване на атрибути на променливи:
-а
Всяко име е променлива на масива (вижте По-горе).
-f
Използвайте само име на функции.
-i
Променливата се третира като цяло число; аритметичната оценка (виж ARITHMETIC EVALUATION) се извършва, когато на променливата е присвоена стойност.
-r
Направете име само за четене. Тези имена след това не могат да бъдат присвоени на стойности чрез последващи отчети за присвояване или изключени.
-T
Дайте на всяко име атрибута за следене . Проследяваните функции наследяват капака DEBUG от обвивката. Атрибутът за проследяване няма специално значение за променливите.
-х
Маркирайте името s за експорт в следващите команди чрез околната среда.
Използването на "+" вместо "-" изключва атрибута, с изключение на това, че + a не може да се използва за унищожаване на променлива масив. Когато се използва във функция, прави всяко име локално, както при местната команда. Стойността на връщането е 0, освен ако не е налице невалидна опция, се прави опит да се дефинира функция, използвайки `` -f foo = bar '', се прави опит да се зададе стойност на променлива само за четене, се прави опит за да присвоите стойност на променлива от масива, без да използвате синтактичния състав на присвояване (вижте по-горе Arrays ), едно от имената не е валидно име на променлива на обвивката, прави се опит да се изключи състоянието само за четене за променлива само за четене, се прави опит да се изключи състоянието на масива за променлива на масива или се прави опит за показване на несъществуваща функция с -f .
dirs [-clpv ] [+ n ] [- n ]
Без опции показва списък с директории, които понастоящем са запомнени. Екранът по подразбиране е на един ред с имена на директории, разделени с интервали. Директорите се добавят към списъка с командата pushd ; командата popd премахва записите от списъка.
+ n
Показва номерът, който се брои отляво на списъка, показан от dirs при извикване без опции, започвайки с нула.
- н
Показва номерът, който се брои отдясно на списъка, показан от dirs при извикване без опции, започвайки с нула.
-° С
Изчиства стека директории, като изтрива всички записи.
-l
Произвежда по-дълъг списък; стандартният формат на малката обява използва tilde за обозначаване на домашната директория.
-p
Отпечатайте стека с директории с един запис на ред.
-V
Отпечатайте стека с директории с един запис на ред, като префиксирате всеки запис с неговия индекс в стека.
Стойността на връщането е 0, освен ако не е предоставена невалидна опция или n индекси след края на стека на директорията.
отхвърляне [ -ар ] [ -h ] [ jobspec ...]
Без опции всеки Jobpec се премахва от таблицата на активните задания. Ако е дадена опцията -h , всяка jobpec не се премахва от таблицата, но е маркирана така, че SIGHUP да не бъде изпратена на заданието, ако shell получат SIGHUP . Ако не са налични работни места и не са предоставени нито опцията -a, нито -r , използва се текущата задача . Ако не се доставят работни места, опцията -а означава премахване или маркиране на всички задания; опцията -r без аргумент на jobpec ограничава операцията до изпълняваните задания. Стойността на връщането е 0, освен ако jobpec не указва валидна задача.
echo [ -neE ] [ арг ...]
Извеждайте аргументите , разделени с интервали, последвани от нов ред. Състоянието на връщане винаги е 0. Ако -n е зададено, последният нов ред е потиснат. Ако е дадена опцията -e, е активирана интерпретация на следните символи, избягали отзад. Опцията -E забранява тълкуването на тези евакуационни знаци, дори на системи, където те се интерпретират по подразбиране. Опцията xpg_echo shell може да се използва за динамично определяне дали ехото разширява тези знаци по подразбиране. ехото не интерпретира - това означава край на опциите. echo тълкува следните избяга последователности:
\ а
сигнал (звънец)
\ б
Backspace
\° С
подтискане на последващия нов ред
\ д
бягство характер
\ е
форма фураж
\ Н
нова линия
\ R
връщане на карето
\T
хоризонтален раздел
\ о
вертикален раздел
\\
наклонена черта
\ N nnn
8-битовият знак, чиято стойност е осмичната стойност nnn (нула до три октави цифри)
\ nnn
осем-битовия знак, чиято стойност е осмичната стойност nnn (от една до три октави цифри)
\ х НН
осем-битовият знак, чиято стойност е шестнадесетичната стойност HH (една или две шестнадесетични цифри)
активиране на [ -adnps ] [ -f име на файл ] [ име ...]
Активирайте и деактивирайте вградените команди на shell. Деактивирането на вграденото позволява да се изпълни дисково команда, която има същото име като вграден четец, без да посочва пълен път, въпреки че черупката обикновено търси вградени файлове преди дисковите команди. Ако -n се използва, всяко име е деактивирано; в противен случай имената са активирани. Например, за да използвате тестовата двоична, намерена чрез PATH, вместо версията, вградена в shell, изпълнете `` enable -n test ''. Опцията -f означава да заредите новото име на вградената команда от името на споделен обект, на системи, които поддържат динамично зареждане. Опцията -d ще изтрие вграден файл, предварително зареден с -f . Ако не са дадени аргументи за имената или ако е предоставена опцията -p , се отпечатва списък с вградени черупки. Без аргументи с други опции списъкът се състои от всички вградени вградени черупки. Ако -n се доставят, се отпечатват само вградените вградени устройства. Ако -a се подава, отпечатаният списък включва всички вградени елементи, с индикация дали всеки е разрешен или не. Ако -s се доставя, изходът се ограничава до специални вградени POSIX.
Стойността на връщането е 0, освен ако името не е вградено в черупка или има грешка при зареждането на нова вградена от споделен обект.
eval [ арг ...]
Аргументите се четат и обединяват заедно в една команда. След това командата се чете и изпълнява от обвивката и изходното й състояние се връща като стойността на eval . Ако няма аргументи или само нулеви аргументи, eval връща 0.
exec [ -cl ] [ -а име ] [ команда [ аргументи ]]
Ако е зададена команда , тя замества обвивката. Няма създаден нов процес. Аргументите стават аргументи за команда . Ако опцията -l е предоставена, черупката поставя тире в началото на нулевия arg, предаван на командата . Това е, което прави влизането (1). Опцията -c прави командата да бъде изпълнена с празна среда. Ако -a се доставя, черупката предава името като нулев аргумент на изпълнената команда. Ако командата не може да бъде изпълнена по някаква причина, излиза и не-интерактивен корпус, освен ако опцията shell execfail не е активирана, в който случай връща провала. Интерактивният корпус връща неизправност, ако файлът не може да бъде изпълнен. Ако не е зададена команда , всички пренасочвания влизат в сила в текущата обвивка и състоянието на връщане е 0. Ако има грешка при пренасочване, състоянието на връщане е 1.
излизане [ n ]
Причината е, че черупката ще излезе със статус n . Ако n е пропуснато, изходният статус е този на последната изпълнена команда. Приключване на EXIT се извършва, преди черупката да се прекрати.
износ [ -fn ] [ име [= дума ]] ...
износ -p
Доставените имена са маркирани за автоматично експортиране в средата на последвалите изпълнени команди. Ако е дадена опцията -f , имената се отнасят до функциите. Ако не са дадени имена или ако е предоставена опцията -p, се отпечатва списък с всички имена, които се експортират в тази черупка. Опцията -n причинява премахването на собствеността за експортиране от посочените променливи. извежда статус на излизане от 0, освен ако не е налице невалидна опция, едно от имената не е валидно име на променлива на обвивката или -f е снабдено с име, което не е функция.
fc [ -e емей ] [ -nlr ] [ първо ] [ последно ]
fc -s [ пат = rep ] [ cmd ]
Fix команда. В първата форма набор от команди от първа до последна се избира от списъка с история. Първият и последният могат да се задават като низ (за намиране на последната команда, която започва с този низ) или като число (индекс в списъка с истории, където отрицателният номер се използва като отместване от текущия команден номер). Ако последното не е зададено, то е зададено на текущата команда за вписване (така че `` fc -l-10 '' да отпечата последните 10 команди) и първо да се запише. Ако първото не е зададено, то е зададено на предишната команда за редактиране и -16 за регистрация.
Опцията -n потиска командните номера при регистрация. Опцията -r обръща реда на командите. Ако е дадена опцията -l , командите са изброени на стандартния изход. В противен случай редакторът, зададен от емаме, се извиква на файл, съдържащ тези команди. Ако не е даден емайл, се използва стойността на променливата FCEDIT , а стойността на EDITOR, ако не е зададена стойност FCEDIT . Ако не е зададена нито една променлива, се използва. Когато редакцията е завършена, редактираните команди се отразяват и изпълняват.
Във втората форма командата се изпълнява отново, след като всяко копие на патица се заменя от rep . Полезен псевдоним, който да използвате с това е `` r = fc -s '', така че натискането на `` rcc '' изпълнява последната команда, започваща с `` cc '' и натискайки `r ' команда.
Ако се използва първият формуляр, връщаната стойност е 0, освен ако не е налице невалидна опция или първата или последната зададете линиите на историята извън обхвата. Ако опцията -e е предоставена, връщащата стойност е стойността на последната изпълнена команда или неизправност, ако възникне грешка при временния файл с команди. Ако се използва вторият формуляр, статусът на връщане е този на изпълнената команда, освен ако cmd не указва валидна линия на историята, в който случай fc връща провал.
fg [ jobspec ]
Възстановете Jobpec на преден план и го направете сегашната работа. Ако jobpec не присъства, използва се понятието "shell" за текущата задача . Връщащата се стойност е тази на командата, поставена на преден план, или неизправност, ако се изпълнява, когато контролът на заданието е деактивиран или когато работи с активиран контрол на заданието, ако jobpec не указва валидна задача или jobspec определя задание, ,
getopts optstring име [ args ]
getopts се използва от черупките процедури, за да се анализират позиционните параметри. optstring съдържа опциите за разпознаване; ако символът е последван от двоеточие, опцията се очаква да има аргумент, който трябва да бъде отделен от него чрез бяло пространство. Знаците на дебелото черво и знак на знак може да не се използват като символи с опции. Всеки път, когато се извиква, getopts поставя следващата опция в името на променливата на обвивката, инициализира името, ако тя не съществува, а индексът на следващия аргумент се обработва в променливата OPTIND . OPTIND се инициализира на 1 всеки път, когато се извиква shell или shell shell. Когато опцията изисква аргумент, getopts поставя този аргумент в променливата OPTARG . Черупката не връща автоматично OPTIND ; трябва да се нулира ръчно между няколко повиквания до getopts в рамките на едно и също призоваване за обвивка, ако се използва нов набор от параметри.
Когато се установи крайът на опциите, getopts излиза с връщаща стойност, по-голяма от нула. OPTIND е настроен на индекса на първия аргумент без опция и името е настроено на?.
getopts обикновено анализира параметрите на позицията, но ако в аргументите са дадени повече аргументи, getopts ги анализира.
getopts могат да съобщават за грешки по два начина. Ако първият знак на optstring е двоеточие, се използва отчет за тихи грешки. При нормална работа диагностичните съобщения се отпечатват, когато се появят невалидни опции или липсващи опции. Ако променливата OPTERR е зададена на 0, няма да се показват съобщения за грешка, дори ако първият знак на optstring не е двоеточие.
Ако се види невалидна опция, getopts места? в име и, ако не е безшумен, отпечатва съобщение за грешка и изважда OPTARG . Ако getopts е безшумен, намереният символ на опцията се поставя в OPTARG и не се отпечатва диагностично съобщение.
Ако не се намери необходим аргумент и getopts не мълчи, въпросът ( ? ) Се поставя в името , OPTARG е деактивиран и се отпечатва диагностично съобщение. Ако getopts е мълчалив, след това двоеточие ( :) се поставя в името и OPTARG е настроен на намерения символ.
getopts се връща вярно, ако се намери опция, посочена или неопределена. Той връща фалшива, ако се появи край на опциите или възникне грешка.
хеш [ -lr ] [ -p име на файл ] [ -dt ] [ име ]
За всяко име пълното име на командата се определя чрез търсене в директории в $ PATH и запомнени. Ако опцията -p е предоставена, не се извършва търсене на път и името на файла се използва като пълното име на командата. Опцията -r кара черупката да забрави всички запомнени местоположения. Опцията -d кара черупката да забрави записаното местоположение на всяко име . Ако опцията -t е предоставена, се отпечатва пълният път, към който отговаря всяко име . Ако аргументите с множество имена се доставят с -t , името се отпечатва преди пълното име на хеширането. Опцията -l прави изхода да се показва във формат, който може да бъде използван отново като вход. Ако няма дадени аргументи или ако е предоставено само -l , се отпечатва информация за запомнените команди. Състоянието на връщане е вярно, освен ако не е намерено име или не е предоставена невалидна опция.
помощ [ -s ] [ модел ]
Показване на полезна информация за вградените команди. Ако е зададен шаблон , помощта дава подробна помощ за всички команди, съответстващи на модела ; в противен случай ще бъдат отпечатани всички вградени и контролни структури. Опцията -s ограничава информацията, която се показва в кратък общ преглед. Състоянието на връщане е 0, освен ако командата не съответства на шаблона .
история [ n ]
история -c
история -d компенсира
история- anrw [ име на файла ]
история -p arg [ арг ... ]
история- s arg [ arg ... ]
Ако няма опции, покажете списъка с история на командите с номерата на редовете. Линиите, изброени с * са променени. Аргументът на n съдържа само последните n редове. Ако името на файла е предоставено, то се използва като име на файла с историята; ако не, стойността на HISTFILE се използва. Опциите, ако са предоставени, имат следните значения:
-° С
Изчистете списъка с историята, като изтриете всички записи.
-d компенсира
Изтрийте записа за историята при отместване на позицията.
-а
Добавете новите "исторически линии" (линии за история, въведени от началото на текущата сесия на bash ) в историческия файл.
-н
Прочетете линиите за историята, които още не са четени от историческия файл, в списъка на текущата история. Това са линии, прикрепени към историческия файл от началото на текущата сесия на bash .
-r
Прочетете съдържанието на историческия файл и го използвайте като текуща история.
-w
Запишете текущата история в историческия файл, презаписвайки съдържанието на файла на историята.
-p
Извършете подмяната на историята на следните аргументи и покажете резултата на стандартния изход. Не съхранява резултатите в списъка с история. Всеки arg трябва да бъде цитиран, за да деактивира нормалното разширяване на историята.
-с
Съхранявайте аргите в списъка на историята като един запис. Последната команда в списъка с история се премахва, преди да се добавят аргументите .
Стойността за връщане е 0, освен ако не е налице невалидна опция, възниква грешка при четене или записване на файла с история, невалиден компенсира се предоставя като аргумент до -d или разширението за история, предоставено като аргумент към -p не е успешно.
работни места [ -inprs ] [ jobspec ...]
задания -x команда [ args ...]
В първия формуляр са изброени активните задания. Опциите имат следните значения:
-l
Посочете идентификационните номера на процеса в допълнение към нормалната информация.
-p
Посочете само идентификационния номер на процеса на ръководителя на групата за работа на групата.
-н
Показване на информация само за задания, които са променили статуса, след като последният е бил уведомен за състоянието им.
-r
Ограничете изхода на изпълняваните задания.
-с
Ограничете изхода до спирания.
Ако jobpec е дадено, продукцията е ограничена до информация за тази работа. Състоянието на връщане е 0, освен ако не е налице невалидна опция или не е предоставена невалидна задача .
Ако опцията -x е предоставена, заданията заменят всички задания, намерени в командата или арги със съответния идентификатор на група от процеси, и изпълняват командата, минаваща от нея, връщайки изходното си състояние.
убий [ -s sigspec | -n signum | - sigspec ] [ pid | jobspec ] ...
kill- l [ sigspec | exit_status ]
Изпратете сигнала, наречен от sigspec или signum, до процесите, наречени pid или jobspec . sigspec е или име на сигнал като SIGKILL или номер на сигнала; signum е номер на сигнала. Ако sigspec е име на сигнал, името може да бъде дадено със или без префикса SIG . Ако sigspec не присъства, тогава SIGTERM се приема. Аргументът на -l посочва имената на сигнала. Ако са предоставени някакви аргументи, когато е даден -l , имената на сигналите, съответстващи на аргументите, са изброени, а състоянието на връщане е 0. Изразът exit_status до -l е число, указващо или номер на сигнал, или изходно състояние на a процес, прекратен от сигнал. kill връща true ако поне един сигнал е успешно изпратен, или false, ако възникне грешка или е възникнала невалидна опция.
нека arg [ arg ...]
Всеки arg е аритметичен израз, който трябва да бъде оценен (вж. АРИМЕТИЧНА ОЦЕНКА ). Ако последното арг оцени до 0, нека върне 1; 0 се връща в противен случай.
локална [ опция ] [ име [= стойност ] ...]
За всеки аргумент се създава локална променлива с наименование име и зададена стойност . Опцията може да бъде всяка от опциите, приети от декларацията . Когато се използва локално в дадена функция, то причинява името на променливата да има видим обхват, ограничен само до тази функция и нейните деца. При липса на операнди, локалният записва списък на локалните променливи към стандартния изход. Грешка е да се използва локално, когато не е в дадена функция. Състоянието на връщане е 0, освен ако локалната се използва извън дадена функция, се предоставя невалидно име или името е readonly променлива.
излез от профила си
Излезте от входната черупка.
popd [- n ] [+ n ] [- n ]
Премахва записите от стека на директорията. Без аргументи премахва горната директория от стека и изпълнява cd в новата горна директория. Аргументите, ако са предоставени, имат следните значения:
+ n
Премахва номерът, който се брои отляво на списъка, показан от dirs , като се започне от нула. Например: `` popd +0 '' премахва първата директория, `` popd +1 '' втората.
- н
Премахва номерата от номера, показани от dirs , започвайки с нула. Например: `` popd -0 '' премахва последната директория, `` popd -1 '' до последната.
-н
Подтиска нормалната промяна на директорията при премахване на директории от стека, така че само манипулирането на стека.
Ако командата popd е успешна, се изпълнява и dirs и състоянието на връщане е 0. popd връща фалшива, ако е налице невалидна опция, стекът на директорията е празен, не е зададен запис на стека директория или директорията промяната не е успешна.
printf формат [ аргументи ]
Запишете форматираните аргументи на стандартния изход под контрола на формата . Форматът е низ на знаци, който съдържа три типа обекти: обикновени символи, които просто се копират на стандартния изход, последователности от избягване на символи, които се преобразуват и копират на стандартния изход, и спецификации на формата, всеки от които предизвиква отпечатване на следващия последователен аргумент . В допълнение към стандартните формати printf (1), % b причинява printf да разширява последователността на обратно наклонена черта в съответния аргумент и % q кара printf да изведе съответния аргумент във формат, който може да бъде използван отново като входен шкаф.
Форматът се използва повторно, ако е необходимо, за да се консумират всички аргументи . Ако форматът изисква повече аргументи, отколкото са предоставени, допълнителните спецификации на формата се държат така, сякаш са били предоставени нулева стойност или нулев низ. Стойността на връщането е нула при успех, с нулева стойност при неуспех.
pushd [ -n ] [ реж. ]
pushd [ -n ] [+ n ] [- n ]
Добавя директория в горната част на стека на директорията или завърта купчината, като прави новия връх на стека текущата работна директория. Без аргументи обменя първите две директории и връща 0, освен ако стека на директорията не е празен. Аргументите, ако са предоставени, имат следните значения:
+ n
Завърта купчината така, че n -тата директория (която се брои отляво на списъка, показана от dirs , започвайки с нула) е в горната част.
- н
Завърта купчината така, че n -тата директория (която се брои отдясно на списъка, показана от dirs , започвайки с нула) е в горната част.
-н
Подтиска нормалната промяна на директорията при добавяне на директории към стека, така че да се манипулира само стека.
реж
Добавя директория към стека на директорията в горната част, което го прави новата работна директория.
Ако командата pushd е успешна, се изпълнява и dirs . Ако се използва първият формуляр, pushd връща 0, освен ако cd- dir не успее. При втория формуляр pushd връща 0, освен ако стека на директорията не е празен, не е зададен елемент на стека на директория или директорията не се променя до зададената нова текуща директория.
pwd [ -LP ]
Отпечатвайте абсолютния път на текущата работна директория. Изведеното име на пътя не съдържа символни връзки, ако е добавена опцията -P или е активирана физическата опция -o към зададената вградена команда. Ако се използва опцията -L , печатаното име може да съдържа символни връзки. Състоянието на връщане е 0, освен ако не се получи грешка при четене на името на текущата директория или е предоставена невалидна опция.
прочетете [ -ers ] [ -u fd ] [ -t timeout ] [ -аменар ] [ -p подканка ] [ -n nchars ] [ -d delim ] [ име ...]
Един ред се чете от стандартния вход или от файловия дескриптор fd, предоставен като аргумент към опцията -u , а първата дума се присвоява на първото име , втората дума към второто име и т.н., с остатък думите и техните наместови сепаратори, назначени на фамилното име . Ако има по-малко думи, четени от входния поток от имената, останалите имена имат зададени празни стойности. Знаците в IFS се използват за разделяне на реда в думи. Знакът за обратна наклонена черта ( \ ) може да се използва за премахване на всяко специално значение за следващия четене на символа и за продължение на линията. Опциите, ако са предоставени, имат следните значения:
- анам
Думите са присвоени на последователни индекси на променливата масив от масива, започвайки от 0. анамът се дезактивира преди да бъдат присвоени нови стойности. Другите аргументи за имената се игнорират.
-d разстояние
Първият знак на разграничение се използва за прекратяване на входната линия, а не на нов ред.
-Д
Ако стандартният вход идва от терминал, се използва readline (виж READLINE по-горе) за получаване на линията.
-nchars
read reads след четене на nchars символи, вместо да чака пълна линия на въвеждане.
-п подкана
Покажете подкана за стандартна грешка, без последователен нов ред, преди да опитате да четете произволен вход. Промптът се показва само ако входът идва от терминал.
-r
Обратното наклонена черта не действа като характер за бягство. Обратното наклон се счита за част от линията. По-специално, двойката наклонена черта-нова линия не може да се използва като продължаване на линията.
-с
Тих режим. Ако входът идва от терминал, символите не се отразяват.
-t изчакване
Причината е четене за изчакване и връщане на неизправност, ако пълната линия на въвеждане не се чете в рамките на секунди за изчакване . Тази опция няма ефект, ако четенето не чете вход от терминала или от тръба.
-u fdFP
Четене на вход от файлов дескриптор fd .
Ако не са предоставени имена , четената линия е присвоена на променливата REPLY . Кодът за връщане е нула, освен ако не е открит край на файла, време за четене или невалиден файлов дескриптор се предоставя като аргумент към -u .
readonly [ -apf ] [ име ...]
Посочените имена са отбелязани с четене; стойностите на тези имена може да не се променят при последващо присвояване. Ако опцията -f е предоставена, функциите, съответстващи на имената, са толкова маркирани. Опцията -a ограничава променливите до масиви. Ако няма дадени имена , или ако е предоставена опцията -p , се отпечатва списък с всички readonly имена. Опцията -p прави изхода да се показва във формат, който може да бъде повторно използван като вход. Състоянието на връщане е 0, освен ако не е налице невалидна опция, едно от имената не е валидно име на променлива на обвивката или -f е снабдено с име, което не е функция.
връщане [ n ]
Причинява функция за излизане с връщащата стойност, определена от n . Ако n е пропуснато, статусът на връщане е този на последната команда, изпълнена във функционалното тяло. Ако се използва извън дадена функция, а по време на изпълнение на скрипт от . ( source ) командата, тя причинява черупката да спре изпълнението на този скрипт и да върне n или изходното състояние на последната команда, изпълнена в скрипта като изходно състояние на скрипта. Ако се използва извън дадена функция, а не по време на изпълнение на скрипт от . , състоянието на връщане е невярно.
задайте [ --abefhkmnptuvxBCHP ] [ -а опция ] [ арг ...]
Без опции името и стойността на всяка променлива на обвивката се показват във формат, който може да бъде използван отново като вход. Изходът се сортира според текущия локал. Когато са зададени опции, те задават или деактивират атрибутите на черупката. Всички аргументи, останали след обработката на опциите, се третират като стойности за позиционните параметри и се задават в ред до $ 1 , $ 2 , ... $ n . Опциите, ако има такива, имат следните значения:
-а
Автоматично маркирайте променливите и функциите, които са променени или създадени за експортиране в средата на следващите команди.
-b
Подайте сигнал за състоянието на прекратените задания на фона незабавно, вместо преди следващия основен прозорец. Това е ефективно само когато е активиран контролът на заданието.
-Д
Излезте незабавно, ако простата команда (вижте SHELL GRAMMAR по-горе) излиза с ненулево състояние. Обвивката не излиза, ако командата, която е неуспешна, е част от цикъл до или докато част от израз на if е част от && или || списък или ако връщаната стойност на командата се обръща чрез ! , Капан на ERR , ако е зададен, се изпълнява преди излизането на черупката.
-f
Деактивиране на разширението на пътя.
-h
Помнете местонахождението на командите, когато те са търсени за изпълнение. Това е активирано по подразбиране.
-k
Всички аргументи под формата на изрази за задание се поставят в средата за команда, а не само тези, които предхождат името на командата.
-м
Монитор режим. Контролът на заданието е активиран. Тази опция е включена по подразбиране за интерактивни черупки на системите, които я поддържат (виж JOB CONTROL по-горе). Функционалните процеси се изпълняват в отделна група от процеси и при тяхното завършване се отпечатва ред, съдържащ изходното им състояние.
-н
Прочетете командите, но не ги изпълнявайте. Това може да се използва за проверка на скрипт на shell за синтактични грешки. Това се игнорира от интерактивните черупки.
-о опция-име
Името на опцията може да бъде едно от следните:
allexport
Същото като -а .
braceexpand
Същото като -Б .
Emacs
Използвайте интерфейс за редактиране на команден ред в стил emacs. Това е активирано по подразбиране, когато черупката е интерактивна, освен ако черупката не е стартирана с опцията --no редактиране .
errexit
Същото като -e .
hashall
Същото като -h .
histexpand
Същото като -H .
история
Активирайте историята на командите, както е описано по-горе в HISTORY . Тази опция е включена по подразбиране в интерактивни черупки.
IGNOREEOF
Ефектът е като че е изпълнена командата shell "IGNOREEOF = 10" (виж Shell Variables по-горе).
ключова дума
Същото като -k .
монитор
Също като -m .
noclobber
Същото като -C .
noexec
Същото като -n .
noglob
Същото като -f . В момента се игнорира.
уведомява
Същото като -b .
nounset
Същото като -u .
onecmd
Същото като -t .
физически
Същото като -P .
POSIX
Променете поведението на bash, където стандартната операция се различава от стандарта POSIX 1003.2, за да съответства на стандартния ( posix режим ).
привилегирован
Същото като -p .
многословен
Същото като -v .
VI
Използвайте интерфейс за редактиране на команден ред в стил vi.
xtrace
Същото като -x .
Ако -o се предоставя без име на опция, се отпечатват стойностите на текущите опции. Ако + o се доставя без име на опция, на стандартния изход се показва серия от зададени команди за пресъздаване на текущите настройки на опциите.
-p
Включете привилегирования режим. В този режим файловете $ ENV и $ BASH_ENV не се обработват, функциите на черупките не се наследиха от околната среда и променливата SHELLOPTS , ако се появи в средата, се игнорира. Ако черупката се стартира с идентификатора на ефективния потребител (група), който не е равен на истинския потребителски (групов) идентификатор и опцията -p не е предоставена, тези действия са предприети и ефективният потребителски идентификатор е настроен на истинския идентификатор на потребителя. Ако опцията -p се доставя при стартиране, ефективният потребителски идентификатор не се нулира. Изключването на тази опция води до това, че ефективните идентификатори на потребители и групи да бъдат зададени на реалните потребителски и групови идентификатори.
-T
Излез след четене и изпълняване на една команда.
-u
Отнасяйте се до нестандартни променливи като грешка при разширяване на параметрите. Ако се опитва експанзия на нестандартна променлива, черупката отпечатва съобщение за грешка и, ако не е интерактивно, излиза с ненулево състояние.
-V
Разпечатвайте входните линии на черупката, докато се четат.
-х
След като разширите всяка проста команда , покажете разширената стойност на PS4 , следвана от командата и нейните разширени аргументи.
-В
Черупката извършва разширение на опората (вижте Разширение на Brace по-горе). Това е включено по подразбиране.
-° С
Ако е зададено, bash не презаписва съществуващ файл с операторите за пренасочване > , > и <> . Това може да бъде преодоляно при създаване на изходни файлове чрез оператора за пренасочване > | вместо > .
-Н
Активирайте ! стил история замяна. Тази опция е включена по подразбиране, когато черупката е интерактивна.
-Р
Ако е зададена, черупката не следва символните връзки при изпълнение на команди като cd, които променят текущата работна директория. Вместо това използва структурата на физическата директория. По подразбиране bash следва логическата верига на директории, когато изпълнява команди, които променят текущата директория.
-
Ако няма никакви аргументи след тази опция, позиционните параметри са деактивирани. В противен случай позиционните параметри се задават на arg s, дори ако някои от тях започват с - .
-
Сигнализирайте края на опциите, тъй като всички оставащи аргументи се присвояват на позиционните параметри. Опциите -x и -v са изключени. Ако няма аргументи, позиционните параметри остават непроменени.
Опциите са изключени по подразбиране, освен ако не е посочено друго. Използването на +, вместо - води до изключване на тези опции. Опциите могат да се задават като аргументи за извикване на обвивката. Текущият набор от опции може да се намери в $ - . Състоянието на връщане винаги е вярно, освен ако не е налице невалидна опция.
преместване [ n ]
Позиционните параметри от n +1 ... се преименуват на $ 1 ... Параметрите, представени от номерата $ # до $ # - n +1, са деактивирани. n трябва да е негативно число по-малко или равно на $ # . Ако n е 0, не се променят параметри. Ако n не е дадено, се приема, че е 1. Ако n е по-голямо от $ # , позиционните параметри не се променят. Състоянието на връщане е по-голямо от нула, ако n е по-голямо от $ # или по-малко от нула; в противен случай 0.
shopt [ -pqsu ] [ -о ] [ optname ...]
Превключвайте стойностите на променливите, управляващи по избор поведението на обвивката. Без опции или с опцията -p се показва списък с всички опции, които могат да бъдат настроени, като се посочва дали са зададени или не. Опцията -p прави изхода да се показва във форма, която може да бъде използвана отново като вход. Другите опции имат следните значения:
-с
Активирайте (задайте) всяко име на опцията .
-u
Деактивиране (деактивиране) на всяко optname .
-q
Подтиска нормалния изход (тих режим); състоянието на връщане показва дали оптовото име е зададено или не е зададено. Ако са дадени няколко аргумента optname с -q , състоянието на връщане е нула, ако всички optnames са активирани; различни от нула.
-o
Ограничава стойностите на optname да бъдат онези, дефинирани за опцията -o към вградения набор .
Ако се използва или -s, или -u без ориентиране на optname , дисплеят е ограничен до онези опции, които са зададени или не са зададени съответно. Освен ако не е отбелязано друго, опциите за шотъм са деактивирани (деактивирани) по подразбиране.
Състоянието на връщане, когато опциите за регистрация е нула, ако всички optnames са активирани, различни от нула. Когато настройвате или деактивирате опции, състоянието на връщане е нула, освен ако optname не е валиден вариант на shell.
Списъкът с опциите за шоп е:
cdable_vars
Ако е зададена, аргументът за вградената cd команда, която не е директория, се приема, че е името на променлива, чиято стойност е директорията, към която да се промени.
cdspell
Ако е зададена, ще бъдат коригирани малки грешки в изписването на директорски компонент в командата cd . Грешките, които са проверени, са транспонирани знаци, липсващ знак и твърде много символи. Ако бъде намерена корекция, се отпечатва коригираното име на файла и командата продължава. Тази опция се използва само от интерактивни черупки.
checkhash
Ако е зададено, bash проверява наличието на команда в хеш таблицата, преди да се опита да я изпълни. Ако вече няма съществуваща хеширана команда, се извършва нормално търсене.
checkwinsize
Ако е зададена, bash проверява размера на прозореца след всяка команда и, ако е необходимо, актуализира стойностите на LINES и COLUMNS .
cmdhist
Ако е зададена, bash се опитва да запази всички линии на командата с няколко реда в същия запис в историята. Това позволява лесно редактиране на многоредовите команди.
dotglob
Ако е зададена, bash включва имена на файлове, започващи с "." в резултатите от разширението на пътя.
execfail
Ако е зададена, неактивният shell няма да излезе, ако не може да изпълни файла, зададен като аргумент към командата exec вградена. Интерактивната черупка не излиза, ако изпълнителът не успее.
expand_aliases
Ако са зададени, псевдонимите се разширяват, както е описано по-горе в ALIASES . Тази опция е активирана по подразбиране за интерактивни черупки.
extglob
Ако е зададена, разширените характеристики за съвпадение на шаблони, описани по-горе под Разширяване на пътя, са активирани.
histappend
Ако е зададена, списъкът с история се прибавя към файла, назован от стойността на променливата HISTFILE, когато командата излезе, вместо да презаписва файла.
histreedit
Ако е зададено и се използва readline , на потребителя се дава възможност да преиздаде неуспешна замяна на историята.
histverify
Ако е зададена и readline се използва, резултатите от заместването на историята не се предават незабавно на анализа за черупки. Вместо това последващата линия се зарежда в буфера за редактиране на readline , което позволява по-нататъшно изменение.
hostcomplete
Ако е зададена и се използва readline , bash ще се опита да изпълни име на хост, когато се изпълни дума, съдържаща @ (вж. Завършване под READLINE по-горе). Това е активирано по подразбиране.
huponexit
Ако е зададена, bash ще изпрати SIGHUP за всички задания, когато излезе интерактивен команда за вход.
interactive_comments
Ако е зададена, позволете на дума, започваща с #, да причини тази дума и всички останали знаци на този ред да бъдат игнорирани в интерактивна обвивка (вж. COMMENTS по-горе). Тази опция е активирана по подразбиране.
lithist
Ако е зададено и опцията cmdhist е активирана, многоредовите команди се запазват в историята с вградени newlines, а не с помощта на точка и запетая, където е възможно.
login_shell
Контейнера задава тази опция, ако тя се стартира като shell за вход (вижте INVOCATION по-горе). Стойността може да не се променя.
mailwarn
Ако е зададен, и файл, който bash проверява за поща, е бил достъпен от последния път, когато е бил отметнат, се появява съобщението `` Пощата в mailfile е четена ''.
no_empty_cmd_completion
Ако е зададено и се използва readline , bash няма да се опита да претърси PATH за евентуални завършвания, когато приключи опита на празен ред.
nocaseglob
Ако е зададена, bash съвпада с имената на файловете по начин, който не се отразява на случаите, когато се извършва разширение на пътя (вижте Разширяване на пътя по-горе).
nullglob
Ако е зададено, башът позволява модели, които не съвпадат с файлове (вижте Разширяване на пътя по-горе), за да се разшири до нулев низ, а не сами.
progcomp
Ако е зададена, програмираните възможности за завършване (вижте Програмируемо завършване по-горе) са активирани. Тази опция е активирана по подразбиране.
promptvars
Ако е зададена, променливите стрингове се променят и променят параметъра след като са били