bash

NOME

SINTASSI

COPYRIGHT

DESCRIZIONE

OPZIONI

-c

Se è presente l'opzione -c, i comandi sono letti dal primo argomento non di opzione stringa_di_comando.Se vi sono argomenti dopo la stringa_di_comando, essi sono assegnati ai parametri posizionali, partendo da $0, e i rimanenti argomenti vengono assegnati ai parametri posizionali. L'assegnamento a $0 imposta il nome della shell, che è usato nei messaggi di avvertimento e di errore.

-i

Se è presente l'opzione -i, la shell è interattiva.

-l

fa sì che bash funzioni come se fosse stata invocata come una shell di login (si veda INVOCAZIONE più avanti).

-r

Se l'opzione -r è presente, la shell diventa ristretta (si veda SHELL RISTRETTA più avanti).

-s

Se è presente l'opzione -s, o se non rimane alcun argomento dopo che sono state esaminate le opzioni, i comandi sono letti dallo standard input. Quest'opzione permette di impostare i parametri posizionali quando si invoca una shell interattiva o si legge l'input tramite una pipe.

-v

Stampa le righe in input alla shell appena sono lette.

-x

Stampa comandi e i loro argomenti così come vengono eseguiti.

-D

Una lista di tutte le stringhe fra virgolette preceduta da $ è stampata sullo standard output. Queste sono le stringhe che sono soggette a traduzione di linguaggio quando la localizzazione corrente non è C o POSIX. Questo implica l'opzione -n; nessun comando verrà eseguito.

[-+]O [shopt_option]

shopt_option è una delle opzioni di shell accettate dal comando incorporato shopt (si veda COMANDI INCORPORATI DELLA SHELL più avanti). Se shopt_option è presente, -O imposta il valore di quella opzione; +O lo rimuove. Se shopt_option non è fornita, i nomi e i valori delle opzioni della shell accettati da shopt sono stampati sullo standard output. Se l'opzione di invocazione è +O, l'output è mostrato in un formato riutilizzabile come input.

--

Un -- segna la fine delle opzioni e disabilita l'ulteriore elaborazione di opzioni. Gli argomenti dopo il -- sono trattati come nomifile e argomenti. Un argomento di - è equivalente a --.

--debugger

Dispone l'esecuzione del debugger profile prima dell'avvio della shell. Attiva la modalità estesa di debug (si veda la descrizione dell'opzione extdebug al comando incorporato shopt più avanti).

--dump-po-strings

Equivalente a -D, ma l'output è nel formato file GNU gettext po (portable object).

--dump-strings

Equivalente a -D.

--help

Mostra sullo standard output un messaggio sull'uso ed esce con stato di uscita 0.

--init-file file

--rcfile file

Esegue comandi letti da file, invece che dal file d'inizializzazione generale di sitema /etc/bash.bashrc e dal file personale di inizializzazione standard ~/.bashrc se la shell è interattiva (si veda INVOCAZIONE più avanti).

--login

Equivalente a -l.

--noediting

Non usa la libreria GNU readline per leggere righe di comando quando la shell è interattiva.

--noprofile

Non legge né il file di inizializzazione generico di sistema /etc/profile né alcuno dei file personali di inizializzazione ~/.bash_profile, ~/.bash_login, o ~/.profile. Per impostazione predefinita bash legge questi file quando è invocata come shell di login (si veda INVOCAZIONE più avanti).

--norc

Non legge né esegue il file file d'inizializzazione generale di sitema /etc/bash.bashrc e il personale di inizializzazione ~/.bashrc se la shell è interattiva. Quest'opzione è attiva per impostazione predefinita se la shell è invocata come sh.

--posix

Cambia il comportamento di bash dove le operazioni predefinite differiscono dallo standard POSIX, in modo da corrispondere allo standard ( modalità posix). Si veda più avanti VEDERE ANCHE dove viene citato un documento che spiega nel dettaglio come la modalità posix influenza il comportamento di bash.

--restricted

La shell diventa ristretta (si veda SHELL RISTRETTA più avanti).

--verbose

Equivalente a -v.

--version

Mostra informazioni sulla versione di questa istanza di bash sullo standard output ed esce con stato d'uscita 0.

ARGOMENTI

INVOCAZIONE

DEFINIZIONI

blank

Uno spazio o carattere di tabulazione (tab).

parola

Una sequenza di caratteri considerata come una singola unità dalla shell. Nota anche come token.

nome

Una parola che consiste solo di caratteri alfanumerici e trattini di sottolineatura, e comincia con un carattere alfabetico o un trattino di sottolineatura. Definita anche un identificatore.

metacarattere

Un carattere che, quando non quotato, separa le parole. Uno dei seguenti:

 

operatore di controllo

Un token che realizza una funzione di controllo. È uno dei seguenti simboli:

PAROLE RISERVATE

GRAMMATICA DELLA SHELL

Comandi semplici

Pipeline

Liste

Comandi composti

(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 è semplicemente eseguita nell'ambiente di shell corrente. lista deve essere fatta terminare con un newline o un punto e virgola. Questo è conosciuto come group command. Lo stato di ritorno è lo stato d'uscita di lista. Da notare che diversamente dai metacaratteri ( e ), { e } sono parole riservate e devono essere usati quando una parola riservata è ammissibile. Poiché esse non causano una divisione delle parole, devono essere separate da lista con uno spazio o un altro metacarattere di shell.

((espressione))

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.

[[ espressione ]]

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. Quando vengono usati con [[, gli operatori < e > vengono ordinati lessicograficamente usando la localizzazione corrente.

for nome [ [ in [ parola ... ] ] ; ] do lista ; done

La lista di parole che seguono in è espansa, generando una lista di elementi. La variabile nome è impostata, di volta in volta, a ciascun elemento di questa lista e lista è eseguita ogni volta. Se la in parola è omessa, il comando for esegue lista una volta per ogni parametro posizionale esistente (si veda PARAMETRI più avanti). Lo stato di ritorno è lo stato d'uscita dell'ultimo comando eseguito. Se l'espansione degli elementi che seguono in risultano in una lista vuota, non è eseguito alcun comando, e lo stato di ritorno è 0.

for (( espr1 ; espr2 ; espr3 )) ; do lista ; done

Prima viene valutata l'espressione aritmetica espr1 in accordo con le regole descritte più avanti sotto VALUTAZIONE ARITMETICA. Viene quindi valutata ripetutamente l'espressione aritmetica espr2 finché non assume il valore zero. Ogni volta che espr2 è diverso da zero, lista viene eseguita e l'espressione aritmetica espr3 viene valutata. Se qualche espressione è omessa, si suppone che abbia il valore 1. Il valore di ritorno è lo stato d'uscita dell'ultimo comando in lista che è eseguito, o falso se una qualsiasi delle espressioni non è valida.

select nome [ in parola ] ; 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 parola in [ [(] modello [ | modello ] ... ) 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

La lista if è eseguita. Se il suo stato d'uscita è 0, è eseguita la lista dopo then. Altrimenti, è eseguita a turno ciascuna lista dopo elif, e se il suo stato d'uscita è 0, è eseguita la corrispondente lista dopo then e il comando termina. Altrimenti, se presente, è eseguita, la lista dopo else. Lo stato d'uscita è lo stato d'uscita dell'ultimo comando eseguito, o zero se nessuna delle condizioni considerate è risultata essere vera.

while lista-1; do lista-2; done

until lista-1; do lista-2; done

Il comando while esegue ripetutamente la lista lista-2 finché l'ultimo comando nella lista lista-1 ritorna uno stato di uscita di zero. Il comando until è identico al comando while, con la sola differenza che il risultato del test è negato: lista-2 è eseguita finché l'ultimo comando in lista-1 ritorna uno stato d'uscita diverso da zero. Lo stato d'uscita dei comandi while e until è lo stato d'uscita dell'ultimo comando eseguito in lista-2, o zero se non ne è stato eseguito alcuno.

Coprocessi

Definizioni della funzione di shell

fname () comando-composto [ridirezione]

function fname [()] comando-composto [ridirezione]

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.)

COMMENTI

QUOTATURA

PARAMETRI

Parametri posizionali

Parametri speciali

*

Si espande nei parametri posizionali, a partire dal primo. Quando l'espansione non è tra virgolette, ogni parametro posizionale si espande in una parola separata. In contesti in cui è effettuata, queste parole sono soggette a successiva suddivisione in parole ed espansione di percorso. Quando l'espansione avviene tra virgolette, si espande in una singola parola contenente il valore di ciascun parametro separato dagli altri dal primo carattere della variabile speciale IFS. Cioè, "$*" è equivalente a " $1c$2c...", dove c è il primo carattere del valore della variabile IFS. Se IFS viene annullata, i parametri sono separati da spazi. Se IFS è nulla, i parametri sono uniti senza alcun separatore.

@

Si espande nei parametri posizionali, a partire dal primo. In contesti in cui è effettuata la suddiviisone in parole, questo espande ogni parametro posizionale in una parola separata; se non è no è tra virgolette, queste parole sono soggette a suddivisione in parole In contesti in cui non è effettuata la suddivisione in parole. questo si espande una parola singola con ogni parametro posizionale separato da spazio. Quando l'espansione avviene tra virgolette, ogni parametro si espande in una parola separata. Cioè, " $@" è equivalente a "$1" "$2" ... Se l'espansione fra virgolette avviene all'interno di una parola, l'espansione del primo parametro è unita con la parte iniziale della parola originale, e l'espansione dell'ultimo parametro è unita con la parte finale della parola originale. Quando non vi è alcun parametro posizionale, " $@" e $@ si espandono come stringa nulla (cioè, sono rimossi).

#

Si espande nel numero di parametri posizionali espresso come numero decimale.

?

Si espande nello stato di uscita della pipeline eseguita più recentemente senza rilasciare il controllo del terminale.

-

Si espande nei flag di opzione correnti come specificato in base alla chiamata, dal comando incorporato set, o in quelli impostati dalla shell stessa (come l'opzione -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.

!

Si espande nell'ID di processo del job più recentemente messo in background, se eseguito come comando asincrono o usando il comando incorporato bg (si veda JOB CONTROL più avanti).

0

Si espande nel nome della shell o script di shell. Questo è impostato alla inizializzazione della shell. Se bash è chiamata con un file di comandi, $0 è impostato al nome di quel file. Se bash è avviata con l'opzione -c, allora $0 è impostato al primo argomento dopo la stringa che deve essere eseguita, se presente. Altrimenti, è impostato al nome-file usato per chiamare bash, come dato dall'argomento zero.

Variabili di shell

_

All'avvio della shell, impostato al nome di percorso usato per invocare la shell o lo script di shell che è eseguito come passato nell'ambiente o nella lista di argomenti. Successivamente, si espande nell'ultimo argomento del precedente comando semplice eseguito inprimo piano, dopo l'espansione. È anche impostato al nome completo usato per invocare ogni comando eseguito e messo nell'ambiente esportato verso quel comando. Mentre si controlla la posta, questo parametro contiene il nome del file del messaggio attualmente in esame.

BASH

Si espande al nome-file completo usato per chiamare questa istanza di bash.

BASHOPTS

Una lista di opzioni di shell abilitate separate da un due punti. Ogni parola della lista è un argomento valido per l'opzione -s del comando incorporato shopt (si veda COMANDI INCORPORATI DELLA SHELL più avanti). Le opzioni che appaiono in BASHOPTS sono quelle contrassegnate come on da shopt. Se questa variabile è nell'ambiente quando bash viene avviato, ogni opzione di shell nella lista sarà abilitata prima della lettura di qualsiasi file di avvio. Questa variabile è di sola lettura.

BASHPID

Espande all'ID del processo dell'attuale bash. In determinate circostanze, ciò differisce da $$, come nel caso di subshell che non richiedono che bash sia reinizializzato. Assegnamenti a BASHPID non hanno alcun effetto. Se BASHPID viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

BASH_ALIASES

Una variabile array associativa i cui elementi corrispondono alla lista interna di alias come conservati dal comando incorporato alias. Gli elementi aggiunti a questo array appaiono nella lista degli alias; comunque, togliendo elementi all'array attualmente gli alias non vengono rimossi dalla lista. Se BASH_ALIASES viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

BASH_ARGC

Una variabile array i cui valori sono il numero di parametri in ogni frame del corrente stack delle chiamate di esecuzione di bash. Il numero di parametri della subroutine corrente (funzione di shell o script eseguito con . o source) è in cima allo stack. Quando viene eseguita una subroutine, il numero di parametri passati è messo in cima a BASH_ARGC. La shell imposta BASH_ARGC solo quando è in modalità estesa di debugging (si veda la descrizione dell'opzione extdebug per il comando incorporato shopt più avanti). Impostare extdebug dopo che la shell ha iniziato a eseguire uno script, o referenziare questa variabile quando extdebug non è impostato, può dar luogo a valori incongruenti.

BASH_ARGV

Una variabile array contenente tutti i parametri nel corrente stack delle chiamate di esecuzione di bash. Il parametro finale dell'ultima chiamata di subroutine è in cima allo stack; il primo parametro della chiamata iniziale è in fondo. Quando una subroutine viene eseguita, i parametri forniti sono messi in cima a BASH_ARGV. La shell imposta BASH_ARGV solo quando è in modalità estesa di debugging (si veda la descrizione dell'opzione extdebug al comando incorporato shopt più avanti). Impostare extdebug dopo che la shell ha iniziato a eseguire uno script, o referenziare questa variabile quando extdebug non è impostato, può dar luogo a valori incongruenti.

BASH_ARGV0

Quando referenziata, questa variabile espande nel nome della shell o script di shell (identico a $0; si veda sopra la descrizione del parametro speciale 0). L'assegnamento a BASH_ARGV0 fa si che il vaqlore assegnato sia assegnato anche a $0. Se BASH_ARGV0 viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

BASH_CMDS

Un variabile array associativa i cui elementi corrispondono alla tabella hash interna di comandi come memorizzati dal comando incorporato hash. Gli elementi aggiunti a questo array appaiono nella tabella hash; comunque, togliendo elementi all'array attualmente i nomi dei comandi non saranno rimossi dalla tabella hash. Se BASH_CMDS non è impostata, perde le sue proprietà speciali, anche se è successivamente annullata.

BASH_COMMAND

Il comando attualmente in esecuzione o in procinto di essere eseguito, a meno che la shell non stia eseguendo un comando come risultato di un'intercettazione di segnale (trap), nel qual caso è il comando in esecuzione al momento dell'intercettazione. Se BASH_COMMAND viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

BASH_EXECUTION_STRING

L'argomento per il comando all'invocazione dell'opzione -c.

BASH_LINENO

Una variabile array i cui elementi sono i numeri di riga nei file di origine dove ogni elemento corrispondente di FUNCNAME è stato chiamato. ${BASH_LINENO[ $i]} è il numero di riga nel file di origine ( ${BASH_SOURCE[$i+1]}) dove ${FUNCNAME[ $i]} è stato chiamato (o ${BASH_LINENO[ $i-1]} se referenziato all'interno di un'altra funzione di shell). Usare LINENO per ottenere il numero di riga corrente.

BASH_LOADABLES_PATH

Un elenco di directory, separate da due punti, nelle quali la shell cerca i comandi incorporato caricabili dinamicamente specificati dal comando enable.

BASH_REMATCH

Una variabile array i cui elementi sono assegnati dall'operatore binario =~ al comando condizionale [[. L'elemento con indice 0 è la porzione della stringa che corrisponde all'intera espressione regolare. L'elemento con indice n è la porzione della stringa che corrisponde alla n-sima sott-espressione fra parentesi.

BASH_SOURCE

Una variabile array i cui elementi sono i nomifile dove sono definiti i nomi delle corrispondenti funzioni di shell nella variabile FUNCNAME. La funzione di shell ${FUNCNAME[$i]} è definita nel file ${BASH_SOURCE[$i]} ed è chiamata da ${BASH_SOURCE[ $i+1]}.

BASH_SUBSHELL

Incrementato di uno al'interno di ciascuna subshell o ambiente di subshell quando la shell inizia a essere eseguita in quell'ambiente. Il valore iniziale è 0. Se BASH_SUBSHELL viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

BASH_VERSINFO

Una variabile array in sola lettura i cui elementi danno informazioni sulla versione di quest'istanza di bash. I valori assegnati ai membri dell'array sono come segue:

BASH_VERSION

Si espande in una stringa che descrive la versione di questa istanza di bash.

COMP_CWORD

Un indice in ${COMP_WORDS} della parola contenente la posizione corrente del cursore. Questa variabile è disponibile solo nelle funzioni di shell invocate dalle risorse di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_KEY

Il tasto (o il tasto finale di una sequenza) usato per invocare la funzione di completamento corrente.

COMP_LINE

La riga di comando corrente. Questa variabile è disponibile solo nelle funzioni di shell e nei comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_POINT

L'indice della posizione corrente del cursore relativa all'inizio del comando corrente. Se la posizione corrente del cursore è alla fine del comando corrente, il valore di questa variabile è uguale a ${#COMP_LINE}. Questa variabile è disponibile solo nelle funzioni di shell e comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_TYPE

Impostata a un valore intero corrispondente al tipo di completamento tentato che ha causato la chiamata di una funzione di completamento: TAB, per il completamento normale, ?, per l'elenco dei completamenti dopo tabulazioni successive, !, per l'elenco delle alternative di completamento di una parte di parola, @, per elencare i completamenti se la parola non ha subito modifiche, o %, per il menù del completamento. Questa variabile è disponibile solo nelle funzioni di shell e nei comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COMP_WORDBREAKS

L'insieme dei caratteri che la libreria readline tratta come separatori di parola nell'effettuare il completamento di parola. Se COMP_WORDBREAKS viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

COMP_WORDS

Una variabile array (si veda Array più avanti) che è composta dalle singole parole nella riga di comando corrente. La riga è divisa in parole come readline la dividerebbe usando COMP_WORDBREAKS come descritto precedentemente. Questa variabile è disponibile solo nelle funzioni di shell e comandi esterni invocati dai servizi di completamento programmabile (si veda Completamento programmabile più avanti).

COPROC

Una variabile array (si veda Array più avanti) creata per contenere i descrittori di file di uscita e di entrata di un coprocesso senza nome (si veda Coprocessi più avanti).

DIRSTACK

Una variabile array (si veda Array più avanti) che contiene il contenuto corrente dello stack delle directory. Le directory appaiono nello stack nell'ordine in cui sono mostrate dal comando incorporato dirs. L'assegnamento agli elementi di questa variabile array può essere usato per modificare le directory già nello stack, ma i comandi incorporati pushd e popd devono essere usati per aggiungere e rimuovere directory. L'assegnamento a questa variabile non cambia la directory corrente. Se DIRSTACK viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

EPOCHREALTIME

Ogni volta che questo parametro è referenziato, espande al numero di secondi a partire dall'epoca Unix (si veda time(3)) come valore in virgola mobile con grado di frazionamento di microsecondi. Gli assegnamenti a EPOCHREALTIME vengono ignorati. Se EPOCHREALTIME viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

EPOCHSECONDS

Ogni volta che questo parametro è referenziato, espande a un numero di secondi trascorsi dall'epoca Unix (si veda time(3)). Assegnamenti a EPOCHSECONDS vengono ignorati. Se EPOCHSECONDS è annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

EUID

Espande all'ID-utente effettivo dell'utente corrente, inizializzata all'avvio della shell. Questa variabile è in sola lettura.

FUNCNAME

Una variabile array contenente i nomi di tutte le funzioni di shell attualmente nello stack delle chiamate di esecuzione. L'elemento con indice 0 è il nome della funzione di shell attualmente in esecuzione. L'elemento più in basso di tutti (quello con l'indice più alto) è "main". Questa variabile esiste solo quando è in esecuzione una funzione di shell. Assegnamenti a FUNCNAME non hanno alcun effetto. Se FUNCNAME viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata. Questa variabile può essere usata con BASH_LINENO e BASH_SOURCE. Ogni elemento di FUNCNAME ha elementi corrispondenti in BASH_LINENO e BASH_SOURCE per descrivere lo stack delle chiamate. Per esempio, ${FUNCNAME[$i]} è stato chiamato dal file ${BASH_SOURCE[$i+1]} al numero di riga ${BASH_LINENO[$i]}. Il comando incorporato caller visualizza lo stack delle chiamate corrente usando questa informazione.

GROUPS

Una variabile array contenente l'elenco dei gruppi dei quali è membro l'utente corrente. Assegnamenti a GROUPS non hanno alcun effetto. Se GROUPS viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

HISTCMD

Il numero di cronologia, o indice nella lista della cronologia, del comando corrente. Gi assegnamenti a HISTCMD vengono ignorati. Se HISTCMD viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

HOSTNAME

Automaticamente impostata al nome dell'host corrente.

HOSTTYPE

Automaticamente impostata a una stringa che univocamente descrive il tipo di macchina su cui bash è in esecuzione. Il valore predefinito è dipendente dal sistema.

LINENO

Ogni volta che questo parametro è referenziato, la shell gli assegna un numero decimale che rappresenta il numero di sequenza della riga corrente (partendo da 1) all'interno di uno script o funzione. Quando non in uno script o funzione, non è garantito che il valore restituito sia significativo. Se LINENO viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

MACHTYPE

Automaticamente impostata a una stringa che descrive completamente il tipo di sistema sul quale bash è in esecuzione, nel formato standard GNU cpu-company-system. Il valore predefinito è dipendente dal sistema.

MAPFILE

Una variabile array (si veda Array più avanti) creata per contenere il testo letto dal comando incorporato mapfile quando non viene fornito un nome di variabile.

OLDPWD

La precedente directory di lavoro come impostata dal comando cd.

OPTARG

Il valore dell'ultimo argomento opzione elaborato dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

OPTIND

L'indice del prossimo argomento che dev'essere elaborato dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

OSTYPE

Automaticamente impostata a una stringa che descrive il sistema operativo su cui bash è in esecuzione. Il valore predefinito è dipendente dal sistema.

PIPESTATUS

Una variabile array (si veda Array più avanti) contenente un elenco di valori di stato d'uscita dai processi nelle pipeline eseguite più recentemente in primo piano [cioè senza rilasciare il controllo del terminale] (può contenere anche un solo comando).

PPID

L'ID di processo del genitore della shell. Questa variabile è in sola lettura.

PWD

La directory di lavoro corrente come impostata dal comando cd.

RANDOM

Ogni volta che questo parametro è referenziato, si espande a un numero intero casuale fra 0 e 32767. Assegnando un valore a RANDOM viene inizializzata (seed) la sequenza di numeri casuali. Se RANDOM viene annullata, perde le sue proprietà speciali, anche se è poi reimpostata.

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

Il contenuto del buffer di riga readline per l'uso con "bind -x" (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

READLINE_MARK

La posizione della marcatura (punto di inserzione) nel buffer di riga readline per l'uso con "bind -x" (si veda COMANDI INCORPORATI DELLA SHELL più avanti). I caratteri tra il punto d'inserzione e la marcatura vine chspesso chiamata regione.

READLINE_POINT

La posizione del punto di inserzione nel buffer di riga readline per l'uso con "bind -x" (si veda COMANDI INCORPORATI DELLA SHELL più avanti).

REPLY

Impostata alla riga di input letta dal comando incorporato read quando nessun argomento è specificato.

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

Una lista, separata da due punti, di opzioni di shell abilitate. Ogni parola nella lista è un argomento valido per l'opzione -o al comando incorporato set (si veda COMANDI INCORPORATI DELLA SHELL più avanti). Le opzioni che appaiono in SHELLOPTS sono quelle indicate come on da set -o. Se questa variabile è nell'ambiente quando bash viene avviata, ogni opzione di shell nella lista viene abilitata prima di leggere un qualsiasi file di avvio. Questa variabile è in sola lettura.

SHLVL

È incrementato di uno ogni volta che una istanza di bash viene avviata.

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

Si espande all'ID-utente dell'utente corrente, inizializzato all'avvio della shell. Questa variabile è in sola lettura.

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

Se questo parametro è impostato quando bash sta eseguendo uno script di shell, il suo valore è interpretato come un nome-file contenente comandi per inizializzare la shell, come in ~/.bashrc. Il valore di BASH_ENV è soggetto a espansione di parametro, sostituzione di comando ed espansione aritmetica prima di essere interpretato come un nome-file. PATH non è usato per cercare il nome-file risultante.

BASH_XTRACEFD

Se impostata a un valore intero corrispondente a un descrittore di file valido, bash scriverà l'output della traccia generata quando set -x è abilitato a quel descrittore di file. Il descrittore di file viene chiuso quando BASH_XTRACEFD non è impostata o le viene assegnato un nuovo valore. Annullando BASH_XTRACEFD o assegnandole una stringa vuota l'output della traccia verrà inviato allo standard error. Da notare che impostando BASH_XTRACEFD a 2 (il descrittore di file dello standard error) e, successivamente, azzerandola il risultato sarà la chiusura dello standard error.

CDPATH

Il percorso di ricerca per il comando cd. Questo è un elenco di directory, separate da due punti, nelle quali la shell cerca le directory di destinazione specificate dal comando cd. Un valore di esempio è ".:~:/usr".

CHILD_MAX

Imposta il numero di valori dello stato di uscita delle shell figlie da tenere in memoria. Bash non permette che questo valore scenda al di sotto di un minimo imposto da POSIX, e c'è un valore massimo (attualmente 8192) che non può essere superato. Il valore minimo è dipendente dal sistema.

COLUMNS

Usato dal comando composto select per determinare il numero di colonne del terminale nella stampa delle liste di selezione. Automaticamente impostata se l'opzione checkwinsize è abilitata o è in una shell interattiva al ricevimento di un segnale SIGWINCH.

COMPREPLY

Una variabile array dalla quale bash legge i possibili completamenti generati da una funzione di shell invocata dal servizio di completamento programmabile (si veda Completamento programmabile più avanti). Ogni elemento di array contiene un completamento possibile.

EMACS

Se bash trova questa variabile d'ambiente alla partenza della shell col valore "t", presume che la shell sia in esecuzione in un buffer di shell Emacs e disabilita la modifica della riga.

ENV

È espansa ed eseguita similarmente a BASH_ENV (si veda INVOCAZIONE sopra) quando una shell interattiva viene invocata in modalità posix.

EXECIGNORE

A colon-separated list of shell patterns (see Pattern Matching) defining the list of filenames to be ignored by command search using PATH. Files whose full pathnames match one of these patterns are not considered executable files for the purposes of completion and command execution via PATH lookup. This does not affect the behavior of the [, test, and [[ commands. Full pathnames in the command hash table are not subject to EXECIGNORE. Use this variable to ignore shared library files that have the executable bit set, but are not executable files. The pattern matching honors the setting of the extglob shell option.

FCEDIT

L'editor predefinito per il comando incorporato fc.

FIGNORE

Una lista di suffissi, separati da due punti, da ignorare quando si effettua il completamento del nome-file (si veda READLINE più avanti). Un nome-file il cui suffisso corrisponde a una delle voci in FIGNORE è escluso dalla lista dei nomifile individuati. Un valore di esempio è ".o:~" (La quotatura è necessaria quando si assegna un valore a questa variabile, che contiene delle tilde).

FUNCNEST

Se impostato a un valore numerico maggiore di 0, definisce un livello massimo di nidificazione per una funzione. Invocazioni di funzione eccedenti questo livello provocheranno l'interruzione del comando corrente.

GLOBIGNORE

Una lista di modelli, separati da due punti, che definiscono l'insieme dei nomi di file che l'espansione del nome di percorso deve ignorare. Se un nome di file individuato da un modello di espansione del percorso corrisponde anche a uno dei modelli in GLOBIGNORE viene rimosso dalla lista dei nomi da individuare.

HISTCONTROL

Una lista di valori, separati da due punti, che controllano come i comandi vengono salvati nell'elenco della cronologia. Se la lista di valori include ignorespace, le righe che iniziano con un carattere di spazio non vengono salvate nell'elenco della cronologia. Un valore di ignoredups fa sì che non venga salvata ogni riga uguale all'elemento precedente della cronologia. Un valore di ignoreboth è la combinazione di ignorespace e ignoredups. Un valore di erasedups fa sì che tutte le righe uguali alla riga corrente vengano rimosse dall'elenco della cronologia prima che la riga venga salvata. Qualsiasi valore che non è nella lista di cui sopra è ignorato. Se HISTCONTROL non è impostato o non include un valore valido, tutte le righe lette dall'analizzatore sintattico della shell sono salvate nell'elenco della cronologia, a meno che non sia stato specificato HISTIGNORE. La seconda riga e le successive di un comando composto multiriga non vengono controllate, e sono aggiunte alla cronologia indipendentemente dal valore di HISTCONTROL.

HISTFILE

Il nome del file nel quale è salvata la cronologia dei comandi (si veda CRONOLOGIA più avanti). Il valore predefinito è ~/.bash_history. Se è annullato la cronologia dei comandi non è salvata al termine di una shell.

HISTFILESIZE

Il numero massimo di righe contenute nel file della cronologia. Quando a questa variabile è assegnato un valore, il file della cronologia è accorciato, se necessario, per contenere non più di quel numero di righe rimuovendo le voci più vecchie. Il file della cronologia è inoltre troncato a questa dimensione dopo la scrittura al termine di una shell. Se il valore è 0, il file della cronologia è troncato alla dimensione zero. Valori non numerici e valori numerici minori di zero inibiscono il troncamento. La shell imposta il valore predefinito al valore di HISTSIZE dopo la lettura di un file di avvio.

HISTIGNORE

Una lista di modelli separati da due punti usata per decidere quali righe di comando devono essehonorsre salvate nell'elenco della cronologia. Ogni modello comincia all'inizio della riga e deve corrispondere alla riga completa (nessun ` * implicito è aggiunto). Ogni modello è confrontato con la riga dopo che i controlli specificati da HISTCONTROL sono stati applicati. In aggiunta ai normali modelli di shell che confrontano caratteri, ` &' designa la linea precedentedella cronologia. `&' può essere protetto usando una barra inversa; la barra inversa è rimossa prima di eseguire un confronto. La seconda riga e le successive di un comando composto multiriga non vengono controllate, e sono aggiunte alla cronologia indipendentemente dal valore di HISTIGNORE. Il modello di ricerca rispetta l'impostazione dell'opzione di shell extglob .

HISTSIZE

Il numero di comandi da tenere in memoria nella cronologia dei comandi (si veda HISTORY più avanti). Se il valore è 0, i comandi non vengono salvati nell'elenco della cronologia. Con valori numerici minori di zero ogni comando viene salvato nell'elenco della cronologia (non ci sono limiti). La shell imposta il valore predefinito a 500 dopo aver letto i file d'inizializzazione.

HISTTIMEFORMAT

Se questa variabile è impostata e non nulla, il suo valore è usato come stringa di formato per strftime(3) per stampare la marcatura oraria associata a ogni voce della cronologia mostrata dal comando incorporato history. Se questa variabile è impostata, data e ora verranno scritte nel file della cronologia in modo da essere disponibili anche in successive sessioni della shell. Per distinguere la marcatura oraria dalle altre righe della cronologia viene usato il carattere di commento.

HOME

La home directory dell'utente corrente; l'argomento predefinito per il comando incorporato cd. Il valore di questa variabile è anche usata quando si effettua l'espansione della tilde.

HOSTFILE

Contiene il nome di un file nello stesso formato di /etc/hosts che dovrà essere letto quando la shell ha bisogno di completare un nome di host. La lista dei possibili completamenti di nome di host può essere cambiata mentre la shell è in esecuzione; alla prossima occasione in cui si tenta il completamento del nome di host dopo che è cambiato il valore, bash aggiunge il contenuto del nuovo file alla lista esistente. Se HOSTFILE è impostato ma non ha alcun valore, o non contiene il nome di un file leggibile, bash tenta di leggere /etc/hosts per ottenere la lista dei possibili completamenti del nome di host. Quando HOSTFILE viene annullato, la lista dei nomi di host viene pure annullata.

IFS

L'Internal Field Separator (separatore di campo interno) è usato per la suddivisione in parole dopo l'espansione e per dividere le righe in parole quando si esegue il comando incorporato read. Il valore predefinito è “<space><tab><newline>”.

IGNOREEOF

Controlla l'azione della shell al ricevimento di un carattere EOF come unico contenuto di una riga di input. Se impostato, il valore è il numero di caratteri EOF consecutivi da battere come primo carattere su una riga di input prima che bash esca. Se la variabile esiste ma non ha un valore numerico, o non ha alcun valore, il valore predefinito è 10. Se non esiste, EOF indica la fine dell'input per la shell.

INPUTRC

Il nome-file per il file di avvio di readline che prevale sul valore predefinito che è ~/.inputrc (si veda READLINE più avanti).

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

Usata per determinare la categoria di localizzazione per qualsiasi categoria non specificatamente indicata da una delle variabili che iniziano con LC_.

LC_ALL

Questa variabile prevale sul valore di LANG e su qualsiasi altra variabile LC_ che specifichi una categoria di localizzazione.

LC_COLLATE

Questa variabile determina l'ordine di collazione usato quando vengono ordinati i risultati dell'espansione di nome di percorso, e determina il comportamento di espressioni di intervallo, classi di equivalenza e sequenze di ordinamento all'interno dell'espansione di nome di percorso e della corrispondenza tra stringhe.

LC_CTYPE

Questa variabile determina l'interpretazione di caratteri e il comportamento di classi di caratteri all'interno dell'espansione di nome di percorso e della corrispondenza tra stringhe.

LC_MESSAGES

Questa variabile determina la localizzazione usata per tradurre stringhe tra virgolette precedute da un $.

LC_NUMERIC

Questa variabile determina la categoria di localizzazione usata per la formattazione dei numeri.

LC_TIME

Questa variabile determina la categoria di localizzazione usata per la formattazione di data e ora.

LINES

Usato dal comando composto select per determinare il numero di linee del terminale nella stampa delle liste di selezione. Automaticamente impostata se l'opzione checkwinsize è abilitata o in una shell interattiva al ricevimento di un segnale SIGWINCH.

MAIL

Se questo parametro è impostato a un nome di file o di directory e la variabile MAILPATH non è impostata, bash informa l'utente dell'arrivo di posta nel file specificato o nella directory del formato Maildir.

MAILCHECK

Specifica la frequenza (in secondi) con cui bash controlla la posta. Il valore predefinito è 60 secondi. Quando è il momento di controllare la posta, la shell lo fa prima di mostrare il prompt primario. Se questa variabile non è impostata, o è impostata a un valore che non sia un numero maggiore o uguale a zero, la shell disabilita il controllo della posta.

MAILPATH

Una lista di nomifile separati da due punti, da usare per il controllo della posta. Il messaggio che deve essere stampato all'arrivo dei messaggi in un particolare file può essere specificato separando il nome-file dal messaggio con un `?'. Quando viene usato nel testo del messaggio $_ è espanso al nome del file di posta corrente. Per esempio:

OPTERR

Se impostato al valore 1, bash mostra i messaggi di errore generati dal comando incorporato getopts (si veda COMANDI INCORPORATI DELLA SHELL più avanti). OPTERR è inizializzato ad 1 ogni volta che viene invocata la shell o viene eseguito uno script di shell.

PATH

Il percorso di ricerca dei comandi. È un elenco di directory separate da due punti, nelle quali la shell cerca i comandi (si veda ESECUZIONE DEI COMANDI più avanti). Un nome di directory di lunghezza zero (nulla) nel valore di PATH indica la directory corrente. Un nome di directory nullo può apparire come una serie di due punti adiacenti, o come due punti all'inizio o alla fine. Il percorso predefinito è dipendente dal sistema ed è impostato dall'amministratore che installa bash. Un valore frequente è ``/usr/local/bin:/usr/local/sbin:/usr/bin:/usr/sbin:/bin:/sbin''.

POSIXLY_CORRECT

Se questa variabile è presente nell'ambiente quando viene avviata bash, la shell entra in modalità posix prima di leggere i file di avvio, come se l'opzione di invocazione --posix fosse stata specificata. Se è impostata mentre la shell è in esecuzione, bash abilita la modalità posix, come se il comando set -o posix fosse stato eseguito. Quando la shell entra in modalità posix, imposta questa variabile se non fosse già impostata.

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

Se impostata a un numero maggiore di zero, il valore è usato come il numero di componenti della directory finale da conservare quando si espandono i caratteri protetti della stringa di prompt \w e \W (si veda PROMPTING più avanti). I caratteri rimossi sono sostituiti da un'ellissi.

PS0

Il valore di questo parametro è espanso (si veda STRINGHE DI PROMPT più avanti) e visualizzato dalle shell interattive dopo aver letto un comando e prima che il comando venga eseguito.

PS1

Il valore di questo parametro è espanso (si veda STRINGHE DI PROMPT più avanti) e usato come stringa del prompt primario. Il valore predefinito è“ \s-\v\$”.

PS2

Il valore di questo parametro è espanso allo stesso modo di PS1 ed è usato come stringa di prompt secondario. Il valore predefinito è “ > ”.

PS3

Il valore di questo parametro è usato come prompt per il comando select (si veda GRAMMATICA DELLA SHELL sopra).

PS4

Il valore di questo parametro è espanso allo stesso modo di PS1 ed il valore è stampato prima di ogni comando che bash mostra durante un trace di esecuzione. Il primo carattere del valore espanso di PS4 è replicato tante volte, quanto necessario, per indicare livelli multipli di indirezione. Il valore predefinito è “ +”.

SHELL

Questa variabile si espande al percorso completo della shell. Se non è impostata quando la shell viene avviata, bash le assegna il percorso completo della shell di login dell'utente corrente.

TIMEFORMAT

Il valore di questo parametro è usato come stringa di formato per specificare come dovrà essere mostrata l'informazione su data e ora per pipeline aventi come prefisso la parola riservata time. Il carattere % introduce una sequenza di formattazione che è espansa a un valore di data e ora o ad altre informazioni. Le sequenze di formattazione e il loro significato sono i seguenti; le parentesi quadre denotano parti opzionali.

a parte opzionale p è una cifra che specifica la precisione, il numero di cifre frazionali dopo il separatore decimale. Un valore pari a 0 fa sì che nessun separatore decimale o frazione venga inserito nell'output. Possono essere specificate al massimo tre posizioni dopo il separatore decimale; valori di p maggiori di 3 sono cambiati a 3. Se p non è specificato è utilizzato il valore 3.

La parte opzionale l specifica un formato più lungo, inclusi i minuti, nella forma MMmSS.FFs. Il valore di p determina se la frazione è inclusa o meno.

Se questa variabile non è impostata, bash agisce come se avesse il valore $'\nreal\t%3lR\nuser\t%3lU\nsys\t%3lS'. Se il valore è nullo, non viene mostrata alcuna informazione di tempo. Una newline finale è aggiunta quando la stringa di formato è visualizzata.

TMOUT

Se impostato a un valore maggiore di zero, TMOUT è trattato come il tempo limite (timeout) predefinito per il comando incorporato read. Il comando select viene terminato se non riceve input dopo TMOUT secondi quando l'input proviene da un terminale. In una shell interattiva il valore è interpretato come il numero di secondi di attesa per l'input dopo l'emissione del prompt primario. Bash termina dopo aver aspettato per quel numero di secondi se non arriva una riga completa di input.

TMPDIR

Se impostato, bash usa il suo valore come nome della directory nella quale bash crea file temporanei a uso della shell.

auto_resume

Questa variabile controlla il modo con cui la shell interagisce con l'utente e con il job-control. Se questa variabile è impostata, dei comandi semplici composti da una sola parola senza ridirezioni sono considerati come candidati per la ripresa di un job in esecuzione che sia stato sospeso. Non è possibile alcuna ambiguità; se vi è più di un job che comincia con la stringa digitata, è scelto il job su cui si è effettuato l'accesso più recentemente. Il nome di un job sospeso, in questo contesto, è la riga di comando usata per avviarlo. Se impostato al valore exact, la stringa fornita deve essere esattamente uguale al nome di un job fermo; se impostato a substring, la stringa fornita deve combaciare con una sottostringa del nome di un job sospeso. Il valore substring fornisce funzionalità analoghe all'identificatore del job %? (si veda JOB CONTROL più avanti). Se impostato a qualsiasi altro valore, la stringa fornita deve essere un prefisso del nome di un job sospeso; questo consente funzionalità analoghe all'identificatore di job %string.

histchars

Sono i due o tre caratteri che controllano l'espansione della cronologia e la suddivisione in token (si veda ESPANSIONE DELLA CRONOLOGIA più avanti). Il primo carattere è il carattere di espansione della cronologia, il carattere che segnala l'inizio di una espansione della cronologia, normalmente ` !'. Il secondo carattere è il carattere di sostituzione rapida, che è usato come scorciatoia per rieseguire il comando precedentemente inserito, sostituendo una stringa con un'altra nel comando. Il valore predefinito è ` ^'. Il terzo carattere, opzionale, è il carattere che indica che il resto della riga è un commento, quando è trovato come primo carattere di una parola, normalmente ` #'. Il carattere di commento della cronologia fa sì che la sostituzione della cronologia venga saltata per le rimanenti parole sulla riga. Esso non fa necessariamente sì che l'analizzatore della shell tratti il resto della riga come un commento.

Array

ESPANSIONE

Espansione delle parentesi graffe

Espansione della tilde

Espansione di parametro

${parametro}

Il valore di parametro è sostituito. Le parentesi graffe sono richieste quando parametro è un parametro posizionale con più di una cifra, o quando parametro è seguito da un carattere che non deve essere interpretato come parte del suo nome. Il parametro è un parametro di shell come descritto sopra ( PARAMETRI) o un riferimento a un array ( Array).

${parametro:-parola}

Usa i valori predefiniti. Se parametro non è impostato o è nullo, è sostituita l'espansione di parola. Altrimenti, il valore di parametro è sostituito.

${parametro:=parola}

Assegna i valori predefiniti. Se parametro non è impostato o è nullo, l'espansione di parola è assegnata a parametro. Il valore di parametro è quindi sostituito. I parametri posizionali e i parametri speciali non possono essere assegnati in questo modo.

${parametro:?parola}

Dà una segnalazione di errore se è nullo o è stato annullato. Se parametro è nullo o è stato annullato, l'espansione di parola (o un messaggio di segnalazione, se parola non è presente) viene scritta sullo standard error e la shell, se non è interattiva, termina. Altrimenti, è sostituito il valore di parametro.

${parametro:+parola}

Se parametro è nullo o è stato annullato, non è sostituito niente, altrimenti è sostituita l'espansione di parola.

${parametro:scostamento}

${parametro:scostamento:lunghezza}

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). Se scostamento è un numero minore di zero, il valore viene usato come scostamento nei caratteri dalla fine del valore di parametro. Se lunghezza è un numero minore di zero, viene interpretato come uno scostamento in caratteri dalla finedel valore di parametro piuttosto che come un numero di caratteri, e l'espansione è rappresentata dai caratteri fra lo scostamento e quel risultato. Si noti che uno scostamento negativo dev'essere separato dai due punti da almeno uno spazio per evitare che venga confuso con l'espansione di :-. 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. Se parametro è un nome di array indicizzato con deponente @ o *, il risultato è un numero di elementi dell'array pari a lunghezza a partire da ${ parametro[scostamento]}. Uno scostamento negativo è inteso come relativo al massimo indice dell'array specificato aumentato di uno. È un errore di espansione se lunghezza è un numero minore di zero. L'espansione di substringa applicata a un array associativo produce risultati indefiniti. L'indicizzazione della sottostringa è a base zero a meno che non vengano usati i parametri posizionali, nel qual caso l'indicizzazione parte da 1 come impostazione predefinita. Se scostamento è 0, e vengono usati i parametri posizionali, alla lista è aggiunto il prefisso $0.

${!prefisso*}

${!prefisso@}

Nomi corrispondenti al prefisso. Espande ai nomi delle variabili i cui nomi iniziano con prefisso, separati dal primo carattere della variabile speciale IFS. Quando viene usato @ e l'espansione appare tra virgolette, ogni nome di variabile si espande in una parola separata.

${!nome[@]}

${!nome[*]}

Lista delle chiavi di array. Se nome è una variabile array, espande alla lista degli indici di array (chiavi) assegnati in nome. Se nome non è un array, espande a 0 se nome è impostato ed è nullo in caso contrario. Quando @ è usato e l'espansione appare fra virgolette, ogni chiave espande a una parola separata.

${#parametro}

lunghezza parametro} È sostituita la lunghezza in caratteri del valore di parametro. Se parametro è * o @, il valore sostituito è il numero di parametri posizionali. Se parametro è un nome di array contrassegnato da * o @ il valore sostituito è il numero di elementi nell'array. Se parametro è un nome di array indicizzato con deponente negativo, quel numero è interpretato come relativo al massimo indice di parametro aumentato di uno, perciò indici negativi si conteggiano dalla fine dell'array all'indietro, e un indice -1 corrisponde all'ultimo elemento.

${parametro#parola}

${parametro##parola}

Rimozione del suffisso corrispondente al modello. La parola è espansa per produrre un modello proprio come nell'espansione di percorso, e confrontata col valore espanso di parametro usando le regole descritte più avanti in Modelli di ricerca. Se il modello corrisponde a una parte finale del valore espanso di parametro, il risultato dell'espansione è il valore espanso di parametro con il più corto dei modelli corrispondenti cancellato (nel caso di “ #” ) o il più lungo dei modelli corrispondenti cancellato (nel caso di “ ##”). Se parametro è @ o *, l'operazione di rimozione del modello è applicata a ognuno dei parametri posizionali, e l'espansione è la lista risultante. Se parametro è una variabile array con deponente @ o *, l'operazione di rimozione del modello è applicata a ognuno degli elementi dell'array, e l'espansione è la lista risultante.

${parametro%parola}

${parametro%%parola}

Rimozione del suffisso corrispondente al modello. La parola è espansa per produrre un modello proprio come nell'espansione di percorso, e confrontata col valore espanso di parametro usando le regole descritte più avanti in Modelli di ricerca. Se il modello corrisponde a una parte finale del valore espanso di parametro, il risultato dell'espansione è il valore espanso di parametro con il più corto dei modelli corrispondenti cancellato (nel caso di “ %” ) o il più lungo dei modelli corrispondenti cancellato (nel caso di “ %%”). Se parametro è @ o *, l'operazione di rimozione del modello è applicata a ognuno dei parametri posizionali, e l'espansione è la lista risultante. Se parametro è una variabile array con deponente @ o *, l'operazione di rimozione del modello è applicata a ognuno degli elementi dell'array, e l'espansione è la lista risultante.

${parameter/modello/stringa}

${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.

${parametro^modello}

${parametro^^modello}

${parametro,modello}

${parametro,,modello}

Modifica minuscolo/maiuscolo. Questa espansione modifica in parametro i caratteri alfabetici da minuscolo a maiuscolo e viceversa. Il modello viene espanso per produrre un modello, proprio come nell'espansione del nome di percorso. Ciascun carattere nel valore espanso di parametro viene confrontato con modello e, se corrisponde al modello, le minuscole/maiuscole vengono convertite. Il modello potrebbe non cercare corrispondenze con più di un carattere. L'operatore ^ converte le lettere minuscole che corrispondono a modello in lettere maiuscole; l'operatore , converte le lettere maiuscole trovate in lettere minuscole. Le espansioni ^^ e ,, convertono ogni carattere trovato nel valore espanso; le espansioni ^ e , trovano e convertono solo il primo carattere nel valore espanso. Se modello è omesso, è trattato come un ?, che individua tutti i caratteri. Se parametro è @ o *, l'operazione di conversione minuscole/maiuscole è applicata a tutti i parametri posizionali successivi, e l'espansione è la lista risultante. Se parametro è una variabile array indicizzata con @ o *, l'operazione di conversione minuscole/maiuscole è applicata a tutti i successivi elementi dell'array, e l'espansione è la lista risultante.

${parametro@operatore}

Trasformazione di parametro. L'espansione è o una trasformazione del valore di parametro o un'informazione su parametro stesso, a seconda del valore di operatore. Ogni operatore è una sola lettera:

Sostituzione di comando

Espansione aritmetica

Sostituzione di processo

Suddivisione in parole

Espansione di percorso

Rimozione dei caratteri di quotatura

RIDIREZIONE

Ridirezione dell'input

Ridirezione dell'output

Accodare l'output ridiretto

Ridirezione di standard output e standard error

Accodare Standard Output e Standard Error

Here Document

[ n]<<[-]word
         here-document
delimitatore

Here String

[ n]<<<parola

Duplicazione dei descrittori di file

Muovere i descrittori di file

Apertura di descrittori di file per lettura e scrittura

ALIAS

FUNZIONI

VALUTAZIONE ARITMETICA

id++ id--

post-incremento e post-decremento di una variabile

- +

meno e più unari

++id --id

pre-incremento e pre-decremento di una variabile

! ~

negazione logica e "bit a bit"

**

elevamento a potenza

* / %

moltiplicazione, divisione, modulo

+ -

addizione, sottrazione

<< >>

scorrimento "bit a bit" a sinistra e a destra

<= >= < >

confronto

== !=

uguaglianza e differenza

&

AND "bit a bit"

^

OR esclusivo "bit a bit"

|

OR "bit a bit"

&&

AND logico

||

OR logico

espr?espr:espr

operatore condizionale

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

assegnamento

espr1 , espr2

virgola

ESPRESSIONI CONDIZIONALI

-a file

Vero se file esiste.

-b file

Vero se file esiste ed è un file speciale a blocchi.

-c file

Vero se file esiste ed è un file speciale a caratteri.

-d file

Vero se file esiste ed è una directory.

-e file

Vero se file esiste.

-f file

Vero se file esiste ed è un file normale.

-g file

Vero se file esiste ed è impostato il suo bit set-group-id.

-h file

Vero se file esiste ed è un collegamento simbolico.

-k file

Vero se file ha il suo “sticky” bit impostato.

-p file

Vero se file esiste ed è una named pipe (FIFO).

-r file

Vero se file esiste ed è leggibile.

-s file

Vero se file esiste ed è di dimensione maggiore di zero byte.

-t fd

Vero se il descrittore di file fd è aperto e si tratta di un terminale.

-u file

Vero se file esiste ed è impostato il suo bit set-user-id.

-w file

Vero se file esiste ed è scrivibile.

-x file

Vero se file esiste ed è eseguibile.

-G file

Vero se file esiste ed è di proprietà del gruppo effettivo dell'utente.

-L file

Vero se file esiste ed è un collegamento simbolico.

-N file

Vero se file esiste ed è stato modificato dall'ultima volta che è stato letto.

-O file

Vero se file esiste ed è di proprietà dell'id utente effettivo.

-S file

Vero se file esiste ed è un socket.

file1 -ef file2

Vero se file1 e file2 fanno riferimento allo stesso dispositivo e agli stessi numeri di inode.

file1 -nt file2

Vero se file1 è più recente (come data di modifica) di file2 o se file1 esiste e file2 no.

file1 -ot file2

Vero se file1 è più vecchio di file2, o se file2 esiste e file1 no.

-o optname

Vero se l'opzione di shell optname è abilitata. Si veda l'elenco delle opzioni sotto la descrizione dell'opzione -o al comando incorporato set più avanti.

-v varname

Vero se la variabile di shell varname è impostata (le è stato assegnato un valore).

-R varname

Vero se la variabile di shell varname è impostata (le è stato assegnato un valore) ed è un riferimento a un nome.

-z stringa

Vero se la lunghezza di stringa è zero.

stringa

-n stringa

Vero se la lunghezza di stringa è diversa da zero.

stringa1 == stringa2

stringa1 = stringa2

Vero se le stringhe sono uguali. Col comando test dovrebbe essere usato = per conformità con lo standard POSIX. Quando è usato col comando [[, effettua la ricerca di corrispondenze come descritto precedentemente ( Comandi composti).

stringa1 != stringa2

Vero se le stringhe non sono uguali.

stringa1 < stringa2

Vero se, lessicograficamente, stringa1 precede come ordine stringa2.

stringa1 > stringa2

Vero se, lessicograficamente, stringa1 segue come ordine stringa2.

arg1 OP arg2

OP è uno tra -eq, -ne, -lt, -le, -gt o -ge. Questi operatori aritmetici binari risultano veri se arg1 è, rispettivamente, uguale, non uguale, minore, minore o uguale, maggiore, o maggiore o uguale ad arg2. Arg1 e arg2 possono essere numeri interi positivi o negativi. Quando è usato col comando [[, Arg1 e Arg2 sono valutati come espressioni aritmetiche (vedi VALUTAZIONE ARITMETICA sopra).

ESPANSIONE DI COMANDO SEMPLICE

1.

Le parole che l'analizzatore ha individuato essere assegnamenti di variabile (quelle che precedono il nome di comando) oppure ridirezioni vengono messe da parte per un'elaborazione successiva.

2.

Le parole che non sono assegnamenti di variabile o ridirezioni sono espanse. Se è presente qualche parola dopo l'espansione, la prima parola è considerata essere il nome del comando e le rimanenti parole come argomenti dello stesso.

3.

Le ridirezioni sono effettuate come descritte prima sotto RIDIREZIONE.

4.

Il testo dopo = in ogni assegnamento di variabile è sottoposto a espansione della tilde, sostituzione di comando, espansione aritmetica e rimozione dei caratteri di quotatura prima di venir assegnato alla variabile.

ESECUZIONE DI UN COMANDO

AMBIENTE DI ESECUZIONE DEL COMANDO

•

file aperti ereditati dalla shell all'invocazione, come modificati dalle ridirezioni fornite al comando incorporato exec

•

la corrente directory di lavoro come impostata da cd, pushd o popd, o ereditata dalla shell all'invocazione

•

la maschera del modo di creazione dei file come impostata da umask o ereditata dalla shell genitrice

•

i segnali da intercettare impostati da trap

•

parametri di shell che sono stati impostati da un assegnamento di variabile o con set, o ereditati dalla shell genitrice nell'ambiente

•

funzioni di shell definite durante l'esecuzione o ereditate dalla shell genitrice nell'ambiente

•

opzioni abilitate all'invocazione (sia in modo predefinito che con argomenti da riga di comando) o da set

•

opzioni abilitate da shopt

•

alias di shell definiti da alias

•

vari ID di processo, inclusi quelli dei job in background, il valore di $$ e il valore di PPID.

•

i file aperti della shell, più qualsiasi modificazione e aggiunta specificata dalle ridirezioni al comando

•

la directory di lavoro corrente

•

la maschera del modo di creazione dei file

•

variabili di shell e funzioni dichiarate esportabili, insieme alle variabili esportate per il comando, passate nell'ambiente

•

i segnali da intercettare come da comando trap dalla shell sono riportati ai valori ereditati dalla shell genitrice, e i segnali ignorati dalla shell vengono ignorati

AMBIENTE

STATO DI USCITA

SEGNALI

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.

JOB-CONTROL

STRINGHE DI PROMPT

READLINE

Notazione readline

Inizializzazione di Readline

Associazioni di tasti readline

Variabili 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)

Controlla cosa succede se readline vuole usare il segnalatore acustico del terminale. Se impostato a none, readline non emette alcun segnale. Se impostato a visible, readline usa un segnalatore visivo se disponibile. Se impostato a audible, readline tenta di attivare il segnalatore acustico del terminale.

bind-tty-special-chars (On)

Se impostato a On, readline tenta di associare i caratteri di controllo trattati in modo speciale dal driver del terminale nel kernel agli equivalenti degli stessi come descritti da readline.

blink-matching-paren (Off)

Se impostato a On, readline tenta di muovere rapidamente il cursore verso una paretesi aperta quando è inserita una parentesi chiusa.

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)

Se impostata a On, readline visualizza i possibili completamenti usando colori diversi per indicare il tipo di file. Le definizioni dei colori sono prese dalla variabile d'ambiente LS_COLORS.

comment-begin (“#”)

La stringa che è inserita quando è eseguito il comando insert-comment. Questo comando è associato a M-# in modalità comandi Emacs e a # in modalità comandi di vi.

completion-display-width (-1)

Il numero di colonne sullo schermo per visualizzare le possibili corrispondenze quando si effettua il completamento. Il valore è ignorato se è minore di 0 o maggiore della dimensione dello schermo. Con un valore di 0 viene visualizzata una corrispondenza per riga. Il valore predefinito è -1.

completion-ignore-case (Off)

Se impostato a On, readline effettua l'individuazione dei nomi-file e il completamento senza distinguere le lettere maiuscole dalle lettere minuscole.

completion-map-case (Off)

Se impostato a On, e completion-ignore-case è abilitato, readline tratta i trattini ( -) e i trattini bassi ( _) come equivalenti quando effettua una ricerca e completamento di nomifile senza distinzione di minuscolo/maiuscolo.

completion-prefix-display-length (0)

La lunghezza in caratteri del prefisso comune di una lista di possibili completamenti che è visualizzata senza modifiche. Quando è impostata a un valore maggiore di zero, i prefissi comuni più lunghi di questo valore sono rimpiazzati da un'ellissi quando vengono visualizzati possibili completamenti.

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)

Se impostato a On, readline inibisce il completamento della parola. I caratteri di completamento saranno inseriti nella riga come se fossero stati mappati come self-insert.

echo-control-characters (On)

Quando è impostato a On, sui sistemi operativi che lo suppportano, readline visualizza un carattere corrispondente a un segnale generato dalla tastiera.

editing-mode (emacs)

Controlla se readline parte con un insieme di associazioni di tasti simile a Emacs o vi. editing-mode (modalità di modifica) può essere impostato a emacs o a 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)

Quando impostato a On, readline tenta di abilitare il tastierino numerico se viene utilizzato. Alcuni sistemi richiedono questo per abilitare i tasti-freccia.

enable-meta-key (On)

Quando è impostato a On, readline tenta di abilitare qualsiasi meta tasto modificatore che il terminale dichiara di supportare quando viene chiamato. Su molti terminali il meta tasto è usato per inviare caratteri a otto bit.

expand-tilde (Off)

Se impostato a On, l'espansione della tilde è effettuata quando readline tenta il completamento della parola.

history-preserve-point (Off)

Se impostato a On, il codice che implementa la cronologia tenta di piazzare il cursore nel punto in cui si trovava su ogni riga della cronologia visualizzata con previous-history o next-history.

history-size (unset)

Definisce il numero massimo di voci salvate nella cronologia. Se impostata a zero, vengono cancellate tutte le voci esistenti e nessuna nuova voce viene salvata. Se impostata a un numero minore di zero, il numero di registrazioni è illimitato. Come impostazione predefinita, il numero di voci di cronologia è impostato al valore della variabile di shell HISTSIZE . Se si tenta di impostare history-size a un valore non numerico, il numero massimo di voci della cronologia sarà 500.

horizontal-scroll-mode (Off)

Quando impostato a On, richiede a readline di usare una sola riga per la visualizzazione, facendo scorrere l'input in orizzontale su una sola riga dello schermo quando essa risulti più lunga della larghezza dello schermo, invece che andando a capo su una nuova riga. Qust'impostazione è abilitata automaticamente nei terminali di altezza 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”)

Una stringa di caratteri che fa terminare una ricerca incrementale senza eseguire successivamente il carattere come se fosse un comando. Se a questa variabile non è stato dato un valore, i caratteri ESC e C-J fanno terminare una ricerca incrementale.

keymap (emacs)

Imposta la mappa corrente dei tasti di readline. Il set dei nomi validi per le mappe dei tasti è emacs, emacs-standard, emacs-meta, emacs-ctlx, vi, vi-command e vi-insert. vi è equivalente a vi-command; emacs è equivalente a emacs-standard. Il valore predefinito è emacs; il valore di editing-mode determina anche la mappa dei tasti predefiniti.

keyseq-timeout (500)

Specifica quanto tempo readline attenderà un carattere quando legge una sequenza di tasti ambigua (una che può formare una sequenza di tasti completa usando l'input letto finora, o può accettare un input aggiuntivo per completare una sequenza di tasti più lunga). Se non riceve nessun input entro il tempo limite, readline userà la sequenza di tasti più corta tra quelle possibili. Il valore è specificato in millisecondi, cosicché un valore di 1000 vuol dire che readline attenderà un secondo per un input aggiuntivo. Se questa variabile è impostata a un valore minore o uguale a zero, o a un valore non numerico, readline attenderà fino a che non sia premuto un altro tasto per decidere quale sequenza di tasti completare.

mark-directories (On)

Se impostata a On, ai nomi delle directory completate è aggiunta una barra [/] alla fine.

mark-modified-lines (Off)

Se impostato a On, le righe della cronologia che sono state modificate sono mostrate precedute da un asterisco ( *).

mark-symlinked-directories (Off)

Se impostato a On, i nomi completati che sono collegamenti simbolici a directory hanno una barra [/] alla fine (se richiesto tramite mark-directories).

match-hidden-files (On)

Questa variabile, se impostata a On, fa sì che readline mostri anche i file i cui nomi iniziano con un `.' (file nascosti) quando effettua il completamento del nome-file. Se impostata a Off, il `.' iniziale dev'essere fornito dall'utente come parte del nome-file da completare.

menu-complete-display-prefix (Off)

Se impostato a On, il completamento del menù visualizza il prefisso comune della lista di possibili completamenti (che può essere vuota) prima di scorrere ciclicamente la lista.

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)

Se impostato a On, readline usa un paginatore interno simile a more per mostrare i possibili completamenti una schermata alla volta.

print-completions-horizontally (Off)

Se impostato a On, readline mostra i completamenti ordinati in ordine alfabetico orizzontalmente, piuttosto che dall'alto in basso.

revert-all-at-newline (Off)

Se impostato a On, readline annulla tutte le modifiche alle righe della cronologia prima di ritornare, quando viene eseguito accept-line. In modo predefinito, le righe della cronologia possono essere modificate e mantengono liste dei singoli anullamenti mediante chiamate a readline.

show-all-if-ambiguous (Off)

Questo cambia il comportamento predefinito delle funzioni di completamento. Se impostato a On, le parole che hanno più di un possibile completamento provocano la visualizzazione immediata delle coincidenze invece che l'attivazione del segnalatore acustico.

show-all-if-unmodified (Off)

Questo cambia il comportamento predefinito delle funzioni di completamento in maniera simile a show-all-if-ambiguous. Se impostato a On, le parole che hanno più di un possibile completamento senza alcun possibile completamento parziale (ovvero i possibili completamenti non hanno alcun prefisso in comune) sono elencate immediatamente invece che provocare l'attivazione del segnalatore acustico.

show-mode-in-prompt (Off)

Se impostata a On, aggiunge una stringa all'inizio del prompt che indica la modalità di modifica: emacs (@), vi comando (:) o vi inserimento (+). Le stringhe della modalità sono impostabili dall'utente (p.es. emacs-mode-string).

skip-completed-text (Off)

Se impostato a On, altera il comportamento predefinito del completamento quando viene inserita una corrispondenza nella riga. È attivo solo quando si effettua il completamento a metà di una parola. Se abilitato, readline non inserisce, dopo il completamento della parola, caratteri provenienti dal completamento che corrispondono ai caratteri della parola da completare che si trovano dopo il cursore; in tal modo porzioni di parola che seguono il cursore non vengono duplicati.

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)

Se impostato a On, un carattere che denota un tipo di file come riportato da stat(2) è accodato al nome-file durante l'elencazione dei possibili completamenti.

Costrutto condizionale di readline

$if

Il costrutto $if permette che le associazioni siano fatte in base alla modalità di modifica, al terminale in uso o all'applicazione che fa uso di readline. Il testo da verificare, dopo qualsiasi operatore di confronto, arriva fino alla fine della riga; a meno che non sia diversamente specificato, nessun carattere che lo delimiti è richiesto.

$if Bash
# Quota la parola corrente o precedente
"\C-xq": "\eb\"\ef\""
$endif

$endif

Questo comando, come si è visto nell'esempio precedente, fa terminare un comando $if.

$else

I comandi in questa parte della direttiva $if sono eseguiti se il test non risulta verificato.

$include

Questa direttiva prende un unico nome-file come argomento e legge comandi e associazioni da quel file. Per esempio, la seguente direttiva legge /etc/inputrc:

$include  /etc/inputrc

Ricerca

Nomi di comando readline

Comandi di movimento

beginning-of-line (C-a)

Si sposta all'inizio della riga corrente.

end-of-line (C-e)

Si sposta alla fine della riga.

forward-char (C-f)

Si sposta avanti di un carattere.

backward-char (C-b)

Si sposta indietro di un carattere.

forward-word (M-f)

Si sposta in avanti fino alla fine della parola successiva. Le parole sono composte di caratteri alfanumerici (lettere e cifre).

backward-word (M-b)

Si sposta indietro all'inizio della parola corrente o precedente. Le parole sono composte di caratteri alfanumerici (lettere e cifre).

shell-forward-word

Si sposta in avanti fino alla fine della parola successiva. Le parole sono delimitate da metacaratteri di shell non quotati.

shell-backward-word

Si sposta indietro all'inizio della parola corrente o precedente. Le parole sono delimitate da metacaratteri di shell non quotati.

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)

Pulisce lo schermo, poi riproduce la riga corrente, lasciando la riga corrente in cima allo schermo. Con un argomento, rilegge la riga corrente senza ripulire lo schermo.

redraw-current-line

Rinfresca la riga corrente.

Comandi per manipolare la cronologia

accept-line (Newline, Return)

Accetta la riga senza curarsi di dove sia il cursore. Se questa riga non è vuota, è aggiunta alla lista della cronologia in accordo con lo stato della variabile HISTCONTROL. Se la riga è una riga di cronologia modificata, allora ripristina la riga di cronologia al suo stato originale.

previous-history (C-p)

Prende il precedente comando dalla lista della cronologia, spostandosi indietro nella lista.

next-history (C-n)

Prende il successivo comando dalla lista della cronologia, spostandosi avanti nella lista.

beginning-of-history (M-<)

Si sposta alla prima riga nella cronologia.

end-of-history (M->)

Si sposta alla fine della cronologia dell'input, cioè, alla riga che si sta inserendo.

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

Accetta la riga corrente per l'esecuzione e prende dalla cronologia la riga successiva a quella corrente, per la modifica. Un argomento numerico, se presente, specifica l'elemento della cronologia da usare al posto della riga corrente.

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)

Cerca all'indietro partendo dalla riga corrente spostandosi in `su' attraverso la cronologia come necessario. Questa è una ricerca incrementale.

forward-search-history (C-s)

Cerca in avanti partendo dalla riga corrente e spostandosi in `giù' attraverso la cronologia come necessario. Questa è una ricerca incrementale.

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

Cerca all'indietro attraverso la cronologia, partendo dalla riga corrente, una stringa fornita dall'utente, usando una ricerca non incrementale.

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

Cerca in avanti attraverso la cronologia una stringa fornita dall'utente, usando una ricerca non incrementale.

history-search-forward

Cerca in avanti attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e il punto del cursore. Questa è una ricerca non incrementale.

history-search-backward

Cerca all'indietro attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e il punto del cursore. Questa è una ricerca non incrementale.

history-substring-search-backward

Cerca all'indietro attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e la posizione corrente del cursore (il punto). La stringa di ricerca può cercare corrispondenze dovunque in una riga della cronologia. Questa è una ricerca non incrementale.

history-substring-search-forward

Cerca in avanti attraverso la cronologia una stringa di caratteri tra l'inizio della riga corrente e il punto del cursore. La stringa di ricerca può cercare corrispondenze dovunque in una riga della cronologia. Questa è una ricerca non incrementale.

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

Inserisce il primo argomento del comando precedente (generalmente la seconda parola sulla riga precedente) alla posizione del cursore. Con un argomento n, inserisce la n-sima parola del comando precedente (le parole nel comando precedente iniziano con la parola 0). Un argomento negativo inserisce la n-sima parola dalla fine del comando precedente. Una volta che l'argomento n è calcolato, l'argomento è estratto come se l'espansione della cronologia "! n" sia stata specificata.

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

Inserisce l'ultimo argomento del comando precedente (l'ultima parola della precedente riga di cronologia). Con un argomento numerico, si comporta esattamente come yank-nth-arg. Chiamate consecutive a yank-last-arg percorrono l'elenco della cronologia all'indietro, inserendo ogni volta l'ultima parola (o la parola specificata dall'argomento della prima chiamata) di ogni riga. Qualsiasi argomento numerico fornito a queste chiamate successive determina la direzione di scorrimento nella cronologia. Un argomento negativo commuta la direzione di scorrimento (all'indietro o in avanti). I servizi dell'espansione della cronologia sono usati per estrarre l'ultima parola, come se fosse stata specificata l'espansione della cronologia "!$".

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

Espande la riga nello stesso modo in cui lo fa la shell. Questo espande gli alias e la cronologia così come tutte le parole della shell. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

history-expand-line (M-^)

Effettua l'espansione della cronologia sulla riga corrente. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

magic-space

Effettua l'espansione della cronologia sulla riga corrente e inserisce uno spazio. Si veda ESPANSIONE DELLA CRONOLOGIA più avanti per una descrizione dell'espansione della cronologia.

alias-expand-line

Effettua l'espansione degli alias sulla riga corrente. Si veda ALIAS sopra per una descrizione dell'espansione degli alias.

history-and-alias-expand-line

Espande la cronologia e gli alias sulla riga corrente.

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

Un sinonimo di yank-last-arg.

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

Invoca un editor sulla riga di comando corrente ed esegue il risultato come comandi di shell. Bash tenta di invocare $VISUAL, $EDITOR e emacs come editor, in quest'ordine.

Comandi per cambiare il testo

fine-del-file (generalmente C-e)

Il carattere che indica fine-del-file come impostato, per esempio, da ``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)

Cancella il carattere nel punto del cursore. Se questa funzione è associata allo stesso carattere come il carattere EOF della tty, come C-d normalmente è, si veda sopra per gli effetti.

backward-delete-char (Rubout)

Cancella il carattere dopo il cursore. Quando è dato un argomento numerico, salva il testo cancellato sul kill-ring.

forward-backward-delete-char

Cancella il carattere sotto il cursore, a meno che il cursore non sia alla fine della riga, nel qual caso il carattere dietro al cursore viene cancellato.

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

Aggiunge il successivo carattere battuto sulla riga in modo letterale. Questo è il modo per inserire caratteri come C-q, per esempio.

tab-insert (C-v TAB)

Inserisce un carattere tab.

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

Inserisce il carattere battuto.

transpose-chars (C-t)

Trascina il carattere prima del punto del cursore in avanti sopra il carattere nel punto, spostando anche il punto in avanti. Se il punto è alla fine della riga, traspone i due caratteri prima del punto. Argomenti negativi non hanno effetto.

transpose-words (M-t)

Trascina la parola prima del punto del cursore dopo la parola oltre il punto, spostando inoltre il punto sopra quella parola. Se il punto è alla fine della riga, allora traspone le ultime due parole sulla riga.

upcase-word (M-u)

Rende maiuscola la parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

downcase-word (M-l)

Rende minuscola la parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

capitalize-word (M-c)

Rende maiuscola la prima lettera della parola corrente (o seguente). Con un argomento negativo, opera sulla parola precedente, ma non sposta il punto del cursore.

overwrite-mode

Alterna fra modalità inserimento e modalità di sovrascrittura. Con un argomento numerico esplicito positivo passa alla modalità sovrascrittura. Con un argomento numerico esplicito non positivo passa alla modalità inserimento. Questo comando riguarda solo la modalità emacs; la modalità vi sovrascrive in modo diverso. Ogni chiamata a readline() viene avviata in modalità inserimento. In modalità sovrascrittura i caratteri associati a self-insert sostituiscono il testo nel punto del cursore piuttosto che sospingere il testo verso destra. I caratteri associati a backward-delete-char sostituiscono il carattere prima del punto con uno spazio. Questo comando è non associato in modo predefinito.

Eliminazione e recupero

kill-line (C-k)

Elimina il testo dal punto del cursore fino alla fine della riga.

backward-kill-line (C-x Rubout)

Elimina all'indietro fino all'inizio della riga.

unix-line-discard (C-u)

Elimina all'indietro dal punto del cursore fino all'inizio della riga. Il testo eliminato viene salvato nel kill-ring.

kill-whole-line

Elimina tutti i caratteri sulla riga corrente, non importa dove sia il punto del cursore.

kill-word (M-d)

Elimina dal punto del cursore fino alla fine della parola corrente o, se tra parole, fino alla fine della successiva parola. I delimitatori di parola sono gli stessi usati da forward-word.

backward-kill-word (M-Rubout)

Elimina la parola dietro il punto del cursore. I delimitatori di parole sono gli stessi usati da forward-word.

shell-kill-word

Elimina dal punto del cursore fino alla fine della parola corrente o, se tra parole, fino alla fine della parola successiva. I delimitatori di parola sono gli stessi usati da shell-forward-word.

shell-backward-kill-word

Elimina la parola dietro il punto del cursore. I delimitatori di parola sono gli stessi usati da shell-backward-word.

unix-word-rubout (C-w)

Elimina la parola dietro il punto del cursore, usando gli spazi bianchi come delimitatori di parola. Il testo eliminato è salvato nel kill-ring.

unix-filename-rubout

Elimina la parola prima del punto del cursore, usando uno spazio bianco e il carattere barra [/] come delimitatori di parola. Il testo eliminato è salvato nel kill-ring.

delete-horizontal-space (M-\)

Cancella tutti gli spazi e i tab attorno al punto del cursore.

kill-region

Elimina il testo nella regione corrente.

copy-region-as-kill

Copia il testo nella regione sul kill buffer.

copy-backward-word

Copia la parola prima del punto del cursore sul kill buffer. I delimitatori di parola sono gli stessi di backward-word.

copy-forward-word

Copia la parola dopo il punto del cursore sul kill buffer. I delimitatori di parola sono gli stessi di forward-word.

yank (C-y)

Copia il contenuto in cima al kill-ring e lo pone nel buffer nel punto del cursore.

yank-pop (M-y)

Ruota il kill-ring, e copia la nuova cima. Funziona solo dopo yank o yank-pop.

Argomenti numerici

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

Aggiunge questa cifra all'argomento che sta già accumulando, o inizia un nuovo argomento. M-- avvia un argomento negativo.

universal-argument

neitherneitherQuesto è un altro modo per specificare un argomento. Se il comando è seguito da una o più cifre, opzionalmente con un segno meno iniziale, queste cifre definiscono l'argomento. Se il comando è seguito da cifre, eseguendo universal-argument di nuovo termina l'argomento numerico, ma a parte questo viene ignorato. Come caso speciale, se questo comando è seguito immediatamente da un carattere che non è né una cifra né un segno meno, il contatore degli argomenti per il comando successivo è moltiplicato per quattro. Il contatore è inizialmente uno, così eseguendo questa funzione la prima volta il contatore diventa quattro, la seconda volta il contatore diventa sedici, e così via.

Completamento

complete (TAB)

Tenta di effettuare il completamento del testo che precede il punto del cursore. Bash tenta il completamento trattando il testo, rispettivamente, come una variabile (se il testo inizia con $), nome di utente (se il testo comincia con ~), nome di host (se il testo comincia con @) o comando (inclusi alias e funzioni). Se nessuno di questi produce un risultato, viene tentato il completamento del nome-file.

possible-completions (M-?)

Elenca i possibili completamenti del testo che precede il punto del cursore.

insert-completions (M-*)

Inserisce tutti i completamenti del testo che precede il punto del cursore che sarebbero stati generati da possible-completions.

menu-complete

Simile a complete, ma sostituisce la parola da completare con una corrispondenza singola dalla lista dei possibili completamenti. Un'esecuzione ripetuta di menu-complete scorre la lista dei possibili completamenti, inserendo una corrispondenza alla volta. Alla fine della lista dei completamenti viene emesso un segnale acustico (dipendente dall'impostazione di bell-style) e il testo originale è ripristinato. Con un argomento n si sposta di n posizioni in avanti nella lista dei completamenti individuati; può essere usato un argomento negativo per spostarsi all'indietro nella lista. Questo comando è da associare normalmente al tasto TABP, però non è associato in modo predefinito.

menu-complete-backward

Identico a menu-complete, ma si muove in senso inverso nella lista dei possibili completamenti, come se menu-complete avesse ricevuto un argomento negativo. Come comportamento predefinito, questo comando non ha restrizioni.

delete-char-or-list

Cancella il carattere sotto il cursore se non si trova all'inizio o alla fine della riga (simile a delete-char). Se è alla fine della riga, si comporta in modo identico a possible-completions. Come comportamento predefinito, questo comando non è associato.

complete-filename (M-/)

Tenta il completamento del nome del file sul testo che precede il punto del cursore.

possible-filename-completions (C-x /)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome-file.

complete-username (M-~)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come un nome di utente.

possible-username-completions (C-x ~)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di utente.

complete-variable (M-$)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come una variabile di shell.

possible-variable-completions (C-x $)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come una variabile di shell.

complete-hostname (M-@)

Tenta il completamento del testo che precede il punto del cursore, trattandolo come un nome di host.

possible-hostname-completions (C-x @)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di host.

complete-command (M-!)

Tenta il completamento del testo che precede punto del cursore, trattandolo come nome di comando. Il completamento di comando tenta di far combaciare il testo confrontandolo con alias, parole riservate, funzioni di shell, comandi incorporati di shell e, da ultimo, nomi-file eseguibili, in quest'ordine.

possible-command-completions (C-x !)

Elenca i possibili completamenti del testo che precede il punto del cursore, trattandolo come un nome di comando.

dynamic-complete-history (M-TAB)

Tenta il completamento del testo che precede il cursore, confrontando il testo con le righe della cronologia cercando le possibili corrispondenze di completamento.

dabbrev-expand

Tenta il completamento del menù sul testo che precede il punto del cursore, confrontando il testo con le righe della lista della cronologia cercando le possibili corrispondenze di completamento.

complete-into-braces (M-{)

Effettua il completamento del nome-file e insericse la lista dei possibili completamenti racchiusi tra parentesi graffe, rendendo la lista disponibile per la shell (si veda Espansione delle parentesi graffe sopra).

Macro di tastiera

start-kbd-macro (C-x ()

Inizia a salvare i caratteri battuti nella corrente macro di tastiera.

end-kbd-macro (C-x ))

Smette di salvare i caratteri battuti nella corrente macro di tastiera e memorizza la definizione.

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

Riesegue l'ultima macro di tastiera definita, facendo sì che i caratteri nella macro appaiano come se fossero stati battuti sulla tastiera.

print-last-kbd-macro ()

Stampa l'ultima macro di tastiera definita in un formato adatto per il file inputrc.

Varie

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

Legge il contenuto del file inputrc, e incorpora ogni associazione o assegnamento di variabile che trova.

abort (C-g)

Annulla il corrente comando di mmodifica ed emette il segnale acustico del terminale (dipendente dall'impostazione di bell-style).

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

Se il carattere x battuto assieme al tasto Meta è maiuscolo, esegue il comando collegato al corrispondente carattere minuscolo. Il comportamento è indefinito se x è già minuscolo.

prefix-meta (ESC)

Definisce come tasto Meta il successivo carattere battuto. ESC f è equivalente a Meta-f.

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

Undo incrementale, memorizzato separatamente per ogni riga.

revert-line (M-r)

Annulla tutti i cambiamenti fatti su questa riga. Questo è come eseguire il comando undo un numero di volte sufficiente a riportare la riga al suo stato iniziale.

tilde-expand (M-&)

Effettua l'espansione della tilde sulla parola corrente.

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

Imposta la marca in corrispondenza del punto del cursore. Se viene fornito un argomento numerico la marca viene impostato a quella posizione.

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

Scambia il punto del cursore con la marca. La posizione corrente del cursore è impostata alla posizione salvata, e la vecchia posizione del cursore è salvata come marca.

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

Legge abbastanza caratteri da esaurire una sequenza di combinazione di tasti come quelle definite per tasti quali Home e End. Queste sequenze iniziano con un Control Sequence Indicator (CSI), generalmente ESC-[. Se questa sequenza è collegata a "\[", i tasti che producono tali sequenze non hanno alcun effetto, a meno che non siano collegati esplicitamente a un comando readline, invece di inserire caratteri sparsi nel buffer di modifica. Come impostazione predefinita, questo comando non ha restrizioni, ma in genere è collegato a ESC-[.

insert-comment (M-#)

Senza un argomento numerico il valore della variabile readline comment-begin è inserito all'inizio della riga corrente. Se è fornito un argomento numerico questo comando agisce come un interruttore: se i caratteri all'inizio della riga non corrispondono al valore di comment-begin, il valore viene inserito, altrimenti i caratteri in comment-begin vengono cancellati dall'inizio della riga. In entrambi i casi la riga viene accettata come se fosse stato battuto un codice di fine riga (newline). Il valore predefinito di comment-begin fa sì che questo comando trasformi la riga corrente in un commento di shell. Se un argomento numerico provoca la rimozione del carattere di commento, la riga verrà eseguita dalla shell.

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)

La parola prima del punto del cursore è trattata come un modello per l'espansione del percorso, con un asterisco aggiunto alla fine implicitamente. Questo modello viene usato per generare una lista di nomi di file corrispondenti a possibili completamenti.

glob-expand-word (C-x *)

La parola prima del punto del cursore è trattata come un modello per l'espansione del percorso, e la lista dei nomi-file individuati viene inserita, sostituendo la parola. Se viene fornito un argomento numerico viene aggiunto alla fine un asterisco prima dell'espansione del percorso.

glob-list-expansions (C-x g)

Viene mostrata la lista delle espansioni che sarebbero state generate da glob-expand-word e la riga è ridisegnata. Se viene fornito un argomento numerico, un asterisco è aggiunto prima dell'espansione del percorso.

dump-functions

Stampa tutte le funzioni e le loro associazioni di tasti sul file di output di readline. Se è fornito un argomento numerico, l'output è formattato in modo tale da poter essere inserito in un file inputrc.

dump-variables

Stampa tutte le variabili readline impostabili e i loro valori sul file di output di readline. Se viene fornito un argomento numerico l'output è formattato in modo tale da poter essere inserito in un file inputrc.

dump-macros

Stampa tutte le sequenze di tasti readline associate a macro e le stringhe da loro prodotte. Se viene fornito un argomento numerico l'uscita è formattata in modo tale da poter essere inserito in un file inputrc.

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

Mostra l'informazione sulla versione della corrente istanza di bash.

Completamento programmabile

STORIA

ESPANSIONE DELLA CRONOLOGIA

Designatore di evento

!

Inizia una sostituzione di cronologia, tranne quando seguita da un blank, newline, carriage return, = o ( (quando l'opzione di shell extglob è abilitata usando il comando incorporato shopt).

!n

Designa la riga di comando n.

!-n

Designa il comando corrente meno n.

!!

Designa il comando precedente. Questo è un sinonimo per `!-1'.

!stringa

Designa il comando più recente che precede la posizione corrente nell'elenco della cronologia che inizia con stringa.

!?stringa[?]

Designa il comando più recente che precede la posizione corrente nell'elenco della cronologia che contiene stringa. Il ? finale può essere omesso se stringa è seguita immediatamente da un codice di fine riga (newline). Se stringa manca, viene usata la stringa dalla ricerca più recente; è un errore se non ci sono precedenti stringhe di ricerca.

^stringa1^stringa2^

Sostituzione rapida. Ripete il comando precedente, rimpiazzando stringa1 con stringa2. Equivalente a “!!:s^ stringa1^stringa2^” (si veda Modificatori più avanti).

!#

L'intera riga di comando battuta fino a questo punto.

Designatori di parola

0 (zero)

La parola numero zero. Per la shell, questa è la parola che costituisce il nome del comando.

n

La n-esima parola.

^

Il primo argomento. Cioè, la parola 1.

$

L'ultima parola. Normalmente questo è l'ultimo argomento, ma si espanderà alla parola numero zero se c'è una sola parola nella riga.

%

La prima parola che combacia con `?stringa?' nella più recente ricerca, se la stringa di ricerca inizia con un carattere che è parte di una parola .

x-y

Un intervallo di parole; `-y' abbrevia `0-y'.

*

Tutte le parole tranne la numero zero. Questo è un sinonimo per ` 1-$'. Non è un errore usare * se vi è solo una parola nell'evento; in quel caso il risultato è una stringa vuota.

x*

Abbrevia x-$.

x-

Abbrevia x-$ come x*, ma omette l'ultima parola. Se manca x , il valore predefinito è 0.

Modificatori

h

Rimuove un componente finale in un nome-file, lasciando solo la testa.

t

Rimuove tutti i componenti iniziali in un nome-file, lasciando la coda.

r

Rimuove un suffisso finale della forma .xxx, lasciando il nome base (basename).

e

Rimuove tutto tranne il suffisso finale.

p

Stampa il nuovo comando ma non lo esegue.

q

Quota le parole sostituite, prevenendo ulteriori sostituzioni.

x

Quota le parole sostituite, come con q, ma spezza in parole sui blank e newline. I modificatori q e x sono mutualmente esclusivi; viene usato l'ultimo fornito.

s/vecchio/nuovo/

Sostituisce nuovo alla prima occorrenza di vecchio nella riga di evento. Qualsiasi carattere può essere usato come delimitatore al posto di /. Il delimitatore finale è opzionale se esso è l'ultimo carattere della riga di evento. Il delimitatore può essere quotato in vecchio e nuovo con una singola barra inversa. Se compare & in nuovo, esso è sostituito da vecchio. Una barra inversa singola quota il carattere &. Se vecchio è nullo, viene impostato all'ultimo vecchio sostituito o, se nessuna sostituzione di cronologia è avvenuta, l'ultima stringa in una ricerca di !?string[?]. Se nuovo è nullo, ogni corrispondenza di vecchio viene cancellata.

&

Ripete la precedente sostituzione.

g

Fa sì che i cambiamenti siano applicati sull'intera riga di evento. Questo si usa in congiunzione con ` :s' (p.es., ` :gs/vecchio/nuovo/') o `:&'. Se usato con ` :s', qualsiasi delimitatore può essere usato al posto di /, e il delimitatore finale è opzionale se è l'ultimo carattere della riga di evento. Un a può essere usato come sinonimo di g.

G

Applica il modificatore che segue `s' o `&' una volta a ogni parola nella riga di evento.

COMANDI INCORPORATI DELLA SHELL

: [argomenti]

Nessun effetto; il comando non fa niente, tranne l'espansione degli argomenti e l'effettuazione di ogni ridirezione specificata. Lo stato di ritorno è zero.

. nome-file [argomenti]

source nome-file [argomenti]

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] [nome[=valore] ...]

Alias senza argomenti o con l'opzione -p stampa la lista degli alias nella forma alias nome=valore sullo standard output. Quando sono forniti argomenti, viene definito un alias per ogni nome per cui è dato il valore. Uno spazio finale a valore fa sì che la parola seguente sia controllata per la sostituzione di alias quando l'alias è espanso. Per ogni nome nella lista di argomenti per cui nessun valore è fornito, è stampato il nome e il valore dell'alias. Alias ritorna 0 (vero) a meno che non venga dato un nome per il quale nessun alias è stato definito.

bg [jobspec ...]

Riprende ogni job sospeso jobspec in background, come se fosse stato avviato con &. Se jobspec non è presente, è usato quello che la shell considera essere il job corrente. bg jobspec ritorna 0 tranne quando viene eseguito con il job-control disabilitato o, se eseguito con il job-control abilitato, se jobspec non è stato trovato o è stato avviato senza usare job-control.

bind [-m keymap] [-lpsvPSVX]

bind [-m keymap] [-q funzione] [ -u funzione] [-r keyseq]

bind [-m keymap] -f nome-file

bind [-m keymap] -x keyseq: comando di shell

bind [-m keymap] keyseq:nome-funzione

bind [-m mappa-tasti] sequenza-tasti: comando 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]

Esce dall'interno di un ciclo for, while, until o select. Se n è specificato, interrompe n livelli. n deve essere ≥ 1. Se n è più grande del numero di cicli racchiusi, tutti i cicli racchiusi vengono terminati. Il valore di ritorno è 0 tranne quando n non è maggiore o uguale a 1.

builtin comando-incorporato [argomenti]

Esegue il comando incorporato specificato, passandogli gli argomenti, e ritorna il suo stato d'uscita. Questo è utile quando si desidera definire una funzione il cui nome è lo stesso di un comando incorporato della shell, ottenendo la funzionalità del comando incorporato attraverso la funzione. Il comando incorporato cd è comunemente ridefinito in questo modo. Lo stato di ritorno è falso se comando-incorporato non è un comando incorporato della shell.

caller [espr]

Restituisce il contesto di qualsiasi chiamata di subroutine attiva (una funzione di shell o uno script eseguito coi comandi incorporati . o source. Senza espr, il caller mostra il numero di riga e il nome di file di origine della chiamata di subroutine corrente. Se un intero non negativo è fornito come espr, caller mostra il numero di riga, il nome di subroutine e il file di origine corrispondente a quella posizione nello stack delle chiamate di esecuzione. Questa informazione aggiuntiva può essere usata, per esempio, per stampare una traccia dello stack. Il frame corrente è il frame 0. Il valore di ritorno è 0 tranne quando la shell non sta eseguendo una chiamata di subroutine o quando espr non corrisponde a una posizione valida nello stack delle chiamate.

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

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] comando [arg ...]

Esegue comando con gli argomenti sopprimendo la normale ricerca tra le funzione di shell. Sono eseguiti solo i comandi incorporati o comandi trovati in PATH. Se è specificata l'opzione -p, la ricerca di comando viene effettuata usando un valore predefinito per PATH usando il quale è garantito che siano trovate tutte le utilità standard. Se è fornita l'opzione -V o -v, viene stampata una descrizione di comando. L'opzione -v provoca la visualizzazione di una singola parola che indica il comando o il nome-file usato per invocare comando; l'opzione -V produce una descrizione più completa. Se è fornita l'opzione -V o -v, lo stato d'uscita è 0 se comando è stato trovato, e 1 altrimenti. Se nessuna delle due opzioni è fornita e avviene un errore o comando non può essere trovato, lo stato d'uscita è 127. Altrimenti, lo stato d'uscita del comando incorporato command è lo stato d'uscita di comando.

compgen [opzione] [parola]

Genera possibili corrispondenze di completamento per parola in accordo con le opzioni, che possono essere qualsiasi opzione accettata dal comando incorporato complete ad eccezione di -p e -r, e scrive le corrispondenze sullo standard output. Quando si usano le opzioni -F o -C, le diverse variabili di shell impostate dai servizi di completamento programmabile, anche se disponibili, non conterranno valori utili. Le corrispondenze saranno generate come se il codice di completamento programmabile le avesse generate direttamente da una specifica di completamento con gli stessi flag. Se viene specificata parola, vengono mostrati solo i completamenti disponibili per parola. Il valore di ritorno è 0 (vero), tranne quando viene fornita un'opzione non valida, o non viene generata alcuna corrispondenza.

complete [-abcdefgjksuv] [-o comp-option] [ -DEI] [-A azione] [-G globpat] [ -W lista_di_parole]

 

[ -F funzione] [-C comando] [-X filterpat] [ -P prefisso] [-S suffisso] nome [nome ...]

complete -pr [-DEI] [nome ...]

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. Altre opzioni, se specificate, hanno i seguenti significati. Gli argomenti alle opzioni -G, -W, e -X (e, se necessario alle opzioni -P e -S) dovrebbero essere quotati per proteggerli dall'espansione prima che venga invocato il comando incorporato complete.

compopt [-o opzione] [-DEI] [+o opzione] [nome]

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. Il valore di ritorno è vero, a meno che non venga fornita un'opzione non valida, venga fatto un tentativo per modificare le opzioni per un nome per il quale non esiste alcuna specifica di completamento, o accada un errore di output.

continue [n]

Riprende la successiva iterazione del ciclo for, while, until o select dentro cui si trova. Se n è specificato, riprende all' n-esima nidificazione del ciclo. n deve essere ≥ 1. Se n è più grande del numero di cicli nidificati, riprende dall'ultimo ciclo esistente (il ciclo a più alto livello). Il valore di ritorno è 0 tranne quando n non è maggiore o uguale a 1.

declare [-aAfFgiIlnrtux] [-p] [nome[= valore] ...]

typeset [-aAfFgiIlnrtux] [-p] [nome[= valore] ...]

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]

Senza opzioni, mostra la lista delle directory correntemente memorizzate. La visualizzazione predefinita è su un singola riga coi nomi di directory separate da spazi. Le directory sono aggiunte alla lista con il comando pushd; il comando popd rimuove elementi dalla lista. La directory corrente è sempre la prima directory nello stack.

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

Senza opzioni, rimuove ogni jobspec dalla tabella dei job attivi. Se jobspec non è presente, e non viene fornita né l'opizone -a né l'opzione -r, viene usato il job corrente. Se viene data l'opzione -h, ogni jobspec non viene rimosso dalla tabella, ma è marcato in modo che SIGHUP non venga inviato al job se la shell riceve un SIGHUP. Se non è specificata alcuna jobspec l'opzione -a richiede la rimozione o il marcamento di tutti i job; l'opzione -r senza un argomento jobspec restringe l'operazione ai job in esecuzione. Il valore di ritorno è 0 tranne quando jobspec non specifica un job valido.

echo [-neE] [arg ...]

Emette gli arg, separati da spazi, seguiti da un newline. Lo stato di ritorno è 0, a meno che non si verifichi un errore di scrittura. Se è specificato -n, il newline finale è soppresso. Se è data l'opzione -e, viene abilitata l'interpretazione dei successivi caratteri preceduti dal carattere di protezione della barra inversa. L'opzione -E disabilita l'interpretazione di questi caratteri di protezione, anche su sistemi dove essi sono interpretati in modo predefinito. L'opzione di shell xpg_echo può essere usata per determinare dinamicamente se echo espande questi caratteri di protezione in modo predefinito oppure no. echo non interpreta -- come fine delle opzioni. echo interpreta le seguenti sequenze di protezione:

enable [-a] [-dnps] [-f nome-file] [ nome ...]

Abilita e disabilita i comandi incorporati della shell. Disabilitare un comando incorporato permette l'esecuzione di un comando residente su disco con lo stesso nome di un comando incorporato della shell senza dover specificare un percorso completo, anche se la shell normalmente cerca i comandi incorporati prima di quelli su disco. Se è usato -n, ogni nome è disabilitato; altrimenti, nomi sono abilitati. Per esempio, per usare il programma binario test trovato attraverso il PATH, invece della versione incorporata nella shell, si esegue ``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 [arg ...]

Gli arg sono letti e concatenati insieme formando un singolo comando. Questo comando è quindi letto ed eseguito dalla shell, e il suo stato di uscita è ritornato come valore del comando eval. Se non vi è alcun arg, o vi sono solo argomenti nulli, eval ritorna 0.

exec [-cl] [-a nome] [comando [ argomenti]]

Se comando è specificato, esso sostituisce la shell. Nessun nuovo processo viene creato. Gli argomenti diventano gli argomenti per comando. Se viene fornita l'opzione -l la shell pone un trattino all'inizio dell'argomento numero zero passato a comando. Questo è quello che fa login(1). L'opzione -c provoca l'esecuzione di comando con un ambiente vuoto. Se viene fornita -a la shell passa nome come argomento numero zero del comando eseguito. Se comando non può essere eseguito per qualche ragione, una shell non interattiva termina, a meno che non sia abilitata l'opzione di shell execfail, nel qual caso restituisce insuccesso. Una shell interattiva restituisce insuccesso se il file non può essere eseguito. Una subshell esce incondizionatamente se exec fallisce. Se comando non è specificato, qualsiasi ridirezione ha effetto nella shell corrente, e lo stato di ritorno è 0. Se si verifica un errore di ridirezione lo stato di ritorno è 1.

exit [n]

Causa l'uscita della shell con uno stato d'uscita n. Se n è omesso, lo stato d'uscita è quello dell'ultimo comando eseguito. Un'intercettazione di segnale su EXIT è eseguita prima che la shell termini.

export [-fn] [nome[=parola]] ...

export -p

I nomi forniti sono marcati per l'esportazione automatica nell'ambiente dei comandi eseguiti in seguito. Se è specificata l' opzione -f, i nomi si riferiscono a funzioni. Se il nome è omesso o se se è fornita l'opzione -p, viene stampata una lista di nomi di tutte le variabili esportate. L'opzione -n provoca la rimozione della proprietà di esportazione da ogni nome. Se un nome di variabile è seguito da = parola, il valore della variabile è impostato a parola. export ritorna uno stato d'uscita di 0 tranne quando viene trovata un'opzione non valida, uno dei nomi non è un nome valido di variabile di shell, o viene fornita l'opzione -f con un nome che non è il nome di una funzione.

fc [-e nome-editor] [-lnr] [primo] [ ultimo]

fc -s [pat=rep] [cmd]

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'' stampa gli ultimi 10 comandi) e a primo altrimenti. Se primo non è specificato è impostato al precedente comando per la modifica e a -16 per l'elencazione. L'opzione -n sopprime i numeri dei comandi quando li elenca. L'opzione -r inverte l'ordine dei comandi. Se è specificata l'opzione -l, i comandi sono elencati sullo standard output. Altrimenti, è invocato l'editor indicato da ename su un file che contiene questi comandi. Se ename è omesso, è usato il valore della variabile FCEDIT, e il valore di EDITOR se FCEDIT non è impostata. Se né l'una né l'altra variabile è impostata, è usato vi Quando la modifica è completata, i comandi modificati sono listati ed eseguiti. Nella seconda forma, comando è rieseguito dopo che ogni istanza di pat è sostituita da rep. Comando è interpretato come primo.Un utile alias da usare con questo è ``r="fc -s"'', così che digitando ``r cc'' si esegue l'ultimo comando che inizia con ``cc'' e battendo ``r'' si riesegue l'ultimo comando. Se è usata la prima forma, il valore di ritorno è 0 a meno che sia incontrata un'opzione non valida o primo o ultimo specifichino righe di cronologia fuori dall'intervallo esistente. Se è fornita l'opzione -e, il valore di ritorno è il valore dell'ultimo comando eseguito, o insuccesso se avviene un errore con il file temporaneo dei comandi. Se è usata la seconda forma, lo stato di ritorno è quello del comando rieseguito, tranne quando cmd non specifica una riga di cronologia valida, nel qual caso fc ritorna insuccesso.

fg [jobspec]

Riprende jobspec in primo piano, e lo rende il job corrente. Se jobspec non è presente, è usata la nozione della shell di job corrente. Il valore di ritorno è quello del comando posto in primo piano, o insuccesso se eseguito mentre il job-control è disabilitato o, quando eseguito col job-control abilitato, se jobspec non specifica un job valido o jobspec specifica un job che era stato avviato senza job-control.

getopts optstring nome [arg ...]

getopts è usato dalle procedure di shell per analizzare i parametri posizionali. optstring contiene i caratteri delle opzioni che devono essere riconosciuti; se un carattere è seguito da due punti, l'opzione si aspetta di avere un argomento, che dovrà essere separato dalla stessa da spazi bianchi. I due punti e il punto interrogativo non possono essere usati come caratteri di opzione. Ogni volta che è invocato, getopts pone la successiva opzione nella variabile di shell nome, inizializzando nome se non esiste, e l'indice del prossimo argomento da elaborare nella variabile OPTIND. OPTIND è inizializzato a 1 ogni volta che la shell o uno script di shell viene invocato. Quando un'opzione richiede un argomento, getopts pone quell'argomento nella variabile OPTARG. La shell non reimposta OPTIND automaticamente; questa variabile deve essere manualmente reimpostata tra più chiamate a getopts dentro la stessa esecuzione della shell, se deve essere usato un nuovo insieme di parametri. Quando viene raggiunta la fine delle opzioni getopts esce con un valore di ritorno maggiore di zero. OPTIND è impostato all'indice del primo argomento senza opzioni e nome viene impostato a ?. getopts normalmente analizza i parametri posizionali, ma se più argomenti vengono dati come valori arg, getopts analizza solo quelli. getopts può informare degli errori in due modi. Se il primo carattere di optstring è un due punti, è usata un'informazione di errore silenziosa. Normalmente i messaggi diagnostici vengono stampati quando vengono trovate opzioni non valide o mancano argomenti alle opzioni. Se la variabile OPTERR è impostata a 0, nessun messaggio di errore viene mostrato, anche se il primo carattere di optstring non è due punti. Se è incontrata un'opzione non valida, getopts pone ? nel nome e, se non silenziosa, stampa un messaggio di errore e annulla OPTARG. Se getopts è silenziosa, il carattere di opzione trovato è posto in OPTARG e nessun messaggio diagnostico è stampato. Se un argomento richiesto non è trovato, e getopts non è silenziosa, un punto interrogativo ( ?) è posto in nome, OPTARG viene annullato, e viene stampato un messaggio diagnostico. Se getopts è silenziosa, allora un carattere di due punti ( :) è posto in nome e OPTARG è impostato al carattere di opzione trovato. getopts ritorna 0 (vero) se viene trovata un'opzione, specificata o non specificata. Ritorna falso se viene incontrata la fine delle opzioni o avviene un errore.

hash [-lr] [-p nome-file] [-dt] [ nome]

Ogni volta che hash viene invocata, il percorso completo del comando nome è determinato ricercando le directory in $PATH e viene memorizzato. Ogni nome di percorso precedentemente memorizzato viene perso. Se viene fornita l'opzione -p, non viene effettuata nessuna ricerca di percorso e nome-file è usato come nome completo del comando. L'opzione -r fa sì che la shell dimentichi tutti i percorsi memorizzati. L'opzione -d fa sì che la shell dimentichi i percorsi memorizzati di ogni nome. Se viene fornita l'opzione -t è stampato il percorso completo al quale corrisponde ogni nome. Se vengono forniti argomenti multipli di nome con -t, il nome viene stampato prima del percorso completo indicizzato. L'opzione -l provoca la visualizzazione dell'output in un formato riutilizzabile come input. Se nessun argomento è dato, ed è fornito solo -l, è stampata l'informazione circa i comandi memorizzati. Lo stato di ritorno è 0 (vero) tranne quando nome è irreperibile o viene fornita un'opzione non valida.

help [-dms] [modello]

Mostra utili informazioni sui i comandi incorporati. Se modello è specificato, help fornisce un aiuto dettagliato su tutti i comandi che corrispondono al modello; altrimenti è stampato l'aiuto per tutti i comandi incorporati e le strutture di controllo della shell.

history [n]

history -c

history -d scostamento

history -d iniziofine

history -anrw [nome-file]

history -p arg [arg ...]

history -s arg [arg ...]

Senza opzioni, mostra la lista della cronologia dei comandi con i numeri di riga. Le righe elencate con un * sono state modificate. Con l'argomento n elenca solo le ultime n righe. Se la variabile di shell HISTTIMEFORMAT è impostata e non nulla, è usata come stringa di formato di strftime(3) per mostrare la data/ora associata a ogni elemento della cronologia. Nessuno spazio è interposto fra la data/ora formattata e la riga della cronologia. Se è fornito nome-file, questo è usato come nome del file di cronologia; altrimenti, è usato il valore di HISTFILE. Le opzioni, se fornite, hanno i seguenti significati:

jobs [-lnprs] [ jobspec ... ]

jobs -x comando [ args ... ]

La prima forma elenca i job attivi. Le opzioni hanno i seguenti significati:

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

kill -l|-L [sigspec | exit_status]

Manda il segnale indicato da sigspec o signum al processo indicato da pid o jobspec. sigspec è o un nome di segnale, senza distinzione tra maiuscole e minuscole, come SIGKILL, (con o senza il prefisso SIG) o un numero di segnale; signum è un numero di segnale. Se sigspec non è presente, si suppone essere SIGTERM. Un argomento -l elenca i nomi dei segnali. Se sono forniti degli argomenti quando è specificata l'opzione -l, sono elencati i nomi dei segnali corrispondenti agli argomenti, e lo stato di ritorno è 0. L'argomento stato d'uscita di -l è un numero che specifica o un numero di segnale o lo stato d'uscita di un processo terminato da un segnale. L'opzione -L è equivalente a -l. kill restituisce 0 (vero) se almeno un segnale è stato inviato con successo, o falso se avviene un errore o se è incontrata un'opzione non valida.

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 [opzione] [nome[=valore] ... | - ]

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

Termina una shell di login.

mapfile [-d delim] [-n numero] [ -O origine] [-s numero] [-t] [ -u fd] [-C callback] [-c quantum] [array]

readarray [-d delim] [-n numero] [ -O origine] [-s numero] [-t] [ -u fd] [-C callback] [-c quantum] [array]

Legge righe dallo standard input all'interno della variabile array indicizzata array, o dal descrittore di file fd se viene fornita l'opzione -u. La variabile MAPFILE è l' array predefinito. Le opzioni, se fornite, hanno il seguente significato:

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 var] formato [argomenti]

Scrive gli argomenti formattati sullo standard output sotto il controllo del formato. Con l'opzione -v l'output viene assegnato alla variabile var piuttosto che essere stampato sullo standard output. Il formato è una stringa di caratteri che contiene tre tipi di oggetti: caratteri semplici, i quali sono semplicemente copiati sullo standard output, sequenze di protezione dei caratteri, che sono convertite e copiate sullo standard output, e specifiche di formato, ognuna delle quali provoca la stampa dell' argomento seguente. Oltre alle specifiche di formato printf(1) standard, printf interpreta le seguenti estensioni:

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

pushd [-n] [dir]

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]

Stampa il percorso assoluto della corrente directory di lavoro. Il percorso stampato non contiene alcun collegamento simbolico se è fornita l'opzione -P o l'opzione -o physical al comando incorporato set è abilitata. Se viene usata l'opzione -L il percorso stampato può contenere collegamenti simbolici. Lo stato di ritorno è 0 tranne quando avviene un errore mentre si legge il percorso della directory corrente o viene fornita un'opzione non valida.

read [-ers] [-a aname] [-d delim] [-i testo] [-n nchars] [ -N nchars] [-p prompt] [-t tempo_limite] [ -u fd] [nome ...]

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] [nome[=parola] ...]

I nomi dati sono da considerare in sola lettura; i valori di questi nomi non possono essere cambiati dagli assegnamenti successivi. Se è fornita l'opzione -f, sono così marcate le funzioni corrispondenti ai nomi. L'opzione -a restringe le variabili agli array indicizzati; l'opzione -A restringe le variabili agli array associativi. Se vengono fornite entrambe le opzioni, -A ha la precedenza. Se nessun argomento nome è dato, o se è fornita l'opzione -p, viene stampata una lista di tutti i nomi in sola lettura. Le altre opzioni possono essere usate per restringere l'output a una sotto-serie della serie di nomi in sola lettura. L'opzione -p provoca la visualizzazione dell'output in un formato riutilizzabile come input. Se un nome di variabile è seguito da = parola il valore della variabile è impostato a parola. Lo stato di ritorno è 0 tranne quando è incontrata un'opzione non valida, uno dei nomi non è un nome di variabile di shell valido, o viene fornita l'opzione -f con un nome che non è una funzione.

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]

I parametri posizionali da n+1 ... sono rinominati $1 .... I parametri rappresentati dai numeri $# fino a $#-n+1 non sono impostati. n dev'essere un numero non negativo minore o uguale a $#. Se n è 0, nessun parametro viene cambiato. Se n è omesso, è considerato valere 1. Se n è più grande di $#, i parametri posizionali non sono cambiati. Lo stato di ritorno è più grande di 0 se n è più grande di $# o minore di 0; altrimenti 0.

shopt [-pqsu] [-o] [nome-opzione ...]

Attiva/disattiva i valori delle impostazioni che controllano il comportamento opzionale della shell. Le impostazioni possono essere o quelle elencate sotto o, se viene usata l'opzione -o, quelle disponibili con l'opzione -o al comando incorporato set. Senza opzioni, o con l'opzione -p, viene mostrata una lista di tutte le opzioni impostabili, con una indicazione se ognuna è impostata o no; se vengono forniti nomi-opzioni, l'output è ristretto a queste opzioni. L'opzione -p fa sì che l'output sia mostrato in una forma che può essere riutilizzata come input. Altre opzioni hanno il seguente significato: