rbash

NAZWA

SKŁADNIA

PRAWA AUTORSKIE

OPIS

OPCJE

-c

Jeśli występuje opcja -c, to polecenia odczytywane są z pierwszego argumentu, niebędącego opcją łańcucha_polecenia. Jeżeli po łańcuchu_polecenia istnieją argumenty, to pierwszy jest przypisywany do $0 a pozostałe są przypisywane do argumentów pozycyjnych. Przypisanie do $0 ustawia nazwę powłoki, co jest wykorzystywane przy ostrzeżeniach i komunikatach z błędami.

-i

Jeżeli występuje opcja -i, to powłoka jest interaktywna.

-l

Program bash będzie działał jakby został wywołany jako powłoka zgłoszeniowa (patrz niżej WYWOŁANIE).

-r

Jeżeli występuje opcja -r, to powłoka staje się powłoką okrojoną (restricted). Patrz poniżej POWŁOKA OKROJONA.

-s

If the -s option is present, or if no arguments remain after option processing, then commands are read from the standard input. This option allows the positional parameters to be set when invoking an interactive shell or when reading input through a pipe.

-v

Wypisuje wiersze wejściowe powłoki przy ich odczytywaniu.

-x

Print commands and their arguments as they are executed.

-D

Na standardowym wyjściu wypisywana jest lista łańcuchów cytowanych cudzysłowem poprzedzonych znakiem $. Są to łańcuchy będące przedmiotem tłumaczenia języka, gdy bieżącym ustawieniem regionalnym (locale) nie jest C ani POSIX. Implikuje to opcję -n; nie zostaną wykonane żadne polecenia.

[-+]O [opcja_shopt]

opcja_shopt jest jedną z opcji powłoki akceptowanych przez polecenie wbudowane shopt (zobacz WBUDOWANE POLECENIA POWŁOKI poniżej). Jeśli występuje opcja_shopt, to -O nadaje wartość tej opcji, zaś +O unieważnia ją. Jeżeli nie podano opcji_shopt, to na standardowym wyjściu wypisywane są nazwy i wartości opcji powłoki akceptowanych przez shopt. Jeśli opcją wywołania jest +O, tworzone wyjście jest formatowane w taki sposób, by można było wykorzystać je jako wejście.

--

Zapis -- sygnalizuje koniec opcji i wyłącza dalsze ich przetwarzanie. Argumenty występujące po -- traktowane są jako nazwy plików i argumenty. Argument - jest równoważnikiem --.

--debugger

Ustawia profil debuggera do wykonania, przed uruchomieniem powłoki. Włącza rozszerzony tryb debugowania (patrz opis opcji extdebug do wbudowanego polecenia shopt poniżej).

--dump-po-strings

Równoważne -D, ale wyjście jest w formacie pliku GNU gettext po (portable object).

--dump-strings

Równoważnik -D.

--help

Wyświetla na standardowym wyjściu komunikat o użytkowaniu i pomyślnie kończy pracę.

--init-file plik

--rcfile plik

Wykonuje polecenia z podanego pliku zamiast ze standardowego systemowego pliku inicjującego /etc/bash.bashrc i osobistego pliku inicjującego ~/.bashrc, jeśli powłoka jest interaktywna. Zobacz WYWOŁANIE poniżej.

--login

Równoważne -l.

--noediting

Nie używa biblioteki GNU readline do odczytu wierszy poleceń w trybie interaktywnym.

--noprofile

Nie odczytuje ani ogólnosystemowego pliku startowego /etc/profile ani żadnego z osobistych plików inicjujących ~/.bash_profile, ~/.bash_login czy ~/.profile. Domyślnie, bash czyta te pliki gdy jest wywołany jako powłoka zgłoszeniowa (zobacz WYWOŁANIE poniżej).

--norc

Nie odczytuje i nie wykonuje systemowego pliku inicjującego /etc/bash.bashrc oraz osobistego pliku inicjującego ~/.bashrc jeśli powłoka jest interaktywna. Opcja ta jest domyślnie włączona, jeżeli powłokę wywołano jako sh.

--posix

Zmienia zachowanie bash tam, gdzie domyślne działanie różni się od standardu POSIX, tak by spełniać standard ( tryb posix). Więcej informacji o tym, jak tryb posix wpływa na zachowanie powłoki można znaleźć w dokumencie do którego odsyła ZOBACZ TAKŻE.

--restricted

Powłoka staje się okrojona (zobacz POWŁOKA OKROJONA poniżej).

--verbose

Równoważnik opcji -v.

--version

Pokazuje na standardowym wyjściu informację o wersji tego egzemplarza bash i pomyślnie kończy pracę.

ARGUMENTY

WYWOŁANIE

DEFINICJE

odstęp

Spacja lub znak tabulacji.

słowo

Sekwencja znaków uważana przez powłokę za pojedynczą jednostkę. Znana też jako token.

nazwa

Jest to słowo składające się wyłącznie ze znaków alfanumerycznych i znaków podkreślenia, i rozpoczynające się znakiem alfabetycznym lub podkreśleniem. Wspominane również jako identyfikator.

metaznak

Znak, który, gdy nie jest cytowany, oddziela słowa. Jeden z poniższych:

 

operator sterujący

token pełniący funkcję sterującą. Jest to jeden z poniższych symboli:

SŁOWA ZASTRZEŻONE

GRAMATYKA POWŁOKI

Polecenia proste

Potoki

Listy

Polecenia złożone

(lista)

list is executed in a subshell (see COMMAND EXECUTION ENVIRONMENT below for a description of a subshell environment). Variable assignments and builtin commands that affect the shell's environment do not remain in effect after the command completes. The return status is the exit status of list.

{ lista; }

Lista jest po prostu wykonywana w bieżącym środowisku powłoki. Lista musi być zakończona znakiem nowej linii lub średnika. Nazywane jest to poleceniem grupowania. Zwracanym kodem jest kod zakończenia listy. Należy pamiętać, że w przeciwieństwie do metaznaków ( i ), { i } są słowami zastrzeżonymi i aby zostały rozpoznane muszą się pojawić tam, gdzie dozwolone jest użycie słów zastrzeżonych. Ponieważ nie powodują podziału na słowa, muszą być oddzielone od listy za pomocą białego znaku lub innego metaznaku powłoki.

((wyrażenie))

The expression is evaluated according to the rules described below under ARITHMETIC EVALUATION. If the value of the expression is non-zero, the return status is 0; otherwise the return status is 1. The expression undergoes the same expansions as if it were within double quotes, but double quote characters in expression are not treated specially and are removed.

[[ wyrażenie ]]

Return a status of 0 or 1 depending on the evaluation of the conditional expression expression. Expressions are composed of the primaries described below under CONDITIONAL EXPRESSIONS. The words between the [[ and ]] do not undergo word splitting and pathname expansion. The shell performs tilde expansion, parameter and variable expansion, arithmetic expansion, command substitution, process substitution, and quote removal on those words (the expansions that would occur if the words were enclosed in double quotes). Conditional operators such as -f must be unquoted to be recognized as primaries. Operatory < i >, gdy są używane z [[, sortują zgodnie z porządkiem leksykograficznym, używając bieżącego ustawienia locale.

for nazwa [ [ in [ słowo ... ] ] ; ] do lista ; done

Interpretowane są słowa następujące po in, tworząc listę elementów. Zmiennej nazwa nadawana jest kolejno wartość każdego elementu tej listy i każdorazowo wykonywana jest lista poleceń. Jeżeli pominięto in słowo, to polecenie for wykonuje listę po jednym razie dla każdego ustawionego parametru pozycyjnego (zobacz PARAMETRY poniżej). Zwracanym kodem jest kod zakończenia ostatniego wykonanego polecenia. Jeśli interpretacja elementów następujących po in daje w wyniku pustą listę, to nie są wykonywane żadne polecenia i zwracany jest kod 0.

for (( wyr1 ; wyr2 ; wyr3 )) ; do lista ; done

Na początku obliczane jest wyrażenie arytmetyczne wyr1, zgodnie z zasadami opisanymi poniżej w OBLICZANIE WYRAŻEŃ ARYTMETYCZNYCH. Następnie wielokrotnie obliczane jest wyr2, aż do osiągnięcia przez nie wartości zero. Każdorazowo gdy obliczone wyr2 jest niezerowe, wykonywana jest lista i obliczane jest wyrażenie arytmetyczne wyr3. Jeśli pominięto któreś z wyrażeń, to zachowuje się ono tak, jakby przyjmowało wartość 1. Zwracanym kodem jest kod zakończenia ostatniego wykonanego polecenia listy, lub fałsz jeśli któreś z wyrażeń jest niepoprawne.

select nazwa [ in słowo ] ; do lista ; done

The list of words following in is expanded, generating a list of items, and the set of expanded words is printed on the standard error, each preceded by a number. If the in word is omitted, the positional parameters are printed (see PARAMETERS below). select then displays the PS3 prompt and reads a line from the standard input. If the line consists of a number corresponding to one of the displayed words, then the value of name is set to that word. If the line is empty, the words and prompt are displayed again. If EOF is read, the select command completes and returns 1. Any other value read causes name to be set to null. The line read is saved in the variable REPLY. The list is executed after each selection until a break command is executed. The exit status of select is the exit status of the last command executed in list, or zero if no commands were executed.

case słowo in [ [(] wzorzec [ | wzorzec ] ... ) lista ;; ] ... esac

A case command first expands word, and tries to match it against each pattern in turn, using the matching rules described under Pattern Matching below. The word is expanded using tilde expansion, parameter and variable expansion, arithmetic expansion, command substitution, process substitution and quote removal. Each pattern examined is expanded using tilde expansion, parameter and variable expansion, arithmetic expansion, command substitution, process substitution, and quote removal. If the nocasematch shell option is enabled, the match is performed without regard to the case of alphabetic characters. When a match is found, the corresponding list is executed. If the ;; operator is used, no subsequent matches are attempted after the first pattern match. Using ;& in place of ;; causes execution to continue with the list associated with the next set of patterns. Using ;;& in place of ;; causes the shell to test the next pattern list in the statement, if any, and execute any associated list on a successful match, continuing the case statement execution as if the pattern list had not matched. The exit status is zero if no pattern matches. Otherwise, it is the exit status of the last command executed in list.

if lista; then lista; [ elif lista; then lista; ] ... [ else lista; ] fi

Wykonywana jest lista występująca po if. Jeżeli jej kod zakończenia jest zerowy, to wykonywana jest lista klauzuli then. W przeciwnym wypadku, wykonywana jest lista każdego elif po kolei; jeśli kod zakończenia którejś wynosi 0, to wykonywana jest lista then i polecenie jest kończone. Jeżeli nie wystąpił żaden z powyższych przypadków, to wykonywana jest lista występująca po klauzuli else, jeśli takowa istnieje. Kodem zakończenia jest kod ostatniego wykonanego polecenia listy lub zero jeśli żaden z warunków nie okazał się prawdziwy.

while lista-1; do lista-2; done

until lista-1; do lista-2; done

Polecenie while wykonuje listę lista-2 w sposób ciągły dopóty, dopóki ostatnie polecenie listy lista-1 nie zwróci kodu zakończenia równego zero. Polecenie until działa podobnie do polecenia while, a jedyną różnicą jest to, że test jest zanegowany: lista-2 jest wykonywana tak długo, aż ostatnie polecenie listy-1 nie zwróci kodu zakończenia różnego od zera. Kod wyjścia poleceń while i until jest kodem zakończenia ostatniego polecenia wykonanego z listy-2 lub zerem, jeśli żadne z nich nie zostało wykonane.

Koprocesy (współprocesy)

Definiowanie funkcji powłoki

fname () compound-command [redirection]

function fname [()] compound-command [redirection]

This defines a function named fname. The reserved word function is optional. If the function reserved word is supplied, the parentheses are optional. The body of the function is the compound command compound-command (see Compound Commands above). That command is usually a list of commands between { and }, but may be any command listed under Compound Commands above. If the function reserved word is used, but the parentheses are not supplied, the braces are recommended. compound-command is executed whenever fname is specified as the name of a simple command. When in posix mode, fname must be a valid shell name and may not be the name of one of the POSIX special builtins. In default mode, a function name can be any unquoted shell word that does not contain $. Any redirections (see REDIRECTION below) specified when a function is defined are performed when the function is executed. The exit status of a function definition is zero unless a syntax error occurs or a readonly function with the same name already exists. When executed, the exit status of a function is the exit status of the last command executed in the body. (See FUNCTIONS below.)

KOMENTARZE

CYTOWANIE

PARAMETRY

Parametry pozycyjne

Parametry specjalne

*

Interpretowane jest jako parametry pozycyjne, począwszy od pierwszego. Gdy interpretacja nie pojawia się wewnątrz cudzysłowów, każdy parametr pozycyjny jest interpretowany jako oddzielne słowo. W kontekście w jakim występują, te słowa ulegają kolejnemu podziałowi na słowa i rozwijaniu ścieżek. Gdy interpretacja pojawia się wewnątrz cudzysłowów, to parametr ten interpretowany jest jako pojedyncze słowo z wartościami każdego z parametrów rozdzielonymi pierwszym znakiem zmiennej specjalnej IFS. To znaczy, " $*" jest równoważne " $1c$2c...", gdzie c jest pierwszym znakiem wartości zmiennej IFS. Jeżeli IFS nie jest ustawione, to parametry oddzielane są spacjami. Jeśli IFS jest łańcuchem pustym, to parametry są ze sobą połączone bez rozdzielających je separatorów.

@

Expands to the positional parameters, starting from one. In contexts where word splitting is performed, this expands each positional parameter to a separate word; if not within double quotes, these words are subject to word splitting. In contexts where word splitting is not performed, this expands to a single word with each positional parameter separated by a space. When the expansion occurs within double quotes, each parameter expands to a separate word. That is, " $@" is equivalent to " $1" "$2" ... If the double-quoted expansion occurs within a word, the expansion of the first parameter is joined with the beginning part of the original word, and the expansion of the last parameter is joined with the last part of the original word. When there are no positional parameters, " $@" and $@ expand to nothing (i.e., they are removed).

#

Interpretowane jako liczba parametrów pozycyjnych, podana dziesiętnie.

?

Interpretowane jako kod zakończenia ostatnio wykonanego potoku pierwszoplanowego.

-

Interpretowane jako bieżące flagi opcji, takie jakie zostały podane podczas wywołania, ustawione przy pomocy wbudowanego polecenia set lub ustawione przez samą powłokę (tak jak opcja -i).

$

Expands to the process ID of the shell. In a subshell, it expands to the process ID of the current shell, not the subshell.

!

Interpretowany jako ID procesu ostatnio wykonywanego polecenia tła, gdy jest wykonywane jako polecenie asynchroniczne lub używając słowa wbudowanego bg (zob. niżej KONTROLA ZADAŃ).

0

Interpretowany jako nazwa powłoki lub skryptu powłoki. Ustawiane jest to na etapie inicjowania powłoki. Jeżeli bash wywoływany został z plikiem poleceń, to $0 ustawiane jest na nazwę tego pliku. Jeśli bash został uruchomiony z opcją -c, to $0 jest ustawiane na pierwszy argument po łańcuchu, jaki ma zostać wywołany, jeśli taki występuje. W przeciwnym wypadku, ustawiany jest na nazwę pliku użytą do wywołania bash, jaką podaje argument zerowy.

Zmienne powłoki

_

At shell startup, set to the pathname used to invoke the shell or shell script being executed as passed in the environment or argument list. Subsequently, expands to the last argument to the previous simple command executed in the foreground, after expansion. Also set to the full pathname used to invoke each command executed and placed in the environment exported to that command. When checking mail, this parameter holds the name of the mail file currently being checked.

BASH

Interpretowane jako pełna nazwa pliku użyta do wywołania tego przebiegu bash.

BASHOPTS

Oddzielana dwukropkiem lista włączonych opcji powłoki. Każde słowo na liście jest poprawnym argumentem do opcji -s wbudowanego polecenia shopt (patrz WBUDOWANE POLECENIA POWŁOKI poniżej). Opcje pojawiające się w BASHOPTS są tymi, które są raportowane jako włączone (on) przez shopt. Jeśli ta zmienna występuje w środowisku podczas uruchamiania bash, to każda opcja powłoki z listy będzie włączona przed odczytaniem plików startowych. Ta zmienna jest tylko do odczytu.

BASHPID

Expands to the process ID of the current bash process. This differs from $$ under certain circumstances, such as subshells that do not require bash to be re-initialized. Assignments to BASHPID have no effect. If BASHPID is unset, it loses its special properties, even if it is subsequently reset.

BASH_ALIASES

Zmienna tablicy asocjacyjnej, której wpisy odpowiadają wewnętrznej liście aliasów zarządzanych przez wbudowane polecenie alias. Elementy dodawane do tablicy pojawiają się na liście aliasów, jednak usunięcie elementów tablicy obecnie nie powoduje usunięcie aliasów z listy aliasów. Jeśli BASH_ALIASES zostanie skasowana, traci swoje specjalne właściwości, nawet jeśli zostanie później zresetowana.

BASH_ARGC

An array variable whose values are the number of parameters in each frame of the current bash execution call stack. The number of parameters to the current subroutine (shell function or script executed with . or source) is at the top of the stack. When a subroutine is executed, the number of parameters passed is pushed onto BASH_ARGC. The shell sets BASH_ARGC only when in extended debugging mode (see the description of the extdebug option to the shopt builtin below). Setting extdebug after the shell has started to execute a script, or referencing this variable when extdebug is not set, may result in inconsistent values.

BASH_ARGV

An array variable containing all of the parameters in the current bash execution call stack. The final parameter of the last subroutine call is at the top of the stack; the first parameter of the initial call is at the bottom. When a subroutine is executed, the parameters supplied are pushed onto BASH_ARGV. The shell sets BASH_ARGV only when in extended debugging mode (see the description of the extdebug option to the shopt builtin below). Setting extdebug after the shell has started to execute a script, or referencing this variable when extdebug is not set, may result in inconsistent values.

BASH_ARGV0

When referenced, this variable expands to the name of the shell or shell script (identical to $0; see the description of special parameter 0 above). Assignment to BASH_ARGV0 causes the value assigned to also be assigned to $0. If BASH_ARGV0 is unset, it loses its special properties, even if it is subsequently reset.

BASH_CMDS

Zmienna tablicy asocjacyjnej, której wpisy odpowiadają wewnętrznej liście skrótów poleceń, zarządzanej przez wbudowane polecenie hash. Elementy dodawane do tablicy pojawiają się na liście skrótów, jednak usunięcie elementów tablicy obecnie nie powoduje powoduje usunięcia ich z tablicy skrótów. Jeśli BASH_CMDS zostanie skasowana, traci swoje specjalne właściwości, nawet jeśli zostanie później zresetowana.

BASH_COMMAND

The command currently being executed or about to be executed, unless the shell is executing a command as the result of a trap, in which case it is the command executing at the time of the trap. If BASH_COMMAND is unset, it loses its special properties, even if it is subsequently reset.

BASH_EXECUTION_STRING

Argument polecenia do opcji wywołania -c.

BASH_LINENO

Zmienna tablicowa, której wartościami są numery wierszy plików źródłowych, w których przywołano każdy odpowiednik ze zmiennej FUNCNAME. ${BASH_LINENO[$i]} jest numerem wiersza w pliku źródłowym ( ${BASH_SOURCE[ $i+1]}), gdzie przywołano ${FUNCNAME[ $i]} (lub ${BASH_LINENO[$i-1 ]}, jeśli odnosi się do innej funkcji powłoki). Proszę użyć LINENO, aby pobrać bieżący numer wiersza.

BASH_LOADABLES_PATH

Lista rozdzielonych dwukropkami katalogów, w których powłoka szuka dynamicznie ładowalnych poleceń wbudowanych podanych przez polecenie enable.

BASH_REMATCH

Zmienna tablicowa, której wartości są przypisywane operatorem dwuargumentowym =~ do polecenia warunkowego [[. Element o indeksie 0 jest częścią łańcucha pasującego do całego wyrażenia regularnego. Element o indeksie n jest częścią łańcucha pasującego do n-tego podwyrażenia ujętego w nawiasy.

BASH_SOURCE

Zmienna tablicowa, której wartościami są nazwy plików źródłowych, w których zdefiniowano odpowiadające nazwy funkcji powłoki w zmiennej tablicowej FUNCNAME. Funkcja powłoki ${FUNCNAME[$i]} jest zdefiniowana w pliku ${BASH_SOURCE[$i]} i wywoływana z ${BASH_SOURCE[$i+1]}..

BASH_SUBSHELL

Incremented by one within each subshell or subshell environment when the shell begins executing in that environment. The initial value is 0. If BASH_SUBSHELL is unset, it loses its special properties, even if it is subsequently reset.

BASH_VERSINFO

Zmienna tablicowa tylko do odczytu, której elementy zawierają informacje o wersji uruchomionego bash. Wartości przypisane elementom tablicy są następujące:

BASH_VERSION

Interpretowane jako łańcuch opisujący wersję uruchomionego bash.

COMP_CWORD

Indeks w ${COMP_WORDS} słowa zawierającego bieżącą pozycję kursora. Zmienna ta jest dostępna wyłącznie w funkcjach powłoki wywołanych przez usługi programowalnego uzupełniania (zobacz poniżej Programowalne uzupełnianie).

COMP_KEY

Klawisz (lub ostatni klawisz w sekwencji klawiszy) użyty do wywołania bieżącej funkcji uzupełniania.

COMP_LINE

Bieżący wiersz poleceń. Ta zmienna jest dostępna tylko w funkcjach powłoki i poleceniach zewnętrznych wywoływanych przez usługi programowalnego uzupełniania (zobacz poniżej Programowalne uzupełnianie).

COMP_POINT

Indeks bieżącej pozycji kursora względem początku bieżącego polecenia. Jeżeli kursor jest na końcu bieżącego polecenia, to wartość tej zmiennej jest równa ${#COMP_LINE}. Ta zmienna jest dostępna tylko w funkcjach powłoki i poleceniach zewnętrznych wywoływanych przez usługi programowalnego uzupełniania (zobacz poniżej Programowalne uzupełnianie).

COMP_TYPE

Ustawiana na wartość całkowitą odpowiadającą typowi uzupełnienia, którego próbę przeprowadzono, które spowodowało wywołanie funkcji uzupełnienia: TAB, do normalnego uzupełnienia, ?, do wypisywania uzupełnień po udanej tabulacji, !, do wypisywania alternatyw częściowego uzupełnienia słowa, @, do wypisania uzupełnień, jeśli słowo nie zostało zmodyfikowane lub %, do uzupełnienia menu. Zmienna ta jest dostępna tylko w funkcjach powłoki i zewnętrznych poleceniach wywołanych przez narzędzia programowalnego uzupełnienia powłoki (patrz poniżej Programowalne uzupełnienie).

COMP_WORDBREAKS

Zestaw znaków traktowanych przez bibliotekę readline jako separatory słów, podczas przeprowadzania uzupełnień słów. Jeśli unieważniono COMP_WORDBREAKS, to traci swe specjalne właściwości, nawet jeżeli jest następnie ponownie ustawiona.

COMP_WORDS

Zmienna tablicowa (patrz Tablice poniżej) składająca się z pojedynczych słów z aktualnego wiersza poleceń. Wiersz jest dzielony na słowa tak, jak podzieliłby go readline, używając COMP_WORDBREAKS, zgodnie z opisem powyżej. Zmienna ta jest dostępna wyłącznie w funkcjach powłoki wywołanych przez usługi programowalnego uzupełniania (zobacz poniżej Programowalne uzupełnianie).

COPROC

Zmienna tablicowa (patrz poniżej Tablice) tworzona do zatrzymania deskryptorów plików z wyjścia lub wejścia nienazwanych koprocesów (zobacz Koprocesy (współprocesy) powyżej).

DIRSTACK

Zmienna tablicowa (zobacz Tablice poniżej) zawierająca bieżącą zawartość stosu katalogów. Katalogi pojawiają się na stosie w kolejności, w jakiej są wyświetlane przez wbudowane dirs. Przypisanie do elementów tej zmiennej tablicowej może posłużyć do zmiany katalogów już występujących na stosie, ale do dodania i usunięcia katalogów muszą być użyte wbudowane pushd i popd. Przypisanie wartości tej zmiennej nie zmieni bieżącego katalogu. Jeśli DIRSTACK jest unieważnione, to traci swe specjalne właściwości, nawet jeżeli jest następnie ponownie ustawione.

EPOCHREALTIME

Each time this parameter is referenced, it expands to the number of seconds since the Unix Epoch (see time(3)) as a floating point value with micro-second granularity. Assignments to EPOCHREALTIME are ignored. If EPOCHREALTIME is unset, it loses its special properties, even if it is subsequently reset.

EPOCHSECONDS

Each time this parameter is referenced, it expands to the number of seconds since the Unix Epoch (see time(3)). Assignments to EPOCHSECONDS are ignored. If EPOCHSECONDS is unset, it loses its special properties, even if it is subsequently reset.

EUID

Interpretowane jako efektywny identyfikator bieżącego użytkownika, inicjowane przy uruchamianiu powłoki. Zmienna ta jest tylko do odczytu.

FUNCNAME

Zmienna tablicowa zawierająca nazwy wszystkich funkcji powłoki obecnych w stosie wywołań. Element z indeksem 0 jest nazwą aktualnie wykonywanej funkcji powłoki. Najniższy element (tzn. z najwyższym numerem indeksu) to "main". Zmienna istnieje tylko gdy wykonywana jest funkcja powłoki. Przypisania do FUNCNAME nie odnoszą skutku. Jeśli FUNCNAME jest unieważniona, to traci swe specjalne właściwości, nawet jeśli jest następnie ponownie ustawiona. Zmienna ta może zostać użyta razem z BASH_LINENO i BASH_SOURCE. Każdy element FUNCNAME ma swój odpowiednik w BASH_LINENO i BASH_SOURCE opisujący stos wywołania. Na przykład, ${FUNCNAME[$i]} została wywołana z pliku ${BASH_SOURCE[$i+1]} w wierszu o numerze ${BASH_LINENO[ $i]}. Wbudowane polecenie caller wyświetla bieżący stos wywołania używając tej informacji.

GROUPS

Zmienna tablicowa zawierająca listę grup, których członkiem jest bieżący użytkownik. Próby przypisywania wartości do GROUPS nie odnoszą efektu. Jeżeli GROUPS jest unieważnione, to traci swe specjalne właściwości, nawet jeżeli jest następnie ponownie ustawione.

HISTCMD

The history number, or index in the history list, of the current command. Assignments to HISTCMD are ignored. If HISTCMD is unset, it loses its special properties, even if it is subsequently reset.

HOSTNAME

Automatycznie ustawiane na nazwę aktualnego hosta.

HOSTTYPE

Automatycznie ustawiane na łańcuch unikalnie opisujący typ maszyny, na której jest wykonywany bash. Wartość domyślna zależy od systemu.

LINENO

Przy każdym odwołaniu do tego parametru powłoka zastępuje jego wartość liczbą dziesiętną reprezentującą aktualny kolejny numer wiersza (poczynając od 1) skryptu lub funkcji. Nie zapewnia się, by wartość ta miała znaczenie poza skryptem bądź funkcją. Jeśli LINENO jest unieważnione, to traci swe specjalne właściwości, nawet jeżeli jest następnie ponownie ustawione.

MACHTYPE

Automatycznie ustawiane na łańcuch w pełni opisujący typ systemu, na którym jest wykonywany bash, w standardowym formacie GNU cpu-firma-system. Wartość domyślna zależy od systemu.

MAPFILE

Zmienna tablicowa (patrz Tablice poniżej) tworzona do zatrzymania tekstu odczytywanego przez wbudowane polecenie mapfile, gdy nie podano nazwy zmiennej.

OLDPWD

Poprzedni katalog roboczy ustawiony poleceniem cd.

OPTARG

Wartość ostatniego, będącego opcją, argumentu przetworzonego przez wbudowane polecenie getopts (zobacz poniżej WBUDOWANE POLECENIA POWŁOKI).

OPTIND

Numer (indeks) następnego argumentu, jaki ma zostać przetworzony przez wbudowane polecenie getopts (zobacz poniżej WBUDOWANE POLECENIA POWŁOKI).

OSTYPE

Automatycznie ustawiane na łańcuch opisujący system operacyjny, w którym jest wykonywany bash. Wartość domyślna zależy od systemu.

PIPESTATUS

Zmienna tablicowa (zobacz Tablice poniżej) zwierająca listę kodów zakończenia z procesów w ostatnio wykonywanym potoku pierwszoplanowym (który może zawierać pojedyncze polecenie).

PPID

Identyfikator procesu macierzystego powłoki. Zmienna ta jest tylko do odczytu.

PWD

Bieżący katalog roboczy, ustawiony poleceniem cd.

RANDOM

Each time this parameter is referenced, it expands to a random integer between 0 and 32767. Assigning a value to RANDOM initializes (seeds) the sequence of random numbers. If RANDOM is unset, it loses its special properties, even if it is subsequently reset.

READLINE_ARGUMENT

Any numeric argument given to a readline command that was defined using "bind -x" (see SHELL BUILTIN COMMANDS below) when it was invoked.

READLINE_LINE

Zawartość bufora wiersza realine, do użycia z "bind -x" (patrz WBUDOWANE POLECENIA POWŁOKI poniżej).

READLINE_MARK

The position of the mark (saved insertion point) in the readline line buffer, for use with "bind -x" (see SHELL BUILTIN COMMANDS below). The characters between the insertion point and the mark are often called the region.

READLINE_POINT

Pozycja punktu wprowadzania w buforze wiersza readline, do użycia z "bind -x" (patrz WBUDOWANE POLECENIA POWŁOKI poniżej).

REPLY

Ustawiona na wiersz wejścia odczytany wbudowanym poleceniem read jeśli nie podano żadnych jego argumentów.

SECONDS

Each time this parameter is referenced, it expands to the number of seconds since shell invocation. If a value is assigned to SECONDS, the value returned upon subsequent references is the number of seconds since the assignment plus the value assigned. The number of seconds at shell invocation and the current time are always determined by querying the system clock. If SECONDS is unset, it loses its special properties, even if it is subsequently reset.

SHELLOPTS

Lista, rozdzielonych dwukropkami, włączonych opcji powłoki. Każde słowo listy jest poprawnym argumentem opcji -o wbudowanego polecenia set (zobacz WBUDOWANE POLECENIA POWŁOKI poniżej). Opcje pojawiające się w SHELLOPTS to te, które są zgłaszane jako włączone ( on) przez set -o. Jeśli zmienna ta istnieje w środowisku podczas uruchamiania bash, to każda z opcji powłoki występująca na tej liście zostanie włączona przed odczytem jakichkolwiek plików startowych. Jest to zmienna tylko do odczytu.

SHLVL

Inkrementowana każdorazowo, gdy uruchamiane jest kolejne wystąpienie bash.

SRANDOM

This variable expands to a 32-bit pseudo-random number each time it is referenced. The random number generator is not linear on systems that support /dev/urandom or arc4random, so each returned number has no relationship to the numbers preceding it. The random number generator cannot be seeded, so assignments to this variable have no effect. If SRANDOM is unset, it loses its special properties, even if it is subsequently reset.

UID

Interpretowane jako identyfikator bieżącego użytkownika, inicjowane przy uruchamianiu powłoki. Zmienna ta jest tylko do odczytu.

BASH_COMPAT

The value is used to set the shell's compatibility level. See SHELL COMPATIBILITY MODE below for a description of the various compatibility levels and their effects. The value may be a decimal number (e.g., 4.2) or an integer (e.g., 42) corresponding to the desired compatibility level. If BASH_COMPAT is unset or set to the empty string, the compatibility level is set to the default for the current version. If BASH_COMPAT is set to a value that is not one of the valid compatibility levels, the shell prints an error message and sets the compatibility level to the default for the current version. The valid values correspond to the compatibility levels described below under SHELL COMPATIBILITY MODE. For example, 4.2 and 42 are valid values that correspond to the compat42 shopt option and set the compatibility level to 42. The current version is also a valid value.

BASH_ENV

Jeżeli parametr ten jest ustawiony podczas wykonywania przez bash skryptu, to jego wartość interpretowana jest jako nazwa pliku zawierającego polecenia do zainicjowania powłoki, jak w ~/.bashrc. Wartość BASH_ENV podlega interpretacji parametrów, podstawianiu wyników poleceń i interpretacjom wyrażeń arytmetycznych przed interpretacją jej jako nazwy pliku. Zmienna PATH nie jest używana do znalezienia pliku o powstałej w ten sposób nazwie.

BASH_XTRACEFD

Jeśli ustawiono liczbę całkowitą odpowiadającą poprawnemu deskryptorowi pliku, to bash zapisze wyjście stosu wygenerowane gdy set -x jest włączone do tego deskryptora pliku. Deskryptor pliku jest zamykany gdy BASH_XTRACEFD jest usuwana lub przy przypisaniu nowej wartości. Usunięcie BASH_XTRACEFD lub przypisanie jej łańcucha pustego powoduje wysłanie stosu na standardowe wyjście błędów. Proszę zauważyć, że ustawienie BASH_XTRACEFD na 2 (deskryptor pliku wyjścia błędów), a następnie usunięcie jej spowoduje zamknięcie standardowego wyjścia błędów.

CDPATH

Ścieżka wyszukiwania dla polecenia cd. Jest to lista rozdzielonych dwukropkami katalogów, w których powłoka szuka katalogów docelowych podanych przez polecenie cd. Przykładową wartością jest ".:~:/usr".

CHILD_MAX

Ustawia liczbę wartości kodów wyjścia zakończonych procesów potomnych, które ma zapamiętać powłoka. Bash nie pozwoli na zmniejszenie tej wartości poniżej minimum określonego normą POSIX, istnieje również wartość maksymalna (obecnie 8192), której nie można przekroczyć. Minimalna wartość jest zależna od systemu.

COLUMNS

Używana przez polecenie wbudowane select do wyznaczenia szerokości terminala przy wypisywaniu list wyboru. Ustawiana automatycznie, gdy włączono opcję checkwinsize oraz w powłoce interaktywnej po otrzymaniu SIGWINCH.

COMPREPLY

Zmienna tablicowa, z której bash czyta możliwe uzupełnienia tworzone przez funkcję powłoki wywołaną przez usługę programowalnego uzupełniania (zobacz poniżej Programowalne uzupełnianie). Każdy element tablicy zawiera jedno możliwe uzupełnienie.

EMACS

Gdy bash znajdzie opisywaną zmienną w środowisku podczas uruchamiania powłoki, z wartością ustawioną na "t", to przyjmuje, że powłoka działa w buforze powłoki Emacsa i wyłącza edycję wiersza.

ENV

Expanded and executed similarly to BASH_ENV (see INVOCATION above) when an interactive shell is invoked in posix mode.

EXECIGNORE

Lista oddzielonych dwukropkami wzorców powłoki (zob. Dopasowanie wzorca) definiujących listę nazw plików ignorowanych przy szukaniu poleceń za pomocą  PATH. Pliki których pełna ścieżka pasuje do jednego z tych wzorców nie są traktowane jako pliki wykonywalne dla dopełniania i wykonywania poleceń przez PATH. Nie wpływa to na zachowanie poleceń [, test oraz [[. Pełne ścieżki w liście skrótów poleceń nie są przedmiotem EXECIGNORE. Tę zmienną należy używać do ignorowania plików bibliotek współdzielonych, które mają ustawione prawo wykonywania, ale nie są plikami wykonywalnymi. Dopasowanie wzorców przestrzega ustawień opcji powłoki extglob.

FCEDIT

Domyślny edytor dla wbudowanego polecenia fc.

FIGNORE

Lista rozdzielonych dwukropkami przyrostków, jakie mają być ignorowane podczas uzupełniania nazw plików (zobacz READLINE poniżej). Nazwa pliku o przyrostku pasującym do jednej z pozycji FIGNORE wyłączana jest z listy dopasowanych nazw plików. Przykładową wartością jest ".o:~" (cytowanie jest niezbędne przy przypisywaniu do tej zmiennej wartości zawierającej tyldy).

FUNCNEST

Gdy jest ustawiona na wartość numeryczną większą od zera, definiuje maksymalny poziom zagnieżdżenia funkcji. Wywołania funkcji przekraczające określony poziom będą powodowały przerwanie bieżącego polecenia.

GLOBIGNORE

A colon-separated list of patterns defining the set of file names to be ignored by pathname expansion. If a file name matched by a pathname expansion pattern also matches one of the patterns in GLOBIGNORE, it is removed from the list of matches.

HISTCONTROL

Lista rozdzielonych dwukropkami wartości, określającymi sposób zapisywania w liście historii. Jeżeli posiada wartość ignorespace, to wiersze rozpoczynające się od znaku spacji nie są wprowadzane do listy historii. Jeśli posiada wartość ignoredups, to wiersze pasujące do ostatniego wiersza historii nie są wprowadzane. Wartość ignoreboth łączy obie te możliwości. Wartość erasedups powoduje usunięcie z historii wszystkich wcześniejszych wierszy, pasujących do bieżącego, przed zapisaniem listy. Wszystkie wartości poza wymienionymi powyżej są ignorowane. Jeśli zmienna ta nie jest zdefiniowana lub ma wartość inną od powyższych, to wszystkie wiersze przeczytane przez analizator składni zachowywane są w liście historii, stosownie do wartości HISTIGNORE. Drugi i kolejne wiersze złożonego polecenia wielowierszowego nie są sprawdzane i są dodawane do historii bez względu na wartość HISTCONTROL.

HISTFILE

Nazwa pliku, w którym zachowywana jest historia poleceń (zobacz HISTORIA poniżej). Wartością domyślną jest ~/.bash_history. Jeśli ustawienie tej zmiennej zostanie skasowane, to historia poleceń nie będzie zachowana po zakończeniu pracy powłoki.

HISTFILESIZE

Maksymalna liczba wierszy zawartych w pliku historii. Podczas przypisywania wartości tej zmiennej, jeżeli jest to niezbędne, plik historii jest obcinany tak, by nie zawierał więcej wierszy, przez usunięcie najstarszych wpisów. Plik historii jest także obcinany do tego rozmiaru po zapisaniu go w czasie kończenia pracy przez powłokę. Jeśli wartość wynosi 0, plik historii jest obcinany do zera. Wartości nienumeryczne i wartości numeryczne mniejsze niż zero wstrzymują obcinanie. Powłoka ustawia wartość domyślną do wartości HISTSIZE po odczytaniu plików początkowych powłoki.

HISTIGNORE

Lista rozdzielonych dwukropkami wzorców służących do decydowania, jakie wiersze poleceń powinny być zachowane w liście historii. Każdy z wzorców zakotwiczony jest na początku wiersza i musi pasować do całego wiersza (nie jest dodawane żadne niejawne ` *'). Każdy z wzorców sprawdzany jest z bieżącym wierszem po wykonaniu kontroli określonych przez HISTCONTROL. Oprócz zwykłych znaków dopasowywania wzorców używanych przez powłokę, ` &' dopasowuje poprzedni wiersz historii. Literał ` &' można uzyskać poprzedzając go odwrotnym ukośnikiem; odwrotny ukośnik jest usuwany przed próbą dopasowania. Druga i kolejne wiersze złożonego polecenia wielowierszowego nie są sprawdzane i są dodawane do historii bez względu na wartość HISTIGNORE. Dopasowanie wzorców honoruje ustawienia opcji powłoki extglob.

HISTSIZE

Liczba poleceń do zapamiętania w historii poleceń (zob. HISTORIA poniżej). Jeśli wartość wynosi 0, polecenia nie są zachowywane w historii. Wartości numeryczne mniejsze niż zero powodują, że każde polecenie jest zapamiętywane w historii (znosi limit). Powłoka ustawia wartość domyślną 500 po odczytaniu plików początkowych powłoki.

HISTTIMEFORMAT

Gdy ta zmienna jest ustawiona i nie jest pusta, jej wartość jest użyta jak format łańcucha do strftime(3), w celu wyświetlenia pieczątki czasowej związanej z każdym wpisem historii, wyświetlanym przez wbudowane polecenie history. Gdy zmienna jest ustawiona, pieczątki czasowe są zapisywane do pliku historii, dzięki czemu mogą być zachowywane między sesjami powłoki. Używany jest wówczas znak komentarza historii, aby odróżnić pieczątki czasowe od pozostałych wierszy historii.

HOME

Katalog domowy bieżącego użytkownika; domyślny argument wbudowanego polecenia cd. Wartość tej zmiennej wykorzystywana jest też przy wykonywaniu interpretacji tyld.

HOSTFILE

Zawiera nazwę pliku o tym samym formacie co /etc/hosts który powinien być czytany, gdy powłoka potrzebuje uzupełnić nazwę hosta. Listę możliwych uzupełnień można zmieniać podczas pracy powłoki. Następnym razem, gdy wykonywana jest próba uzupełnienia nazwy hosta bash dodaje zawartość nowego pliku do już istniejącej listy. Jeżeli HOSTFILE jest ustawione, ale nie posiada wartości, bash usiłuje uzyskać listę możliwych uzupełnień nazw hostów czytając /etc/hosts Gdy HOSTFILE jest unieważniane, lista hostów jest czyszczona.

IFS

Wewnętrzny Separator Pól (Internal Field Separator) używany do podziału na słowa po interpretacjach i dzieleniu wierszy na słowa we wbudowanym poleceniu read. Jego domyślną wartością jest ,,<spacja><tabulacja><nowalinia>”.

IGNOREEOF

Steruje działaniem powłoki interaktywnej przy otrzymaniu przez nią znaku EOF jako jedynego znaku wejścia. Jeżeli jest ustawiona, to jej wartość jest liczbą kolejnych znaków EOF jakie muszą być wpisane jako pierwsze znaki wiersza wprowadzania przed zakończeniem pracy przez bash. Jeśli zmienna ta istnieje, ale nie zawiera wartości numerycznej lub nie ma wartości, to wartością domyślną jest 10. Jeżeli nie istnieje, to EOF wskazuje powłoce koniec wprowadzanych danych.

INPUTRC

Nazwa pliku startowego dla readline, unieważniająca domyślny plik ~/.inputrc (zobacz READLINE poniżej).

INSIDE_EMACS

If this variable appears in the environment when the shell starts, bash assumes that it is running inside an Emacs shell buffer and may disable line editing, depending on the value of TERM.

LANG

Służy do wyznaczania kategorii locale dla wszystkich kategorii nie wyszczególnionych przez zmienne rozpoczynające się od znaków LC_.

LC_ALL

Zmienna ta unieważnia wartość LANG i wszelkich innych zmiennych LC_ określających kategorie locale.

LC_COLLATE

Ta zmienna wyznacza kolejność (collation order) używaną przy sortowaniu wyników rozwijania nazw plików, decyduje też o zachowaniu wielu wyrażeń, klas równoważnych i sekwencje sortowania (collating sequences) w rozwijaniu nazw plików i dopasowywaniu wzorców.

LC_CTYPE

Ta zmienna decyduje o interpretacji znaków i zachowaniu się klas znaków wewnątrz rozwijania nazw plików i dopasowywania wzorców.

LC_MESSAGES

Ta zmienna decyduje o ustawieniu locale używanym do tłumaczenia ujętych w cudzysłowy łańcuchów poprzedzonych znakiem $.

LC_NUMERIC

Ta zmienna określa kategorię locale używaną do formatowania liczb.

LC_TIME

Ta zmienna określa kategorię locale używaną do formatowania daty i czasu.

LINES

Używana przez polecenie wbudowane select do wyznaczenia długości kolumn przy wypisywaniu list wyboru. Ustawiana automatycznie gdy włączono opcję checkwinsize oraz w powłoce interaktywnej po otrzymaniu po otrzymaniu SIGWINCH.

MAIL

Jeżeli parametrowi temu jest przypisana nazwa pliku, a nie jest ustawiona zmienna MAILPATH, to bash informuje użytkownika o nadejściu poczty do podanego pliku lub katalogu w formacie Maildir.

MAILCHECK

Określa jak często (w sekundach) bash sprawdza pocztę. Domyślnie jest to 60 sekund. Gdy nadchodzi pora sprawdzenia poczty, powłoka wykonuje to przed wyświetleniem głównej zachęty. Jeśli zmienna ta nie jest ustawiona lub jest ustawiona na wartość nie większą od zera lub zero, to powłoka wyłącza sprawdzanie poczty.

MAILPATH

Lista rozdzielonych dwukropkami nazw plików, w jakich ma być sprawdzana poczta. Można podać komunikat, jaki ma zostać wyświetlony, gdy do danego pliku przybędzie wiadomość pocztowa, przez oddzielenie nazwy pliku od komunikatu znakiem '?'. Użyte w tekście komunikatu, $_ interpretowane jest jako nazwa bieżącego pliku pocztowego. Przykład:

OPTERR

Jeżeli ustawiono na wartość 1, bash wyświetla komunikaty o błędach generowanych przez wbudowane polecenie getopts (zobacz WBUDOWANE POLECENIA POWŁOKI poniżej). OPTERR inicjowane jest na 1 każdorazowo, gdy wywoływana jest powłoka lub wykonywany jest skrypt powłoki.

PATH

Ścieżka wyszukiwania poleceń. Jest to lista rozdzielanych dwukropkami katalogów, w których powłoka szuka poleceń (zobacz WYKONYWANIE POLECEŃ poniżej). Nazwa katalogu zerowej długości (pusta) oznacza katalog bieżący. Pusty katalog można podać jako dwa złączone dwukropki lub początkowy albo końcowy dwukropek. Domyślna ścieżka zależy od systemu i ustawiana jest przez administratora instalującego bash. Powszechną wartością jest ``/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin''.

POSIXLY_CORRECT

Jeśli podczas uruchamiania bash w środowisku istnieje ta zmienna, to powłoka przed odczytem plików startowych wchodzi w tryb posix, tak jakby przy jej wywołaniu podano opcję --posix. Jeśli zmienna ta zostanie ustawiona podczas pracy powłoki, to bash włącza tryb posix, tak jakby zostało wykonane polecenie set -o posix had been executed. When the shell enters posix mode, it sets this variable if it was not already set.

PROMPT_COMMAND

If this variable is set, and is an array, the value of each set element is executed as a command prior to issuing each primary prompt. If this is set but not an array variable, its value is used as a command to execute instead.

PROMPT_DIRTRIM

Gdy jest ustawiona na liczbę większa od zera, jej wartość jest używana jako liczba początkowych składowych katalogów do usunięcia podczas interpretowania sekwencji specjalnych łańcucha zachęty \w i \W (patrz poniżej ZACHĘTA POWŁOKI). Usuwane znaki są zastępowane wielokropkiem.

PS0

Wartość tego parametru jest interpretowana (zobacz poniżej ZACHĘTA) i wyświetlana przez powłokę interaktywną po odczytaniu polecenia, a przed jego wykonaniem.

PS1

Wartość tego parametru jest interpretowana (zobacz poniżej ZACHĘTA) i używana jako główny łańcuch zachęty. Jego wartością domyślną jest " \s-\v\$ ".

PS2

Wartość tego parametru jest interpretowana jak PS1 i używana jako wtórny (secondary) łańcuch zachęty. Domyślnie jest to " > ".

PS3

Wartość tego parametru służy jako zachęta w poleceniu select (zobacz powyżej GRAMATYKA POWŁOKI).

PS4

The value of this parameter is expanded as with PS1 and the value is printed before each command bash displays during an execution trace. The first character of the expanded value of PS4 is replicated multiple times, as necessary, to indicate multiple levels of indirection. The default is “ + ”.

SHELL

This variable expands to the full pathname to the shell. If it is not set when the shell starts, bash assigns to it the full pathname of the current user's login shell.

TIMEFORMAT

Wartość tego parametru służy jako łańcuch formatu określającego, jak powinna być wyświetlana informacja o czasach dla potoków poprzedzonych słowem zastrzeżonym time. Znak % rozpoczyna sekwencję specjalną, która jest interpretowana jako wartość czasu lub inna informacja. Sekwencje specjalne i ich znaczenie są następujące; nawiasy kwadratowe opisują części opcjonalne.

Opcjonalne p jest cyfrą określającą dokładność (precision), liczbę cyfr ułamkowych po kropce dziesiętnej. Wartość zero powoduje, że nie będzie wyświetlana ani kropka dziesiętna ani część ułamkowa. Mogą być podane co najwyżej trzy miejsca po kropce dziesiętnej; wartości p większe od 3 zmieniane są na 3. Jeżeli nie podano p, to używana jest wartość 3.

Opcjonalne l określa dłuższy (longer) format wyników, zawierający minuty, w postaci MMm SS.FFs. O tym, czy występuje ułamkowa część sekund decyduje wartość p.

Jeżeli zmienna ta nie jest ustawiona, to bash działa tak, jakby miała ona wartość $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Jeżeli jej wartością jest pusty łańcuch, to nie jest wyświetlana żadna informacja o czasach (timing). Podczas wyświetlania łańcucha formatu dodawany jest kończący znak nowej linii.

TMOUT

Jeśli ustawione na wartość większą od zera, to TMOUT jest interpretowane jako domyślny czas oczekiwania wbudowanego read. Polecenie select kończy się, jeśli dane nie zostaną wprowadzone po liczbie TMOUT sekund, jeżeli wejście pochodzi z terminala. W przypadku powłok interaktywnych, wartość jest interpretowana jako liczba sekund określającą czas, przez jaki powłoka ma czekać na wprowadzenie wiersza danych po wyświetleniu głównej zachęty. Bash kończy pracę po odczekaniu tego czasu jeśli pełen wiersz danych nie pojawił się.

TMPDIR

Jeśli jest ustawiona, bash używa jej wartości jako nazwy katalogu w którym tworzy pliki tymczasowe do użytku powłoki.

auto_resume

Zmienna ta steruje sposobem interakcji powłoki z użytkownikiem i sposobem kontroli zadań. Jeżeli jest ustawiona, to jednowyrazowe polecenia proste bez przekierowań traktowane są jako aspirujące do wznowienia istniejącego zatrzymanego zadania. Nie pozwala się na żadną dwuznaczność; jeśli jest więcej niż jedno zadanie rozpoczynające się od wpisanego łańcucha, wybierane jest zadanie, do którego ostatnio sięgano. Nazwa zatrzymanego zadania, w tym kontekście, jest wierszem poleceń użytym do jego uruchomienia. Jeśli posiada wartość exact, to podany łańcuch musi pasować dokładnie do nazwy zatrzymanego zadania; Jeśli jest ustawione na substring, to podany łańcuch powinien pasować do podłańcucha nazwy zatrzymanego zadania. Wartość substring zapewnia funkcjonalność analogiczną do identyfikatora zadania %? (zobacz STEROWANIE ZADANIAMI poniżej). Jeśli ustawiono inną wartość, to podany łańcuch musi być przedrostkiem nazwy zatrzymanego zadania; zapewnia to funkcjonalność analogiczną do identyfikatora zadania %.

histchars

Dwa lub trzy znaki sterujące interpretacją historii i podziałem na leksemy (zobacz poniżej INTERPRETACJA HISTORII). Pierwszy znak jest znakiem interpretacji historii, sygnalizującym początek interpretacji historii, zwykle ` !'. Drugi znak jest znakiem szybkiego podstawiania, ("quick substitution"), służącym jako skrót do powtórnego uruchamiania poprzednio wprowadzonego polecenia, podstawiającym w poleceniu jeden łańcuch za inny. Domyślnym znakiem szybkiego podstawiania jest ` ^'. Opcjonalny, trzeci znak jest znakiem wskazującym, że pozostała część wiersza, w którym występuje on jako pierwszy znak słowa, jest komentarzem. Zwykle znakiem tym jest ` #'. Znak komentarza historii powoduje, że dla pozostałych słów wiersza podstawianie historii jest pomijane. Niekoniecznie powoduje to traktowanie reszty wiersza jako komentarza przez analizator składni powłoki.

Tablice

INTERPRETACJA

Interpretacja nawiasów

Interpretacja tyldy

Podstawianie parametrów

${parametr}

Podstawiana jest wartość parametru. Nawiasy wymagane są gdy parametr jest parametrem pozycyjnym o więcej niż jednej cyfrze, lub gdy po parametrze występuje znak, który nie powinien być interpretowany jako część jego nazwy. Parametr jest parametrem powłoki opisanych powyżej PARAMETRY lub odniesieniem do tablicy ( Tablice).

${parametr:-słowo}

Używa wartości domyślnych. Jeżeli parametr jest nieustawiony lub pusty, to podstawiane jest zinterpretowane słowo. W przeciwnym razie, podstawiana jest wartość parametru.

${parametr:=słowo}

Przypisuje wartości domyślne. Jeżeli parametr jest nieustawiony lub pusty, to jest mu przypisywane zinterpretowane słowo. Następnie podstawiana jest wartość parametru. Nie można w ten sposób przypisywać wartości parametrom pozycyjnym ani parametrom specjalnym.

${parametr:?słowo}

Wyświetla błąd jeśli pusty lub nieustawiony. Jeżeli parametr jest nieustawiony lub pusty, to na standardowe wyjście błędów zapisywane jest zinterpretowane słowo (lub komunikat o takim wyniku, jeśli brak słowa). Jeśli powłoka nie jest interaktywna, to kończy pracę. W przeciwnym wypadku, podstawiana jest wartość parametru.

${parametr:+słowo}

Używa wartości alternatywnej. Jeżeli parametr jest nieustawiony lub pusty, to nic nie jest podstawiane, w przeciwnym razie podstawiane jest zinterpretowane słowo.

${parametr:przesunięcie}

${parametr:przesunięcie:długość}

Substring Expansion. Expands to up to length characters of the value of parameter starting at the character specified by offset. If parameter is @ or *, an indexed array subscripted by @ or *, or an associative array name, the results differ as described below. If length is omitted, expands to the substring of the value of parameter starting at the character specified by offset and extending to the end of the value. length and offset are arithmetic expressions (see ARITHMETIC EVALUATION below). Jeśli przesunięcie wyniesie mniej niż zero, wartość jest używana jako przesunięcie w znakach od końca wartości parametru. Jeśli długość wyniesie mniej niż zero, jest interpretowana jako przesunięcie w znakach od końca wartości parametru, a nie jako liczba znaków, a interpretacja będzie dotyczyć znaków pomiędzy przesunięciem i tym wynikiem. Proszę zauważyć, że ujemne przesunięcie musi być oddzielone od dwukropka przynajmniej jedną spacją aby zapobiec pomyleniu z wyrażeniem :-. If parameter is @ or *, the result is length positional parameters beginning at offset. A negative offset is taken relative to one greater than the greatest positional parameter, so an offset of -1 evaluates to the last positional parameter. It is an expansion error if length evaluates to a number less than zero. Jeśli parametr jest nazwą tablicy indeksowanej z wskaźnikiem @ lub *, to wynikiem jest długość elementów tablicy poczynając od ${ parametr[przesunięcie]}. Jeśli wskaźnik da po interpretacji liczbę mniejszą od zera, to jest używany jako przesunięcie od maksymalnego indeksu tablicy plus jeden. Jeśli długość będzie mniejsza od zera wystąpi błąd interpretacji. Interpretacja podłańcucha zastosowana do tablicy asocjacyjnej da w wyniku niezdefiniowany rezultat. Indeksowanie podłańcuchów zaczyna się od zera, chyba że używane są parametry pozycyjne, wówczas indeksy liczy się domyślnie od 1. Jeśli przesunięcie wyniesie 0 i użyje się parametrów pozycyjnych, do listy włącza się na początku $0.

${!przedrostek*}

${!przedrostek@}

Nazywa pasujący przedrostek. Rozwija się w listę nazw tych zmiennych, których nazwy rozpoczynają się od przedrostka, rozdzielonych od siebie pierwszym znakiem zmiennej specjalnej IFS. Jeśli używane jest @, a interpretacja jest ujęta w cudzysłowy, to każda nazwa zmiennej jest interpretowana jako oddzielne słowo.

${!nazwa[@]}

${!nazwa[*]}

Lista kluczy z tablicy. Jeśli nazwa jest zmienną tablicową, jest rozwijana do listy wskaźników (kluczy) tablicowych przypisanych do nazwy. Jeśli nazwa nie jest tablicą, interpretowana jest do 0, jeśli nazwa jest ustawiona lub pozostaje pusta w przeciwnym wypadku. Gdy używane jest !, a interpretacja jest ujęta w cudzysłowy, każdy klucz jest rozwijany do oddzielnego słowa.

${#parametr}

Długość parametru. Podstawiana jest długość, w znakach, wartości parametru. Jeżeli parametrem jest * lub @, wartość podstawiana jest liczbą parametrów pozycyjnych. Jeżeli parametr jest nazwą tablicy o indeksowanej przez * lub @, wartość podstawiana jest liczbą elementów tablicy.

${parametr#słowo}

${parametr##słowo}

Remove matching prefix pattern. The word is expanded to produce a pattern just as in pathname expansion, and matched against the expanded value of parameter using the rules described under Pattern Matching below. If the pattern matches the beginning of the value of parameter, then the result of the expansion is the expanded value of parameter with the shortest matching pattern (the “ #” case) or the longest matching pattern (the “ ##” case) deleted. If parameter is @ or *, the pattern removal operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the pattern removal operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parametr%słowo}

${parametr%%słowo}

Remove matching suffix pattern. The word is expanded to produce a pattern just as in pathname expansion, and matched against the expanded value of parameter using the rules described under Pattern Matching below. If the pattern matches a trailing portion of the expanded value of parameter, then the result of the expansion is the expanded value of parameter with the shortest matching pattern (the “ %” case) or the longest matching pattern (the “ %%” case) deleted. If parameter is @ or *, the pattern removal operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the pattern removal operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parametr/wzorzec/łańcuch}

${parameter//pattern/string}

${parameter/#pattern/string}

${parameter/%pattern/string}

Pattern substitution. The pattern is expanded to produce a pattern just as in pathname expansion. Parameter is expanded and the longest match of pattern against its value is replaced with string. string undergoes tilde expansion, parameter and variable expansion, arithmetic expansion, command and process substitution, and quote removal. The match is performed using the rules described under Pattern Matching below. In the first form above, only the first match is replaced. If there are two slashes separating parameter and pattern (the second form above), all matches of pattern are replaced with string. If pattern is preceded by # (the third form above), it must match at the beginning of the expanded value of parameter. If pattern is preceded by % (the fourth form above), it must match at the end of the expanded value of parameter. If the expansion of string is null, matches of pattern are deleted. If string is null, matches of pattern are deleted and the / following pattern may be omitted. If the patsub_replacement shell option is enabled using shopt, any unquoted instances of & in string are replaced with the matching portion of pattern. Quoting any part of string inhibits replacement in the expansion of the quoted portion, including replacement strings stored in shell variables. Backslash will escape & in string; the backslash is removed in order to permit a literal & in the replacement string. Backslash can also be used to escape a backslash; \\ results in a literal backslash in the replacement. Users should take care if string is double-quoted to avoid unwanted interactions between the backslash and double-quoting, since backslash has special meaning within double quotes. Pattern substitution performs the check for unquoted & after expanding string; shell programmers should quote any occurrences of & they want to be taken literally in the replacement and ensure any instances of & they want to be replaced are unquoted. If the nocasematch shell option is enabled, the match is performed without regard to the case of alphabetic characters. If parameter is @ or *, the substitution operation is applied to each positional parameter in turn, and the expansion is the resultant list. If parameter is an array variable subscripted with @ or *, the substitution operation is applied to each member of the array in turn, and the expansion is the resultant list.

${parametr^wzorzec}

${parametr^^wzorzec}

${parametr,wzorzec}

${parametr,,wzorzec}

Modyfikacja wielkości znaków. Ta interpretacja modyfikuje wielkość zawartych liter zgodnie z parametrem. Wzorzec jest interpretowany w taki sposób, jak czyni to rozwijanie nazw plików. Każdy znak w interpretowanej wartości parametru jest sprawdzany ze wzorcem i jeśli do niego pasuje, wielkość litery jest zmieniana. Wzorzec nie powinien dopasowywać więcej niż jednego znaku. Operator ^ konwertuje małe litery pasujące do wzorca na wielkie, operator , działa odwrotnie. ^^ i ,, konwertują każdy dopasowany znak interpretowanej wartości, natomiast ^ i , konwertują jedynie jej pierwszy znak. Jeśli nie podano wzorca, to przyjmuje się za niego ?, co powoduje dopasowanie każdego znaku. Jeśli parametrem jest @ lub *, to operacja podstawiania stosowana jest do każdego po kolei parametru pozycyjnego, zaś wynikiem interpretacji jest powstała lista. Jeśli parametr jest zmienną tablicową indeksowaną przez @ lub *, operacja podstawiania jest przeprowadzana po kolei na każdym elemencie tablicy, zaś wynikiem interpretacji jest powstała lista.

${parametr@operator}

Przekształcenie parametrów. Ta interpretacja jest albo przekształceniem wartości parametrów, albo informacji o samych parametrach, w zależności od wartości operatora. Każdy operator jest pojedynczą literą:

Podstawianie wyników poleceń

Interpretacja wyrażeń arytmetycznych

Podstawianie wyników procesów (Process substitution)

Podział na słowa

Rozwijanie nazw plików (Pathname Expansion)

Usunięcie cytowań

PRZEKIEROWANIE

Przekierowanie wejścia

Przekierowanie wyjścia

Dołączanie przekierowanego wyjścia

Przekierowanie standardowego wyjścia i wyjścia błędów

Dołączanie standardowego wyjścia i wyjścia błędów

Dokumenty włączone (Here Documents)

[ n]<<[-]słowo
         dokument włączony
ogranicznik

Łańcuchy włączone (Here Strings)

[ n]<<<słowo

Powielanie deskryptorów plików

Przenoszenie deskryptorów plików

Otwieranie deskryptorów plików do odczytu i zapisu

ALIASY

FUNKCJE

OBLICZANIE WYRAŻEŃ ARYTMETYCZNYCH

id++ id--

post-inkrementacja i post-dekrementacja zmiennej

- +

jednoargumentowy minus i plus

++id --id

pre-inkrementacja i pre-dekrementacja zmiennej

! ~

negacja logiczna i bitowa

**

potęgowanie

* / %

mnożenie, dzielenie, reszta z dzielenia

+ -

dodawanie, odejmowanie

<< >>

lewo i prawostronne przesunięcie bitowe

<= >= < >

porównanie

== !=

równości i nierówność

&

bitowa koniunkcja (AND)

^

bitowa alternatywa wyłączna (XOR)

|

bitowa alternatywa (OR)

&&

logiczna koniunkcja (AND)

||

logiczna alternatywa (OR)

wyraż?wyraż:wyraż

operator warunkowy

= *= /= %= += -= <<= >>= &= ^= |=

przypisanie

wyraż1 , wyraż2

przecinek

WYRAŻENIA WARUNKOWE

-a plik

Prawda jeśli plik istnieje.

-b plik

Prawda jeśli plik istnieje i jest blokowym plikiem specjalnym.

-c plik

Prawda jeśli plik istnieje i jest znakowym plikiem specjalnym.

-d plik

Prawda jeśli plik istnieje i jest katalogiem.

-e plik

Prawda jeśli plik istnieje.

-f plik

Prawda jeśli plik istnieje i jest plikiem zwykłym.

-g plik

Prawda jeśli plik istnieje i ma ustawiony bit set-group-id.

-h plik

Prawda jeśli plik istnieje i jest dowiązaniem symbolicznym.

-k plik

Prawda jeśli plik istnieje i ma ustawiony bit ochrony (sticky bit).

-p plik

Prawda jeśli plik istnieje i jest potokiem nazwanym (FIFO).

-r plik

Prawda jeśli plik istnieje i daje się czytać.

-s plik

Prawda jeśli plik istnieje i ma rozmiar większy niż zero.

-t fd

Prawda jeśli deskryptor pliku fd jest otwarty i odnosi się do terminala.

-u plik

Prawda jeśli plik istnieje i ma ustawiony bit set-user-id.

-w plik

Prawda jeśli plik istnieje i daje się doń zapisać.

-x plik

Prawda jeśli plik istnieje i jest wykonywalny.

-G plik

Prawda jeśli plik istnieje i jego właścicielem jest efektywny id grupy.

-L plik

Prawda jeśli plik istnieje i jest dowiązaniem symbolicznym.

-N plik

Prawda jeśli plik istnieje i został zmodyfikowany od czasu jego ostatniego odczytu.

-0 plik

Prawda jeśli plik istnieje i jego właścicielem jest efektywny id użytkownika.

-S plik

Prawda jeśli plik istnieje i jest gniazdem.

plik1 -ef plik2

Prawda jeśli plik1 i plik2 odnoszą się do tego samego urządzenia i numeru i-węzła.

plik1 -nt plik2

Prawda, jeśli plik1 jest nowszy (według daty modyfikacji) niż plik2 lub plik1 istnieje a plik2 nie.

plik1 -ot plik2

Prawda, jeśli plik1 jest starszy niż plik2 lub plik2 istnieje a plik1 nie.

-o nazwa_opcji

Prawda jeśli opcja powłoki nazwa_opcji jest włączona. Zobacz zestawienie opcji w opisie opcji -o wbudowanego set, poniżej.

-v nazwa-zmiennej

Prawda, jeśli zmienna powłoki zmienna-powłoki jest ustawiona (została jej przypisana wartość).

-R nazwa-zmiennej

Prawda, jeśli zmienna powłoki zmienna-powłoki jest ustawiona i jest nazwą referencyjną.

-z łańcuch

Prawda jeśli długość łańcucha wynosi zero.

string

-n łańcuch

Prawda jeśli łańcuch ma długość niezerową.

łańcuch1 == łańcuch2

łańcuch1 = łańcuch2

Prawda, jeśli łańcuchy są sobie równe. = powinno być używane z poleceniem test, w celu zachowania zgodności z normą POSIX. Gdy używane jest z poleceniem [[, przeprowadzane jest dopasowanie do wzorca, zgodnie z opisem powyżej Polecenia złożone).

łańcuch1 != łańcuch2

Prawda jeśli łańcuchy nie są równe.

łańcuch1 < łańcuch2

Prawda jeśli łańcuch1 przy sortowaniu występowałby przed łańcuchem2 według bieżącego ustawienia locale.

łańcuch1 > łańcuch2

Prawda jeśli łańcuch1 przy sortowaniu występowałby po łańcuchu2 według bieżącego ustawienia locale.

arg1 OP arg2

OP is one of -eq, -ne, -lt, -le, -gt, or -ge. These arithmetic binary operators return true if arg1 is equal to, not equal to, less than, less than or equal to, greater than, or greater than or equal to arg2, respectively. Arg1 and arg2 may be positive or negative integers. When used with the [[ command, Arg1 and Arg2 are evaluated as arithmetic expressions (see ARITHMETIC EVALUATION above).

INTERPRETACJA POLECEŃ PROSTYCH

1.

Słowa oznaczone przez analizator składni jako przypisania zmiennych (poprzedzające nazwę polecenia) i przekierowania zachowywane są do późniejszego przetworzenia.

2.

Słowa, nie będące przypisaniami zmiennych ani przekierowaniami są interpretowane. Jeżeli po interpretacji pozostaną jakieś słowa, to pierwsze z nich przyjmowane jest za nazwę polecenia a pozostałe za argumenty.

3.

Wykonywane są przekierowania, jak opisano powyżej w sekcji PRZEKIEROWANIE.

4.

W każdym przypisaniu zmiennej tekst po znaku równości = podlega interpretacji tyldy, interpretacji parametrów, podstawianiu wyników poleceń, interpretacji wyrażeń arytmetycznych i usuwaniu cudzysłowów, zanim zostanie przypisany do zmiennej.

WYKONYWANIE POLECEŃ

ŚRODOWISKO WYKONYWANIA POLECEŃ

•

otwarte pliki odziedziczone przez powłokę przy wywołaniu, zmodyfikowane przez przekierowania przekazane do wbudowanego polecenia exec

•

bieżący katalog roboczy ustawiony przez cd, pushd lub popd, albo odziedziczony przez powłokę przy wywołaniu

•

maska trybu tworzonych plików ustawioną przez umask albo odziedziczoną po rodzicu powłoki

•

bieżące pułapki ustawione przez trap

•

parametry powłoki ustawione przez przypisania zmiennych przy pomocy set albo odziedziczone ze środowiska rodzica powłoki

•

funkcje powłoki zdefiniowane podczas wykonywania lub odziedziczone ze środowiska rodzica powłoki

•

opcje włączone przy wywołaniu (albo domyślnie albo przy pomocy argumentów wiersza poleceń) albo przez set

•

opcje włączone przez shopt

•

aliasy powłoki zdefiniowane przy pomocy alias

•

różne id procesów, łącznie z identyfikatorami zadań tła, wartość $$ i wartość $PPID

•

otwarte pliki powłoki, plus modyfikacje i dodatki określone przez przekierowania polecenia

•

bieżący katalog roboczy

•

maska trybu tworzonych plików

•

zmienne powłoki oznaczone do wyeksportowania, razem ze zmiennymi wyeksportowanymi do polecenia, przekazane w środowisku

•

pułapki przechwycone przez powłokę resetowane są do wartości odziedziczonych przez nią od rodzica, a pułapki ignorowane przez powłokę są ignorowane.

ŚRODOWISKO

KOD ZAKOŃCZENIA

SYGNAŁY

1.

If the command terminates due to the SIGINT, bash concludes that the user meant to end the entire script, and acts on the SIGINT (e.g., by running a SIGINT trap or exiting itself);

2.

If the command does not terminate due to SIGINT, the program handled the SIGINT itself and did not treat it as a fatal signal. In that case, bash does not treat SIGINT as a fatal signal, either, instead assuming that the SIGINT was used as part of the program's normal operation (e.g., emacs uses it to abort editing commands) or deliberately discarded. However, bash will run any trap set on SIGINT, as it does with any other trapped signal it receives while it is waiting for the foreground command to complete, for compatibility.

KONTROLA ZADAŃ

ZACHĘTA POWŁOKI

READLINE

Notacja Readline

Inicjalizacja Readline

Przypisania klawiszy Readline

Zmienne Readline

active-region-start-color

A string variable that controls the text color and background when displaying the text in the active region (see the description of enable-active-region below). This string must not take up any physical character positions on the display, so it should consist only of terminal escape sequences. It is output to the terminal before displaying the text in the active region. This variable is reset to the default value whenever the terminal type changes. The default value is the string that puts the terminal in standout mode, as obtained from the terminal's terminfo description. A sample value might be "\e[01;33m".

active-region-end-color

A string variable that "undoes" the effects of active-region-start-color and restores "normal" terminal display appearance after displaying text in the active region. This string must not take up any physical character positions on the display, so it should consist only of terminal escape sequences. It is output to the terminal after displaying the text in the active region. This variable is reset to the default value whenever the terminal type changes. The default value is the string that restores the terminal from standout mode, as obtained from the terminal's terminfo description. A sample value might be "\e[0m".

bell-style (audible)

Kontroluje, co dzieje się gdy readline chce użyć sygnału dźwiękowego terminala. Jeśli ustawiona na none, readline nigdy nie emituje sygnału. Jeśli ustawiona na visible, readline posługuje się "widzialnym dzwonkiem" (visible bell), jeśli jest dostępny. Jeżeli ustawiona na audible, readline usiłuje uzyskać sygnał dźwiękowy z terminala.

bind-tty-special-chars (On)

Jeśli ustawiona na On, readline będzie próbował przypiąć znaki kontrolne traktowane w sposób specjalny przez sterownik terminala jądra do ich odpowiedników readline.

blink-matching-paren (Off)

Jeśli ustawiona na On, readline spróbuje na krótko przesunąć kursor do nawiasu otwierającego przy wstawieniu nawiasu zamykającego.

colored-completion-prefix (Off)

If set to On, when listing completions, readline displays the common prefix of the set of possible completions using a different color. The color definitions are taken from the value of the LS_COLORS environment variable. If there is a color definition in $LS_COLORS for the custom suffix "readline-colored-completion-prefix", readline uses this color for the common prefix instead of its default.

colored-stats (Off)

Jeśli ustawiona na On, readline wyświetli możliwe dopasowania za pomocą używając kolorów wskazujących na ich typ pliku. Wzory kolorów są brane z wartości zmiennej środowiskowej LS_COLORS.

comment-begin (,,#”)

Łańcuch wstawiany, gdy wykonywane jest polecenie insert-comment readline. Polecenie to jest przypisane do M-# w trybie emacs, zaś do # w trybie vi.

completion-display-width (-1)

Liczba kolumn ekranowych używanych do wyświetlenia możliwych dopasowań przy przeprowadzaniu dopasowań. Wartość jest ignorowana, jeśli jest mniejsza niż 0 lub większa niż szerokość ekranu terminala. Wartość 0 spowoduje, że dopasowania będą wyświetlane po jednym na wiersz. Domyślna wartość to -1.

completion-ignore-case (Off)

Jeżeli ustawiona na On, readline wykonuje dopasowywanie i uzupełnianie nazw plików bez rozróżniania wielkości liter.

completion-map-case (Off)

Jeśli ustawiona na On i włączona jest completion-ignore-case readline traktuje znaki minusa -) i podkreślnika (_) jako równoważne przy dokonywaniu dopasowania i uzupełniania nazw plików gdy ma to czynić bez względu na wielkość znaków.

completion-prefix-display-length (0)

Długość (w znakach) wspólnego przedrostka listy możliwych uzupełnień, które są wyświetlane bez modyfikacji. Gdy jest ustawiona na wartość większą od zera, wspólne przedrostki dłuższe od tej wartości są zastępowane wielokropkiem podczas wyświetlania dostępnych uzupełnień.

completion-query-items (100)

This determines when the user is queried about viewing the number of possible completions generated by the possible-completions command. It may be set to any integer value greater than or equal to zero. If the number of possible completions is greater than or equal to the value of this variable, readline will ask whether or not the user wishes to view them; otherwise they are simply listed on the terminal. A zero value means readline should never ask; negative values are treated as zero.

convert-meta (On)

If set to On, readline will convert characters with the eighth bit set to an ASCII key sequence by stripping the eighth bit and prefixing an escape character (in effect, using escape as the meta prefix). The default is On, but readline will set it to Off if the locale contains eight-bit characters. This variable is dependent on the LC_CTYPE locale category, and may change if the locale is changed.

disable-completion (Off)

Jeśli ustawione na On, readline zabroni uzupełniania słów. Znaki uzupełniania zostaną wstawione w wiersz tak, jakby zostały przypisane do self-insert.

echo-control-characters (On)

Jeśli ustawione na On, readline wyświetla znak odpowiadający sygnałowi otrzymanemu z klawiatury, w systemach które informują o obsługiwaniu tej właściwości.

editing-mode (emacs)

Kontroluje czy readline rozpoczyna pracę z zestawem przypisań klawiszy podobnym do emacs czy do vi. editing-mode może być ustawiane albo na emacs albo na vi.

emacs-mode-string (@)

If the show-mode-in-prompt variable is enabled, this string is displayed immediately before the last line of the primary prompt when emacs editing mode is active. The value is expanded like a key binding, so the standard set of meta- and control prefixes and backslash escape sequences is available. Use the \1 and \2 escapes to begin and end sequences of non-printing characters, which can be used to embed a terminal control sequence into the mode string.

enable-active-region (On)

The point is the current cursor position, and mark refers to a saved cursor position. The text between the point and mark is referred to as the region. When this variable is set to On, readline allows certain commands to designate the region as active. When the region is active, readline highlights the text in the region using the value of the active-region-start-color, which defaults to the string that enables the terminal's standout mode. The active region shows the text inserted by bracketed-paste and any matching text found by incremental and non-incremental history searches.

enable-bracketed-paste (On)

When set to On, readline configures the terminal to insert each paste into the editing buffer as a single string of characters, instead of treating each character as if it had been read from the keyboard. This prevents readline from executing any editing commands bound to key sequences appearing in the pasted text.

enable-keypad (Off)

Gdy jest ustawione na On, readline będzie usiłować włączyć numeryczny blok klawiatury (application keypad) przy wywołaniu. Niektóre systemy potrzebują tego do włączenia klawiszy strzałek.

enable-meta-key (On)

Gdy jest ustawiona na On, readline próbuje włączyć dostępne modyfikujące klawisze meta, o których obsługiwaniu zapewnia terminal, gdy są wywoływane. Na wielu terminalach meta klawisz jest używany do wysyłania znaków ośmiobitowych.

expand-tilde (Off)

Jeżeli ustawione na On, podczas próby uzupełniania słów readline wykonuje interpretację tyldy.

history-preserve-point (Off)

Ustawione na on powoduje, że kod obsługi historii poleceń usiłuje w każdym wierszu poleceń odzyskanym za pomocą previous-history lub next-history umieścić punkt (bieżącą pozycję kursora) w tym samym miejscu.

history-size (unset)

Ustawia maksymalną liczbę wpisów historii zapisywanych w liście historii. Gdy jest ustawiona na zero, istniejące wpisy są usuwane, a nowe nie są zapisywane. Gdy wartość jest mniejsza od zera, liczba wpisów w liście historii jest nieograniczona. Domyślnie liczba wpisów w liście historii jest ustawiana na wartość zmiennej powłoki HISTSIZE. Jeśli spróbuje się ustawić history-size na wartość nienumeryczną, maksymalna liczba wpisów historii zostanie ustawiona na 500.

horizontal-scroll-mode (Off)

When set to On, makes readline use a single line for display, scrolling the input horizontally on a single screen line when it becomes longer than the screen width rather than wrapping to a new line. This setting is automatically enabled for terminals of height 1.

input-meta (Off)

If set to On, readline will enable eight-bit input (that is, it will not strip the eighth bit from the characters it reads), regardless of what the terminal claims it can support. The name meta-flag is a synonym for this variable. The default is Off, but readline will set it to On if the locale contains eight-bit characters. This variable is dependent on the LC_CTYPE locale category, and may change if the locale is changed.

isearch-terminators (,,C-[C-J”)

Łańcuch znaków, który powinien przerywać wyszukiwanie krokowe (incremental search) bez późniejszego wykonywania znaku jako polecenia. Jeżeli zmiennej tej nie nadano wartości, to wyszukiwanie krokowe będą przerywać ESC i C-J.

keymap (emacs)

Ustawia bieżące mapowanie klawiatury readline. Zestawami poprawnych mapowań są emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command i vi-insert. vi jest równoważnikiem dla vi-command; emacs jest równoważne emacs-standard. Domyślną wartością jest emacs; wartość editing-mode również wpływa na domyślne mapowanie.

keyseq-timeout (500)

Określa czas, jaki readline poczeka na znak, gdy odczytuje wieloznaczną sekwencję klawiszy (taką, która z dotychczasowego wejścia może utworzyć kompletną sekwencję klawiszy lub może otrzymać dodatkowe wejście, aby utworzyć kompletną, dłuższą sekwencję klawiszy). Jeżeli wejście nie zostanie wprowadzone w trakcie czasu oczekiwania, readline użyje krótszej kompletnej sekwencji klawiszy. Wartość jest określona w milisekundach, dlatego 1000 oznacza, że readline poczeka sekundę na dodatkowe wejście. Jeśli ta zmienna jest ustawiona na wartość mniejszą lub równą zero, lub na wartość nienumeryczną, readline poczeka na wciśnięcie dodatkowego klawisza, aby zdecydować którą sekwencję klawiszy uzupełnić.

mark-directories (On)

Jeżeli ustawione na On, to uzupełniane nazwy katalogów mają dołączany końcowy ukośnik.

mark-modified-lines (Off)

Jeżeli ustawione na On, wiersze historii, które zostały zmienione wyświetlane są z poprzedzającą je gwiazdką ( *).

mark-symlinked-directories (Off)

Gdy ustawiona na On, uzupełniane nazwy będące dowiązaniami symbolicznymi do katalogów, mają dodany znak ukośnika (przedmiot wartości mark-directories).

match-hidden-files (On)

Ta zmienna, gdy jest ustawiona na On, powoduje, że readline wykonując uzupełnianie nazw plików dopasowuje pliki, których nazwy zaczynają się od kropki `.' (pliki ukryte). Gdy ustawiona na Off, początkowa kropka w nazwie jaka ma być uzupełniona, musi być wpisana przez użytkownika.

menu-complete-display-prefix (Off)

Gdy ustawiona na On, uzupełnianie menu wyświetla wspólny przedrostek listy możliwych uzupełnień (który może być pusty) przed cyklicznym przełączaniem się między pozycjami z listy.

output-meta (Off)

If set to On, readline will display characters with the eighth bit set directly rather than as a meta-prefixed escape sequence. The default is Off, but readline will set it to On if the locale contains eight-bit characters. This variable is dependent on the LC_CTYPE locale category, and may change if the locale is changed.

page-completions (On)

Gdy ustawione na On, readline używa wewnętrznego programu wyświetlającego podobnego do more, do wyświetlania pełnego ekranu możliwych uzupełnień na raz.

print-completions-horizontally (Off)

Jeżeli ustawione na On, readline wyświetla dopasowane uzupełnienia w kolejności alfabetycznej poziomo, zamiast w dół ekranu.

revert-all-at-newline (Off)

Gdy ustawione na On, readline anuluje wszystkie zmiany w wierszach historii przed powrotem, gdy wykonywane jest accept-line. Domyślnie, wiersze historii mogą zostać zmodyfikowane i zachować swe listy anulowań poprzez odwołania do readline.

show-all-if-ambiguous (Off)

Zmienia to domyślne zachowanie funkcji uzupełniania. Jeżeli jest ustawione na on, to słowa mające więcej niż jedno możliwe uzupełnienie powodują, że natychmiast zostaną podane dopasowania zamiast wyemitowania sygnału dźwiękowego.

show-all-if-unmodified (Off)

Zmienna modyfikuje domyślne zachowanie funkcji uzupełnienia w sposób podobny do show-all-if-ambiguous. Gdy jest ustawiona na On, słowa które mają więcej niż jedno możliwe uzupełnienie bez możliwych uzupełnień częściowych (możliwe uzupełnienia nie posiadają wspólnego przedrostka), są wypisywane natychmiast, bez wcześniejszego używania brzęczyka.

show-mode-in-prompt (Off)

If set to On, add a string to the beginning of the prompt indicating the editing mode: emacs, vi command, or vi insertion. The mode strings are user-settable (e.g., emacs-mode-string).

skip-completed-text (Off)

Gdy jest ustawiona na On, modyfikuje domyślne zachowanie uzupełniania gdy do wiersza wstawiane jest pojedyncze dopasowanie. Jest to aktywne tylko podczas przeprowadzania uzupełnienia w środku słowa. Gdy jest włączona, readline nie wstawia znaków z uzupełniania, które pasują do znaków w miejscu wprowadzania w uzupełnianym słowie, dzięki czemu części słowa za kursorem, nie są duplikowane.

vi-cmd-mode-string ((cmd))

If the show-mode-in-prompt variable is enabled, this string is displayed immediately before the last line of the primary prompt when vi editing mode is active and in command mode. The value is expanded like a key binding, so the standard set of meta- and control prefixes and backslash escape sequences is available. Use the \1 and \2 escapes to begin and end sequences of non-printing characters, which can be used to embed a terminal control sequence into the mode string.

vi-ins-mode-string ((ins))

If the show-mode-in-prompt variable is enabled, this string is displayed immediately before the last line of the primary prompt when vi editing mode is active and in insertion mode. The value is expanded like a key binding, so the standard set of meta- and control prefixes and backslash escape sequences is available. Use the \1 and \2 escapes to begin and end sequences of non-printing characters, which can be used to embed a terminal control sequence into the mode string.

visible-stats (Off)

Jeżeli ustawione na On, to przy wyświetlaniu możliwych uzupełnień do nazwy pliku zostanie dołączony znak określający typ pliku wskazywany przez stat(2).

Konstrukcje warunkowe Readline

$if

The $if construct allows bindings to be made based on the editing mode, the terminal being used, or the application using readline. The text of the test, after any comparison operator,
extends to the end of the line; unless otherwise noted, no characters are required to isolate it.

$if Bash
# Cytuj bieżące lub poprzednie słowo
"\C-xq": "\eb\"\ef\""
$endif

$endif

Polecenie to, jak widać w poprzednim przykładzie, kończy wykonywanie polecenia $if.

$else

Polecenia w tej gałęzi dyrektywy $if wykonywane są gdy nie powiedzie się sprawdzenie warunku.

$include

Dyrektywa ta pobiera jako argument pojedynczą nazwę pliku i odczytuje polecenia i przypisania z tego pliku. Na przykład, poniższa dyrektywa odczytałaby /etc/inputrc:

$include  /etc/inputrc

Wyszukiwanie

Nazwy poleceń Readline

Polecenia ruchu

beginning-of-line (C-a)

Przesuwa na początek bieżącego wiersza.

end-of-line (C-e)

Przesuwa na koniec wiersza.

forward-char (C-f)

Przesuwa o znak w przód.

backward-char (C-b)

Przesuwa o znak wstecz.

forward-word (M-f)

Przesuwa na koniec następnego słowa. Słowa złożone są ze znaków alfanumerycznych (liter i cyfr).

backward-word (M-b)

Przesuwa na początek bieżącego, lub poprzedniego, słowa. Słowa złożone są ze znaków alfanumerycznych (liter i cyfr).

shell-forward-word

Przesuwa na koniec następnego słowa w przód. Słowa są oddzielone niecytowanymi metaznakami powłoki.

shell-backward-word

Przesuwa na początek bieżącego lub poprzedniego słowa w tył. Słowa są oddzielone niecytowanymi metaznakami powłoki.

previous-screen-line

Attempt to move point to the same physical screen column on the previous physical screen line. This will not have the desired effect if the current readline line does not take up more than one physical line or if point is not greater than the length of the prompt plus the screen width.

next-screen-line

Attempt to move point to the same physical screen column on the next physical screen line. This will not have the desired effect if the current readline line does not take up more than one physical line or if the length of the current readline line is not greater than the length of the prompt plus the screen width.

clear-display (M-C-l)

Clear the screen and, if possible, the terminal's scrollback buffer, then redraw the current line, leaving the current line at the top of the screen.

clear-screen (C-l)

Clear the screen, then redraw the current line, leaving the current line at the top of the screen. With an argument, refresh the current line without clearing the screen.

redraw-current-line

Odświeża bieżący wiersz.

Polecenia operujące na historii

accept-line (Newline, Return)

Akceptuje wiersz bez względu na to, gdzie znajduje się kursor. Jeżeli wiersz ten nie jest pusty, to dodaje go do listy historii stosownie do stanu zmiennej HISTCONTROL. Jeżeli wiersz jest zmienionym wierszem historii, to odtwarza wiersz historii do stanu pierwotnego.

previous-history (C-p)

Sprowadza poprzednie polecenie z listy historii, przesuwając się wstecz listy.

next-history (C-n)

Ściąga następne polecenie z listy historii, przesuwając się do przodu na liście.

beginning-of-history (M-<)

Przesuwa na pierwszy wiersz w historii.

end-of-history (M->)

Przesuwa na koniec historii wprowadzania, tj. obecnie wprowadzanego wiersza.

operate-and-get-next (C-o)

Accept the current line for execution and fetch the next line relative to the current line from the history for editing. A numeric argument, if supplied, specifies the history entry to use instead of the current line.

fetch-history

With a numeric argument, fetch that entry from the history list and make it the current line. Without an argument, move back to the first entry in the history list.

reverse-search-history (C-r)

Wyszukuje wstecz poczynając od bieżącego wiersza i przesuwając się, w razie potrzeby, 'w górę' historii. Jest to wyszukiwanie krokowe.

forward-search-history (C-s)

Wyszukuje w przód poczynając od bieżącego wiersza i przesuwając się, w razie potrzeby, 'w dół' historii. Jest to wyszukiwanie krokowe.

non-incremental-reverse-search-history (M-p)

Wyszukuje wstecz poczynając od bieżącego wiersza posługując się wyszukiwaniem nie-krokowym podanego przez użytkownika łańcucha.

non-incremental-forward-search-history (M-n)

Wyszukuje w przód poczynając od bieżącego wiersza posługując się wyszukiwaniem nie-krokowym podanego przez użytkownika łańcucha.

history-search-forward

Wyszukuje w przód w historii łańcucha znaków pomiędzy początkiem bieżącego wiersza a punktem. Jest to wyszukiwanie nie-krokowe.

history-search-backward

Wyszukuje wstecz w historii łańcucha znaków pomiędzy początkiem bieżącego wiersza a bieżącą pozycją kursora ( punkt). Jest to wyszukiwanie nie-krokowe.

history-substring-search-backward

Search backward through the history for the string of characters between the start of the current line and the current cursor position (the point). The search string may match anywhere in a history line. This is a non-incremental search.

history-substring-search-forward

Search forward through the history for the string of characters between the start of the current line and the point. The search string may match anywhere in a history line. This is a non-incremental search.

yank-nth-arg (M-C-y)

Wstawia pierwszy argument poprzedniego polecenia (zwykle drugie słowo z poprzedniego wiersza) w punkt (bieżącą pozycję kursora). Z argumentem n, wstawia n-te słowo poprzedniego polecenia (słowa w poprzednim poleceniu zaczynają się od słowa 0). Argument ujemny wstawia n-te słowo od końca poprzedniego polecenia. Po obliczeniu argumentu n, jest on wyodrębniany w taki sposób, jak gdyby podano opcję interpretowania historii "! n".

yank-last-arg (M-., M-_)

Wstawia ostatni argument poprzedniego polecenia (ostatnie słowo poprzedniej pozycji historii). Z argumentem numerycznym, zachowuje się dokładnie tak, jak yank-nth-arg. Kolejne wywołania yank-last-arg przesuwają wstecz listy historii, wstawiając po kolei ostatni argument (lub słowo określone przez argument do pierwszego wywołania) każdego wiersza. Każdy argument numeryczny podany do pomyślnego wywołania określa kierunek ruchu w historii. Argument ujemny zmienia kierunek poruszania się (w tył lub w przód). Możliwości interpretacji historii są używane do wyodrębnienia ostatniego słowa, podobnie jak gdyby wybrano interpretację historii za pomocą "!$".

shell-expand-line (M-C-e)

Interpretuj wiersz, jak czyni to powłoka. Wykonuje to aliasy i interpretację historii, jak również interpretację słów powłoki. Zobacz INTERPRETACJA HISTORII poniżej.

history-expand-line (M-^)

Wykonuje interpretację powłoki w odniesieniu do bieżącego wiersza. Zobacz INTERPRETACJA HISTORII poniżej.

magic-space

Wykonuje interpretację powłoki w odniesieniu do bieżącego wiersza i wstawia spację. Zobacz INTERPRETACJA HISTORII poniżej.

alias-expand-line

Wykonuje interpretację aliasów w odniesieniu do bieżącego wiersza. Zobacz ALIASY powyżej.

history-and-alias-expand-line

Wykonuje interpretację historii i aliasów w odniesieniu do bieżącego wiersza.

insert-last-argument (M-., M-_)

Synonim yank-last-arg.

edit-and-execute-command (C-x C-e)

Przywołuje edytor w bieżącym wierszu poleceń i wykonuje wynik jako polecenie powłoki. Bash stara się wywołać $VISUAL, $EDITOR i emacs jako edytor, w tej kolejności.

Polecenia zmiany tekstu

koniec-pliku (zwykle C-d)

Znak wskazujący koniec pliku, jak ustawiony np. przez ``stty''. If this character is read when there are no characters on the line, and point is at the beginning of the line, readline interprets it as the end of input and returns EOF.

delete-char (C-d)

Usuwa znak w tym punkcie. Jeżeli funkcja jest przypisana do tego samego znaku, jak znak EOF tty, jak często bywa z C-d, efekt jest opisany powyżej.

backward-delete-char (Rubout)

Usuwa znak przed kursorem. Jeżeli podano argument numeryczny, zachowuje usunięty tekst na stosie usunięć.

forward-backward-delete-char

Usuwa znak pod kursorem, chyba że kursor znajduje się na końcu wiersza, wówczas usuwany jest znak przed kursorem.

quoted-insert (C-q, C-v)

Dodaje następny znak do wiersza dosłownie. W ten sposób wstawiane są znaki takie, jak na przykład C-q.

tab-insert (C-v TAB)

Wstawia znak tabulacji.

self-insert (a, b, A, 1, !, ...)

Wstawia wpisany znak.

transpose-chars (C-t)

Zamienia miejscami znak sprzed punktu ze znakiem w punkcie, równocześnie przesuwając punkt w przód. Jeżeli punkt jest na końcu wiersza to zamienia to miejscami dwa znaki przed punktem. Argumenty ujemne nie skutkują.

transpose-words (M-t)

Zamienia miejscami słowo sprzed punktu ze słowem za punktem, przesuwając równocześnie punkt za przesunięte sprzed niego słowo. Jeżeli punkt jest na końcu wiersza to zamienia to miejscami dwa ostanie słowa wiersza.

upcase-word (M-u)

Zamienia na wielkie litery bieżące (lub następne) słowo. Z argumentem ujemnym zamienia na wielkie litery poprzednie słowo, ale nie przesuwa punktu.

downcase-word (M-l)

Zamienia na małe litery bieżące (lub następne) słowo. Z argumentem ujemnym zamienia na małe litery poprzednie słowo, ale nie przesuwa punktu.

capitalize-word (M-c)

Zamienia na kapitaliki (pierwsza litera wielka, pozostałe małe) bieżące (następne) słowo. Z argumentem ujemnym zamienia na kapitaliki poprzednie słowo, ale nie przesuwa punktu.

overwrite-mode

Przełącza tryb nadpisywania. Z jawnym, dodatnim argumentem liczbowym, przełącza do trybu nadpisywania. Z jawnym, niedodatnim argumentem liczbowym, przełącza do trybu wstawiania. Polecenie dotyczy jedynie trybu emacs, tryb vi nadpisuje w inny sposób. Każde odwołania do readline() jest uruchamiane w trybie wstawiania. W trybie nadpisywania, znaki przypisane do self-insert zastępują tekst pod kursorem, zamiast przesuwać go w prawą stronę. Znaki przypisane do backward-delete-char zastępują znak przed kursorem spacją. Domyślnie, to polecenie nie jest przypisane.

Usuwanie i wklejanie

kill-line (C-k)

Usuwa tekst od punktu do końca wiersza.

backward-kill-line (C-x Rubout)

Usuwa wstecz do początku wiersza.

unix-line-discard (C-u)

Usuwa wstecz od punktu do początku wiersza. Usuwany tekst jest zachowywany na stosie usunięć.

kill-whole-line

Usuwa wszystkie znaki bieżącego wiersza, bez względu na położenie punktu.

kill-word (M-d)

Usuwa od punktu do końca bieżącego słowa, lub jeśli użyte pomiędzy słowami, do końca następnego słowa. Granice słów są takie same, jak używane przez forward-word.

backward-kill-word (M-Rubout)

Usuwa słowo sprzed punktu. Granice słów są takie same, jak używane przez backward-word.

shell-kill-word

Usuwa od kursora do końca bieżącego słowa lub, jeśli kursor znajduje się pomiędzy słowami, do końca następnego słowa. Granice słów są takie same, jak używane przez shell-forward-word.

shell-backward-kill-word

Usuwa słowo sprzed punktu. Granice słów są takie same, jak używane przez shell-backward-word.

unix-word-rubout (C-w)

Usuwa słowo sprzed punktu, jako separatora słów używając białych znaków. Usunięty tekst zachowywany jest na stosie usunięć.

unix-filename-rubout

Usuwa słowo sprzed punktu, jako separatora słów używając białych znaków i ukośnika.Usunięty tekst zachowywany jest na stosie usunięć.

delete-horizontal-space (M-\)

Usuwa wszystkie spacje i tabulatory wokół punktu.

kill-region

Usuwa tekst w bieżącym obszarze.

copy-region-as-kill

Kopiuje tekst obszaru do bufora usuwania.

copy-backward-word

Kopiuje słowo sprzed punktu do bufora usuwania. Granice słów są takie same, jak dla backward-word.

copy-forward-word

Kopiuje słowo występujące po punkcie do bufora usuwania. Granice słów są takie same, jak dla forward-word.

yank (C-y)

Wkleja wierzchołek stosu usunięć do bufora w punkcie (w miejscu kursora).

yank-pop (M-y)

Obraca stos usunięć i wkleja nowy wierzchołek. Działa tylko następując po yank lub yank-pop.

Argumenty numeryczne

digit-argument (M-0, M-1, ..., M--)

Dodaje tę cyfrę do już składanego argumentu lub rozpoczyna nowy argument. M-- rozpoczyna argument ujemny.

universal-argument

Jest to inna metoda podawania argumentu. Jeżeli po tym poleceniu występuje jedna lub więcej cyfr, z opcjonalnym początkowym znakiem minus, to cyfry te definiują argument. Jeżeli po poleceniu występują cyfry, to powtórne wykonanie universal-argument kończy argument numeryczny, ale w przeciwnym wypadku jest ignorowane. W przypadku specjalnym, jeżeli bezpośrednio po tym poleceniu występuje znak nie będący ani cyfrą ani znakiem minus, to argument licznik dla następnego polecenia mnożony jest przez cztery. Argument licznik [zwykle powtórzeń] wynosi początkowo cztery, toteż wykonanie tej funkcji po raz pierwszy nadaje mu wartość cztery, po raz drugi szesnaście, i tak dalej.

Uzupełnianie

complete (TAB)

Usiłuje przeprowadzić uzupełnianie tekstu przed punktem. Bash próbuje uzupełniania traktując tekst kolejno: jako zmienną (jeżeli tekst zaczyna się od $), nazwę użytkownika (jeśli tekst zaczyna się od ~), nazwę hosta (jeśli tekst zaczyna się od @) lub polecenie (łącznie z aliasami i funkcjami). Jeżeli żadne z powyższych nie daje dopasowania, to próbowane jest uzupełnianie nazw plików.

possible-completions (M-?)

Pokazuje możliwe uzupełnienia tekstu przed punktem.

insert-completions (M-*)

Wstawia przed punktem wszystkie uzupełnienia tekstu, które zostałyby wygenerowane przez possible-completions.

menu-complete

Podobne do complete, ale zastępuje słowo, jakie ma zostać uzupełnione pojedynczym uzupełnieniem z listy możliwych. Powtarzane wykonanie menu-complete powoduje krokowe przechodzenie przez listę możliwych uzupełnień i wstawianie każdego z nich po kolei (zamiast uzupełnianego słowa). Na końcu listy uzupełnień emitowany jest sygnał dźwiękowy (zależny od ustawienia bell-style) i przywracany jest pierwotny tekst. Argument n przesuwa n pozycji w przód na liście dopasowań; do przesuwania się wstecz można użyć argumentu ujemnego. Polecenie w zamierzeniu ma być przypisane do klawisza TAB, ale domyślnie nie jest przypisane.

menu-complete-backward

Podobne do menu-complete, ale przemieszcza się wstecz po liście możliwych uzupełnień, identycznie gdyby menu-complete podano ujemny argument. To polecenie jest domyślnie nieprzypisane.

delete-char-or-list

Usuwa znak pod kursorem, jeśli nie jest to początek bądź koniec wiersza (jak delete-char). Na końcu wiersza, zachowuje się identycznie jak possible-completions. To polecenie jest domyślnie nieprzypisane.

complete-filename (M-/)

Usiłuje wykonać uzupełnianie nazw plików na tekście sprzed kursora.

possible-filename-completions (C-x /)

Pokazuje możliwe uzupełnienia tekstu sprzed kursora, traktując go jak nazwę pliku.

complete-username (M-~)

Usiłuje wykonać uzupełnianie tekstu sprzed kursora, traktując go jak nazwę użytkownika.

possible-username-completions (C-x ~)

Pokazuje możliwe uzupełnienia tekstu sprzed kursora, traktując go jak nazwę użytkownika.

complete-variable (M-$)

Usiłuje wykonać uzupełnianie tekstu sprzed kursora, traktując go jak zmienną powłoki.

possible-variable-completions (C-x $)

Pokazuje możliwe uzupełnienia tekstu sprzed kursora, traktując go jak zmienną powłoki.

complete-hostname (M-@)

Usiłuje wykonać uzupełnianie tekstu sprzed kursora, traktując go jak nazwę hosta.

possible-hostname-completions (C-x @)

Pokazuje możliwe uzupełnienia tekstu sprzed kursora, traktując go jak nazwę hosta.

complete-command (M-!)

Usiłuje uzupełnić tekst sprzed punktu, traktując go jak nazwę polecenia. Uzupełnianie polecenia próbuje dopasować tekst kolejno do aliasów, słów zastrzeżonych, funkcji powłoki, poleceń wbudowanych powłoki i wreszcie nazw plików wykonywalnych.

possible-command-completions (C-x !)

Pokazuje możliwe uzupełnienia tekstu sprzed kursora, traktując go jak nazwę polecenia.

dynamic-complete-history (M-TAB)

Usiłuje uzupełnić tekst sprzed kursora, w celu odnalezienia możliwych uzupełnień porównując go z wierszami listy historii.

dabbrev-expand

Usiłuje wykonać uzupełnienie menu na tekście sprzed kursora, w celu odnalezienia możliwych uzupełnień porównując go z wierszami listy historii.

complete-into-braces (M-{)

Wykonuje uzupełnianie nazwy pliku i wstawia listę możliwych uzupełnień ujętą w nawiasy klamrowe, tak że jest ona dostępna dla powłoki (zobacz powyżej Interpretacja nawiasów).

Makra klawiaturowe

start-kbd-macro (C-x ()

Rozpoczyna zachowywanie wpisywanych znaków w bieżącym makrze klawiaturowym.

end-kbd-macro (C-x ))

Zatrzymuje zachowywanie wpisywanych znaków w bieżącym makrze klawiaturowym i przechowuje definicję.

call-last-kbd-macro (C-x e)

Ponownie wykonuje zdefiniowane makro klawiaturowe, powodując pojawianie się znaków makra tak, jakby zostały wpisane z klawiatury.

print-last-kbd-macro ()

Wypisuje ostatnie makro klawiaturowe, w formacie przeznaczonym do pliku inputrc.

Różne

re-read-init-file (C-x C-r)

Odczytuje zawartość pliku inputrc i dołącza wszystkie znalezione tam przypisania klawiszy i zmiennych.

abort (C-g)

Zaniechuje bieżącego polecenia edycji i emituje sygnał dźwiękowy terminala (zgodnie z ustawieniami bell-style).

do-lowercase-version (M-A, M-B, M-x, ...)

If the metafied character x is uppercase, run the command that is bound to the corresponding metafied lowercase character. The behavior is undefined if x is already lowercase.

prefix-meta (ESC)

Poprzedza przedrostkiem meta następny wpisany znak. ESC f jest równoważne Meta-f.

undo (C-_, C-x C-u)

Krokowe cofnięcie operacji, pamiętane odrębnie dla każdego wiersza.

revert-line (M-r)

Cofa wszystkie zmiany wykonane na tym wierszu. Podobne do wykonania polecenia undo wystarczająco wiele razy, by przywrócić wiersz do stanu początkowego.

tilde-expand (M-&)

Wykonuje interpretację tyldy w odniesieniu do bieżącego słowa.

set-mark (C-@, M-<spacja>)

stawia znacznik (mark) w bieżącym punkcie. Jeżeli podano argument numeryczny, znacznik jest ustawiany na takiej pozycji.

exchange-point-and-mark (C-x C-x)

Zamień punkt ze znacznikiem. Aktualna pozycja kursora ustawiana jest na zapamiętaną, a dotychczasowa pozycja zachowywana jako znacznik.

character-search (C-])

A character is read and point is moved to the next occurrence of that character. A negative argument searches for previous occurrences.

character-search-backward (M-C-])

A character is read and point is moved to the previous occurrence of that character. A negative argument searches for subsequent occurrences.

skip-csi-sequence

Odczytuje wystarczająco wiele znaków, aby pobrać sekwencje wielu klawiszy, np. zdefiniowaną przez klawisze takie jak Home i End. Takie sekwencje zaczynają się znacznikiem sekwencji kontrolnej (Control Sequence Indicator - CSI), z reguły ESC-[. Jeśli taka sekwencja jest przypisana do "\[", to klawisze wchodzące w skład tej sekwencji nie będą działać (chyba że zostały jawnie przypisane do polecenia readline) zamiast wstawiać niepowiązane znaki do bufora edycyjnego. Domyślnie, to polecenie jest nieprzypisane, ale przypisanie powinno przeważnie odnosić się do ESC-[.

insert-comment (M-#)

Bez argumentu numerycznego, na początek bieżącego wiersza wstawiana jest wartość zmiennej comment-begin readline. Jeśli podano numeryczny argument, to polecenia działa jak przełącznik: jeśli znaki na początku wiersza nie pasują do wartości comment-begin, to wartość jest wstawiana, w przeciwnym wypadku znaki w comment-begin są usuwane z początku każdego wiersza. W każdym przypadku wiersz jest akceptowany tak, jakby wprowadzono znak nowej linii. Domyślna wartość comment-begin powoduje, że polecenie to czyni bieżący wiersz komentarzem powłoki. Jeśli numeryczny argument powoduje usunięcie znaku komentarza, to dany wiersze będzie wykonany przez powłokę.

spell-correct-word (C-x s)

Perform spelling correction on the current word, treating it as a directory or filename, in the same way as the cdspell shell option. Word boundaries are the same as those used by shell-forward-word.

glob-complete-word (M-g)

Słowo sprzed kursora jest traktowane jako wzorzec rozwijania nazw plików, bez jawnego dodania gwiazdki (asterysku). Ten wzorzec może zostać użyty do wygenerowania listy pasujących nazw plików do możliwych uzupełnień.

glob-expand-word (C-x *)

Słowo sprzed kursora traktowane jest jak wzorzec rozwijania nazw plików i wstawiana jest lista pasujących nazw, zastępując słowo-wzorzec. Jeśli podano numeryczny argument, to przed rozwijaniem nazw plików dodawana jest gwiazdka (asterysk).

glob-list-expansions (C-x g)

Wyświetlana jest lista rozwinięć, jakie zostałyby utworzone przez glob-expand-word, a wiersz jest ponownie wyświetlany. Jeśli podano numeryczny argument, to przed rozwijaniem nazw plików dodawana jest gwiazdka (asterysk).

dump-functions

Wypisuje do strumienia wyjściowego readline wszystkie funkcje i ich przypisania klawiszy. Jeżeli podano argument numeryczny, wyjście jest formatowane w taki sposób, by można zrobić je częścią pliku inputrc.

dump-variables

Wypisuje do strumienia wyjściowego readline wszystkie ustawialne zmienne readline i ich wartości. Jeżeli podano argument numeryczny, wyjście jest formatowane w taki sposób, by można zrobić je częścią pliku inputrc.

dump-macros

Wypisuje wszystkie sekwencje klawiszy readline przypisane do makr i łańcuchy jakie dają w wyniku. Jeżeli podano argument numeryczny, wyjście jest formatowane w taki sposób, by można zrobić je częścią pliku inputrc.

display-shell-version (C-x C-v)

Wyświetla informację o wersji aktualnego egzemplarza bash.

Programowalne uzupełnianie

HISTORIA

INTERPRETACJA HISTORII

Desygnatory zdarzeń (Event Designators)

!

Rozpoczyna podstawianie historii, z wyjątkiem sytuacji, gdy występuje po nim odstęp, znak nowej linii, = lub ( (gdy włączono opcję powłoki extglob używając wbudowanego shopt).

!n

Wskazuje na n-ty wiersz poleceń.

!-n

Wskazuje na wiersz poleceń bieżący minus n.

!!

Wskazuje na poprzednie polecenie. jest to synonim `!-1'.

!łańcuch

Wskazuje na ostatnie poleceniem rozpoczynające się od łańcucha.

!?łańcuch[?]

Refer to the most recent command preceding the current position in the history list containing string. The trailing ? may be omitted if string is followed immediately by a newline. If string is missing, the string from the most recent search is used; it is an error if there is no previous search string.

^łańcuch1^łańcuch2^

Szybkie podstawianie. Powtarza ostatnie polecenie, wymieniając łańcuch1 na łańcuch2. Równoważnik ,,!!:s^ ◈a◈cuch1^ ◈a◈cuch2^ (zobacz poniżej Modyfikatory).

!#

Cały wiersz poleceń wpisany do tego momentu.

Desygnatory słów (Word Designators)

0 (zero)

Słowo zerowe. Dla powłoki jest to słowo polecenia.

n

n-te słowo.

^

Pierwszy argument. To znaczy, słowo 1.

$

Ostatnie słowo. Jest to zwykle ostatni argument, ale jest interpretowany jako zerowe słowo, gdy jest tylko jedno słowo w wierszu.

%

The first word matched by the most recent `?string?' search, if the search string begins with a character that is part of a word.

x-y

Zakres słów; `-y' jest skróconym `0- y'.

*

Wszystkie słowa prócz zerowego. jest to synonim dla ` 1-$'. Nie jest błędem użycie * jeśli w zdarzeniu jest tylko jedno słowo; w tym przypadku zwracany jest łańcuch pusty.

x*

Skrót od x-$.

x-

Abbreviates x-$ like x*, but omits the last word. If x is missing, it defaults to 0.

Modyfikatory

h

Usuwa końcową składową nazwy pliku, pozostawiając tylko początek.

t

Usuwa wszystkie początkowe składowe nazwy pliku, pozostawiając koniec.

r

Usuwa kończący przyrostek postaci .xxx, pozostawiając główną część nazwy (basename).

e

Usuwa wszystko prócz końcowego przyrostka.

p

Wypisuje nowe polecenie, ale go nie wykonuje.

q

Cytuje podstawiane słowa, zabezpieczając je przed dalszym podstawianiem.

x

Quote the substituted words as with q, but break into words at blanks and newlines. The q and x modifiers are mutually exclusive; the last one supplied is used.

s/stary/nowy/

Substitute new for the first occurrence of old in the event line. Any character may be used as the delimiter in place of /. The final delimiter is optional if it is the last character of the event line. The delimiter may be quoted in old and new with a single backslash. If & appears in new, it is replaced by old. A single backslash will quote the &. If old is null, it is set to the last old substituted, or, if no previous history substitutions took place, the last string in a !?string[?] search. If new is null, each matching old is deleted.

&

Powtarza poprzednie podstawienie.

g

Powoduje, że zmiany zostaną zastosowane do całego wiersza zdarzenia. Używany w połączeniu z ` :s' (np. `:gs/stary/nowy/') lub ` :&'. Jeśli użyty z `:s', to zamiast / można posłużyć się dowolnym separatorem, a ostatni separator jest opcjonalny jeżeli jest ostatnim znakiem wiersza zdarzenia.

G

Apply the following `s' or `&' modifier once to each word in the event line.

WBUDOWANE POLECENIA POWŁOKI

: [argumenty]

Bez efektów; polecenie to nie robi niczego poza interpretacją argumentów i wykonaniem ewentualnych podanych przekierowań. Zwracany status to zero.

. plik [argumenty]

source plik [argumenty]

Read and execute commands from filename in the current shell environment and return the exit status of the last command executed from filename. If filename does not contain a slash, filenames in PATH are used to find the directory containing filename, but filename does not need to be executable. The file searched for in PATH need not be executable. When bash is not in posix mode, it searches the current directory if no file is found in PATH. If the sourcepath option to the shopt builtin command is turned off, the PATH is not searched. If any arguments are supplied, they become the positional parameters when filename is executed. Otherwise the positional parameters are unchanged. If the -T option is enabled, . inherits any trap on DEBUG; if it is not, any DEBUG trap string is saved and restored around the call to ., and . unsets the DEBUG trap while it executes. If -T is not set, and the sourced file changes the DEBUG trap, the new value is retained when . completes. The return status is the status of the last command exited within the script (0 if no commands are executed), and false if filename is not found or cannot be read.

alias [-p] [nazwa[=wartość] ...]

Alias bez argumentów bądź z opcją -p wypisuje na standardowym wyjściu listę aliasów w postaci alias nazwa=wartość. Jeśli nie dostarczono argumentów, to definiowany jest alias (synonim) dla każdej nazwy, dla której podano wartość. Początkowa spacja w wartości powoduje, że podczas interpretacji aliasu następne słowo będzie sprawdzane na podstawianie aliasów. Dla każdej nazwy z listy argumentów, dla której nie podano wartości, wypisywana jest nazwa i wartość aliasu. Alias zwraca prawdę, chyba że podano nazwę, dla której nie został zdefiniowany żaden alias.

bg [spec_zad]

Wznawia w tle zawieszone zadanie spec_zad, tak jakby zostało ono uruchomione z &. Jeśli spec_zad nie występuje, to używane jest bieżące zadanie, określone tak, jak je pojmuje powłoka. bg spec_zad zwraca 0, chyba że uruchomiono je przy wyłączonej kontroli zadań (job control) lub uruchomiono z włączoną kontrolą zadań, jeśli nie znaleziono spec_zad lub uruchomiono bez kontroli zadań.

bind [-m mapa-klawiszy] [-lpsvPSVX]

bind [-m mapa-klawiszy] [-q funkcja] [ -u funkcja] [-r sekw_klaw]

bind [-m mapa-klawiszy] -f plik

bind [-m mapa-klawiszy] -x sekw_klaw: polec_powłoki

bind [-m mapa-klawiszy] sekw_klaw: nazwa_funkcji

bind [-m mapa-klawiszy] sekw_klaw: polec_readline

bind readline-command-line

Display current readline key and function bindings, bind a key sequence to a readline function or macro, or set a readline variable. Each non-option argument is a command as it would appear in a readline initialization file such as .inputrc, but each binding or command must be passed as a separate argument; e.g., '"\C-x\C-r": re-read-init-file'. Options, if supplied, have the following meanings:

break [n]

Opuszcza pętlę for, while, until lub select. Jeżeli podano n, przerywa działanie do n-tego poziomu. n musi być ≥ 1. Jeżeli n jest większe od liczby obejmujących polecenie pętli, to kończone są wszystkie obejmujące pętle. Wartością zwracaną jest 0, chyba że powłoka nie wykonuje pętli podczas wykonania break.

builtin wbudowane [argumenty]

Wykonuje zadane polecenie wbudowane powłoki, przesyłając mu argumenty i zwraca jego kod zakończenia. Przydatne podczas definiowania funkcji o nazwie tożsamej z nazwą wbudowanego polecenia powłoki, zachowując funkcjonalność polecenia wbudowanego wewnątrz funkcji. Wbudowane cd jest powszechnie redefiniowane w ten sposób. Kodem zakończenia jest fałsz jeśli wbudowane nie jest wbudowanym poleceniem powłoki.

caller [wyrażenie]

Zwraca kontekst aktywnego wywołania podprogramu (funkcji powłoki lub skryptu wykonywanego wbudowanymi poleceniami . lub source). Bez wyrażenia, caller wyświetla numer wiersza i plik źródłowy bieżącego wywołania podprogramu. Jeśli do wyrażenia przekazano nieujemną liczbę całkowitą, to caller wyświetla numer wiersza, nazwę podprogramu i plik źródłowy związany z pozycją w bieżącym stosie wywołania. Te dodatkowe informacje mogą być użyte np. do wyświetlenia stosu wywołania. Bieżąca ramka jest ramką 0. Zwracaną wartością jest 0, chyba że powłoka nie wykonuje wywołania podprogramu lub wyrażenie nie odnosi się do prawidłowej pozycji w stosie wywołania.

cd [-L|[-P [-e]] [-@]] [katalog]

Change the current directory to dir. if dir is not supplied, the value of the HOME shell variable is the default. The variable CDPATH defines the search path for the directory containing dir: each directory name in CDPATH is searched for dir. Alternative directory names in CDPATH are separated by a colon (:). A null directory name in CDPATH is the same as the current directory, i.e., “ .”. If dir begins with a slash (/), then CDPATH is not used. The -P option causes cd to use the physical directory structure by resolving symbolic links while traversing dir and before processing instances of .. in dir (see also the -P option to the set builtin command); the -L option forces symbolic links to be followed by resolving the link after processing instances of .. in dir. If .. appears in dir, it is processed by removing the immediately previous pathname component from dir, back to a slash or the beginning of dir. If the -e option is supplied with -P, and the current working directory cannot be successfully determined after a successful directory change, cd will return an unsuccessful status. On systems that support it, the -@ option presents the extended attributes associated with a file as a directory. An argument of - is converted to $OLDPWD before the directory change is attempted. If a non-empty directory name from CDPATH is used, or if - is the first argument, and the directory change is successful, the absolute pathname of the new working directory is written to the standard output. If the directory change is successful, cd sets the value of the PWD environment variable to the new directory name, and sets the OLDPWD environment variable to the value of the current working directory before the change. The return value is true if the directory was successfully changed; false otherwise.

command [-pVv] polecenie [arg ...]

Uruchamia polecenie z argumentami zakazując zwykłego wyszukiwania funkcji przez powłokę. Wykonywane są wyłącznie polecenia wbudowane i polecenia znalezione w PATH. Jeżeli podano opcję -p, wyszukiwanie polecenia wykonywane jest przy użyciu domyślnej PATH, która gwarantuje znalezienie wszystkich standardowych narzędzi. Jeśli użyto albo opcji -V albo -v, to wypisywany jest opis polecenia. Opcja -v powoduje, że zostanie wyświetlone pojedyncze słowo wskazujące polecenie lub nazwę pliku, użyte do wywołania polecenia; opcja -V tworzy bardziej obszerny opis. Jeżeli podano opcję -V lub -v, to kodem zakończenia jest 0 gdy odnaleziono polecenie, zaś 1 gdy nie. Jeśli nie podano żadnej z tych opcji i pojawił się błąd lub nie można znaleźć polecenia, to kod zakończenia wynosi 127. W przeciwnym wypadku kodem zakończenia wbudowanego polecenia command jest kod zakończenia polecenia.

compgen [opcja] [słowo]

Tworzy możliwe dopasowania uzupełnień dla słowa zgodnie z opcjami, które mogą być dowolnymi z opcji akceptowanych przez wbudowane polecenie complete, z wyjątkiem -p i -r, i wypisuje dopasowania na standardowe wyjście. Przy stosowaniu opcji -F lub -C, różne zmienne powłoki ustawiane przez usługi programowalnego uzupełniania, gdy są dostępne, nie będą mieć użytecznych wartości. Dopasowania będą tworzone w ten sam sposób, jakby kod uzupełniania programowalnego tworzył je wprost ze specyfikacji uzupełniania z tymi samymi flagami. Jeżeli podano słowo, to wyświetlone zostaną wyłącznie uzupełnienia doń pasujące. Wartością zwracaną jest prawda, chyba że podano niepoprawną opcję lub nie zostały utworzone żadne dopasowania.

complete [-abcdefgjksuv] [-o opcjacomp] [ -DEI] [-A akcja] [-G wzglob] [ -W listasłów]

 

[ -F function] [-C command] [-X filterpat] [ -P prefix] [-S suffix] name [ name ...]

complete -pr [-DEI] [nazwa ...]

Specify how arguments to each name should be completed. If the -p option is supplied, or if no options are supplied, existing completion specifications are printed in a way that allows them to be reused as input. The -r option removes a completion specification for each name, or, if no names are supplied, all completion specifications. The -D option indicates that other supplied options and actions should apply to the “default” command completion; that is, completion attempted on a command for which no completion has previously been defined. The -E option indicates that other supplied options and actions should apply to “empty” command completion; that is, completion attempted on a blank line. The -I option indicates that other supplied options and actions should apply to completion on the initial non-assignment word on the line, or after a command delimiter such as ; or |, which is usually command name completion. If multiple options are supplied, the -D option takes precedence over -E, and both take precedence over -I. If any of -D, -E, or -I are supplied, any other name arguments are ignored; these completions only apply to the case specified by the option. The process of applying these completion specifications when word completion is attempted is described above under Programmable Completion. Pozostałe opcje, jeśli je podano, mają niżej opisane znaczenie. Argumenty opcji -G, -W i -X (i, jeśli to niezbędne, -P i -S) powinny być cytowane dla ochrony przed interpretacją jaka wystąpi zanim zostanie wywołane polecenie complete.

compopt [-o opcja] [-DEI] [+o opcja] [nazwa]

Modify completion options for each name according to the options, or for the currently-executing completion if no names are supplied. If no options are given, display the completion options for each name or the current completion. The possible values of option are those valid for the complete builtin described above. The -D option indicates that other supplied options should apply to the “default” command completion; that is, completion attempted on a command for which no completion has previously been defined. The -E option indicates that other supplied options should apply to “empty” command completion; that is, completion attempted on a blank line. The -I option indicates that other supplied options should apply to completion on the initial non-assignment word on the line, or after a command delimiter such as ; or |, which is usually command name completion. Zwracaną wartością jest prawda, chyba że podano nieprawidłową opcję, przeprowadzono próbę zmodyfikowania opcji dla nazwy, dla której nie istnieje specyfikacja uzupełniania lub wystąpił błąd wyjścia.

continue [n]

Wznawia następną iterację obejmującej je pętli for, while, until lub select. Jeżeli podano n, wznawia n-tą obejmującą pętlę. n musi być ≥ 1. Jeżeli n jest większe niż liczba obejmujących pętli, to wznawiana jest ostatnia z pętli (,,najwyższa”). Wartość zwracana wynosi 0, chyba że powłoka nie wykonuje pętli podczas wykonywania continue.

declare [-aAfFgiIlnrtux] [-p] [nazwa[= wartość] ...]

typeset [-aAfFgiIlnrtux] [-p] [nazwa[= wartość] ...]

Declare variables and/or give them attributes. If no names are given then display the values of variables. The -p option will display the attributes and values of each name. When -p is used with name arguments, additional options, other than -f and -F, are ignored. When -p is supplied without name arguments, it will display the attributes and values of all variables having the attributes specified by the additional options. If no other options are supplied with -p, declare will display the attributes and values of all shell variables. The -f option will restrict the display to shell functions. The -F option inhibits the display of function definitions; only the function name and attributes are printed. If the extdebug shell option is enabled using shopt, the source file name and line number where each name is defined are displayed as well. The -F option implies -f. The -g option forces variables to be created or modified at the global scope, even when declare is executed in a shell function. It is ignored in all other cases. The -I option causes local variables to inherit the attributes (except the nameref attribute) and value of any existing variable with the same name at a surrounding scope. If there is no existing variable, the local variable is initially unset. The following options can be used to restrict output to variables with the specified attribute or to give variables attributes:

dirs [-clpv] [+n] [-n ]

Bez opcji wyświetla listę aktualnie zapamiętanych katalogów. Domyślnie wyświetlana jest ona w pojedynczym wierszu, z nazwami katalogów rozdzielonymi spacjami. Katalogi dodawane są do listy poleceniem pushd polecenie popd usuwa pozycje z listy. Bieżący katalog jest zawsze pierwszy na stosie.

disown [-ar] [-h] [zadanie ... | pid ... ]

Bez opcji, usuwa każde z podanych zadań z tablicy zadań aktywnych. Jeśli nie podano zadania i nie użyto ani opcji -a ani -r, to używane jest zadanie bieżące. Jeśli użyto opcji -h, każde zadanie nie jest usuwane z tablicy, ale jest jako takie zaznaczane, tak że do zadania nie jest wysyłany sygnał SIGHUP jeśli powłoka otrzymuje SIGHUP. Jeżeli podano zadanie, opcja -a oznacza usunięcie lub zaznaczenie wszystkich zadań; opcja -r bez argumentu zadania ogranicza akcję do działających zadań. Wartością zwracaną jest 0, chyba że zadanie nie określa poprawnego zadania.

echo [-neE] [argument ...]

Wyświetla argumenty, rozdzielone spacjami, zakończone znakiem nowej linii. Kodem zakończenia jest zawsze 0, chyba że wystąpi błąd zapisu. Jeżeli podano -n, to nie jest wysyłany kończący znak nowej linii. Jeżeli podano opcję -e, włączana jest interpretacja podanych niżej znaków specjalnych. Opcja -E wyłącza interpretację tych znaków, nawet na systemach, gdzie są one domyślnie interpretowane. Do dynamicznego sprawdzania, czy echo interpretuje domyślnie te znaki, czy nie, służy opcja powłoki xpg_echo. echo nie interpretuje -- jako oznaczenia końca opcji. echo interpretuje następujące sekwencje specjalne:

enable [-a] [-dnps] [-f plik] [ nazwa ...]

Włącza i wyłącza wbudowane polecenia powłoki. Wyłączenie poleceń wbudowanych umożliwia wykonanie polecenia dyskowego mającego tę samą nazwę, co wbudowane, bez podawania jego pełnej nazwy ścieżkowej, mimo iż powłoka normalnie szuka poleceń wbudowanych przed poleceniami dyskowymi. Jeżeli posłużono się opcją -n, wyłączana jest każda z nazw; w przeciwnym razie nazwy są włączone. Na przykład, chcąc użyć pliku binarnego test znalezionego przez PATH zamiast wersji wbudowanej w powłokę, należy uruchomić ``enable -n test''. The -f option means to load the new builtin command name from shared object filename, on systems that support dynamic loading. Bash will use the value of the BASH_LOADABLES_PATH variable as a colon-separated list of directories in which to search for filename. The default is system-dependent. The -d option will delete a builtin previously loaded with -f. If no name arguments are given, or if the -p option is supplied, a list of shell builtins is printed. With no other option arguments, the list consists of all enabled shell builtins. If -n is supplied, only disabled builtins are printed. If -a is supplied, the list printed includes all builtins, with an indication of whether or not each is enabled. If -s is supplied, the output is restricted to the POSIX special builtins. If no options are supplied and a name is not a shell builtin, enable will attempt to load name from a shared object named name, as if the command were ``enable -f name name . The return value is 0 unless a name is not a shell builtin or there is an error loading a new builtin from a shared object.

eval [argument ...]

Argumenty są czytane i łączone w pojedyncze polecenie. Polecenie to jest następnie odczytywane i wykonywane przez powłokę, zaś jego kod zakończenia jest zwracany jako wartość eval. Jeżeli nie na żadnych argumentów, lub wszystkie argumenty są puste, eval zwraca 0.

exec [-cl] [-a nazwa] [polecenie [ argumenty]]

If command is specified, it replaces the shell. No new process is created. The arguments become the arguments to command. If the -l option is supplied, the shell places a dash at the beginning of the zeroth argument passed to command. This is what login(1) does. The -c option causes command to be executed with an empty environment. If -a is supplied, the shell passes name as the zeroth argument to the executed command. If command cannot be executed for some reason, a non-interactive shell exits, unless the execfail shell option is enabled. In that case, it returns failure. An interactive shell returns failure if the file cannot be executed. A subshell exits unconditionally if exec fails. If command is not specified, any redirections take effect in the current shell, and the return status is 0. If there is a redirection error, the return status is 1.

exit [n]

Powoduje, że powłoka kończy pracę z kodem równym n. Jeśli pominięto n, kodem zakończenia jest kod ostatniego wykonanego polecenia. Przed końcem pracy powłoki wykonywane jest przechwycenie sygnału EXIT.

export [-fn] [nazwa[=słowo]] ...

export -p

Podane nazwy zaznaczane są do automatycznego wyeksportowania do środowiska następnych wykonywanych poleceń. Jeśli podano opcję -f, to nazwy odnoszą się do funkcji. Jeżeli nie podano żadnych nazw lub jeżeli podano opcję -p, to wypisywana jest lista nazw wszystkich eksportowanych w tej powłoce zmiennych. Opcja -n powoduje usunięcie cechy eksportowania z podanych zmiennych. Jeśli po nazwie zmiennej występuje = słowo, to wartość zmiennej jest ustawiana na słowo. export zwraca zerowy kod zakończenia, chyba że napotkano nieprawidłową opcję, jedna z nazw nie jest poprawną nazwą zmiennej powłoki lub podano -f z nazwą, która nie jest funkcją.

fc [-e nazwa_e] [-lnr] [pierwsze] [ ostatnie]

fc -s [wzorzec=zastąpienie] [ polecenie]

The first form selects a range of commands from first to last from the history list and displays or edits and re-executes them. First and last may be specified as a string (to locate the last command beginning with that string) or as a number (an index into the history list, where a negative number is used as an offset from the current command number). When listing, a first or last of 0 is equivalent to -1 and -0 is equivalent to the current command (usually the fc command); otherwise 0 is equivalent to -1 and -0 is invalid. If last is not specified, it is set to the current command for listing (so that ``fc -l -10'' wypisuje ostatnich 10 poleceń) i na pierwsze w pozostałych przypadkach. Jeżeli nie określono pierwszego polecenia, to jest ono ustawiane na poprzednie polecenie w przypadku edycji a na -16 przy listowaniu. Opcja -n wstrzymuje wyświetlanie numerów poleceń podczas listowania. Opcja -r odwraca kolejność poleceń. Jeżeli podano opcję -l, to polecenia listowane są na standardowym wyjściu. W przeciwnym razie dla pliku zawierającego te polecenia wywoływany jest edytor podany przez nazwa_e. Jeżeli nie podano nazwa_e, używana jest wartość FCEDIT, a wartość EDITOR jeśli nie ustawiono FCEDIT. Jeżeli nie ustawiono żadnej z nich, używany jest vi Po zakończeniu edycji, wysyłane edytowane polecenia są wyświetlane przez echo i wykonywane. W drugiej postaci, polecenie jest ponownie wykonywane po każdej wymianie wystąpienia wzorca przez zastąpienie. Polecenie jest interpretowane podobnie jak pierwsze powyżej. Przydatnym aliasem do wykorzystania z tą formą jest ``r="fc -s"'', tak, że napisanie ``r cc'' uruchamia ostatnie polecenie rozpoczynające się od ``cc'' a napisanie ``r'' ponownie wykonuje ostatnie polecenie. Jeżeli użyta została pierwsza postać, to wartością zwracaną jest 0, chyba że napotkano nieprawidłową opcję lub pierwszy albo ostatni określają wiersze historii spoza zakresu. Jeżeli podano opcję -e, wartością zwracaną jest wartość ostatniego wykonanego polecenia lub niepowodzenie jeśli pojawił się błąd tymczasowego pliku poleceń. Jeżeli użyta została druga postać, to zwracanym kodem jest kod ponownie wykonanego polecenia, chyba że polecenie nie określa poprawnego wiersza poleceń -- wówczas fc zwraca porażkę.

fg [zadanie]

Wznawia zadanie na pierwszym planie i czyni je zadaniem bieżącym. Jeżeli nie podano zadania, używane jest bieżące zadanie w pojęciu powłoki. Wartością zwracaną jest wartość polecenia umieszczonego na pierwszym planie, lub porażka jeżeli fb uruchomiono przy wyłączonej kontroli zadań, lub uruchomiono je przy włączonej kontroli zadań, ale zadanie nie określa prawidłowego zadania lub zadanie określa zadanie, które zostało uruchomione bez kontroli zadań.

getopts optstring name [arg ...]

getopts używane jest przez procedury powłoki do analizy parametrów pozycyjnych. Łańcuch opcji zawiera znaki opcji, jakie mają być rozpoznawane; jeżeli po znaku występuje dwukropek, to oczekuje się, że opcja będzie posiadać argument, który powinien być od niej oddzielony białym znakiem. Jako znaki opcji nie mogą wystąpić dwukropek i znak zapytania. Przy każdym wywołaniu getopts umieszcza następną opcję w zmiennej powłoki nazwa, inicjując nazwę jeśli nie istniała. Indeks następnego argumentu do przetwarzania umieszczany jest w zmiennej OPTIND. OPTIND inicjowany jest na 1 za każdym razem, gdy wywoływana jest powłoka lub skrypt powłoki. Gdy opcja wymaga argumentu, getopts umieszcza go w zmiennej OPTARG. Powłoka nie resetuje OPTIND automatycznie; musi być on resetowany ręcznie pomiędzy wielokrotnymi odwołaniami do getopts w tym samym wywołaniu powłoki, jeśli używany ma być nowy zestaw parametrów. Po napotkaniu końca opcji, getopts kończy pracę zwracając wartość większą od zera. OPTIND ustawiane jest na indeks pierwszego argumentu nie będącego opcją, zaś nazwa ustawiana jest na ?. getopts normally parses the positional parameters, but if more arguments are supplied as arg values, getopts parses those instead. getopts może zgłaszać błędy na dwa sposoby. Jeżeli pierwszym znakiem łańcucha opcji jest dwukropek, to stosowane jest ciche (silent) zgłaszanie błędów. Przy zwykłej pracy komunikaty diagnostyczne wypisywane są przy napotkaniu nieprawidłowych opcji lub brakujących argumentów opcji. Jeżeli zmienna OPTERR ustawiona jest na 0, nie będą wyświetlane żadne komunikaty błędów, nawet jeśli pierwszym znakiem łańcucha opcji nie jest dwukropek. Przy napotkaniu nieprawidłowej opcji getopts umieszcza ? w nazwie i, jeśli nie pracuje w trybie cichym, wypisuje komunikat błędu i kasuje OPTARG. Jeżeli getopts pracuje w trybie cichym, to znaleziony znak opcji umieszczany jest w OPTARG i nie jest wypisywany żaden komunikat diagnostyczny. Jeśli nie znaleziono wymaganego argumentu, a getopts nie pracuje w trybie cichym, w nazwa umieszczany jest znak zapytania (?), kasowane jest OPTARG i wyświetlany jest komunikat błędu. Jeżeli getopts pracuje w trybie cichym, to w nazwie umieszczany jest dwukropek ( :), a OPTARG ustawiane jest na znaleziony znak opcji. getopts zwraca prawdę, jeśli znaleziono określoną lub nie określoną opcję. Zwraca fałsz jeżeli napotkano koniec opcji lub pojawił się błąd.

hash [-lr] [-p plik] [-dt] [ nazwa]

Dla każdej nazwy określana i zapamiętywana jest pełna nazwa plikowa polecenia wyszukanego w katalogach $PATH. Jeżeli podano opcję -p, nie jest wykonywane przeszukanie ścieżki, a plik używane jest jako pełna nazwa pliku polecenia. Opcja -r powoduje, że powłoka zapomina wszystkie zapamiętane wcześniej miejsca. Opcja -d powoduje, że powłoka zapomina wszystkie zapamiętane wcześniej miejsca dla każdej nazwy. Jeśli podano opcję -t, to wypisywana jest odpowiadająca nazwie pełna nazwa pliku. Jeżeli przy więcej niż jednym argumencie nazwy podano -t, to przed każdą przechowywaną pełną nazwą wypisywana jest nazwa. Opcja -l powoduje wyświetlanie wyniku w formacie, który może zostać ponownie wykorzystany jako wejście. Jeżeli nie podano żadnych argumentów, to wypisywana jest informacja o zapamiętanych poleceniach. Kodem zwracanym jest prawda, chyba że nie odnaleziono nazwy lub podano nieprawidłową opcję.

help [-dms] [wzorzec]

Wyświetla pomocne informacje o poleceniach wbudowanych. Jeżeli podano wzorzec, to help daje szczegółową pomoc dotyczącą wszystkich poleceń pasujących do wzorca; w przeciwnym razie wypisywana jest pomoc dla wszystkich poleceń wbudowanych i struktur sterujących powłoki.

history [n]

history -c

history -d przesunięcie

history -d start-end

history -anrw [plik]

history -p arg [arg ...]

history -s arg [arg ...]

Bez żadnych opcji, wyświetla listę historii poleceń z numerami wierszy. Wiersze ukazane z * zostały zmienione. Argument n pokazuje jedynie ostatnich n wierszy. Jeśli ustawiono zmienną powłoki HISTTIMEFORMAT i nie jest ona pusta, to do wyświetlania pieczątek czasowych związanych z każdym wyświetlanym wpisem historii używany jest format łańcucha do strftime(3). Pomiędzy formatowaną pieczątką czasową a wierszem historii nie jest wstawiany odstęp. Jeżeli podano plik, to używany jest on jako nazwa pliku historii; jeśli nie, to używana jest wartość HISTFILE. Opcje, jeżeli je podano, mają następujące znaczenie:

jobs [-lnprs] [ zadanie ... ]

jobs -x polecenie [ argumenty ... ]

Pierwsza postać podaje aktywne zadania. Opcje mają następujące znaczenie:

kill [-s sigspec | -n signum | -sigspec] [pid | jobspec] ...

kill -l|-L [sigspec | exit_status]

Wysyła sygnały określony przez sigspec lub signum do procesu określonego przez pid lub jobspec. sigspec jest albo nazwą sygnału, jak np. SIGKILL (z lub bez przedrostka SIG) albo numerem sygnału; signum jest numerem sygnału. Jeśli nie podano sigspec, to przyjmuje się SIGTERM. Opcja -l listuje nazwy sygnałów. Jeżeli przy podanym -l użyto jakichś argumentów, to listowane są sygnały odpowiadające tym argumentom, a kodem zwracanym jest 0. Argument exit_status opcji -l jest liczbą określającą numer sygnału lub kod zakończenia procesu przerwanego przez sygnał. Opcja -L jest równoważna -l. kill zwraca prawdę, jeśli przynajmniej jeden z sygnałów został pomyślnie przesłany, lub fałsz, jeśli pojawił się błąd lub napotkano niepoprawną opcję.

let arg [arg ...]

Each arg is an arithmetic expression to be evaluated (see ARITHMETIC EVALUATION above). If the last arg evaluates to 0, let returns 1; 0 is returned otherwise.

local [opcja] [nazwa[=wartość] ... | - ]

For each argument, a local variable named name is created, and assigned value. The option can be any of the options accepted by declare. When local is used within a function, it causes the variable name to have a visible scope restricted to that function and its children. If name is -, the set of shell options is made local to the function in which local is invoked: shell options changed using the set builtin inside the function are restored to their original values when the function returns. The restore is effected as if a series of set commands were executed to restore the values that were in place before the function. With no operands, local writes a list of local variables to the standard output. It is an error to use local when not within a function. The return status is 0 unless local is used outside a function, an invalid name is supplied, or name is a readonly variable.

logout

Kończy pracę powłoki zgłoszeniowej.

mapfile [-d sep] [-n liczba] [ -O indeks] [-s liczba] [-t] [ -u fd] [-C wywoł-zwr] [-c wielkość] [tablica]

readarray [-d sep] [-n liczba] [ -O indeks] [-s liczba] [-t] [ -u fd] [-C wywoł-zwr] [-c wielkość] [tablica]

Odczytuje wiersze ze standardowego wejścia do indeksowanej zmiennej tablicowej tablica lub, jeśli podano opcję -u, z deskryptora pliku fd. Domyślną tablicą jest zmienna MAPFILE Opcje, jeśli je podano, mają następujące znaczenie:

popd [-n] [+n] [-n]

Removes entries from the directory stack. The elements are numbered from 0 starting at the first directory listed by dirs. With no arguments, popd removes the top directory from the stack, and changes to the new top directory. Arguments, if supplied, have the following meanings:

printf [-v zmienna] format [argumenty]

Zapisuje sformatowane argumenty na standardowe wyjście przy pomocy zadanego formatu. Opcja -v przypisuje wynik do zmiennej zmienna zamiast wyświetlać je na standardowe wyjściowe. format jest łańcuchem znakowym zawierającym trzy rodzaje obiektów: zwykłe znaki, które są po prostu kopiowane na standardowe wyjście, sekwencje specjalne, które są konwertowane i kopiowane na standardowe wyjście, i specyfikacje formatu, z których każda powoduje wypisanie następnego kolejnego argumentu. Oprócz standardowych formatów printf(1), interpretuje on również następujące rozszerzenia:

pushd [-n] [+n] [-n]

pushd [-n] [katalog]

Adds a directory to the top of the directory stack, or rotates the stack, making the new top of the stack the current working directory. With no arguments, pushd exchanges the top two elements of the directory stack. Arguments, if supplied, have the following meanings:

pwd [-LP]

Wypisuje bezwzględną nazwę pliku bieżącego katalogu roboczego. Pokazana nazwa nie zawiera żadnych dowiązań symbolicznych jeśli podano opcję -P albo włączona jest opcja -o physical wbudowanego polecenia set. Jeśli użyto opcji -L, wypisana nazwa ścieżkowa może zawierać dowiązania symboliczne. Zwracany kod wynosi 0, chyba że podczas odczytu nazwy bieżącego katalogu pojawi się błąd lub podano nieprawidłową opcję.

read [-ers] [-a anazwa] [-d znak-odst] [-i tekst] [-n nznaki] [ -N nznaki] [-p zachęta] [ -t czas-oczek] [-u fd] [nazwa ...]

One line is read from the standard input, or from the file descriptor fd supplied as an argument to the -u option, split into words as described above under Word Splitting, and the first word is assigned to the first name, the second word to the second name, and so on. If there are more words than names, the remaining words and their intervening delimiters are assigned to the last name. If there are fewer words read from the input stream than names, the remaining names are assigned empty values. The characters in IFS are used to split the line into words using the same rules the shell uses for expansion (described above under Word Splitting). The backslash character ( \) may be used to remove any special meaning for the next character read and for line continuation. Options, if supplied, have the following meanings:

readonly [-aAf] [-p] [nazwa[=słowo] ...]

Podane nazwy oznaczane są jako readonly; wartości tych nazw nie mogą być zmieniane następującymi później przypisaniami. Jeśli podano opcję -f, oznaczane są funkcje o nazwach odpowiadających nazwom. Opcja -a ogranicza zmienne do tablic indeksowanych, a -A do tablic asocjacyjnych. Jeśli podano obie opcje, pierwszeństwo ma opcja -A. Jeśli nie podano argumentów nazw lub jeśli podano opcję -p, wypisywane jest zestawienie wszystkich nazw o atrybucie readonly. Inne opcje mogą zostać użyte do ograniczenia wyniku do podzbioru nazw readonly. Opcja -p powoduje, że wyniki będą wyświetlane w formacie, który może być ponownie wykorzystany jako wejście. Jeśli po nazwie zmiennej występuje = słowo, to wartość zmiennej jest ustawiana na słowo. Zwracany jest kod równy 0, chyba że napotkano nieprawidłową opcję, jedna z nazw nie jest poprawną nazwą zmiennej powłoki lub podano -f z nazwą, która nie jest funkcją.

return [n]

Causes a function to stop executing and return the value specified by n to its caller. If n is omitted, the return status is that of the last command executed in the function body. If return is executed by a trap handler, the last command used to determine the status is the last command executed before the trap handler. If return is executed during a DEBUG trap, the last command used to determine the status is the last command executed by the trap handler before return was invoked. If return is used outside a function, but during execution of a script by the . (source) command, it causes the shell to stop executing that script and return either n or the exit status of the last command executed within the script as the exit status of the script. If n is supplied, the return value is its least significant 8 bits. The return status is non-zero if return is supplied a non-numeric argument, or is used outside a function and not during execution of a script by . or source. Any command associated with the RETURN trap is executed before execution resumes after the function or script.

set [-abefhkmnptuvxBCEHPT] [-o option-name] [ --] [-] [arg ...]

set [+abefhkmnptuvxBCEHPT] [+o option-name] [ --] [-] [arg ...]

Without options, display the name and value of each shell variable in a format that can be reused as input for setting or resetting the currently-set variables. Read-only variables cannot be reset. In posix mode, only shell variables are listed. The output is sorted according to the current locale. When options are specified, they set or unset shell attributes. Any arguments remaining after option processing are treated as values for the positional parameters and are assigned, in order, to $1, $2, ... $n. Options, if specified, have the following meanings:

shift [n]

Parametrom pozycyjnym od n+1 ... zmienia nazwy na $1 ..... Parametry reprezentowane przez liczby $# w dół do $#-n+1 są usuwane. n musi być liczbą nieujemną mniejszą lub równą $#. Jeżeli n wynosi 0, parametry nie są zmieniane. Jeżeli nie podano n, zakłada się, że wynosi 1. Jeżeli n jest większe od $#, parametry pozycyjne nie są zmieniane. Kod zakończenia jest większy od zera jeżeli n jest większe od $# lub mniejsze od zera; w przeciwnym wypadku 0.

shopt [-pqsu] [-o] [nazwa_opcji ...]

Toggle the values of settings controlling optional shell behavior. The settings can be either those listed below, or, if the -o option is used, those available with the -o option to the set builtin command. With no options, or with the -p option, a list of all settable options is displayed, with an indication of whether or not each is set; if optnames are supplied, the output is restricted to those options. The -p option causes output to be displayed in a form that may be reused as input. Other options have the following meanings: