zshmodules - Online nel cloud

PROGRAMMA:

NOME

zshmodules - moduli caricabili zsh

DESCRIZIONE

Alcune parti opzionali di zsh si trovano in moduli, separati dal nucleo della shell. Ciascuna di
questi moduli possono essere collegati alla shell in fase di creazione o possono essere collegati dinamicamente
mentre la shell è in esecuzione se l'installazione supporta questa funzionalità. I moduli sono collegati
in fase di esecuzione con il zmodload comando, vedi zshbuiltins(1).

I moduli forniti in bundle con la distribuzione zsh sono:

zsh/attr
Funzioni integrate per manipolare attributi estesi (xattr).

zsh/cap
Componenti incorporati per manipolare set di capacità (privilegi) POSIX.1e (POSIX.6).

zsh/clone
Un built-in che può clonare una shell in esecuzione su un altro terminale.

zsh/compctl
. compl integrato per il controllo del completamento.

zsh/completo
Il codice di completamento di base.

zsh/complist
Estensioni dell'elenco di completamento.

zsh/computil
Un modulo con utilità integrate necessarie per il completamento basato sulle funzioni della shell
.

zsh/maledizioni
maledice i comandi delle finestre

zsh/dataora
Alcuni comandi e parametri di data/ora.

zsh/db/gdbm
Componenti integrati per la gestione dei parametri di array associativi legati ai database GDBM.

zsh/deltochar
Una funzione ZLE che duplica EMACS' zap-to-char.

zsh/esempio
Un esempio di come scrivere un modulo.

zsh/file
Alcuni comandi di base per la manipolazione dei file come incorporati.

zsh/langinfo
Interfaccia per le informazioni locali.

zsh/mapfile
Accesso ai file esterni tramite uno speciale array associativo.

zsh/funzione matematica
Funzioni scientifiche standard da utilizzare nelle valutazioni matematiche.

zsh/nuovo utente
Organizzare l'installazione dei file per i nuovi utenti.

zsh/parametro
Accesso alle tabelle hash interne tramite speciali array associativi.

zsh/pc
Interfaccia con la libreria PCRE.

zsh/espressione regolare
Interfaccia con la libreria regex POSIX.

zsh/sched
Un componente integrato che fornisce una funzionalità di esecuzione temporizzata all'interno della shell.

zsh/rete/presa
Manipolazione dei socket di dominio Unix

zsh/stat
Un'interfaccia di comando integrata per stat chiamata di sistema.

zsh/sistema
Un'interfaccia integrata per varie funzionalità di sistema di basso livello.

zsh/rete/tcp
Manipolazione dei socket TCP

zsh/termcap
Interfaccia con il database termcap.

zsh/terminfo
Interfaccia con il database terminfo.

zs/zftp
Un client FTP integrato.

zsh/zle
L'editor della linea Zsh, incluso il file tasto legato e variato incorporati.

parametro zsh/zle
Accesso agli interni di Zsh Line Editor tramite parametri.

zsh/zprof
Un modulo che consente la profilazione delle funzioni della shell.

zsh/zpty
Un built-in per avviare un comando in uno pseudo-terminale.

zsh/zseleziona
Blocca e restituisci quando i descrittori di file sono pronti.

zsh/zutil
Alcuni built-in di utilità, ad es. quello per supportare la configurazione tramite stili.

IL ZSH/ATTR MODULO

. zsh/attr il modulo viene utilizzato per manipolare gli attributi estesi. IL -h cause di opzione
tutti i comandi devono operare su collegamenti simbolici invece che sui loro obiettivi. Le caratteristiche integrate in questo
modulo sono:

zgetattr [ -h ] Nome del file attributo [ parametro ]
Ottieni l'attributo esteso attributo da quello specificato Nome del file. Se l'opzionale
argomento parametro viene fornito, l'attributo viene impostato su quel parametro anziché su
in fase di stampa su stdout.

zsetattr [ -h ] Nome del file attributo APPREZZIAMO
Imposta l'attributo esteso attributo su specificato Nome del file a APPREZZIAMO.

zdelattr [ -h ] Nome del file attributo
Rimuovere l'attributo esteso attributo da quello specificato Nome del file.

zlistattr [ -h ] Nome del file [ parametro ]
Elenca gli attributi estesi attualmente impostati sull'oggetto specificato Nome del file. Se il
argomento opzionale parametro viene fornito, l'elenco degli attributi viene impostato su quello
parametro invece di essere stampato su stdout.

zgetattr e zlistattr allocare la memoria in modo dinamico. Se l'attributo o l'elenco di
gli attributi crescono tra l'allocazione e la chiamata per ottenerli, restituiscono 2. Su tutti
altri errori, viene restituito 1. Ciò consente alla funzione chiamante di verificare questo caso e
riprovare.

IL ZSH/CAP MODULO

. zsh/cap Il modulo viene utilizzato per manipolare i set di funzionalità POSIX.1e (POSIX.6). Se la
Il sistema operativo non supporta questa interfaccia, i built-in definiti da questo modulo lo faranno
fare niente. Gli elementi incorporati in questo modulo sono:

berretto [ funzionalità ]
Modificare i set di capacità del processo della shell come specificato funzionalità, Altrimenti
visualizzare le capacità attuali della shell.

getcap Nome del file ...
Questa è un'implementazione integrata dell'utilità standard POSIX. Visualizza il
set di capacità su ciascuno specificato Nome del file.

setcap funzionalità Nome del file ...
Questa è un'implementazione integrata dell'utilità standard POSIX. Imposta il
set di capacità su ciascuno specificato Nome del file al specificata funzionalità.

IL ZSH/CLONE MODULO

. zsh/clone il modulo rende disponibile un comando integrato:

clonare tty
Crea un'istanza biforcuta della shell corrente, collegata all'oggetto specificato tty. in
la nuova shell, il PID, PPID e TTY i parametri speciali vengono modificati in modo appropriato.
$! è impostato su zero nella nuova shell e sul PID della nuova shell nell'originale
conchiglia.

Lo stato di ritorno del built-in è zero in entrambe le shell in caso di successo e diverso da zero
su errore.

L'obiettivo di clonare dovrebbe essere un terminale inutilizzato, come una console virtuale inutilizzata
o un terminale virtuale creato da

xterm -e sh -c 'trappola : INT SMETTERE TSTP; tty;
while :; do sonno 100000000; Fatto'

Alcune parole di spiegazione sono giustificate su questa lunga riga di comando xterm: quando
facendo clone su uno pseudo-terminale, qualche altra sessione ("sessione" intesa come unix
gruppo di sessione o SID) possiede già il terminale. Quindi lo zsh clonato non può
acquisire lo pseudo-terminale come tty di controllo. Ciò significa due cose:

· i segnali di controllo del lavoro andranno al gruppo di processi sh-started-by-xterm
(ecco perché disabilitiamo INT QUIT e TSTP con trap; altrimenti il ​​ciclo while
potrebbe essere sospeso o ucciso)

· la shell clonata avrà il controllo del lavoro disabilitato e i tasti di controllo del lavoro
(control-C, control-\ e control-Z) non funzioneranno.

Ciò non si applica quando si clona su un file non usato vc.

La clonazione su un terminale utilizzato (e non preparato) comporterà la lettura di due processi
simultaneamente dallo stesso terminale, con i byte di input che vanno casualmente a uno dei due


clonare è utile soprattutto come sostituto integrato nella shell di openvt.

IL ZSH/COMPCTL MODULO

. zsh/compctl il modulo mette a disposizione due comandi integrati. compl, è il vecchio,
modo deprecato per controllare i completamenti per ZLE. Vedere zshcompctl(1). L'altro incorporato
comando, compcall può essere utilizzato nei widget di completamento definiti dall'utente, vedere zshcompwid(1).

IL ZSH/COMPLETO MODULO

. zsh/completo Il modulo rende disponibili diversi comandi integrati che possono essere utilizzati in
widget di completamento definiti dall'utente, vedere zshcompwid(1).

IL ZSH/COMPLIST MODULO

. zsh/complist il modulo offre tre estensioni agli elenchi di completamento: la capacità di
evidenziare le corrispondenze in tale elenco, la possibilità di scorrere elenchi lunghi e un altro
stile di completamento del menu.

Colorato completamento annunci
Ogni volta che uno dei parametri ZLS_COLORI or ZLS_COLORI è impostato e il zsh/complist
viene caricato o collegato alla shell, gli elenchi di completamento verranno colorati. Nota,
tuttavia, quello complist non verrà caricato automaticamente se non è collegato in: on
sistemi con carico dinamico, `zmodload zsh/complist' è obbligatorio.

I parametri ZLS_COLORI e ZLS_COLORI descrivere come vengono evidenziate le corrispondenze. Girare
sull'evidenziazione di un valore vuoto è sufficiente, in tal caso tutti i valori predefiniti riportati di seguito
sarà usato. Il formato del valore di questi parametri è lo stesso utilizzato da GNU
versione del ls comando: un elenco di specifiche del modulo separate da due punti
`Nome=APPREZZIAMO'. Il Nome può essere una delle seguenti stringhe, la maggior parte delle quali specifica file
tipi per i quali il APPREZZIAMO sarà usato. Le stringhe e i relativi valori predefiniti sono:

no 0 per testo normale (ovvero quando viene visualizzato qualcosa di diverso da un file corrispondente)

fi 0 per i file normali

di 32 per le directory

ln 36 per i collegamenti simbolici. Se questo ha un valore speciale bersaglio, i collegamenti simbolici sono
dereferenziato e il file di destinazione utilizzato per determinare il formato di visualizzazione.

pi 31 per pipe denominate (FIFO)

so 33 per prese

bd 44; 37
per i dispositivi a blocchi

cd 44; 37
per i dispositivi a caratteri

or nessuna
per un collegamento simbolico a un file inesistente (il valore predefinito è quello definito per ln)

mi nessuna
per un file inesistente (il valore predefinito è il valore definito per fi); questo codice è
attualmente non utilizzato

su 37; 41
per file con bit setuid impostato

sg 30; 43
per file con bit setgid impostato

tw 30; 42
per directory scrivibili in tutto il mondo con set di bit appiccicosi

ow 34; 43
per directory scrivibili da tutto il mondo senza set di bit appiccicosi

sa nessuna
per i file con un alias suffisso associato; questo viene testato solo dopo specifico
suffissi, come descritto di seguito

st 37; 44
per directory con bit permanente impostato ma non scrivibili da tutti

ex 35 per i file eseguibili

lc \e[ per il codice di sinistra (vedi sotto)

rc m per il codice giusto

tc 0 per il carattere che indica il tipo di file stampato dopo i nomi dei file se il file
LISTA_TIPI l'opzione è impostata

sp 0 per gli spazi stampati dopo le corrispondenze per allineare la colonna successiva

ec nessuna
per il codice finale

Oltre a queste stringhe, il Nome può anche essere un asterisco (`*') seguito da qualsiasi stringa.
. APPREZZIAMO dato per tale stringa verrà utilizzato per tutti i file il cui nome termina con
corda. Il Nome può anche essere un segno di uguale (`=') seguito da uno schema; IL
EXTENDED_GLOB verrà attivata l'opzione per la valutazione del modello. IL APPREZZIAMO dato per
questo modello verrà utilizzato per tutte le corrispondenze (non solo per i nomi di file) la cui stringa di visualizzazione è
abbinato al modello. Prendi le definizioni per la forma con il segno uguale iniziale
precedenza sui valori definiti per i tipi di file, che a loro volta hanno la precedenza sui valori
modulo con l'asterisco iniziale (estensioni di file).

La forma iniziale-uguale consente inoltre di colorare diverse parti delle stringhe visualizzate
diversamente. Per questo, il modello deve utilizzare l'estensione `(#B)'bandiera globbing e coppie di
parentesi che racchiudono le parti delle stringhe che devono essere colorate diversamente. In
questo caso il APPREZZIAMO può essere costituito da più codici colore separati da segni uguali. IL
il primo codice verrà utilizzato per tutte le parti per le quali non è specificato alcun codice esplicito e il
i seguenti codici verranno utilizzati per le parti corrispondenti ai sottomodelli tra parentesi.
Ad esempio, la specificazione `=(#b)(?)*(?)=0=3=7' verrà utilizzato per tutte le corrispondenze che sono
lungo almeno due caratteri e utilizzerà il codice `3' per il primo carattere, `7' per
l'ultimo carattere e `0' per il resto.

Tutte e tre le forme di Nome può essere preceduto da uno schema tra parentesi. Se questo viene dato,
, il APPREZZIAMO verrà utilizzato solo per le corrispondenze nei gruppi i cui nomi corrispondono al modello
dato tra parentesi. Ad esempio, `(g*)m*=43' evidenzia tutte le partite che iniziano con
`m' nei gruppi i cui nomi iniziano con `g' utilizzando il codice colore `43'. Nel caso del `lc',
`rc', e `ec', il modello di gruppo viene ignorato.

Si noti inoltre che tutti i pattern vengono provati nell'ordine in cui appaiono nel parametro
valore fino a quando il primo non corrisponde a quello che viene quindi utilizzato.

Quando si stampa una corrispondenza, il codice stampa il valore di lc, il valore per il tipo di file o il file
ultima specifica corrispondente con un `*', il valore di rc, la stringa da visualizzare per il
corrisponde a se stesso e quindi al valore di ec se questo è definito o i valori di lc, noe rc
if ec non è definito.

I valori predefiniti sono conformi allo standard ISO 6429 (ANSI) e possono essere utilizzati su dispositivi compatibili con vt100
terminali come xtermS. Sui terminali monocromatici i valori predefiniti non saranno visibili
effetto. Il Colori la funzione dal contributo può essere utilizzata per ottenere array associativi
contenente i codici per i terminali ANSI (vedere la sezione "Altre funzioni" in
zshcontrib(1)). Ad esempio, dopo il caricamento Colori, si potrebbe usare `$colori[rosso]' ottenere
il codice per il colore di primo piano rosso e `$colori[bg-verde]' per il codice per lo sfondo
colore verde.

Se viene utilizzato il sistema di completamento richiamato da compinit, questi parametri non devono essere impostati
direttamente perché il sistema stesso li controlla. Invece, il lista-colori lo stile dovrebbe
essere utilizzato (vedere la sezione "Completamento della configurazione del sistema" in zshcomsys(1)).

Scorrimento in completamento annunci
Per abilitare lo scorrimento di un elenco di completamento, il file PRONTA ELENCO il parametro deve essere impostato. Suo
il valore verrà utilizzato come prompt; se è una stringa vuota, verrà visualizzato un prompt predefinito
usato. Il valore può contenere caratteri di escape nella forma `%x'. Supporta le fughe`%B',
`%b', `%S', `%s', `%U', `%u', `%F', `%f', `%K', `%k' e `%{...%}' usato anche nella conchiglia
richiede così come tre paia di sequenze aggiuntive: un `%l' o `%L'è sostituito da
numero dell'ultima riga visualizzata e numero totale di righe nel formato `numero/totale'; UN
`%m' o `%M' viene sostituito con il numero dell'ultima corrispondenza mostrata e il numero totale di
partite; e `%p' o `%P' viene sostituito con `Top', `Parte inferiore' o la posizione del primo
linea mostrata rispettivamente in percentuale del numero totale di linee. In ciascuno di questi casi
la maschera con la lettera maiuscola verrà sostituita con una stringa di larghezza fissa, riempita
a destra con spazi, mentre la forma minuscola non verrà riempita.

Se il parametro PRONTA ELENCO è impostato, il codice di completamento non chiederà se l'elenco dovrebbe essere
mostrato. Invece inizia immediatamente a visualizzare l'elenco, fermandosi dopo il primo
schermata, mostrando il prompt in basso, in attesa della pressione di un tasto dopo temporaneamente
passando a listscroll mappa dei tasti. Alcune funzioni zle hanno un significato speciale
durante lo scorrimento degli elenchi:

invio-break
smette di elencare scartando il tasto premuto

accettare-line, down-storia, down-line-o-storia
down-line-o-cerca, vi-down-line-o-storia
scorre avanti di una riga

parola-completa, menu-completo, espandi o completa
prefisso espandi o completa, menu-completa-o-espandi
scorre in avanti di una schermata

accetta-cerca
interrompi l'elenco ma non intraprendi altre azioni

Tutti gli altri caratteri interrompono l'elenco ed elaborano immediatamente la chiave come al solito. Qualsiasi chiave
che non è vincolato nel listscroll keymap o a cui è associato chiave indefinita è cercato
nella mappa dei tasti attualmente selezionata.

Come per l' ZLS_COLORI e ZLS_COLORI parametri, PRONTA ELENCO non dovrebbe essere impostato direttamente
quando si utilizza il sistema di completamento basato su funzioni di shell. Invece, il lista-prompt stile
dovrebbe essere usato.

Menu prodotti
. zsh/complist il modulo offre anche uno stile alternativo per selezionare le corrispondenze da un elenco,
chiamata selezione del menu, che può essere utilizzata se la shell è impostata per tornare all'ultima
prompt dopo aver mostrato un elenco di completamento (vedere il file SEMPRE_ULTIMO_PROMPT opzione
zshoptions(1)).

La selezione del menu può essere richiamata direttamente dal widget selezione menu definito da questo modulo.
Questo è un widget ZLE standard che può essere associato a una chiave nel solito modo, come descritto in
zshzle(1).

In alternativa, il parametro MENUSELEZ può essere impostato su un numero intero, che fornisce il minimo
numero di corrispondenze che devono essere presenti prima che la selezione del menu venga attivata automaticamente.
Questo secondo metodo richiede che venga avviato il completamento del menu, oppure direttamente da un widget
ad esempio menu-completoo a causa di una delle opzioni MENU_COMPLETO or AUTO_MENU essere impostato.
If MENUSELEZ è impostato, ma è 0, 1 o vuoto, la selezione del menu verrà sempre avviata durante
un completamento del menu ambiguo.

Quando si utilizza il sistema di completamento basato su funzioni di shell, il file MENUSELEZ il parametro dovrebbe
non essere utilizzato (come il ZLS_COLORI e ZLS_COLORI parametri sopra descritti). Invece,
, il menu style dovrebbe essere usato con il file seleziona=... parola chiave.

Dopo aver avviato la selezione del menu, verranno elencate le corrispondenze. Se ci sono più corrispondenze
di quelli visualizzati sullo schermo, viene mostrata solo la prima schermata. Le partite da inserire nel file
la riga di comando può essere selezionata da questo elenco. Nell'elenco viene evidenziata una corrispondenza utilizzando
il valore per ma dal ZLS_COLORI or ZLS_COLORI parametro. Il valore predefinito per questo
è `7' che forza l'evidenziazione della corrispondenza selezionata utilizzando la modalità standout su a
Terminale compatibile con vt100. Se nessuno dei due ZLS_COLORI né ZLS_COLORI è impostato, lo stesso
sequenza di controllo del terminale come per `%S' viene utilizzato l'escape nei prompt.

Se ci sono più corrispondenze di quelle che si adattano allo schermo e al parametro MENUPROMPT è impostato, è
il valore verrà mostrato sotto le corrispondenze. Supporta le stesse sequenze di escape di
PRONTA ELENCO, ma il numero della corrispondenza o della riga visualizzata sarà quello in cui si trova il
il contrassegno è posizionato. Se il suo valore è una stringa vuota, verrà utilizzato un prompt predefinito.

. SCORRIMENTO DEL MENU Il parametro può essere utilizzato per specificare la modalità di scorrimento dell'elenco. Se la
non è impostato, l'operazione viene eseguita riga per riga, se è impostato su `0' (zero), l'elenco lo farà
scorrere la metà del numero di righe dello schermo. Se il valore è positivo, dà il
numero di righe da scorrere e se è negativo la lista verrà fatta scorrere del numero di
righe dello schermo meno il valore (assoluto).

Come per l' ZLS_COLORI, ZLS_COLORI e PRONTA ELENCO parametri, nemmeno MENUPROMPT né
SCORRIMENTO DEL MENU dovrebbe essere impostato direttamente quando si utilizza il sistema di completamento basato sulle funzioni di shell.
Invece, il prompt di selezione e seleziona-scorri dovrebbero essere utilizzati gli stili

Il codice di completamento a volte decide di non mostrare tutte le corrispondenze nell'elenco. Questi
le corrispondenze nascoste sono corrispondenze per le quali è stata aggiunta la funzione di completamento
richiesto esplicitamente che non compaiano nell'elenco (utilizzando il file -n opzione del compad
comando incorporato) oppure sono corrispondenze che duplicano una stringa già presente nell'elenco (perché
differiscono solo in cose come prefissi o suffissi che non vengono visualizzati). Nella lista
utilizzato per la selezione del menu, tuttavia, anche queste corrispondenze vengono visualizzate in modo che sia possibile farlo
selezionali. Per evidenziare tali corrispondenze il hi e du capacità nel ZLS_COLORI e
ZLS_COLORI sono supportati i parametri per le corrispondenze nascoste del primo e del secondo tipo,
rispettivamente.

La selezione delle corrispondenze viene effettuata spostando il segno utilizzando le funzioni di movimento zle.
Quando non tutte le partite possono essere visualizzate sullo schermo contemporaneamente, l'elenco scorrerà verso l'alto
e verso il basso quando si attraversa la linea superiore o inferiore. Le seguenti funzioni zle hanno speciali
significato durante la selezione del menu. Tieni presente che quanto segue esegue sempre la stessa attività
all'interno della mappa di selezione del menu e non può essere sostituito da widget definiti dall'utente, né può farlo il file
insieme di funzioni essere esteso:

accettare-line, accetta-cerca
accetta la corrispondenza corrente e lascia la selezione del menu (ma non attivare il comando
linea da accettare)

invio-break
abbandona la selezione del menu e ripristina il contenuto precedente della riga di comando

rivisualizzare, schermo pulito
eseguire la loro normale funzione senza abbandonare la selezione del menu

accetta e trattieni, accetta-e-menu-completo
accetta la corrispondenza attualmente inserita e continua la selezione permettendo di selezionare il
corrispondenza successiva da inserire nella riga

accettare-e-inferire-prossima-storia
accetta la corrispondenza corrente e quindi tenta nuovamente il completamento con la selezione del menu; In
nel caso dei file ciò consente di selezionare una directory e tentare immediatamente di farlo
completare i file in esso contenuti; se non ci sono corrispondenze, viene mostrato un messaggio ed è possibile utilizzarlo
disfare per tornare al livello precedente, ogni altro tasto esce dal menu
selezione (comprese le altre funzioni zle che altrimenti sarebbero speciali durante
selezione del menù)

disfare rimuove le corrispondenze inserite durante la selezione del menu da una delle tre funzioni
prima

down-storia, down-line-o-storia
vi-down-line-o-storia, down-line-o-cerca
sposta il segno di una riga verso il basso

up-storia, up-line-o-storia
vi-up-line-o-storia, up-line-o-cerca
sposta il segno di una riga verso l'alto

avanti-char, vi-forward-char
sposta il segno di una colonna a destra

carattere all'indietro, vi-indietro-char
sposta il segno di una colonna a sinistra

avanti-parola, vi-forward-parola
vi-avanti-fine-parola, emacs-forward-parola
sposta il segno di una schermata verso il basso

parola all'indietro, vi-indietro-parola, emacs-backward-parola
sposta il segno di una schermata verso l'alto

vi-avanti-parola-vuota, vi-avanti-parola-vuota-fine
sposta il contrassegno sulla prima riga del successivo gruppo di corrispondenze

vi-parola-vuota all'indietro
sposta il contrassegno sull'ultima riga del gruppo di corrispondenze precedente

inizio-storia
sposta il segno sulla prima riga

fine della storia
sposta il segno sull'ultima riga

inizio-buffer-o-storia, inizio riga
storico-inizio-riga, vi-inizio-di-linea
sposta il segno sulla colonna più a sinistra

fine-buffer-o-storia, fine linea
fine-riga-hist, vi-fine linea
sposta il segno nella colonna più a destra

parola-completa, menu-completo, espandi o completa
prefisso espandi o completa, menu-espandi-o-completa
sposta il segno alla corrispondenza successiva

menu inverso-completo
sposta il contrassegno alla corrispondenza precedente

vi-inserire
questo alterna tra la modalità normale e quella interattiva; in modalità interattiva i tasti
legato a auto-inserimento e auto-inserimento-unmeta inserire nella riga di comando come in
modalità di modifica normale ma senza abbandonare la selezione del menu; dopo ogni carattere
si tenta nuovamente il completamento e l'elenco cambia per contenere solo le nuove corrispondenze; IL
i widget di completamento fanno sì che nel comando venga inserita la stringa non ambigua più lunga
linea e disfare e back-delete-char tornare alla serie di partite precedente

cronologia-incrementale-ricerca-avanti
cronologia-ricerca-incrementale-indietro
avvia ricerche incrementali nella lista dei completamenti visualizzati; in questo
modalità, accettare-line lascia solo la ricerca incrementale, tornando al menu normale
modalità di selezione

Tutte le funzioni di movimento si avvolgono ai bordi; qualsiasi altra funzione zle non elencata viene abbandonata
selezione del menu ed esegue tale funzione. È possibile creare widget in quanto sopra
list fai lo stesso utilizzando il modulo del widget con un `.' davanti. Ad esempio, il
widget `.accetta-linea' ha l'effetto di abbandonare la selezione del menu e accettarne l'intero
riga di comando.

Durante questa selezione il widget utilizza la mappa dei tasti menuseleziona. Qualsiasi chiave non definita
in questa mappa dei tasti o a cui è associato chiave indefinita viene cercato attualmente nella mappa dei tasti
selezionato. Questo viene utilizzato per garantire che i tasti più importanti utilizzati durante la selezione
(vale a dire i tasti cursore, Invio e TAB) hanno impostazioni predefinite sensate. Tuttavia, le chiavi in
menuseleziona la mappa dei tasti può essere modificata direttamente utilizzando il file tasto legato comando integrato (vedi
zshmodules(1)). Ad esempio, per fare in modo che il tasto Invio esca dalla selezione del menu senza accettare
si potrebbe chiamare la partita attualmente selezionata

tasto legato -M menuseleziona '^M' invio-break

dopo aver caricato il zsh/complist modulo.

IL ZSH/COMPUTIL MODULO

. zsh/computil Il modulo aggiunge diversi comandi integrati utilizzati da alcuni dei
funzioni di completamento nel sistema di completamento basato su funzioni di shell (vedi zshcomsys(1)
). Eccetto per compquote questi comandi integrati sono molto specializzati e quindi non molto
interessante quando scrivi le tue funzioni di completamento. In sintesi, questi builtin
i comandi sono:

comparmenti
Questo è usato dal _argomenti funzione per eseguire l'argomento e la riga di comando
analisi. Come compdescrivere ha un'opzione -i per eseguire l'analisi e l'inizializzazione
alcuni stati interni e varie opzioni per accedere alle informazioni sullo stato per decidere
cosa dovrebbe essere completato.

compdescrivere
Questo è usato dal _descrivere funzione per costruire i display per le partite e per
ottieni le stringhe da aggiungere come corrispondenze con le loro opzioni. Alla prima chiamata uno dei
Opzioni -i or -I dovrebbe essere fornito come primo argomento. Nel primo caso,
verranno generate stringhe di visualizzazione prive delle descrizioni, nel secondo caso verrà generato il file
la stringa utilizzata per separare le corrispondenze dalle relative descrizioni deve essere fornita come file
verrà mostrato il secondo argomento e le descrizioni (se presenti). Tutti gli altri argomenti
sono come gli argomenti della definizione _descrivere stessa.

Quando compdescrivere è stato chiamato con il -i oppure -I opzione, può essere
chiamato ripetutamente con il -g opzione e i nomi di quattro parametri come suo
argomenti. Questo passerà attraverso i diversi set di corrispondenze e memorizzerà il file
valore di compstato[lista] nel primo scalare, le opzioni per compad nel secondo
array, le corrispondenze nel terzo array e le stringhe da visualizzare nel file
elenco di completamento nel quarto array. Gli array possono quindi essere forniti direttamente a
compad per registrare le partite con il codice di completamento.

compfiles
Utilizzato dal _percorso_file funzione per ottimizzare la generazione di nomi di file ricorsivi complessi
(globbing). Fa tre cose. Con il -p e -P opzioni costruisce il glob
modelli da utilizzare, compresi i percorsi già gestiti e cercando di ottimizzare il
modelli rispetto al prefisso e al suffisso dalla linea e dalla corrispondenza
specifica attualmente utilizzata. IL -i L'opzione esegue i test della directory per il file
ignora-genitori lo stile e il -r l'opzione verifica se un componente per alcune corrispondenze
sono uguali alla stringa sulla riga e rimuove tutte le altre corrispondenze se ciò è vero.

gruppi di comp
Utilizzato dal _tag funzione per implementare gli interni del ordine di gruppo stile.
Questo accetta solo i suoi argomenti come nomi di gruppi di completamento e crea i gruppi
per esso (tutti e sei i tipi: ordinati e non ordinati, entrambi senza rimuovere i duplicati, con
rimuovendo tutti i duplicati e rimuovendo i duplicati consecutivi).

compquote [ -p ] nomi ...
Potrebbero esserci motivi per scrivere funzioni di completamento che devono aggiungere le corrispondenze
usando il -Q opzione a compad ed eseguire citando se stessi. Invece di
interpretando il primo carattere del tutte_citazioni chiave del composto la nostra speciale
associazione e utilizzando il file q flag per le espansioni dei parametri, è possibile utilizzare questo built-in
comando. Gli argomenti sono i nomi dei parametri scalari o di array e i valori
di questi parametri sono quotati secondo necessità per il livello di quotazione più interno. Se la
-p viene fornita l'opzione, le virgolette vengono eseguite come se ci fosse un prefisso prima dei valori di
i parametri, in modo che il segno uguale iniziale non venga racchiuso tra virgolette.

Lo stato di ritorno è diverso da zero in caso di errore e zero altrimenti.

comptag
compt
Questi implementano gli interni del meccanismo dei tag.

compvalues
Come comparmenti, ma per _valori funzione.

IL ZSH/MALEDIZIONI MODULO

. zsh/maledizioni il modulo rende disponibile un comando integrato e vari parametri.

incorporato
zcurses init
zcurses fine
zcurses addwin targetwin linee coli inizio_a inizio_x [ parentwin ]
zcurses delwin targetwin
zcurses rinfrescare [ targetwin ...]
zcurses toccare targetwin ...
zcurses cambiano targetwin nuovo_y nuovo_x
zcurses pulire campo targetwin [ ridisegnare | eol | museruola ]
zcurses posizione targetwin schieramento
zcurses serbatoio targetwin carattere
zcurses stringa targetwin stringa
zcurses sistema targetwin sistema
zcurses attra targetwin [ [+|-]attributo | fg_col/bg_col ] […]
zcurses bg targetwin [ [+|-]attributo | fg_col/bg_col | @serbatoio ] […]
zcurses scorrere targetwin [ on | MENO | [+|-]Linee ]
zcurses ingresso targetwin [ param [ kparam [ mparam ] ] ]
zcurses mouse [ ritardo num | [+|-]movimento ]
zcurses timeout targetwin intervallo
zcurses querychar targetwin [ param ]
Manipolare le finestre delle maledizioni. Tutti gli usi di questo comando dovrebbero essere racchiusi tra parentesi
`zcurses init' per inizializzare l'uso di curses e `zcurses fine' per finirlo; omettendo
`zcurses fine' può causare uno stato indesiderato del terminale.

Il sottocomando addwin crea una finestra con linee linee e coli colonne. Suo
l'angolo superiore sinistro verrà posizionato alla riga inizio_a e colonna inizio_x dello schermo.
targetwin è una stringa e fa riferimento al nome di una finestra che attualmente non lo è
assegnato. Notare in particolare la convenzione curses secondo cui appaiono i valori verticali
prima dei valori orizzontali.

If addwin viene data una finestra esistente come argomento finale, la nuova finestra sarà
creata come sottofinestra di parentwin. Questo è diverso da una normale nuova finestra in
che la memoria del contenuto della finestra sia condivisa con la memoria del genitore.
Le sottofinestre devono essere cancellate prima della loro finestra principale. Da notare che le coordinate di
le sottofinestre sono relative allo schermo, non al genitore, come con le altre finestre.

Utilizzare il sottocomando delwin per eliminare una finestra creata con addwin. Nota che fine
effettua non è un elimina implicitamente Windows e quello delwin non cancella l'immagine sullo schermo
della finestra.

Viene richiamata la finestra corrispondente all'intero schermo visibile stdscr; lo è sempre
esiste dopo `zcurses init' e non può essere eliminato con delwin.

Il sottocomando rinfrescare aggiornerà la finestra targetwin; questo è necessario per realizzarne uno qualsiasi
modifiche in sospeso (come i caratteri che hai preparato per l'output con serbatoio) visibile
sullo schermo. rinfrescare senza argomenti, lo schermo viene cancellato e
ridisegnato. Se vengono fornite più finestre, lo schermo viene aggiornato una volta alla fine.

Il sottocomando toccare segna il targetwinè elencato come modificato. Questo è necessario
prima rinfrescareing windows se una finestra che si trovava di fronte a un'altra finestra ( Which
può essere stdscr) viene cancellato.

Il sottocomando cambiano sposta la posizione del cursore verso l'interno targetwin a nuove coordinate nuovo_y
e nuovo_x. Si noti che il sottocomando stringa (ma non il sottocomando serbatoio) avanza
la posizione del cursore sui caratteri aggiunti.

Il sottocomando pulire campo cancella il contenuto di targetwin. Uno (e non più di uno)
È possibile specificare tre opzioni. Con l'opzione ridisegnare, inoltre il successivo
rinfrescare of targetwin farà sì che lo schermo venga cancellato e ridipinto. Con il
opzione eol, targetwin viene cancellato solo fino alla fine della riga corrente del cursore. Con
l'opzione museruola, targetwin viene cancellato fino alla fine della finestra, cioè tutto fino a
la parte destra e inferiore del cursore viene cancellata.

Il sottocomando posizione scrive varie posizioni associate a targetwin nella
matrice denominata schieramento. Questi sono, in ordine:
- Le coordinate yex del cursore relative alla parte superiore sinistra di targetwin
- Le coordinate yex in alto a sinistra targetwin sullo schermo
- La dimensione di targetwin nelle dimensioni y e x.

L'output di caratteri e stringhe è ottenuto da serbatoio e stringa rispettivamente.

Per disegnare un bordo attorno alla finestra targetwin, Utilizzare sistema. Si noti che il confine non lo è
successivamente gestito in modo speciale: in altre parole, il confine è semplicemente un insieme di
caratteri emessi sul bordo della finestra. Quindi può essere sovrascritto, can
scorrere fuori dalla finestra, ecc.

Il sottocomando attra sarà impostato targetwino il colore di primo piano/sfondo
coppia per qualsiasi output di carattere successivo. Ogni attributo dato sulla linea potrebbe essere
preceduto da a + impostare o a - per disattivare quell'attributo; + si presume se assente.
Gli attributi supportati sono lampeggiare, , dim, invertire, standoute sottolineare.

Ogni fg_col/bg_col attributo (da leggere come `fg_col on bg_col') imposta il primo piano
e il colore di sfondo per l'output dei caratteri. Il colore difetto è a volte
disponibile (in particolare se la libreria è ncurses), specificando il primo piano o
colore di sfondo con cui è stato avviato il terminale. La coppia di colori predefinito/predefinito
è sempre disponibile.

bg sovrascrive il colore e gli altri attributi di tutti i caratteri nella finestra. Suo
l'uso normale è impostare inizialmente lo sfondo, ma sovrascriverà gli attributi
di qualsiasi carattere nel momento in cui viene chiamato. Oltre agli argomenti
permesso con attra, un argomento @serbatoio specifica un carattere da mostrare altrimenti
aree vuote della finestra. A causa delle limitazioni delle maledizioni questo non può essere a
carattere multibyte (si consiglia l'uso solo di caratteri ASCII). Come il
l'insieme di attributi specificato sovrascrive lo sfondo esistente, trasformando gli attributi
off negli argomenti non è utile, sebbene ciò non causi un errore.

Il sottocomando scorrere può essere utilizzato con on or MENO per abilitare o disabilitare lo scorrimento di
una finestra quando altrimenti il ​​cursore si sposterebbe sotto la finestra a causa della digitazione o
produzione. Può anche essere utilizzato con un numero intero positivo o negativo per scorrere il file
finestra verso l'alto o verso il basso per un determinato numero di righe senza modificare il cursore corrente
posizione (che quindi sembra muoversi in direzione opposta rispetto alla
finestra). Nel secondo caso, se lo scorrimento è MENO è temporaneamente girato on a
consentire lo scorrimento della finestra.

Il sottocomando ingresso legge un singolo carattere dalla finestra senza visualizzarne l'eco
indietro. Se param viene fornito il carattere assegnato al parametro param, altro
è assegnato al parametro REPLY.

Se entrambi param e kparam vengono forniti, la chiave viene letta in modalità "tastiera". In questo
i tasti speciali della modalità come i tasti funzione e i tasti freccia restituiscono il nome del tasto
nel parametro kparam. I nomi delle chiavi sono le macro definite nel file maledizioni.h or
ncurses.h con il prefisso `CHIAVE_' RIMOSSO; vedere anche la descrizione del parametro
zcurses_keycodes sotto. Altri tasti determinano l'impostazione di un valore param come prima. SU
un ritorno di successo solo uno di param or kparam contiene una stringa non vuota; IL
other è impostato su una stringa vuota.

If mparam viene fornito anche ingresso tenta di gestire l'input del mouse. Questo è solo
disponibile con la libreria ncurses; la gestione del mouse può essere rilevata controllando
lo stato di uscita di `zcurses mouse' senza argomenti. Se si fa clic su un pulsante del mouse
(o doppio o triplo clic oppure premuto o rilasciato con un ritardo configurabile
dall'essere cliccato) quindi kparam è impostato sulla stringa MOUSEe mparam è impostato su un
array composto dai seguenti elementi:
- Un identificatore per discriminare diversi dispositivi di input; questo accade solo raramente
utile.
- Le coordinate x, y e z del clic del mouse relative allo schermo intero,
come tre elementi in quest'ordine (cioè la coordinata y è, insolitamente, dopo
la coordinata x). La coordinata z è disponibile solo per pochi insoliti
dispositivi di input ed è altrimenti impostato su zero.
- Eventuali eventi accaduti come voci separate; di solito ce ne sarà solo uno.
Un evento è composto da PREMUTO, RILASCIATO, CLICCATO, DOPPIO_CLIC or
TRIPLO_CLIC seguito immediatamente (nello stesso elemento) dal numero di
il tasto.
- Se è stato premuto il tasto Maiusc, la stringa SPOSTAMENTO.
- Se è stato premuto il tasto di controllo, la stringa CTRL.
- Se è stato premuto il tasto alt, la stringa ALT.

Non tutti gli eventi del mouse possono essere passati alla finestra del terminale; la maggior parte dei terminali
gli emulatori gestiscono autonomamente alcuni eventi del mouse. Tieni presente che il manuale di ncurses
implica che l'utilizzo dell'input sia con che senza la gestione del mouse può causare l'utilizzo del mouse
cursore per apparire e scomparire.

Il sottocomando mouse può essere utilizzato per configurare l'uso del mouse. Non c'è
argomento della finestra; le opzioni del mouse sono globali. `zcurses mouse' senza argomenti
restituisce lo stato 0 se è possibile la gestione del mouse, altrimenti lo stato 1. Altrimenti, il
i possibili argomenti (che possono essere combinati sulla stessa riga di comando) sono i seguenti.
ritardo num imposta il ritardo massimo in millisecondi tra gli eventi di stampa e rilascio
da considerare come un clic; il valore 0 disabilita la risoluzione dei clic e l'impostazione predefinita
è un sesto di secondo. movimento preceduto da un `+' (predefinito) o -
attiva o disattiva la segnalazione del movimento del mouse oltre ai clic, alle pressioni e
rilasci, che vengono sempre segnalati. Tuttavia, sembra che vengano segnalati i movimenti del mouse
non sono attualmente implementati.

Il sottocomando timeout specifica un valore di timeout per l'input da targetwin. Se
intervallo è negativo, `zcurses ingresso' attende indefinitamente la digitazione di un carattere;
questa è l'impostazione predefinita. Se intervallo è zero, `zcurses ingresso' restituisce immediatamente; Se
viene restituito il testo in anticipo, altrimenti non viene eseguito alcun input e viene restituito lo stato 1.
If intervallo è positivo, `zcurses ingressoaspetta intervallo millisecondi per input e if
non ce n'è nessuno alla fine di quel periodo restituisce lo stato 1.

Il sottocomando querychar interroga il carattere nella posizione corrente del cursore. IL
i valori restituiti sono memorizzati nell'array denominato param se fornito, altrimenti nell'array
rispondere. Il primo valore è il carattere (che può essere un carattere multibyte se il file
il sistema li supporta); il secondo è la solita coppia di colori fg_col/bg_col
notazione, o 0 se il colore non è supportato. Qualsiasi attributo diverso dal colore
si applicano al carattere, come impostato con il sottocomando attra, appaiono come aggiuntivi
elementi.

Scheda Sintetica
ZCURSES_COLORS
Intero di sola lettura. Il numero massimo di colori supportati dal terminale. Questo valore
viene inizializzato dalla libreria curses e non è disponibile fino alla prima volta
zcurses init è eseguito.

ZCURSES_COLOR_PAIRS
Intero di sola lettura. Il numero massimo di coppie di colori fg_col/bg_col potrebbe essere
definito in `zcurses attra'comandi; nota che questo limite si applica a tutte le coppie di colori che
sono stati utilizzati indipendentemente dal fatto che siano attualmente attivi o meno. Questo valore è inizializzato
dalla libreria curses e non è disponibile fino alla prima volta zcurses init is
eseguire.

zcurses_attrs
Array di sola lettura. Gli attributi supportati da zsh/maledizioni; disponibile non appena il
il modulo è caricato.

zcurses_colors
Array di sola lettura. I colori supportati da zsh/maledizioni; disponibile non appena il
il modulo è caricato.

zcurses_keycodes
Array di sola lettura. I valori che possono essere restituiti nel secondo parametro fornito
a `zcurses ingresso' nell'ordine in cui sono definiti internamente da curses.
Non sono elencati solo tutti i tasti funzione F0; maledizioni riserva spazio per F0 fino all F63.

zcurses_windows
Array di sola lettura. L'elenco corrente delle finestre, ovvero tutte le finestre che sono state
creato con `zcurses addwin' e non rimosso con `zcurses delwin'.

IL ZSH/DATAORA MODULO

. zsh/dataora il modulo rende disponibile un comando integrato:

strftime [ -s scalare ] formato epoca
strftime -r [ -q ] [ -s scalare ] formato sequenza temporale
Emette la data indicata da epoca nella formato specificato. Vedere strftime(3) per
dettagli. Le estensioni zsh descritte nella sezione ESPANSIONE DELLE SEQUENZE DI PROMPT
in zshmisc(1) sono disponibili anche.

-q Corri tranquillamente; sopprimere la stampa di tutti i messaggi di errore descritti di seguito.
Errori per non valido epoca i valori vengono sempre stampati.

-r Con l'opzione -r (inverso), usare formato per analizzare la stringa di input
sequenza temporale e restituisce il numero di secondi trascorsi dall'epoca in cui il
si è verificato il tempo. L'analisi è implementata dalla funzione di sistema strptime;
vedere strptime(3). Ciò significa che le estensioni del formato zsh non sono disponibili,
ma per la ricerca inversa non sono necessari.

Nella maggior parte delle implementazioni di strftime qualsiasi fuso orario nel sequenza temporale is
ignorato e il fuso orario locale dichiarato da TZ la variabile d'ambiente è
usato; gli altri parametri vengono impostati a zero se non presenti.

If sequenza temporale non corrisponde formato il comando restituisce lo stato 1 e stampa
un messaggio di errore. Se sequenza temporale fiammiferi formato ma non tutti i personaggi in
sequenza temporale sono stati utilizzati, la conversione riesce ma viene visualizzato anche un errore
messaggio.

Se uno dei sistemi funziona strptime or mktime Non è disponibile,
viene restituito lo stato 2 e viene stampato un messaggio di errore.

-s scalare
Assegnare la stringa della data (o l'ora dell'epoca in secondi se -r è dato) a scalare
invece di stamparlo.

Si noti che, a seconda del tipo di tempo integrale dichiarato dal sistema, strftime può
producono risultati errati per epoche superiori a 2147483647 che corrisponde
to 2038-01-19 03:14:07 +0000.

. zsh/dataora il modulo mette a disposizione diversi parametri; sono tutti di sola lettura:

TEMPO EPOCRALE
Un valore in virgola mobile che rappresenta il numero di secondi trascorsi dall'epoca. IL
la precisione teorica è di nanosecondi se il orologio_gettime la chiamata è disponibile e a
microsecondi altrimenti, ma in pratica l'intervallo del flottante a doppia precisione
le latenze di pianificazione di punti e shell possono essere effetti significativi.

EPOCHISECONDI
Un valore intero che rappresenta il numero di secondi trascorsi dall'epoca.

epoca
Un valore di matrice contenente il numero di secondi trascorsi dall'epoca nel primo
elemento e il tempo rimanente dall'epoca in nanosecondi nel secondo
elemento. Per garantire che i due elementi siano coerenti, l'array deve essere copiato o
altrimenti indicato come singola sostituzione prima che i valori vengano utilizzati. IL
si può usare il seguente idioma:

da secs nsec in $epoca; do
...
fatto

IL ZSH/DB/GDBM MODULO

. zsh/db/gdbm Il modulo viene utilizzato per creare array associativi "legati" che si interfacciano a
file di database. Se l'interfaccia GDBM non è disponibile, i built-in definiti da questo
il modulo segnalerà un errore. Questo modulo è inteso anche come prototipo per la creazione
interfacce di database aggiuntive, quindi il ztie builtin potrebbe spostarsi in un modulo più generico in
Il futuro.

Gli elementi incorporati in questo modulo sono:

ztie -d db/gdbm -f Nome del file [ -r ] nomearray
Aprire il database GDBM identificato da Nome del file e, in caso di successo, creare il file
matrice associativa nomearray collegato al file. Per creare un array legato locale, il file
Il parametro deve essere prima dichiarato, quindi sarebbero comandi simili al seguente
eseguito all'interno di un ambito di funzione:

locale -A campionatob
ztie -d db/gdbm -f campione.gdbm campionatob

. -r l'opzione apre il file del database in sola lettura, creando un parametro con
l'attributo di sola lettura. Senza questa opzione, utilizzando `ztie' su un file per il quale il file
l'utente non dispone dell'autorizzazione di scrittura è un errore. Se scrivibile, il database lo è
aperto in modo sincrono in modo che i campi siano cambiati nomearray vengono immediatamente scritti
Nome del file.

Modifiche alle modalità file Nome del file dopo l'apertura non alterarne lo stato
of nomearray, ma `comporre -r nomearrayfunziona come previsto.

zuntie [ -u ] nomearray ...
Chiudere il database GDBM associato a ciascuno nomearray e quindi disimpostare il
parametro. Il -u L'opzione forza l'annullamento dell'insieme dei parametri resi di sola lettura con `ztie
-r'.

Ciò avviene automaticamente se il parametro o il suo ambito locale sono esplicitamente non impostati
(funzione) termina. Tieni presente che un parametro di sola lettura potrebbe non essere esplicitamente disattivato, quindi
l'unico modo per annullare l'impostazione di un parametro globale creato con `ztie -r' significa usare `zuntie
-u'.

I campi di un array associativo legato a GDBM non vengono né memorizzati nella cache né archiviati in altro modo
memoria, vengono letti o scritti nel database su ciascun riferimento. Quindi, per
ad esempio, i valori in un array di sola lettura possono essere modificati da un secondo scrittore dello stesso
file di database.

IL ZSH/DELTOCAR MODULO

. zsh/deltochar Il modulo mette a disposizione due funzioni ZLE:

elimina-carattere
Legge un carattere dalla tastiera ed elimina dalla posizione del cursore fino a e
compreso il successivo (o, con conteggio delle ripetizioni n, l' nth) istanza di quel personaggio.
I conteggi di ripetizioni negativi indicano l'eliminazione all'indietro.

zap-to-char
Questo si comporta come elimina-carattere, tranne che per l'occorrenza finale del carattere
stesso non viene eliminato.

IL ZSH/ESEMPIO MODULO

. zsh/esempio il modulo rende disponibile un comando integrato:

esempio [ -bandiere ] [ args ...]
Visualizza i flag e gli argomenti con cui viene invocato.

Lo scopo del modulo è quello di servire da esempio su come scrivere un modulo.

IL ZSH/FILE MODULO

. zsh/file Il modulo rende disponibili alcuni comandi comuni per la manipolazione dei file come
incorporati; questi comandi probabilmente non sono necessari per molte situazioni normali, ma possono esserlo
utile in situazioni di recupero di emergenza con risorse limitate. I comandi no
implementare tutte le funzionalità ora richieste dai comitati di standardizzazione pertinenti.

Per tutti i comandi, una variante che inizia zf_ è anche disponibile e caricato automaticamente.
L'utilizzo delle funzionalità di zmodload ti consentirà di caricare solo i nomi che desideri.
Tieni presente che è possibile caricare solo i built-in con nomi specifici di zsh utilizzando il file
seguente comando:

zmodload -m -F zsh/file b:zf_\*

I comandi caricati di default sono:

chgrp [ -ore ] gruppo Nome del file ...
Cambia il gruppo di file specificato. Ciò equivale a chown con una specifiche dell'utente
argomento di `:gruppo'.

chown [ -ore ] specifiche dell'utente Nome del file ...
Modifica la proprietà e il gruppo di file specificati.

. specifiche dell'utente può assumere quattro forme:

Utente cambia proprietario in Utente; non cambiare gruppo
Utente:: cambia proprietario in Utente; non cambiare gruppo
Utente: cambia proprietario in Utente; cambia gruppo in Utenteè il gruppo principale
Utente:gruppo
cambia proprietario in Utente; cambia gruppo in gruppo
:gruppo non cambiare proprietario; cambia gruppo in gruppo

In ogni caso, il `:' potrebbe invece essere un `.'. La regola è che se c'è un `:'
quindi il separatore è `:', altrimenti se è presente un `.' allora il separatore è `.',
altrimenti non c'è alcun separatore.

Ciascuno di Utente e gruppo può essere un nome utente (o un nome di gruppo, a seconda dei casi) o
un ID utente decimale (ID gruppo). L'interpretazione come nome ha la precedenza, se presente
è un nome utente (o nome di gruppo) tutto numerico.

Se la destinazione è un collegamento simbolico, il file -h cause di opzione chown per impostare la proprietà
del collegamento anziché del suo obiettivo.

. -R cause di opzione chown per scendere ricorsivamente nelle directory, modificando il file
proprietà di tutti i file nella directory dopo aver modificato la proprietà del file
directory stessa.

. -s l'opzione è un'estensione zsh di chown funzionalità. Abilita il paranoico
comportamento, volto ad evitare problemi di sicurezza che coinvolgano a chown essere ingannato
interessare file diversi da quelli previsti. Si rifiuterà di seguire il simbolico
collegamenti, in modo che (ad esempio) ``chown luser /tmp/foo/passwd'' non può accidentalmente
chown /etc/passwd if /tmp/pippo sembra essere un collegamento a / Etc. Verificherà anche
dove si trova dopo aver lasciato le directory, in modo che venga visualizzato un chown ricorsivo profondo
l'albero delle directory non può finire per chownare ricorsivamente / usr come risultato delle directory
essere spostato sull'albero.

ln [ -dfhins ] Nome del file meno
ln [ -dfhins ] Nome del file ... dir
Crea duro (o, con -s, simbolici). Nella prima forma, il specificato
menoviene creata l'informazione, come collegamento all'oggetto specificato Nome del file. Nella seconda forma,
ognuno di Nome del files viene preso a sua volta e collegato a un percorso specificato
directory che ha lo stesso ultimo componente del percorso.

Normalmente, ln non tenterà di creare collegamenti fisici alle directory. Questo controllo può
essere sovrascritto utilizzando il file -d opzione. In genere solo il superutente può effettivamente farlo
riuscire a creare collegamenti reali alle directory. Questo non si applica al simbolico
link in ogni caso.

Per impostazione predefinita, i file esistenti non possono essere sostituiti dai collegamenti. IL -i l'opzione causa il
interrogare l'utente sulla sostituzione dei file esistenti. IL -f l'opzione causa l'esistenza
file da eliminare silenziosamente, senza interrogazioni. -f ha la precedenza.

. -h e -n le opzioni sono identiche ed esistono entrambe per compatibilità; uno a scelta
indica che se la destinazione è un collegamento simbolico, non dovrebbe essere dereferenziato.
In genere questo viene utilizzato in combinazione con -sf in modo che se un collegamento esistente punti
in una directory, verrà rimossa anziché seguita. Se questa opzione lo è
utilizzato con più nomi di file e la destinazione è un collegamento simbolico che punta a a
directory, il risultato è un errore.

mkdir [ -p ] [ -m modo ] dir ...
Crea directory. Con il -p opzione, le directory principali non esistenti vengono prima
creato se necessario e non ci saranno reclami se la directory è già
esiste. Il -m l'opzione può essere utilizzata per specificare (in ottale) un insieme di permessi sui file
per le directory create, altrimenti modalità 777 modificata dalla corrente umask (Vedi
umask(2)) viene utilizzato.

mv [ -fi ] Nome del file meno
mv [ -fi ] Nome del file ... dir
Sposta i file. Nella prima forma, il specificato Nome del file viene spostato nel campo specificato
menoinazione. Nella seconda forma, ciascuno dei Nome del files viene preso a sua volta e spostato
a un percorso nel file specificato directory che ha lo stesso ultimo componente del percorso.

Per impostazione predefinita, l'utente verrà interrogato prima di sostituire qualsiasi file che l'utente non può
scrivere, ma i file scrivibili verranno rimossi silenziosamente. IL -i l'opzione causa il
interrogare l'utente sulla sostituzione di eventuali file esistenti. IL -f l'opzione causa qualsiasi
file esistenti da eliminare silenziosamente, senza interrogazioni. -f ha la precedenza.

Si noti che questo mv non sposterà i file tra i dispositivi. Versioni storiche di mv,
quando la ridenominazione effettiva è impossibile, ricorrere alla copia e alla rimozione dei file; Se
questo comportamento è desiderato, utilizzare cp e rm manualmente. Questo potrebbe cambiare in futuro
versione.

rm [ -dfirs ] Nome del file ...
Rimuove i file e le directory specificate.

Normalmente, rm non rimuoverà le directory (eccetto con il file -r opzione). Il -d
cause di opzione rm per provare a rimuovere le directory con scollegare (Vedi scollegare(2)), lo stesso
metodo utilizzato per i file. In genere solo il superutente può effettivamente riuscirci
scollegando le directory in questo modo. -d ha la precedenza su -r.

Per impostazione predefinita, l'utente verrà interrogato prima di rimuovere qualsiasi file che l'utente non può rimuovere
scrivere, ma i file scrivibili verranno rimossi silenziosamente. IL -i l'opzione causa il
interrogare l'utente sulla rimozione di eventuali file. IL -f l'opzione fa sì che i file siano
cancellato silenziosamente, senza interrogazioni, e sopprime tutte le indicazioni di errore. -f prende
precedenza.

. -r cause di opzione rm per scendere ricorsivamente nelle directory, cancellando tutti i file
nella directory prima di rimuovere la directory con il file rmdir chiamata di sistema (vedi
rmdir(2)).

. -s l'opzione è un'estensione zsh di rm funzionalità. Abilita il paranoico
comportamento, inteso a evitare problemi di sicurezza comuni che coinvolgono un'esecuzione root rm essendo
indotto a rimuovere file diversi da quelli previsti. Si rifiuterà di seguirlo
collegamenti simbolici, in modo che (ad esempio) ``rm /tmp/foo/passwd'' non può accidentalmente
rimuovere /etc/passwd if /tmp/pippo sembra essere un collegamento a / Etc. Verificherà anche
dove si trova dopo aver lasciato le directory, in modo che venga eseguita una rimozione ricorsiva di un file deep
l'albero delle directory non può finire per essere rimosso in modo ricorsivo / usr come risultato delle directory
essere spostato sull'albero.

rmdir dir ...
Rimuove le directory vuote specificate.

sync Richiama la chiamata di sistema con lo stesso nome (vedi sync(2)), che scarica i buffer sporchi
su disco. Potrebbe ritornare prima che l'I/O sia stato effettivamente completato.

IL ZSH/LANGINFO MODULO

. zsh/langinfo il modulo mette a disposizione un parametro:

langinfo
Un array associativo che mappa gli elementi langinfo sui loro valori.

L'implementazione può supportare alcune delle seguenti chiavi:

CODICE, D_T_FMT, D_FMT, T_FMT, RADIXCHAR, THOUSEP, SIESPR, NOESPR, CRNCYSTR,
ABDAY_{1..7}, GIORNO_{1..7}, ABMON_{1..12}, LUN_{1..12}, T_FMT_AMPM, AM_STR, PM_STR,
ERA, ERA_D_FMT, ERA_D_T_FMT, ERA_T_FMT, ALT_DIGITS

IL ZSH/FILEMAP MODULO

. zsh/mapfile Il modulo fornisce uno speciale parametro di array associativo con lo stesso nome.

mapfile
Questo array associativo prende come chiavi i nomi dei file; il valore risultante è il
contenuto del file. Il valore viene trattato in modo identico a qualsiasi altro testo in arrivo
da un parametro. Il valore può anche essere assegnato a, nel qual caso il file in
viene scritta la domanda (se esistesse o meno originariamente); o un elemento può esserlo
unset, che eliminerà il file in questione. Ad esempio, `variato
mapfile[miofile]' funziona come previsto, modificando il file `il mio file'.

Quando si accede all'array nel suo insieme, le chiavi sono i nomi dei file nel file
directory corrente e i valori sono vuoti (per risparmiare un enorme sovraccarico di memoria).
così ${(k)filemappa} ha lo stesso effetto dell'operatore glob *(D), poiché i file
che iniziano con un punto non sono speciali. Bisogna fare attenzione con espressioni come
rm ${(k)filemappa}, che eliminerà tutti i file nella directory corrente senza l'estensione
solito'rm *' test.

Il parametro mapfile può essere reso di sola lettura; in tal caso, i file a cui si fa riferimento potrebbero non esserlo
essere scritti o cancellati.

Un file può essere convenientemente letto in un array come una riga per elemento con il modulo
`schieramento=("${(f@)filemappa[Nome del file]}")'. Le virgolette doppie e il `@sono necessari
per evitare che le righe vuote vengano rimosse. Tieni presente che se il file termina con a
newline, la shell si dividerà sul newline finale, generando un ulteriore vuoto
campo; questo può essere soppresso utilizzando
`schieramento=("${(f@)${filemappa[Nome del file]%$'\n'}}")'.

Limiti
Sebbene la lettura e la scrittura del file in questione siano gestite in modo efficiente, zsh's
la gestione della memoria interna può essere arbitrariamente barocca; Tuttavia, mapfile di solito è molto
molto più efficiente di qualsiasi cosa coinvolga un loop. Da notare in particolare che il tutto
il contenuto del file risiederà sempre fisicamente in memoria quando vi si accede (possibilmente
più volte, a causa delle operazioni di sostituzione dei parametri standard). In particolare, questo
significa gestire file sufficientemente lunghi (maggiori dello spazio di swap della macchina o di
l'intervallo del tipo di puntatore) sarà errato.

Nessun errore viene stampato o contrassegnato per file inesistenti, illeggibili o non scrivibili, poiché il file
Il meccanismo dei parametri è troppo basso nella gerarchia di esecuzione della shell per renderlo conveniente.

È un peccato che il meccanismo di caricamento dei moduli non lo consenta ancora all'utente
specificare il nome del parametro della shell a cui assegnare il comportamento speciale.

IL ZSH/MATHFUNC MODULO

. zsh/funzione matematica il modulo fornisce funzioni matematiche standard da utilizzare durante la valutazione
formule matematiche. La sintassi concorda con le normali convenzioni C e FORTRAN, for
esempio,

(( f = peccato(0.3) ))

assegna il seno di 0.3 al parametro f.

La maggior parte delle funzioni accetta argomenti in virgola mobile e restituisce un valore in virgola mobile. Tuttavia,
qualsiasi conversione necessaria da o verso il tipo intero verrà eseguita automaticamente da
conchiglia. A parte un'abbronzatura con un secondo argomento e il abs, int e galleggiante funzioni, tutto
le funzioni si comportano come indicato nella pagina di manuale per la corrispondente funzione C, tranne che
qualsiasi argomento fuori intervallo per la funzione in questione verrà rilevato dalla shell e
è stato segnalato un errore.

Le seguenti funzioni accettano un singolo argomento in virgola mobile: aco, acosh, asin, asin,
un'abbronzatura, atanah, cbrt, ceil, cos, cosh, erf, erf, exp, expm1, FAB, piano, gamma, j0, j1,
gamma, ceppo, log10, log1p, logb, peccato, sinh, sqrt, abbronzatura, di pesce, y0, y1. un'abbronzatura funzione
può opzionalmente accettare un secondo argomento, nel qual caso si comporta come la funzione C atan2.
. ilogb la funzione accetta un singolo argomento in virgola mobile, ma restituisce un numero intero.

La funzione segno non accetta argomenti e restituisce un numero intero, che è la variabile C
con lo stesso nome, come descritto in gamma(3). Tieni presente che è quindi solo utile
subito dopo una chiamata a gamma or gamma. Si noti inoltre che `segno()' e `segno' sono
espressioni distinte.

Le seguenti funzioni accettano due argomenti in virgola mobile: copia segno, fmod, ipot,
successivo.

Quanto segue accetta un primo argomento intero e un secondo argomento in virgola mobile: jn, yn.

Quanto segue accetta un primo argomento in virgola mobile e un secondo argomento intero: ldexp,
squama.

La funzione abs non converte il tipo del suo singolo argomento; restituisce l'assoluto
valore di un numero in virgola mobile o di un numero intero. Le funzioni galleggiante e int
convertire i loro argomenti in un valore in virgola mobile o intero (tramite troncamento)
rispettivamente.

Da notare che il C pow è disponibile nella valutazione matematica ordinaria come `**'operatore
e non è fornito qui.

La funzione rand48 è disponibile se la libreria matematica del tuo sistema ha la funzione
erand48(3). Restituisce un numero in virgola mobile pseudo-casuale compreso tra 0 e 1. Richiede a
argomento facoltativo a stringa singola.

Se l'argomento non è presente, il seme del numero casuale viene inizializzato da tre chiamate a
, il rand(3) funzione --- questo produce gli stessi numeri casuali dei successivi tre valori di
$ RANDOM.

Se l'argomento è presente, fornisce il nome di un parametro scalare dove corrente
verrà memorizzato il seme di un numero casuale. Alla prima chiamata, il valore deve contenere almeno
dodici cifre esadecimali (il resto della stringa viene ignorato), altrimenti lo sarà il seme
inizializzato nello stesso modo di una chiamata a rand48 senza argomenti. Chiamate successive
a rand48(param) manterrà quindi il seme nel parametro param come una serie di dodici
cifre esadecimali, senza significante di base. Le sequenze di numeri casuali per diversi
i parametri sono completamente indipendenti e sono anche indipendenti da quelli utilizzati dalle chiamate a
rand48 senza argomenti.

Ad esempio, considera

stampare $(( rand48(seme) ))
stampare $(( Rand48() ))
stampare $(( rand48(seme) ))

Assumendo $seme non esiste, verrà inizializzato alla prima chiamata. Nel secondo
call, il seed predefinito viene inizializzato; si noti, tuttavia, che a causa delle proprietà di
rand () esiste una correlazione tra i seed utilizzati per le due inizializzazioni, quindi for
usi più sicuri, dovresti generare il tuo seed da 12 byte. La terza chiamata ritorna a
la stessa sequenza di numeri casuali utilizzata nella prima chiamata, non influenzata dall'intervento
Rand48().

IL ZSH/NUOVOUTENTE MODULO

. zsh/nuovo utente il modulo viene caricato all'avvio se è disponibile, il file RCS l'opzione è impostata e
, il PRIVILEGIATO l'opzione non è impostata (tutti e tre sono veri per impostazione predefinita). Questo avviene
immediatamente dopo i comandi nel global zshenv file (tipicamente /etc/zshenv), se presente, averlo
stato giustiziato. Se il modulo non è disponibile viene silenziosamente ignorato dalla shell; IL
il modulo può essere rimosso in tutta sicurezza $MODULO_PATH dall'amministratore se non è richiesto.

Durante il caricamento, il modulo verifica se sono presenti file di avvio .zshenv, .zprofilo, .zshrc or
.zlogin esistere nella directory data dalla variabile d'ambiente ZDOTDIRo quello dell'utente
directory home se non è impostata. Il test non viene eseguito e il modulo si blocca
se la shell era in modalità di emulazione (cioè era stata invocata come qualche altra
shell che zsh).

Se non viene trovato nessuno dei file di avvio, il modulo cerca il file nuovo utente prima di tutto
in una directory dell'intero sito, solitamente la directory principale di funzioni del sito directory, e
se non viene trovato, il modulo cerca in una directory specifica della versione, solitamente la
genitore del funzioni directory contenente funzioni specifiche della versione. (Questi
le directory possono essere configurate quando zsh viene creato utilizzando il file --enable-site-scriptdir=dir e
--enable-scriptdir=dir bandiere per configure, rispettivamente; le impostazioni predefinite sono prefisso/condividi/zsh
e prefisso/share/zsh/$ZSH_VERSION dove il valore predefinito prefisso is / Usr / local.)

Se il file nuovo utente viene trovato, viene quindi generato allo stesso modo di un file di avvio.
Si prevede che il file contenga il codice per installare i file di avvio per l'utente, comunque qualsiasi
verrà eseguito il codice shell valido.

. zsh/nuovo utente il modulo viene quindi scaricato incondizionatamente.

Tieni presente che è possibile ottenere esattamente lo stesso effetto di zsh/nuovo utente modulo di
aggiungendo codice a /etc/zshenv. Il modulo esiste semplicemente per consentire alla shell di creare
accordi per i nuovi utenti senza la necessità di intervento da parte dei manutentori del pacchetto e
amministratori di sistema.

Lo script fornito con il modulo invoca la funzione shell zsh-newuser-install. Questo
può essere invocato direttamente dall'utente anche se il zsh/nuovo utente il modulo è disabilitato. Nota,
tuttavia, se il modulo non è installato, anche la funzione non verrà installata.
La funzione è documentata nella sezione Funzioni di configurazione utente in zshcontrib(1).

IL ZSH/PARAMETRO MODULO

. zsh/parametro il modulo dà accesso ad alcune delle tabelle hash interne utilizzate da
shell definendo alcuni parametri speciali.

Opzioni
Le chiavi di questo array associativo sono i nomi delle opzioni che possono essere impostate
e disimpostare utilizzando il impostare e unsett builtin. Il valore di ciascuna chiave è uno dei due
la stringa on se l'opzione è attualmente impostata o la stringa MENO se l'opzione è
non settato. Impostare una chiave su una di queste stringhe è come impostare o disinserire il file
opzione, rispettivamente. Disimpostare una chiave in questo array è come impostarla sul valore
MENO.

comandi
Questo array dà accesso alla tabella hash dei comandi. Le chiavi sono i nomi di
comandi esterni, i valori sono i percorsi dei file che verrebbero eseguiti
quando il comando verrebbe invocato. L'impostazione di una chiave in questo array definisce una nuova voce
in questa tabella allo stesso modo del hash incorporato. Disinserimento di una chiave come in
`non settato "comandi[foo]"' rimuove la voce relativa alla chiave specificata dall'hash del comando
tabella.

funzioni
Questo array associativo mappa i nomi delle funzioni abilitate alle loro definizioni.
Impostarvi una chiave è come definire una funzione con il nome dato dalla chiave e
il corpo dato dal valore. La disattivazione di una chiave rimuove la definizione del file
funzione denominata dal tasto.

dis_funzioni
Come funzioni ma per funzioni disabilitate.

incorporati
Questo array associativo fornisce informazioni sui comandi attualmente incorporati
abilitato. Le chiavi sono i nomi dei comandi integrati e i valori lo sono entrambi
`indefinito' per i comandi integrati che verranno caricati automaticamente da un modulo if
invocato o `definito' per i comandi integrati già caricati.

dis_builtins
Come incorporati ma per i comandi integrati disabilitati.

respade
Questo array contiene le parole riservate abilitate.

dis_reswords
Come respade ma per le parole riservate disabilitate.

patchar
Questo array contiene i caratteri del modello abilitati.

dis_patchars
Come patchar ma per i caratteri del pattern disabilitati.

alias
Questo mappa i nomi degli alias regolari attualmente abilitati alle loro espansioni.

dis_aliases
Come alias ma per gli alias regolari disabilitati.

Galiasi
Come alias, ma per gli alias globali.

dis_galiases
Come Galiasi ma per gli alias globali disabilitati.

saliasi
Come raliases, ma per gli alias dei suffissi.

dis_saliases
Come saliasi ma per gli alias del suffisso disabilitati.

parametri
Le chiavi in ​​questo array associativo sono i nomi dei parametri attualmente
definito. I valori sono stringhe che descrivono il tipo del parametro, nello stesso
formato utilizzato dal t flag parametro, vedere zshexpn(1) . Inserimento o disinserimento delle chiavi
questa matrice non è possibile.

moduli
Un array associativo che fornisce informazioni sui moduli. Le chiavi sono i nomi di
i moduli caricati, registrati per il caricamento automatico o con alias. Il valore dice quale
dichiara che si trova il modulo denominato ed è una delle stringhe `caricato', `caricato automaticamente', o
`alias:Nome', dove Nome è il nome a cui è assegnato l'alias del modulo.

Non è possibile inserire o disinserire le chiavi in ​​questo array.

pile di pile
Un normale array che contiene gli elementi dello stack di directory. Si noti che l'output di
, il dirs Il comando integrato include un'altra directory, quella attualmente funzionante
directory.

storia
Questo array associativo mappa i numeri degli eventi della cronologia sulle righe della cronologia completa.

parole di storia
Un array speciale contenente le parole memorizzate nella cronologia.

jobdirs
Questo array associativo associa i numeri di lavoro alle directory da cui proveniva il lavoro
avviato (che potrebbe non essere la directory corrente del lavoro).

Le chiavi degli array associativi sono solitamente numeri di lavoro validi, e questi sono i
valori emessi con, ad esempio, ${(k)indirizzi di lavoro}. Possono essere riferimenti lavorativi non numerici
utilizzato quando si cerca un valore; Per esempio, ${direttore di lavoro[%+]} si riferisce alla corrente
lavoro.

jobtexts
Questo array associativo associa i numeri di lavoro ai testi delle righe di comando che erano
utilizzato per avviare i lavori.

La gestione delle chiavi dell'array associativo è come descritto per jobdirs sopra.

stati di lavoro
Questo array associativo fornisce informazioni sullo stato attuale dei lavori
conosciuto. Le chiavi sono i numeri di lavoro e i valori sono stringhe del modulo
`stato-lavoro:marchio:pid=stato...'. IL stato-lavoro affida allo Stato l'intero compito
attualmente in, uno dei `running', `sospeso', o `fatto'. Il marchio è `+' per il
lavoro attuale, `-' per il lavoro precedente e vuoto altrimenti. Questo è seguito da uno
`:pid=stato' per ogni processo del lavoro. IL pids sono, ovviamente, gli ID del processo
e la stato descrive lo stato di quel processo.

La gestione delle chiavi dell'array associativo è come descritto per jobdirs sopra.

nomedirs
Questo array associativo associa i nomi delle directory denominate ai loro percorsi
stare per.

userdirs
Questo array associativo associa i nomi utente ai nomi dei percorsi delle loro directory home.

gruppi utenti
Questo array associativo mappa i nomi dei gruppi di sistema di cui fa parte l'utente corrente
membro agli identificatori di gruppo corrispondenti. Il contenuto è lo stesso del
gruppi prodotti da id comando.

funfiletrace
Questo array contiene i numeri di riga assoluti e i nomi di file corrispondenti per il file
punto in cui la funzione corrente, il file di origine o (se EVAL_LINENO è impostato) eval
è stato chiamato il comando. L'array ha la stessa lunghezza di funcsourcetrace e
funtrace, ma differisce da funcsourcetrace in quanto la riga e il file sono il punto
di chiamata, non il punto di definizione, e differisce da funtrace in questo tutti i valori
sono numeri di riga assoluti nei file, anziché relativi all'inizio di a
funzione, se presente.

funcsourcetrace
Questo array contiene i nomi dei file e i numeri di riga dei punti in cui si trova il file
funzioni, file di origine e (se EVAL_LINENO è impostato) eval comandi attualmente in corso
eseguiti sono stati definiti. Il numero di riga è la riga in cui `funzione Nome' o
`Nome ()' iniziato. Nel caso di una funzione caricata automaticamente, il numero di riga è
riportato come zero. Il formato di ciascun elemento è Nome del file:lino. Per le funzioni
caricato automaticamente da un file in formato zsh nativo, dove solo il corpo della funzione
si verifica nel file o per i file che sono stati eseguiti da source o `.'
builtins, le informazioni sulla traccia vengono mostrate come Nome del file:0, poiché l'intero file è
la definizione.

La maggior parte degli utenti sarà interessata alle informazioni contenute nel file funfiletrace schieramento
anziché.

funcstack
Questo array contiene i nomi delle funzioni, dei file di origine e (se EVAL_LINENO
è impostato) eval comandi. attualmente in esecuzione. Il primo elemento è il nome di
la funzione utilizzando il parametro.

L'array di shell standard zsh_eval_context può essere utilizzato per determinare il tipo di
costrutto di shell eseguito ad ogni profondità: nota, tuttavia, che è nel file
ordine inverso, con l'elemento più recente per ultimo, ed è più dettagliato, per
esempio che include una voce per toplevel, viene eseguito anche il codice della shell principale
in modo interattivo o da uno script, che non è presente in $stack funzioni.

funtrace
Questo array contiene i nomi e i numeri di linea dei chiamanti corrispondenti a
funzioni attualmente in esecuzione. Il formato di ciascun elemento è Nome:lino.
I chiamanti vengono visualizzati anche per i file di origine; il chiamante è il punto in cui il source
o `.' il comando è stato eseguito.

IL ZSH/PCRE MODULO

. zsh/pc Il modulo rende disponibili alcuni comandi come incorporati:

pcre_compile [ -aimxs ] PCRE
Compila un'espressione regolare compatibile con Perl.

Opzione -a forzerà l'ancoraggio del modello. Opzione -i compilerà un
modello senza distinzione tra maiuscole e minuscole. Opzione -m compilerà uno schema multilinea; questo è, ^
e $ corrisponderà ai ritorni a capo all'interno del modello. Opzione -x compilerà un file esteso
modello, in cui spazi bianchi e # i commenti vengono ignorati. Opzione -s fa il punto
metacarattere corrisponde a tutti i caratteri, compresi quelli che indicano una nuova riga.

pcre_studio
Studia il PCRE precedentemente compilato che può comportare una corrispondenza più rapida.

pcre_match [ -v var ] [ -a arr ] [ -n offset ] [ -b ] stringa
Restituisce con successo se stringa corrisponde al PCRE precedentemente compilato.

In caso di corrispondenza riuscita, se l'espressione cattura sottostringhe tra parentesi,
pcre_match imposterà l'array stile a quelle sottostringhe, a meno che il -a opzione è
dato, nel qual caso imposterà l'array arr. Allo stesso modo, la variabile PARTITA andrete a
essere impostato sull'intera porzione corrispondente della stringa, a meno che il file -v l'opzione è data,
in tal caso la variabile var sarà impostato. Se presente, nessuna variabile viene modificata
nessuna corrispondenza riuscita. UN -n l'opzione avvia la ricerca di una corrispondenza dal byte offset
posizione stringa. Se il -b viene data l'opzione, la variabile ZPCRE_OP sarà impostato
a una stringa di coppia di offset, che rappresenta le posizioni di offset dei byte dell'intero
porzione corrispondente all'interno del stringa. Ad esempio, a ZPCRE_OP impostato su "32 45"
indica che la porzione corrispondente è iniziata con l'offset di byte 32 e è terminata con l'offset di byte
44. Qui, la posizione di offset del byte 45 è la posizione direttamente dopo la corrispondenza
porzione. Tieni presente che la posizione del byte non è necessariamente la stessa di
posizione del carattere quando sono coinvolti caratteri UTF-8. Di conseguenza, il byte
le posizioni offset devono essere prese in considerazione solo nel contesto del loro utilizzo
ricerche successive su stringa, utilizzando una posizione di offset come argomento per -n
opzione. Viene utilizzato principalmente per implementare la funzione "trova tutte le corrispondenze non sovrapposte"
funzionalità.

Un semplice esempio di "trova tutte le corrispondenze non sovrapposte":

stringa="Il i seguenti chiusura codici: 78884 90210 99513 "
pcre_compile -m "\d{5}"
accumula=()
pcre_match -b -- $stringa
while [[ $? -eq 0 ]] do
b=($=ZPCRE_OP)
accum+=$PARTITA
pcre_match -b -n $b[2] -- $stringa
fatto
stampare -l $accum

. zsh/pc il modulo mette a disposizione la seguente condizione di test:

espr -pcre-partita PCRE
Confronta una stringa con un'espressione regolare compatibile con Perl.

Per esempio,

[[ "$testo" -pcre-partita ^d+$ ]] &&
stampare testo variabile contiene esclusivamente "d".

Se l' REMATCH_PCRE l'opzione è impostata, il =~ operatore è equivalente a -pcre-partita,
e la NO_CASE_MATCH è possibile utilizzare l'opzione. Notare che NO_CASE_MATCH non si applica mai a
, il pcre_match integrato, utilizzare invece il file -i interruttore di pcre_compile.

IL ZSH/REGEX MODULO

. zsh/espressione regolare il modulo mette a disposizione la seguente condizione di test:

espr -corrispondenza regex regex
Confronta una stringa con un'espressione regolare estesa POSIX. In caso di corrispondenza riuscita,
la parte corrispondente della stringa verrà normalmente posizionata nel file PARTITA variabile. Se
ci sono delle parentesi di cattura all'interno della regex, quindi il stile variabile di matrice
conterrà quelli. Se la corrispondenza non ha esito positivo, le variabili non lo saranno
alterato.

Per esempio,

[[ alfabetico -corrispondenza regex ^a([^a]+)a([^a]+)a ]] &&
stampare -l $ PARTITA X $ match

Se l'opzione REMATCH_PCRE non è impostato, allora il =~ l'operatore caricherà automaticamente
questo modulo secondo necessità e invocherà il file -corrispondenza regex operatore.

If BASH_REMATCH è impostato, quindi l'array BASH_REMATCH verrà impostato al posto di PARTITA
e stile.

IL ZSH/SCHED MODULO

. zsh/sched Il modulo rende disponibili un comando integrato e un parametro.

sched [-o] [+]hh:mm[:ss] command ...
sched [-o] [+]secondo command ...
sched [ -articolo ]
Effettuare una voce nell'elenco pianificato dei comandi da eseguire. Potrebbe essere il momento
specificato in tempo assoluto o relativo e come ore, minuti e
(facoltativamente) secondi separati da due punti o solo secondi. Un numero assoluto di
i secondi indicano il tempo trascorso dall'epoca (1970/01/01 00:00); questo è utile in
combinazione con le funzionalità in zsh/dataora modulo, vedere zsh/datetime
inserimento del modulo in zshmodules(1).

Senza argomenti, stampa l'elenco dei comandi pianificati. Se il comando pianificato
ha la -o flag impostato, questo viene mostrato all'inizio del comando.

Con l'argomento `-articolo', rimuove l'elemento specificato dall'elenco. La numerazione di
l'elenco è continuo e le voci sono in ordine cronologico, pertanto la numerazione può cambiare
quando le voci vengono aggiunte o eliminate.

I comandi vengono eseguiti immediatamente prima di un prompt o durante la riga della shell
l'editor è in attesa di input. In quest'ultimo caso è utile saper produrre
output che non interferisce con la riga in fase di modifica. Fornire l'opzione -o
fa sì che la shell cancelli la riga di comando prima dell'evento e la ridisegni
dopo. Dovrebbe essere utilizzato con qualsiasi evento pianificato che produca visibilità
uscita al terminale; non è necessario, ad esempio, con l'output che aggiorna a
barra del titolo dell'emulatore di terminale.

. sched builtin non è reso disponibile per impostazione predefinita quando la shell viene avviata in modalità a
emulando un'altra shell. Può essere reso disponibile con il comando `zmodload -F
zsh/sched b:programmato'.

zsh_scheduled_events
Un array di sola lettura corrispondente agli eventi pianificati da sched incorporato Il
gli indici dell'array corrispondono ai numeri mostrati quando sched viene eseguito senza
argomenti (a condizione che il KSH_ARRAY l'opzione non è impostata). Il valore dell'array
consiste nel tempo programmato in secondi a partire dall'epoca (vedere la sezione `The
zsh/datetime Module' per le funzionalità per l'utilizzo di questo numero), seguito da due punti,
seguito da eventuali opzioni (che potrebbero essere vuote ma saranno precedute da un `-'
altrimenti), seguito da due punti, seguito dal comando da eseguire.

. sched builtin dovrebbe essere usato per manipolare gli eventi. Tieni presente che questo lo farà
hanno un effetto immediato sul contenuto dell'array, in modo che gli indici possano diventare
non valido.

IL ZSH/RETE/PRESA MODULO

. zsh/rete/presa il modulo rende disponibile un comando integrato:

zsocket [ -altv ] [ -d fd ] [ args ]
zsocket è implementato come integrato per consentire il pieno utilizzo della riga di comando della shell
meccanismi di modifica, I/O di file e controllo dei lavori.

In uscita Connessioni
zsocket [ -v ] [ -d fd ] Nome del file
Apri una nuova connessione al dominio Unix a Nome del file. Il parametro della shell REPLY sarà
impostato sul descrittore di file associato a quella connessione. Al momento solo streaming
le connessioni sono supportate.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

Per ottenere un output più dettagliato, utilizzare -v.

In entrata Connessioni
zsocket -l [ -v ] [ -d fd ] Nome del file
zsocket -l aprirà un socket in ascolto Nome del file. Il parametro della shell REPLY
verrà impostato sul descrittore di file associato a quel listener.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

Per ottenere un output più dettagliato, utilizzare -v.

zsocket -a [ - tv ] [ -d targetfd ] ascoltafd
zsocket -a accetterà una connessione in entrata al socket associato a
ascoltafd. Il parametro della shell REPLY verrà impostato sul descrittore di file associato
con la connessione in entrata.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

If -t è specificato, zsocket restituirà se non è in sospeso alcuna connessione in entrata.
Altrimenti ne aspetterà uno.

Per ottenere un output più dettagliato, utilizzare -v.

IL ZSH/STAT MODULO

. zsh/stat Il modulo rende disponibile un comando integrato con due possibili nomi:

zstat [ -gnNolLtTrs ] [ -f fd ] [ -H hash ] [ -A schieramento ] [ -F FMT ]
[ +elemento ] [ filetto ...]
stat ...
Il comando funge da front-end per il file stat chiamata di sistema (vedi stat(2)). Lo stesso
il comando viene fornito con due nomi; come il nome stat viene spesso utilizzato da un esterno
comando si consiglia di utilizzare solo il comando zstat viene utilizzata la forma del comando. Questo
può essere organizzato caricando il modulo con il comando `zmodload -F zsh/stat
b:zstat'.

Se l' stat la chiamata non riesce, viene stampato il messaggio di errore di sistema appropriato e lo stato 1
viene restituito. I campi di struct stat fornire informazioni sui file forniti
come argomenti del comando. Oltre a quelli disponibili da stat chiama, un
elemento aggiuntivo `link' è fornito. Questi elementi sono:

dispositivo Il numero del dispositivo su cui risiede il file.

inode Il numero univoco del file su questo dispositivo (`inode' numero).

modo La modalità del file; ovvero il tipo di file e le autorizzazioni di accesso. Con
, il -s opzione, questa verrà restituita come una stringa corrispondente alla prima
colonna nel display del ls -l comando.

link Il numero di collegamenti fisici al file.

uid L'ID utente del proprietario del file. Con il -s opzione, questa viene visualizzata
come nome utente.

gid L'ID del gruppo del file. Con il -s opzione, questo viene visualizzato come gruppo
nome.

rdev Il numero grezzo del dispositivo. Questo è utile solo per dispositivi speciali.

Taglia La dimensione del file in byte.

un tempo
mtime
ctempo Gli orari dell'ultimo accesso, modifica e cambio inode del file,
rispettivamente, come numero di secondi trascorsi dalla mezzanotte GMT del 1° gennaio,
1970. Con il -s opzione, questi vengono stampati come stringhe per l'ora locale
zona; il formato può essere modificato con il file -F opzione e con il -g opzione
gli orari sono in GMT.

nero
Il numero di byte in un blocco di allocazione sul dispositivo su cui si trova il file
risiede.

bloccare Il numero di blocchi del disco utilizzati dal file.

link Se il file è un collegamento e il file -L è attiva, questo contiene il nome
del file collegato, altrimenti è vuoto. Tieni presente che se questo elemento lo è
selezionato (``zstat + collegamento'') poi il -L l'opzione viene utilizzata automaticamente.

Un particolare elemento può essere selezionato includendo il suo nome preceduto da un `+' nel
elenco delle opzioni; è consentito un solo elemento. L'elemento può essere abbreviato in qualsiasi
insieme unico di personaggi principali. Altrimenti verranno visualizzati tutti gli elementi per tutti
File.

Opzioni:

-A schieramento
Invece di visualizzare i risultati sull'output standard, assegnali a un file
schieramento, uno struct stat elemento per elemento dell'array per ciascun file in ordine. In
in questo caso non appare né il nome dell'elemento né il nome dei file
in schieramento a meno che il -t or -n sono state fornite le opzioni, rispettivamente. Se -t is
dato, il nome dell'elemento appare come prefisso dell'array appropriato
elemento; Se -n viene fornito, il nome del file appare come un elemento dell'array separato
precedendo tutti gli altri. Le altre opzioni di formattazione vengono rispettate.

-H hash
Simile a -A, ma assegna invece i valori a hash. Le chiavi sono le
elementi sopra elencati. Se la -n viene fornita l'opzione quindi il nome del file
il file è incluso nell'hash con chiave Nome.

-f fd Utilizzare il file nel descrittore di file fd invece di file con nome; nessun elenco di file
i nomi sono consentiti in questo caso.

-F FMT Forniture a strftime (Vedi strftime(3)) stringa per la formattazione dell'ora
elementi. Il -s l'opzione è implicita.

-g Mostra gli elementi orari nel fuso orario GMT. IL -s l'opzione è implicita.

-l Elenca i nomi degli elementi di tipo (sull'output standard o su un array come
appropriato) e restituire immediatamente; opzioni diverse da -A e gli argomenti lo sono
ignorato.

-L Eseguire un Istat (Vedi Istat(2)) piuttosto che a stat chiamata di sistema. In questo
caso, se il file è un collegamento, informazioni sul collegamento stesso anziché
viene restituito il file di destinazione. Questa opzione è necessaria per effettuare il file link
elemento utile. È importante notare che questo è esattamente l'opposto di
ls(1), ecc.

-n Mostra sempre i nomi dei file. Di solito questi vengono mostrati solo quando l'output è
sullo standard output e nell'elenco è presente più di un file.

-N Non mostrare mai i nomi dei file.

-o Se viene stampato un file raw, mostralo in ottale, che è più utile
consumo umano rispetto al valore predefinito decimale. Uno zero iniziale sarà
stampato in questo caso. Tieni presente che ciò non influisce sul fatto che si tratti di un file raw o
viene mostrata la modalità file formattato, che è controllata dal file -r e -s opzioni,
né se viene mostrata una modalità.

-r Stampa i dati grezzi (il formato predefinito) insieme ai dati stringa (il -s formato);
i dati della stringa vengono visualizzati tra parentesi dopo i dati grezzi.

-s Stampa modo, uid, gid e i tre elementi temporali come stringhe invece di
numeri. In ogni caso il formato è come quello di ls -l.

-t Mostra sempre i nomi dei tipi per gli elementi di struct stat. Di solito questi
vengono visualizzati solo quando l'output è sullo standard output e nessun singolo elemento
è stato selezionato.

-T Non mostrare mai i nomi dei tipi di file struct stat elementi.

IL ZSH/SISTEMA MODULO

. zsh/sistema Il modulo rende disponibili vari comandi e parametri integrati.

Builtin
syserrore [ -e errvar ] [ -p prefisso ] [ err | errname ]
Questo comando stampa il messaggio di errore associato a err, un errore di sistema
numero, seguito da una nuova riga per l'errore standard.

Invece del numero di errore, un nome errnamedi strumenti adatti, questi ENOENTE, può essere usato. IL
insieme di nomi è uguale al contenuto dell'array errnos, vedi sotto.

Se la stringa prefisso viene fornito, viene stampato davanti al messaggio di errore, con il n
spazio intermedio.

If errvar viene fornito, l'intero messaggio, senza un ritorno a capo, viene assegnato al file
nomi dei parametri errvar e non viene emesso nulla.

Uno stato restituito pari a 0 indica che il messaggio è stato stampato con successo (sebbene
potrebbe non essere utile se il numero di errore non rientra nell'intervallo del sistema), un ritorno
lo stato 1 indica un errore nei parametri e uno stato restituito 2
indica che il nome dell'errore non è stato riconosciuto (non viene stampato alcun messaggio per questo).

sysopen [ -arw ] [ -m permessi ] [ -o Opzioni ]
-u fd filetto
Questo comando apre un file. IL -r, -w e -a i flag indicano se il file dovrebbe
essere aperti rispettivamente per la lettura, la scrittura e l'aggiunta. IL -m l'opzione consente
i permessi iniziali da utilizzare durante la creazione di un file da specificare in forma ottale.
Il descrittore del file è specificato con -u. O un descrittore di file esplicito nel file
è possibile specificare un intervallo da 0 a 9 oppure è possibile assegnare un nome di variabile a cui assegnare il file
verrà assegnato il numero descrittore.

. -o L'opzione consente di specificare varie opzioni specifiche del sistema come a
elenco separato da virgole. Di seguito è riportato un elenco delle opzioni possibili. Notare che,
a seconda del sistema, alcuni potrebbero non essere disponibili.
cloexec
contrassegnare il file da chiudere quando vengono eseguiti altri programmi

creare
creat creare il file se non esiste

escl crea file, errore se esiste già

noatime
sopprimere l'aggiornamento del file atime

nofollow
fallire se filetto è un collegamento simbolico

sync request that write attende finché i dati non sono stati scritti fisicamente

troncare
tronca troncare il file alla dimensione 0

Per chiudere il file, utilizzare uno dei seguenti:

exec {fd
exec {fd}>&-

sysread [ -c conteggiovar ] [ -i inf ] [ -o outfd ]
[ -s buffe ] [ -t timeout ] [ param ]
Esegue una singola lettura di sistema dal descrittore di file info zero se non lo è
dato. Il risultato della lettura viene memorizzato in param or REPLY se questo non viene dato.
If conteggiovar viene fornito, il numero di byte letti viene assegnato al parametro denominato
by conteggiovar.

Il numero massimo di byte letti è buffe o 8192 se comunque non viene fornito
il comando ritorna non appena un numero qualsiasi di byte è stato letto con successo.

If timeout viene fornito, specifica un timeout in secondi, che può essere zero per il poll
il descrittore di file. Questo è gestito da sondaggio chiamata di sistema se disponibile,
altrimenti il select chiamata di sistema se disponibile.

If outfd viene fornito, viene effettuato un tentativo di scrivere nel file tutti i byte appena letti
descrittore outfd. Se questo fallisce, a causa di un errore di sistema diverso da EINTR or
a causa di un errore zsh interno durante un'interruzione, i byte vengono letti ma non
scritti vengono memorizzati nel parametro denominato da param se fornito (non viene utilizzato alcun valore predefinito
in questo caso) e il numero di byte letti ma non scritti viene memorizzato nel file
parametro denominato da conteggiovar se questo viene fornito. Se avesse avuto successo, conteggiovar
contiene il numero completo di byte trasferiti, come al solito, e param non è impostato.

L'errore EINTR (chiamata di sistema interrotta) viene gestita internamente in modo che shell
gli interrupt sono trasparenti per il chiamante. Qualsiasi altro errore provoca un reso.

I possibili stati di reso sono
0 Almeno un byte di dati è stato letto con successo ed eventualmente
scritto.

1 Si è verificato un errore nei parametri del comando. Questo è l'unico errore
per il quale viene stampato un messaggio di errore standard.

2 Si è verificato un errore durante la lettura o durante il polling del descrittore del file di input
un timeout. Il parametro ERRORE dà l'errore.

3 I dati sono stati letti con successo, ma si è verificato un errore durante la loro scrittura outfd.
Il parametro ERRORE dà l'errore.

4 Il tentativo di lettura è scaduto. Nota che questo non viene impostato ERRORE poiché questo non lo è
un errore di sistema.

5 Non si è verificato alcun errore di sistema, ma sono stati letti zero byte. Questo di solito indica
fine del fascicolo. I parametri vengono impostati secondo le consuete regole; non scrivere
a outfd è tentato.

sysseek [ -u fd ] [ -w inizia a|fine|corrente ] offset
La posizione corrente del file in cui avranno luogo le letture e le scritture future è
adattato all'offset di byte specificato. IL offset viene valutato come un calcolo matematico
espressione. Il -u l'opzione consente di specificare il descrittore del file. Per impostazione predefinita
l'offset viene specificato rispetto alla partenza o al file ma, con il -w opzione,
è possibile specificare che l'offset sia relativo alla corrente
posizione o la fine del file.

syswrite [ -c conteggiovar ] [ -o outfd ] dati
I dati (una singola stringa di byte) vengono scritti nel descrittore di file outfd, O 1
se non viene fornito, utilizzare il file scrivere chiamata di sistema. Possono essere eseguite più operazioni di scrittura
da utilizzare se il primo non scrive tutti i dati.

If conteggiovar viene fornito, il numero di byte scritti viene memorizzato nel parametro denominato
by conteggiovar; questa potrebbe non essere l'intera lunghezza dati se si è verificato un errore.

L'errore EINTR (chiamata di sistema interrotta) viene gestita internamente riprovando;
in caso contrario, un errore causerà la restituzione del comando. Ad esempio, se il file
il descrittore è impostato su un output non bloccante, un errore ANCORA (su alcuni sistemi,
EWOULDBLOCK) può comportare la restituzione anticipata del comando.

Lo stato restituito può essere 0 per successo, 1 per un errore nei parametri del
comando, oppure 2 per un errore in scrittura; nessun messaggio di errore viene stampato nell'ultimo
case, ma il parametro ERRORE rifletterà l'errore che si è verificato.

zsystem gregge [ -t timeout ] [ -f var ] [-R] filetto
zsystem gregge -u fd_espr
Il builtin zsystemil sottocomando gregge esegue il blocco consultivo dei file (tramite il file
fctl(2) chiamata di sistema) sull'intero contenuto del file specificato. Questa forma di
il blocco richiede che i processi che accedono al file cooperino; è più ovvio
l'uso è tra due istanze della shell stessa.

Nella prima forma il nome filetto, che deve già esistere, si blocca aprendo a
descrittore di file al file e applicando un blocco al descrittore di file. La serratura
termina quando termina il processo di shell che ha creato il blocco; è quindi
spesso è conveniente creare blocchi di file all'interno di subshell, poiché il blocco lo è
rilasciato automaticamente quando esce la subshell. Lo stato 0 viene restituito se il lock
ha successo, altrimenti stato 1.

Nella seconda forma il descrittore di file dato dall'espressione aritmetica fd_espr
è chiuso, rilasciando un lucchetto. Il descrittore di file può essere interrogato utilizzando il comando `-f
var' forma durante il blocco; in caso di blocco riuscito, la variabile di shell var è impostato su
il descrittore di file utilizzato per il blocco. Il blocco verrà rilasciato se il file
il descrittore viene chiuso con qualsiasi altro mezzo, ad esempio utilizzando `exec {var}>&-';
tuttavia, il modulo qui descritto esegue un controllo di sicurezza sul descrittore di file
è in uso per il blocco dei file.

Per impostazione predefinita la shell attende indefinitamente che il blocco abbia successo. L'opzione -t
timeout specifica un timeout per il blocco in secondi; attualmente questo deve essere un
numero intero. La shell tenterà di bloccare il file una volta al secondo durante questo periodo.
Se il tentativo scade, viene restituito lo stato 2.

Se l'opzione -e viene fornito, il descrittore di file per il blocco viene preservato quando viene fornito il file
usi della shell exec avviare un nuovo processo; altrimenti è chiuso a quel punto e
la serratura si aprì.

Se l'opzione -r viene dato, la serratura serve solo per la lettura, altrimenti è per
leggendo e scrivendo. Il descrittore del file viene aperto di conseguenza.

zsystem supporta sottocomando
Il builtin zsystemil sottocomando supporta verifica se un dato sottocomando lo è
supportato. Restituisce lo stato 0 in tal caso, altrimenti lo stato 1. Funziona silenziosamente a meno che
si è verificato un errore di sintassi (ovvero il numero errato di argomenti), nel qual caso status
255 viene restituito. Lo stato 1 può indicare una delle due cose: sottocomando è noto ma
non supportato dal sistema operativo corrente, o sottocomando non è noto (forse
perché questa è una versione precedente della shell prima che fosse implementata).

Matematica funzioni
sistema(fd)
La funzione matematica di sistema restituisce la posizione corrente del file per il descrittore di file
passato come argomento.

Scheda Sintetica
errnos Un array di sola lettura dei nomi degli errori definiti nel sistema. Questi sono in genere
macro definite in C includendo il file di intestazione del sistema errno.h. L'indice di ciascuno
nome (assumendo l'opzione KSH_ARRAY non è impostato) corrisponde al numero di errore.
Numeri di errore num prima dell'ultimo errore noto a cui non è assegnato un nome viene assegnato un nome
Enum nell'array.

Tieni presente che gli alias per gli errori non vengono gestiti; viene utilizzato solo il nome canonico.

sysparams
Un array associativo di sola lettura. Le chiavi sono:

pid Restituisce l'ID del processo corrente, anche nelle subshell. Confrontare
$$, che restituisce l'ID del processo della shell principale.

ppd Restituisce l'ID del processo genitore del processo corrente, anche in
subshell. Confrontare $PPID, che restituisce l'ID del processo del genitore di
processo della shell principale.

IL ZSH/NET/TCP MODULO

. zsh/rete/tcp il modulo rende disponibile un comando integrato:

ztcp [ -acflLtv ] [ -d fd ] [ args ]
ztcp è implementato come integrato per consentire il pieno utilizzo della modifica della riga di comando della shell,
I/O di file e meccanismi di controllo dei lavori.

If ztcp viene eseguito senza opzioni, restituirà il contenuto della sua tabella di sessione.

Se viene eseguito solo con l'opzione -L, produrrà il contenuto della sessione
tabella in un formato adatto per l'analisi automatica. Se fornita, l'opzione viene ignorata
con un comando per aprire o chiudere una sessione. L'output è costituito da un insieme di righe,
uno per sessione, ciascuno contenente i seguenti elementi separati da spazi:

Descrittore di file
Il descrittore di file in uso per la connessione. Per l'ingresso normale (I) e
in uscita (O) connessioni, questo può essere letto e scritto dalla solita shell
meccanismi. Tuttavia, dovrebbe essere vicino solo a `ztcp -c'.

Tipo di connessione
Una lettera che indica come è stata creata la sessione:

Z Una sessione creata con il file zftp comando.

L Una connessione aperta per l'ascolto con `ztcp -l'.

I Una connessione in entrata accettata con `ztcp -a'.

O Una connessione in uscita creata con `ztcp host ...'.

L'ospite locale
Di solito è impostato su un indirizzo IP tutto zero come indirizzo del file
localhost è irrilevante.

Il porto locale
È probabile che sia zero a meno che la connessione non sia per l'ascolto.

L'host remoto
Questo è il nome di dominio completo del peer, se disponibile, altrimenti an
Indirizzo IP. È un indirizzo IP tutto zero per una sessione aperta
ascoltando.

Il porto remoto
Questo è zero per una connessione aperta per l'ascolto.

In uscita Connessioni
ztcp [ -v ] [ -d fd ] host [ porto ]
Apri una nuova connessione TCP a host. Se il porto viene omesso, verrà utilizzato per impostazione predefinita port
23. La connessione verrà aggiunta alla tabella della sessione e al parametro della shell
REPLY verrà impostato sul descrittore di file associato a quella connessione.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

Per ottenere un output più dettagliato, utilizzare -v.

In entrata Connessioni
ztcp -l [ -v ] [ -d fd ] porto
ztcp -l aprirà un socket in ascolto su TCP porto. Il socket verrà aggiunto al file
tabella di sessione e il parametro della shell REPLY verrà impostato sul descrittore di file
associato a quell'ascoltatore.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

Per ottenere un output più dettagliato, utilizzare -v.

ztcp -a [ - tv ] [ -d targetfd ] ascoltafd
ztcp -a accetterà una connessione in entrata alla porta associata a ascoltafd.
La connessione verrà aggiunta alla tabella della sessione e al parametro della shell REPLY
verrà impostato sul descrittore di file associato alla connessione in entrata.

If -d è specificato, il suo argomento verrà preso come descrittore del file di destinazione per
la connessione.

If -t è specificato, ztcp restituirà se non è in sospeso alcuna connessione in entrata.
Altrimenti ne aspetterà uno.

Per ottenere un output più dettagliato, utilizzare -v.

Chiusura Connessioni
ztcp -cfr [ -v ] [ fd ]
ztcp -c [ -v ] [ fd ]
ztcp -c chiuderà il socket associato a fd. La presa verrà rimossa da
il tavolo della seduta. Se fd non è specificato, ztcp chiuderà tutto nel file
tavolo di seduta.

Normalmente, i socket registrati da zftp (vedi zshmodules(1)) non può essere chiuso
modo. Per forzare la chiusura di tale socket, utilizzare -f.

Per ottenere un output più dettagliato, utilizzare -v.

Esempio
Ecco come creare una connessione TCP tra due istanze di zsh. Dobbiamo scegliere un
porta non assegnata; qui usiamo il 5123 scelto casualmente.

On host1,
zmodload zsh/rete/tcp
ztcp -l 5123
ascoltafd=$RISPOSTA
ztcp -a $ascoltafd
fd=$RISPOSTA
Il penultimo comando si blocca finché non viene stabilita una connessione in entrata.

Ora crea una connessione da host2 (che potrebbe, ovviamente, essere la stessa macchina):
zmodload zsh/rete/tcp
ztcp host1 5123
fd=$RISPOSTA

Ora su ciascun host, $fd contiene un descrittore di file per parlare con l'altro. Per esempio,
on host1:
stampare Questo is a messaggio >&$fd
e host2:
read -r linea <&$fd; stampare -r - $ linea
stampa `Questo is a messaggio'.

Per mettere ordine, avanti host1:
ztcp -c $ascoltafd
ztcp -c $fd
e host2
ztcp -c $fd

IL ZSH/TERMCAP MODULO

. zsh/termcap il modulo rende disponibile un comando integrato:

eco berretto [ arg ...]
Emette il valore termcap corrispondente alla capacità berretto, con optional
argomenti.

. zsh/termcap il modulo mette a disposizione un parametro:

termcap
Un array associativo che associa i codici di funzionalità termcap ai relativi valori.

IL ZSH/TERMINFO MODULO

. zsh/terminfo il modulo rende disponibile un comando integrato:

ecoti berretto [ arg ]
Emette il valore terminfo corrispondente alla capacità berretto, istanziato con
arg se applicabile.

. zsh/terminfo il modulo mette a disposizione un parametro:

terminfo
Un array associativo che associa i nomi delle funzionalità terminfo ai relativi valori.

IL ZSH/ZFTP MODULO

. zs/zftp il modulo rende disponibile un comando integrato:

zftp sottocomando [ args ]
. zs/zftp il modulo è un client per FTP (protocollo di trasferimento file). È
implementato come integrato per consentire il pieno utilizzo della modifica della riga di comando della shell, dell'I/O dei file,
e meccanismi di controllo del lavoro. Spesso gli utenti vi accedono tramite le funzioni della shell
fornire un'interfaccia più potente; viene fornito un set con il zsh distribuzione
ed è descritto in zshzftpsys(1). comunque, il zftp il comando è interamente utilizzabile in
proprio diritto.

Tutti i comandi sono costituiti dal nome del comando zftp seguito dal nome di un sottocomando.
Questi sono elencati di seguito. Si suppone che lo stato di ritorno di ciascun sottocomando lo sia
riflettere il successo o il fallimento dell'operazione remota. Vedere una descrizione del
variabile ZFTP_VERBOSE per ulteriori informazioni su come potrebbero essere le risposte dal server
stampato.

sottocomandi
aprire host[:porto] [ Utente [ password [ account ] ] ]
Apri una nuova sessione FTP su host, che potrebbe essere il nome di un host connesso TCP/IP o
un numero IP nella notazione punto standard. Se l'argomento è nella forma
host:porto, aprire una connessione alla porta TCP porto invece della porta FTP standard 21.
Può essere il nome di un servizio TCP o un numero: vedere la descrizione di
ZFTP_PORT sotto per maggiori informazioni.

Se vengono utilizzati indirizzi IPv6 nel formato due punti, il file host dovrebbe essere circondato da virgolette
parentesi quadre per distinguerlo da portodi strumenti adatti, questi
'[fe80::203:baff:fe02:8b56]'. Per coerenza questo è consentito con tutte le forme di
host.

Gli argomenti rimanenti vengono passati al file accesso sottocomando. Tieni presente che se non ci sono argomenti
al di là di host vengono forniti, aprire andrete a non è un chiama automaticamente accesso. Se non ci sono argomenti
vengono forniti tutti, aprire utilizzerà i parametri impostati dal params sottocomando.

Dopo un'apertura riuscita, le variabili di shell ZFTP_HOST, ZFTP_PORT, ZFTP_IP e
ZFTP_SYSTEM sono disponibili; vedere "Variabili" di seguito.

accesso [ Nome [ password [ account ] ] ]
Utente [ Nome [ password [ account ] ] ]
Accedi all'utente Nome con parametri password e account. Uno qualsiasi dei parametri
può essere omesso e, se necessario, verrà letto dallo standard input (Nome è sempre
necessario). Se l'input standard è un terminale, verrà stampato un prompt per ciascuno di essi
errore standard e password non verrà ripreso. Se uno qualsiasi dei parametri non lo è
utilizzato, viene stampato un messaggio di avviso.

Dopo un accesso riuscito, le variabili di shell ZFTP_USER, ZFTP_ACCOUNT e ZFTP_PWD
sono disponibili; vedere "Variabili" di seguito.

Questo comando può essere nuovamente emesso quando un utente ha già effettuato l'accesso e il server lo farà
essere prima reinizializzato per un nuovo utente.

params [ host [ Utente [ password [ account ]]]
params -
Memorizzare i parametri specificati per un secondo momento aprire comando senza argomenti. Solo quelli
dati sulla riga di comando verranno ricordati. Se non vengono forniti argomenti, il
vengono stampati i parametri attualmente impostati, anche se la password apparirà come una riga
di stelle; lo stato di ritorno è uno se non sono stati impostati parametri, zero altrimenti.

Qualsiasi parametro può essere specificato come `?', che potrebbe essere necessario citare
proteggerlo dall'espansione della shell. In questo caso, il parametro appropriato sarà
leggi da stdin come con accesso sottocomando, inclusa la gestione speciale di
password. Se il `?' è seguito da una stringa utilizzata come prompt per
leggendo il parametro invece del messaggio predefinito (eventuale punteggiatura necessaria e
gli spazi bianchi dovrebbero essere inclusi alla fine del prompt). La prima lettera del
Il parametro (solo) può essere racchiuso tra apici `\'; quindi un argomento "\\$parola" garanzie
che la stringa dal parametro shell $parola sarà trattato alla lettera, se
oppure no, inizia con un `?'.

Se invece un singolo `-', i parametri esistenti, se presenti, vengono cancellati. In
in quel caso, chiamando aprire senza argomenti causerà un errore.

L'elenco dei parametri non viene cancellato dopo a close, tuttavia verrà eliminato se
, il zs/zftp il modulo è scarico.

Per esempio,

zftp params ftp.altrove.xx giuseppe '?Parola d'ordine da juser: '

memorizzerà l'host ftp.altrove.xx e l'utente giuseppe e quindi richiedere all'utente
per la password corrispondente con la richiesta fornita.

test Testare la connessione; se il server ha segnalato di aver chiuso la connessione
(forse a causa di un timeout), restituisce lo stato 2; se comunque nessuna connessione era aperta, ritorna
stato 1; altrimenti restituisce lo stato 0. Il test il sottocomando è silenzioso, a parte i messaggi
stampato da $ZFTP_VERBOSE meccanismo o messaggi di errore se la connessione si chiude.
Non vi è alcun sovraccarico di rete per questo test.

Il test è supportato solo su sistemi con select(2) or sondaggio(2) sistema
chiamate; altrimenti il ​​messaggio `non è un supportato on questo sistema' viene invece stampato.

. test il sottocomando verrà automaticamente chiamato all'inizio di qualsiasi altro
sottocomando per la sessione corrente quando una connessione è aperta.

cd elenco
Cambia la directory remota in elenco. Altera anche la variabile di shell ZFTP_PWD.

cdup Cambiare la directory remota in quella più in alto nell'albero delle directory. Notare che cd
.. funzionerà correttamente anche su sistemi non UNIX.

dir [ arg ...]
Fornire un elenco (dettaglio) della directory remota. IL argvengono passati direttamente a
il server. Il comportamento del comando dipende dall'implementazione, ma da un server UNIX
tipicamente interpreterà args come argomenti per il ls comando e senza argomenti
restituire il risultato di `ls -l'. La directory viene elencata nell'output standard.

ls [ arg ...]
Fornire un (breve) elenco della directory remota. Senza arg, produce un elenco non elaborato
dei file nella directory, uno per riga. Altrimenti, fino ai capricci del
implementazione del server, si comporta in modo simile a dir.

Digitare [ Digitare ]
Cambia il tipo di trasferimento in Digitareo stampa il tipo corrente se Digitare is
assente. I valori consentiti sono `A' (ASCII), "I' (Immagine, cioè binario), o `B' (UN
sinonimo di "I').

L'impostazione FTP predefinita per un trasferimento è ASCII. Tuttavia, se zftp rileva che il telecomando
host è una macchina UNIX con bye a 8 bit, passerà automaticamente all'utilizzo
binario per i trasferimenti di file su aprire. Questo può essere successivamente ignorato.

Il tipo di trasferimento viene passato all'host remoto solo quando è disponibile una connessione dati
stabilito; questo comando non comporta alcun sovraccarico di rete.

ascii Lo stesso di Digitare A.

binario Lo stesso di Digitare I.

modo [ S | B ]
Imposta il tipo di modalità su streaming (S) o bloccare (B). La modalità streaming è l'impostazione predefinita; bloccare
la modalità non è ampiamente supportata.

a distanza filetto ...
locale [ filetto ...]
Stampa la dimensione e l'ora dell'ultima modifica dei file remoti o locali. Se ci
è presente più di una voce nell'elenco, viene stampato per primo il nome del file. IL
il primo numero è la dimensione del file, il secondo è l'ora dell'ultima modifica del file
nel formato AAMMGGhhmmSS composto da anno, mese, data, ora, minuti e
secondi nel GMT. Tieni presente che questo formato, inclusa la lunghezza, è garantito, quindi
che le stringhe temporali possono essere confrontate direttamente tramite [[ integrato < e > operatori,
anche se sono troppo lunghi per essere rappresentati come numeri interi.

Non tutti i server supportano i comandi per recuperare queste informazioni. In ciò
caso, il a distanza il comando non stamperà nulla e restituirà lo stato 2, rispetto a
stato 1 per un file non trovato.

. locale comando (ma non a distanza) può essere utilizzato senza argomenti, nel qual caso the
le informazioni provengono dall'esame del descrittore di file zero. Questo è lo stesso file di
visto da A metti comando senza ulteriore reindirizzamento.

ottenere filetto ...
Recupera tutto filettos dal server, concatenandoli e inviandoli a standard
produzione.

metti filetto ...
Per ciascun filetto, leggi un file dallo standard input e invialo all'host remoto
con il nome dato.

aggiungere filetto ...
As metti , ma se il telecomando filetto esiste già, i dati vengono invece aggiunti ad esso
sovrascrivendolo.

arrivare a filetto punto
putat filetto punto
appendice filetto punto
Versioni di ottenere, metti e aggiungere che inizierà il trasferimento al dato punto in
il remoto filetto. Ciò è utile per l'aggiunta a un file locale incompleto.
Tuttavia, tieni presente che questa capacità non è universalmente supportata dai server (e non lo è
esattamente il comportamento specificato dalla norma).

delete filetto ...
Elimina l'elenco dei file sul server.

mkdir elenco
Crea una nuova directory elenco sul server.

rmdir elenco
Elimina la directory elenco sul server.

rinominare vecchio nome nuovo nome
Rinomina il file vecchio nome a nuovo nome sul server.

site arg ...
Invia un comando specifico dell'host al server. Probabilmente ne avrai bisogno solo se
incaricato dal server di utilizzarlo.

citare arg ...
Invia la sequenza di comandi FTP grezza al server. Dovresti avere familiarità con il
Il comando FTP viene impostato come definito nella RFC959 prima di eseguire questa operazione. I comandi utili possono
includere STATISTICA e AIUTO. Notare anche il meccanismo per restituire i messaggi come descritto
per la variabile ZFTP_VERBOSE di seguito, in particolare che tutti i messaggi provenienti da
la connessione di controllo viene inviata all'errore standard.

close
smettere Chiude la connessione dati corrente. Ciò annulla i parametri della shell ZFTP_HOST,
ZFTP_PORT, ZFTP_IP, ZFTP_SYSTEM, ZFTP_USER, ZFTP_ACCOUNT, ZFTP_PWD, ZFTP_TYPE e
ZFTP_MODE.

Sessione [ sessname ]
Consente di utilizzare più sessioni FTP contemporaneamente. Il nome della sessione è an
stringa arbitraria di caratteri; la sessione predefinita si chiama `difetto'. Se questo
il comando viene chiamato senza argomenti, elencherà tutte le sessioni correnti; con
un argomento, passerà alla sessione esistente chiamata sessname, o
creare una nuova sessione con quel nome.

Ogni sessione ricorda lo stato della connessione, l'insieme delle specifiche della connessione
parametri della shell (gli stessi impostati che vengono annullati quando una connessione viene chiusa, come indicato in
la descrizione di close) e tutti i parametri utente specificati con il file params
sottocomando. Il passaggio a una sessione precedente ripristina tali valori; cambiando in a
la nuova sessione li inizializza allo stesso modo di if zftp era appena stato caricato. IL
il nome della sessione corrente è dato dal parametro ZFTP_SESSION.

rmsession [ sessname ]
Elimina una sessione; se non viene fornito un nome, la sessione corrente viene eliminata. Se la
la sessione corrente viene eliminata, la prima sessione esistente diventa la nuova corrente
sessione, altrimenti la sessione corrente non viene modificata. Se la sessione è
cancellato è l'unico, una nuova sessione chiamata `difetto' viene creato e diventa il
sessione corrente; tieni presente che questa è una nuova sessione anche se la sessione viene eliminata
è anche chiamato "difetto'. Si consiglia di non eliminare le sessioni durante
comandi in background che utilizzano zftp sono ancora attivi.

Scheda Sintetica
I seguenti parametri della shell vengono utilizzati da zftp. Attualmente nessuno di loro è speciale.

ZFTP_TMOUT
Numero intero. Il tempo in secondi di attesa prima del completamento di un'operazione di rete
restituendo un errore. Se non viene impostato al caricamento del modulo, verrà fornito
il valore predefinito è 60. Un valore pari a zero disattiva i timeout. Se si verifica un timeout
la connessione di controllo verrà chiusa. Utilizzare un valore maggiore se si verifica anche questo
frequentemente.

ZFTP_IP
Sola lettura. L'indirizzo IP della connessione corrente in notazione con punti.

ZFTP_HOST
Sola lettura. Il nome host del server remoto corrente. Se l'host è stato aperto come file
numero IP, ZFTP_HOST contiene quello invece; questo risparmia il sovraccarico per un nome
ricerca, poiché i numeri IP vengono utilizzati più comunemente quando un server dei nomi non è disponibile.

ZFTP_PORT
Sola lettura. Il numero della porta TCP remota verso la quale è aperta la connessione (pari
se la porta era stata originariamente specificata come servizio denominato). Di solito questo è il
porta FTP standard, 21.

Nell'improbabile caso in cui il tuo sistema non disponga della conversione appropriata
funzioni, questo appare nell'ordine dei byte di rete. Se il tuo sistema è little-endian,
la porta sarà quindi composta da due byte scambiati e verrà segnalata la porta standard
come 5376. In tal caso, le porte numeriche passate a zftp aprire dovrà essere presente anche lui
questo formato.

ZFTP_SYSTEM
Sola lettura. La stringa del tipo di sistema restituita dal server in risposta a un FTP SISTEMA
richiesta. Il caso più interessante è l'inizio di una stringa "UNIX Tipo: L8", quale
garantisce la massima compatibilità con un host UNIX locale.

ZFTP_TYPE
Sola lettura. Il tipo da utilizzare per i trasferimenti di dati, `A' o `I'. Usa il
Digitare sottocomando per cambiarlo.

ZFTP_USER
Sola lettura. Il nome utente attualmente connesso, se presente.

ZFTP_ACCOUNT
Sola lettura. Il nome account dell'utente corrente, se presente. La maggior parte dei server no
richiedono un nome account.

ZFTP_PWD
Sola lettura. La directory corrente sul server.

ZFTP_CODE
Sola lettura. Il codice a tre cifre dell'ultima risposta FTP dal server come stringa.
Questo può ancora essere letto dopo la chiusura della connessione e non viene modificato quando il file
modifiche della sessione corrente.

ZFTP_REPLY
Sola lettura. L'ultima riga dell'ultima risposta inviata dal server. Questo può ancora essere
letto dopo la chiusura della connessione e non viene modificato durante la sessione corrente
modifiche.

ZFTP_SESSION
Sola lettura. Il nome della sessione FTP corrente; vedere la descrizione del Sessione
sottocomando.

ZFTP_PREFS
Una serie di preferenze per modificarne gli aspetti zftpil suo comportamento. Ogni preferenza
è un singolo carattere. Sono definiti:

P Passivo: tenta di fare in modo che il server remoto avvii i trasferimenti di dati. Questo
è leggermente più efficiente della modalità sendport. Se la lettera S avviene più tardi
nella stringa, zftp utilizzerà la modalità sendport se la modalità passiva non è disponibile.

S Sendport: avvia i trasferimenti tramite FTP PORT comando. Se ciò accade
prima di qualsiasi P nella stringa non verrà mai tentata la modalità passiva.

D Stupido: usa solo il minimo indispensabile di comandi FTP. Ciò impedisce il
variabili ZFTP_SYSTEM e ZFTP_PWD dall'essere impostato, e significherà tutto
le connessioni sono predefinite sul tipo ASCII. Potrebbe prevenire ZFTP_SIZE dall'essere impostato
durante un trasferimento se il server non lo invia comunque (molti server lo fanno).

If ZFTP_PREFS non è impostato quando zftp viene caricato, verrà impostato su un valore predefinito di `PS',
ovvero utilizzare la modalità passiva se disponibile, altrimenti ricorrere alla modalità sendport.

ZFTP_VERBOSE
Una stringa di cifre compresa tra 0 e 5 inclusi, che specifica quali risposte provengono da
il server dovrebbe essere stampato. Tutte le risposte vanno all'errore standard. Se qualcuno dei
nella stringa compaiono i numeri da 1 a 5, risposte grezze dal server con codici di risposta
che inizia con quella cifra verrà stampato in errore standard. La prima cifra di
il codice di risposta a tre cifre è definito da RFC959 per corrispondere a:

1. Una risposta preliminare positiva.

2. Una risposta di completamento positiva.

3. Una risposta intermedia positiva.

4. Una risposta di completamento negativa temporanea.

5. Una risposta di completamento negativa permanente.

Si segnala che, per motivi sconosciuti, la risposta "Servizio non disponibile",
che forza l'interruzione di una connessione, è classificato come 421, cioè "transitorio".
negativo', un'interessante interpretazione della parola 'transitorio'.

Il codice 0 è speciale: indica che tutte le righe del multiriga tranne l'ultima
le risposte lette dal server verranno stampate in errore standard in un elaborato
formato. Per convenzione, i server utilizzano questo meccanismo per inviare informazioni per il
utente da leggere. Viene utilizzato il codice di risposta appropriato, se corrisponde alla stessa risposta
priorità.

If ZFTP_VERBOSE non è impostato quando zftp viene caricato, verrà impostato sul valore predefinito
450, ovvero verranno stampati i messaggi destinati all'utente e tutti gli errori. Un nulla
la stringa è valida e specifica che nessun messaggio deve essere stampato.

funzioni
zftp_chpwd
Se questa funzione è impostata dall'utente, viene chiamata ogni volta che cambia la directory
sul server, incluso quando un utente ha effettuato l'accesso o quando una connessione è chiusa.
Nell'ultimo caso, $ZFTP_PWD verrà disattivato; altrimenti rifletterà il nuovo
directory.

zftp_progress
Se questa funzione è impostata dall'utente, verrà chiamata durante a ottenere, metti or aggiungere
operazione ogni volta che sono stati ricevuti dati sufficienti dall'host. Durante un ottenere,
i dati vengono inviati allo standard output, quindi è fondamentale che questa funzione scriva
all'errore standard o direttamente al terminale, non è un allo standard output.

Quando viene richiamata con un trasferimento in corso, viene visualizzata la seguente shell aggiuntiva
si impostano i parametri:

ZFTP_FILE
Il nome del file remoto trasferito da o a.

ZFTP_TRANSFER
A G per ottenere funzionamento e a P per metti

ZFTP_SIZE
La dimensione totale del file completo da trasferire: uguale al primo
valore fornito dal a distanza e locale sottocomandi per un particolare file.
Se il server non è in grado di fornire questo valore per un file remoto da recuperare, esso
non verrà impostato. Se l'input proviene da un tubo, il valore potrebbe essere errato e
corrispondono semplicemente ad un buffer di tubo pieno.

ZFTP_COUNT
La quantità di dati finora trasferiti; un numero compreso tra zero e $ZFTP_SIZE,
se è impostato. Questo numero è sempre disponibile.

La funzione viene inizialmente chiamata con ZFTP_TRANSFER impostare in modo appropriato e
ZFTP_COUNT impostato a zero. Al termine del trasferimento, la funzione sarà
chiamato ancora una volta con ZFTP_TRANSFER impostato GF or PF, nel caso in cui desideri riordinare
su. Altrimenti non verrà mai chiamato due volte con lo stesso valore di ZFTP_COUNT.

A volte la barra di avanzamento può causare interruzioni. Sta all'utente decidere
se la funzione deve essere definita e utilizzata non funzionante quando necessario.

Problematica
Non è possibile aprire una connessione sul lato sinistro di una tubazione poiché ciò avviene in a
subshell e le informazioni sul file non vengono aggiornate nella shell principale. Nel caso di tipo
o la modalità cambia o chiude la connessione in una subshell, l'informazione viene restituita ma
le variabili non vengono aggiornate fino alla successiva chiamata a zftp. Altri cambiamenti di stato nelle subshell
non si rifletterà nelle modifiche alle variabili (ma dovrebbe essere altrimenti innocuo).

Eliminazione delle sessioni mentre a zftp il comando è attivo in background può avere effetti imprevisti
effetti, anche se non utilizza la sessione da eliminare. Questo perché tutto shell
i sottoprocessi condividono informazioni sullo stato di tutte le connessioni e sull'eliminazione di una sessione
cambia l'ordine di tali informazioni.

Su alcuni sistemi operativi, la connessione di controllo non è valida dopo un fork(), quindi
le operazioni nelle subshell, sul lato sinistro di una pipeline o in background non lo sono
possibile, come dovrebbero essere. Si tratta presumibilmente di un bug nel sistema operativo.

IL ZSH/ZLE MODULO

. zsh/zle Il modulo contiene Zsh Line Editor. Vedere zshzle(1).

IL PARAMETRO ZSH/ZLE MODULO

. parametro zsh/zle Il modulo definisce due parametri speciali che possono essere utilizzati per accedere
informazioni interne dello Zsh Line Editor (vedi zshzle(1)).

mappe dei tasti
Questo array contiene i nomi delle mappe dei tasti attualmente definite.

widget
Questo array associativo contiene una voce per widget definito. Il nome del
widget è la chiave e il valore fornisce informazioni sul widget. Lo è o
la stringa `incorporato' per i widget integrati, una stringa nel formato `utente:Nome' per
widget definiti dall'utente, dove Nome è il nome della funzione shell che implementa il file
widget, oppure è una stringa nella forma `completamento:Digitare:Nome', per il completamento
widget. Nell'ultimo caso Digitare è il nome dei widget integrati al completamento
widget imita nel suo comportamento e Nome è il nome della funzione di shell
implementare il widget di completamento.

IL ZSH/ZPROF MODULO

Una volta caricato, il zsh/zprof fa sì che le funzioni della shell vengano profilate. I risultati della profilazione
può essere ottenuto con il zprof comando integrato reso disponibile da questo modulo. Non c'è
modo per disattivare la profilazione diverso dallo scaricamento del modulo.

zprof [ -c ]
Senza il -c opzione, zprof elenca i risultati della profilazione sull'output standard. IL
format è paragonabile a quello di comandi come gprof.

In alto c'è un riepilogo che elenca tutte le funzioni che sono state richiamate almeno una volta.
Questo riepilogo è ordinato in ordine decrescente in base alla quantità di tempo trascorso in ciascuno.
Le righe contengono in ordine il numero della funzione che viene utilizzata nelle altre parti
dell'elenco in suffissi nella forma `[num]', quindi il numero di chiamate effettuate al
funzione. Le tre colonne successive elencano il tempo in millisecondi trascorso nel
funzione e i suoi discendenti, il tempo medio in millisecondi trascorso nella funzione
funzione e i suoi discendenti per chiamata e la percentuale di tempo trascorso in tutta la shell
funzioni utilizzate in questa funzione e nei suoi discendenti. Le tre colonne seguenti
danno le stesse informazioni, ma conteggiando solo il tempo trascorso nella funzione stessa.
L'ultima colonna mostra il nome della funzione.

Dopo il riepilogo, vengono fornite informazioni dettagliate su ogni funzione richiamata
elencati, ordinati in ordine decrescente in base alla quantità di tempo trascorso in ciascuna funzione e
i suoi discendenti. Ognuna di queste voci è costituita da descrizioni per le funzioni
che ha chiamato la funzione descritta, la funzione stessa e le funzioni che
furono chiamati da esso. La descrizione della funzione stessa ha lo stesso formato
come nel riepilogo (e mostra le stesse informazioni). Le altre righe non mostrano il file
numero della funzione all'inizio e il nome della funzione è rientrato
rendere più facile distinguere la linea che mostra la funzione descritta nel
sezione dalle linee circostanti.

Le informazioni mostrate in questo caso sono quasi le stesse del riepilogo, ma solo
si riferisce alla gerarchia delle chiamate visualizzata. Ad esempio, per una funzione di chiamata
la colonna che mostra il tempo di esecuzione totale elenca il tempo trascorso nella descrizione
funzione e i suoi discendenti solo per i tempi in cui venne chiamata da quella
particolare funzione di chiamata. Allo stesso modo, per una funzione chiamata, questa colonna elenca
il tempo totale trascorso nella funzione chiamata e nei suoi discendenti solo per i tempi
quando è stato chiamato dalla funzione descritta.

Anche in questo caso compare anche la colonna che riporta il numero di chiamate ad una funzione
una barra e quindi il numero totale di invocazioni effettuate alla funzione chiamata.

Finché il zsh/zprof il modulo viene caricato, la profilazione verrà eseguita e multipla
invocazioni del zprof il comando integrato mostrerà gli orari e i numeri delle chiamate
da quando il modulo è stato caricato. Con il -c opzione, il zprof il comando integrato lo farà
reimposta i suoi contatori interni e non mostrerà l'elenco.

IL ZSH/ZPTY MODULO

. zsh/zpty il modulo offre uno integrato:

zpty [ -e ] [ -b ] Nome [ arg ...]
Le argomentazioni che seguono Nome sono concatenati con spazi tra, quindi eseguiti come
un comando, come se fosse passato al eval incorporato. Il comando viene eseguito con un new
pseudo-terminale assegnato; questo è utile per eseguire comandi in modo non interattivo
che si aspettano un ambiente interattivo. IL Nome non fa parte del comando, ma
viene utilizzato per fare riferimento a questo comando nelle chiamate successive a zpty.

Grazie alla -e opzione, lo pseudo-terminale è impostato in modo che i caratteri di input siano
gli fece eco.

Grazie alla -b opzione, vengono effettuati l'input e l'output dallo pseudo-terminale
non bloccante.

Il parametro della shell REPLY è impostato sul descrittore di file assegnato al lato master
dello pseudo-terminale. Ciò consente il monitoraggio del terminale con ZLE
gestori di descrittori (vedi zshzle(1)) o manipolato con sysread e syswrite (Vedi
IL MODULO ZSH/SYSTEM in zshmodules(1)). Avvertenza: Uso di sysread e syswrite is
non è un consigliato, utilizzare zpty -r e zpty -w a meno che tu non sappia esattamente cosa sei
facendo.

zpty -d [ Nome ...]
La seconda forma, con il -d opzione, serve per cancellare i comandi precedentemente avviati,
fornendo un elenco dei loro NomeS. se no Nome viene fornito, tutti i comandi vengono cancellati.
L'eliminazione di un comando provoca l'invio del segnale HUP al processo corrispondente.

zpty -w [ -n ] Nome [ stringa ...]
. -w l'opzione può essere utilizzata per inviare il comando to Nome il dato stringaè come input
(separati da spazi). Se la -n opzione è non è un dato, viene aggiunta una nuova riga al file
fine.

Se no stringa viene fornito, lo standard input viene copiato sullo pseudo-terminale; Questo
potrebbe fermarsi prima di copiare l'intero input se lo pseudo-terminale non è bloccante.

Nota che il comando sotto lo pseudo-terminale vede questo input come se lo fosse
digitato, quindi fai attenzione quando invii caratteri speciali del driver tty come cancella parole,
line-kill e fine del file.

zpty -r [ - mt ] Nome [ param [ modello ]]
. -r l'opzione può essere utilizzata per leggere l'output del comando Nome. Con solo un Nome
argomento, l'output letto viene copiato sullo standard output. A meno che il
pseudo-terminale non è bloccante, la copia continua fino al comando sotto il
uscite pseudo-terminali; quando non blocca, solo la quantità di output immediata
disponibile viene copiato. Lo stato di ritorno è zero se viene copiato un output.

Quando viene dato anche a param argomento, al massimo una riga viene letta e memorizzata nel file
parametro denominato param. Se lo pseudo-terminale lo è, è possibile leggere meno di una riga intera
non bloccante. Lo stato di ritorno è zero se è memorizzato almeno un carattere
param.

Se un modello viene fornito anche l'output, l'output viene letto finché l'intera stringa letta non corrisponde
, il modello, anche nel caso non bloccante. Lo stato di reso è zero se il
stringa letta corrisponde al modello o se il comando è terminato ma almeno uno
il carattere potrebbe ancora essere letto. Se l'opzione -m è presente, lo stato del reso è
zero solo se il modello corrisponde. Al momento della stesura di questo documento, un massimo di un megabyte di
la produzione può essere consumata in questo modo; se viene letto un megabyte intero senza corrispondere al file
pattern, lo stato di restituzione è diverso da zero.

In tutti i casi, lo stato restituito è diverso da zero se non è possibile leggere nulla, e lo è 2 if
questo perché il comando è terminato.

Se l' -r l'opzione è combinata con -t opzione, zpty verifica se l'output è
disponibile prima di provare a leggere. Se non è disponibile alcun output, zpty subito
restituisce lo stato 1. Se utilizzato con a modello, il comportamento in caso di sondaggio fallito è
simile a quando il comando è terminato: il valore restituito è zero se almeno uno
il carattere potrebbe ancora essere letto anche se il modello non corrispondesse.

zpty -t Nome
. -t opzione senza il -r l'opzione può essere utilizzata per verificare se il comando Nome is
ancora correndo. Restituisce uno stato zero se il comando è in esecuzione e uno stato diverso da zero
valore altrimenti.

zpty [ -L ]
L'ultima forma, senza argomenti, viene utilizzata per elencare i comandi attualmente
definito. Se la -L viene fornita l'opzione, ciò avviene sotto forma di chiamate al file zpty
incorporato.

IL ZSH/ZSELEZ MODULO

. zsh/zseleziona il modulo rende disponibile un comando integrato:

zseleziona [ -rwe ] [ -t timeout ] [ -a schieramento ] [ -A Assoc ] [ fd ...]
. zseleziona builtin è un front-end per la chiamata di sistema `select', che si blocca fino a quando
un descrittore di file è pronto per la lettura o la scrittura, o presenta una condizione di errore, con
un timeout facoltativo. Se questo non è disponibile sul tuo sistema, il comando viene stampato
un messaggio di errore e restituisce lo stato 2 (gli errori normali restituiscono lo stato 1). Per più
informazioni, consultare la documentazione del sistema select(3). Nota che non c'è
connessione con l'omonimo builtin della shell.

Argomenti e opzioni possono essere mescolati in qualsiasi ordine. Gli argomenti non opzionali lo sono
descrittori di file, che devono essere numeri interi decimali. Per impostazione predefinita, i descrittori di file sono
essere testato per la lettura, ad es zseleziona tornerà quando i dati saranno disponibili
leggere dal descrittore di file, o più precisamente, quando un'operazione di lettura dal descrittore di file
il descrittore di file non si bloccherà. Dopo un -r, -w e -e, i descrittori di file specificati
devono essere testati per la lettura, la scrittura o le condizioni di errore. Queste opzioni e un
un elenco arbitrario di descrittori di file può essere fornito in qualsiasi ordine.

(La presenza di una `condizione di errore' non è ben definita nella documentazione di
molte implementazioni della chiamata di sistema select. Secondo le recenti versioni di
la specifica POSIX, è davvero un file eccezione condizione, di cui l'unica
un esempio standard sono i dati fuori banda ricevuti su un socket. Quindi lo sono gli utenti zsh
difficilmente troverai il -e opzione utile.)

L'opzione `-t timeout' specifica un timeout in centesimi di secondo. Può essere
zero, nel qual caso i descrittori di file verranno semplicemente interrogati e zseleziona andrete a
ritornare immediatamente. È possibile chiamare zselect senza descrittori di file e a
timeout diverso da zero da utilizzare come sostituto più dettagliato di "sleep"; notare, tuttavia,
lo stato di ritorno è sempre 1 per un timeout.

L'opzione `-a schieramento' indica che schieramento dovrebbe essere impostato per indicare il file
descrittore/i che sono pronti. Se l'opzione non viene fornita, l'array rispondere sarà
utilizzato per questo scopo. L'array conterrà una stringa simile agli argomenti
da zseleziona. Per esempio,

zseleziona -t 0 -r 0 -w 1

potrebbe restituire immediatamente lo stato 0 e $risposta contenente "-r 0 -w 1' mostrare
che entrambi i descrittori di file siano pronti per le operazioni richieste.

L'opzione `-A Assoc' indica che l'array associativo Assoc dovrebbe essere impostato su
indicare i descrittori di file che sono pronti. Questa opzione sovrascrive l'opzione
-a, né lo farà rispondere essere modificato. Le chiavi di Assoc sono i descrittori di file e
i valori corrispondenti sono uno qualsiasi dei caratteri `il suo' per indicare la condizione.

Il comando restituisce lo stato 0 se alcuni descrittori di file sono pronti per la lettura. Se
l'operazione è scaduta oppure è stato fornito un timeout pari a 0 e non è stato rilevato alcun descrittore di file
pronto o si è verificato un errore, restituisce lo stato 1 e l'array non verrà impostato
(né modificato in alcun modo). Se si è verificato un errore nell'operazione di selezione, il file
viene stampato il messaggio di errore appropriato.

IL ZSH/ZUTIL MODULO

. zsh/zutil il modulo aggiunge solo alcuni built-in:

stile z [ -L [ modello [ stile ] ] ]
stile z [ -e | - | -- ] modello stile stringa ...
stile z -d [ modello [ stile ...]]
stile z -g Nome [ modello [ stile ]]
stile z -{a|b|s} contesto stile Nome [ settembre ]
stile z -{T|t} contesto stile [ stringa ...]
stile z -m contesto stile modello
Questo comando integrato viene utilizzato per definire e cercare stili. Gli stili sono coppie di
nomi e valori, dove i valori sono costituiti da un numero qualsiasi di stringhe. Sono
memorizzato insieme ai modelli e la ricerca viene eseguita fornendo una stringa, chiamata the
"contesto", che viene confrontato con i modelli. La definizione memorizzata per il primo
verrà restituito il modello corrispondente.

Per ordinare i confronti, i modelli vengono cercati dal più specifico al meno specifico
specifici, e modelli che sono ugualmente specifici mantengono l’ordine in cui erano
definito. Un modello è considerato più specifico di un altro se contiene
più componenti (sottostringhe separate da due punti) o se i modelli per il
i componenti sono più specifici, dove le stringhe semplici sono considerate di più
specifici dei modelli e i modelli complessi sono considerati più specifici di
il modello `*'.

La prima forma (senza argomenti) elenca le definizioni. Gli stili sono mostrati in
l'ordine alfabetico e i modelli vengono visualizzati nell'ordine stile z li metterò alla prova.

Se l' -L viene data l'opzione, l'elenco viene effettuato sotto forma di chiamate a stile z.
il primo argomento opzionale è un modello che verrà confrontato con la stringa
fornito come modello per il contesto; notare che questo significa, ad esempio, `stile z
-L ":completamento:*"' corrisponderà a qualsiasi modello fornito che inizia con `:completamento:', non
ad appena ":completamento:*": uso ":completamento:\*" per abbinarlo. Il secondo facoltativo
argomento limita l'output a uno specifico stile (non uno schema). -L non è
compatibile con qualsiasi altra opzione.

Le altre forme sono le seguenti:

stile z [ - | -- | -e ] modello stile stringa ...
Definisce il dato stile per l' modello con la stringas come valore. Se
, il -e l'opzione è data, il stringaverranno concatenati (separati da
spazi) e la stringa risultante verrà valutata (nello stesso modo in cui è
fatto dal eval comando integrato) quando viene cercato lo stile. In questo caso
il parametro `rispondere' deve essere assegnato per impostare le stringhe restituite dopo il
valutazione. Prima di valutarne il valore, rispondere non è impostato e se è fermo
unset dopo la valutazione, lo stile viene trattato come se non fosse impostato.

stile z -d [ modello [ stile ...]]
Elimina le definizioni di stile. Senza argomenti tutte le definizioni vengono cancellate,
con una modello tutte le definizioni per quel modello vengono eliminate e, se presenti,
stiles vengono forniti, solo quegli stili vengono eliminati per il file modello.

stile z -g Nome [ modello [ stile ]]
Recuperare una definizione di stile. IL Nome viene utilizzato come nome di un array in
in cui vengono memorizzati i risultati. Senza ulteriori argomenti, tutti i modelli
definiti vengono restituiti. Con un modello gli stili definiti per quel modello sono
restituito e con entrambi a modello e stile, le stringhe di valore di quello
viene restituita la combinazione.

Gli altri moduli possono essere utilizzati per cercare o testare modelli.

stile z -s contesto stile Nome [ settembre ]
Il parametro Nome è impostato sul valore dello stile interpretato come una stringa.
Se il valore contiene più stringhe queste vengono concatenate con spazi (o
con la settembre stringa se fornita) tra di loro.

stile z -b contesto stile Nome
Il valore è memorizzato in Nome come booleano, cioè come stringa `sì' se la
value ha solo una stringa e quella stringa è uguale a uno di `sì', `vero',
`on', o `1'. Se il valore è qualsiasi altra stringa o ha più di una stringa,
il parametro è impostato su `no'.

stile z -a contesto stile Nome
Il valore è memorizzato in Nome come una matrice. Se Nome è dichiarato come an
array associativo, la prima, la terza, ecc. stringhe vengono utilizzate come chiavi e
le altre stringhe vengono utilizzate come valori.

stile z -t contesto stile [ stringa ...]
stile z -T contesto stile [ stringa ...]
Testare il valore di uno stile, ovvero il -t l'opzione restituisce solo uno stato (sets
$?). Senza alcun stringa lo stato di reso è zero se lo stile è definito
per almeno un modello corrispondente, ha solo una stringa nel suo valore e
questo è uguale a uno di `vero', `sì', `on' o `1'. Se presente stringasono dati
lo stato è zero se e solo se almeno uno dei stringas è uguale a at
almeno una delle stringhe nel valore. Se lo stile è definito ma non lo è
corrispondenza, lo stato del reso è 1. Se lo stile non è definito, lo stato lo è 2.

. -T L'opzione testa i valori dello stile like -t, ma restituisce lo stato
zero (anziché 2) se lo stile non è definito per alcun modello corrispondente.

stile z -m contesto stile modello
Abbina un valore. Restituisce lo stato zero se il modello corrisponde ad almeno uno di
le stringhe nel valore.

formato z -f param formato spec ...
formato z -a schieramento settembre spec ...
Questo built-in fornisce due diverse forme di formattazione. Viene selezionato il primo modulo
con la -f opzione. In questo caso il formato la stringa verrà modificata sostituendo
sequenze che iniziano con un segno di percentuale al suo interno con stringhe da specS. Ogni
spec dovrebbe essere nella forma `serbatoio:stringa' che causerà ogni aspetto del
sequenza `%serbatoio' in formato essere sostituito dal stringa. Il `%' sequenza può anche
contengono le specifiche facoltative relative alla larghezza minima e massima del campo tra i caratteri `%' e
il `serbatoio' nella forma `%verbale.maxc', cioè viene data prima la larghezza minima del campo e
se viene utilizzata la larghezza massima del campo, deve essere preceduta da un punto. Specificando a
la larghezza minima del campo fa sì che il risultato venga riempito con spazi a destra se il file
stringa è più corto della larghezza richiesta. L'imbottitura a sinistra può essere ottenuta tramite
dando una larghezza minima del campo negativa. Se viene specificata una larghezza massima del campo, il file
stringa verrà troncato dopo quel numero di caratteri. Dopotutto `%' sequenze per
il dato specsono stati elaborati, la stringa risultante viene archiviata nel file
parametro param.

. %-escapes comprende anche le espressioni ternarie nella forma utilizzata dai prompt. IL
% è seguito da un `(' e quindi un normale carattere identificatore di formato come descritto
Sopra. Potrebbe esserci una serie di cifre prima o dopo `('; questi specificano
un numero di prova, che per impostazione predefinita è zero. Sono ammessi anche numeri negativi. UN
il carattere delimitatore arbitrario segue l'identificatore di formato, seguito da a
pezzo di testo "vero", ancora il carattere delimitatore, un pezzo di testo "falso" e a
parentesi di chiusura. L'espressione completa (senza le cifre) appare così
`%(X.text1.text2)', tranne che il `.' è arbitrario. Il valore dato
per l'identificatore di formato nel file serbatoio:stringa le espressioni vengono valutate come a
espressione matematica e confrontata con il numero del test. Se sono uguali,
text1 viene emesso, altrimenti text2 viene emesso. È possibile inserire una parentesi text2 as
%). Entrambi text1 or text2 può contenere nidificati %-fugge.

Per esempio:

formato z -f REPLY "The rispondere is '%3(c.sì.no)'." c:3

restituisce "La risposta è 'sì'." A REPLY dal valore per l'identificatore di formato c
è 3, in accordo con l'argomento cifra dell'espressione ternaria.

La seconda forma, utilizzando il -a opzione, può essere utilizzata per allineare le stringhe. Ecco, il
specs sono della forma `a sinistra:right' dove `a sinistra' e `right' sono stringhe arbitrarie.
Queste stringhe vengono modificate sostituendo i due punti con il settembre corda e imbottitura
, il a sinistra stringhe con spazi a destra in modo che il settembre stringhe nel risultato
(e quindi il right stringhe dopo di loro) sono tutti allineati se le stringhe vengono stampate
uno sotto l'altro. Tutte le stringhe senza i due punti vengono lasciate invariate e tutte le stringhe
con un vuoto right string hanno i due punti finali rimossi. In entrambi i casi il
le lunghezze delle stringhe non vengono utilizzate per determinare come devono essere le altre stringhe
allineato. Le stringhe risultanti vengono archiviate nel file schieramento.

zregexparse
Questo implementa alcuni interni di _argomenti_regex funzione.

zparseopts [ -DKME ] [ -a schieramento ] [ -A Assoc ] spec ...
Questo integrato semplifica l'analisi delle opzioni nei parametri posizionali, ovvero il
insieme di argomentazioni fornite da $*. Ogni spec descrive un'opzione e deve essere di
forma `optare[=schieramento]'. Se un'opzione descritta da optare si trova nel posizionale
parametri in cui viene copiato schieramento specificato con il -a opzione; se la
facoltativo `=schieramento' viene fornito, viene invece copiato in quell'array.

Tieni presente che è un errore fornirne uno qualsiasi spec senza `=schieramento' a meno che uno dei -a
or -A vengono utilizzate le opzioni.

A meno che il -E viene fornita l'opzione, l'analisi si interrompe alla prima stringa che non lo è
descritto da uno dei specS. Anche con -E, l'analisi si ferma sempre in corrispondenza di un valore posizionale
parametro uguale a `-' o `--'.

. optare la descrizione deve essere una delle seguenti. Uno qualsiasi dei caratteri speciali
può apparire nel nome dell'opzione purché sia ​​preceduto da una barra rovesciata.

Nome
Nome+ . Nome è il nome dell'opzione senza il `-'. Per specificare a
Opzione lunga in stile GNU, una delle solite due iniziali `-' deve essere incluso in
Nome; ad esempio, un `--file' è rappresentata da a Nome di `-file'.

Se un `+' appare dopo Nome, l'opzione viene aggiunta schieramento ogni volta che lo è
si trova nei parametri posizionali; senza il `+' solo il ultimo evento
dell'opzione viene preservata.

Se viene utilizzata una di queste forme, l'opzione non accetta argomenti, quindi viene eseguita l'analisi
si ferma se anche il parametro posizionale successivo non inizia con `-' (salvo che
, il -E viene utilizzata l'opzione).

Nome:
Nome:-
Nome:: Se vengono forniti uno o due due punti, l'opzione accetta un argomento; con uno
due punti, l'argomento è obbligatorio mentre con due punti è facoltativo. IL
l'argomento è aggiunto a schieramento dopo l'opzione stessa.

Un argomento facoltativo viene inserito nello stesso elemento dell'array del nome dell'opzione
(nota che questo rende indistinguibili le stringhe vuote come argomenti). UN
l'argomento obbligatorio viene aggiunto come elemento separato a meno che l'argomento `:-' la forma è
utilizzato, nel qual caso l'argomento viene inserito nello stesso elemento.

un `+' come descritto sopra può apparire tra il Nome e il primo colon.

Le opzioni di zparseopts stesso sono:

-a schieramento
Come descritto sopra, questo nomina l'array predefinito in cui memorizzare il file
opzioni riconosciute.

-A Assoc
Se questo viene fornito, anche le opzioni e i loro valori vengono inseriti in un file
array associativo con i nomi delle opzioni come chiavi e gli argomenti (se presenti)
come i valori.

-D Se viene fornita questa opzione, tutte le opzioni trovate verranno rimosse dal posizionale
parametri della shell chiamante o della funzione shell, fino a ma esclusi
qualsiasi non descritto da specS. Questo è simile all'utilizzo di spostamento incorporato.

-K Con questa opzione, gli array specificati con il file -a opzione e con il
`=schieramento' vengono mantenuti invariati quando nessuno dei specs per loro viene utilizzato.
Altrimenti l'intero array viene sostituito quando uno qualsiasi dei file specviene utilizzato s.
Singoli elementi di array associativi specificati con -A l'opzione sono
conservato da -K. Ciò consente l'assegnazione di valori predefiniti agli array prima
chiamata zparseopts.

-M Ciò modifica le regole di assegnazione per implementare una mappa tra opzioni equivalenti
nomi. Se presente spec usa il `=schieramento' forma, la stringa schieramento è interpretato
come il nome di un altro spec, che viene utilizzato per scegliere dove archiviare il file
valori. Se non altro spec viene trovato, i valori vengono memorizzati come al solito. Questo
cambia solo il modo in cui i valori vengono memorizzati, non il modo $* viene analizzato, quindi
i risultati potrebbero essere imprevedibili se il `Nome+' viene utilizzato l'identificatore
incoerentemente.

-E Ciò modifica le regole di analisi in non è un fermati alla prima stringa che non lo è
descritto da uno dei specS. Può essere utilizzato per testare o (se utilizzato
insieme -D) estrae le opzioni e i relativi argomenti, ignorando tutti gli altri
opzioni e argomenti che possono essere presenti nei parametri posizionali.

Per esempio,

set -- -a -bx -c y -cz baz -cend
zparseopts a=pippo b:=barra c+:=barra

avrà l'effetto di

pippo=(-a)
bar=(-b x -c y -c z)

Le argomentazioni di `baz'on non verrà utilizzato.

Come esempio per il -E opzione, considerare:

set -- -a x -b y -c z arg1 arg2
zparseopts -E -D b:=barra

avrà l'effetto di

bar=(-b y)
set -- -a x -c z arg1 arg2

Cioè, l'opzione -b e i suoi argomenti sono presi dai parametri posizionali e
inserire nell'array bar.

. -M l'opzione può essere utilizzata in questo modo:

set -- -a -bx -c y -cz baz -cend
zparseopts -A bar -M a=pippo b+: c:=b

avere l'effetto di

pippo=(-a)
barra=(-a '' -b xyz)

Utilizza zshmodules online utilizzando i servizi onworks.net