zshmodules - En ligne dans le Cloud

PROGRAMME:

Nom

zshmodules - modules chargeables zsh

DESCRIPTION

Certaines parties facultatives de zsh sont dans des modules, séparés du noyau du shell. Chacun des
ces modules peuvent être liés au shell au moment de la construction, ou peuvent être liés dynamiquement
pendant l'exécution du shell si l'installation prend en charge cette fonctionnalité. Les modules sont liés
au moment de l'exécution avec le zmodload commande, voir zshbuiltins (1).

Les modules fournis avec la distribution zsh sont :

zsh/attr
Builtins pour manipuler les attributs étendus (xattr).

zsh/cap
Builtins pour manipuler les ensembles de capacités (privilèges) POSIX.1e (POSIX.6).

zsh/cloner
Une fonction intégrée qui peut cloner un shell en cours d'exécution sur un autre terminal.

zsh/compctl
Votre compctl intégré pour contrôler l'achèvement.

zsh/complet
Le code d'achèvement de base.

zsh/compliste
Extensions de liste d'achèvement.

zsh/compil
Un module avec des utilitaires intégrés nécessaires à la complétion basée sur la fonction shell
système.

zsh/malédictions
maudit les commandes de fenêtrage

zsh/dateheure
Quelques commandes et paramètres de date/heure.

zsh/db/gdbm
Builtins pour la gestion des paramètres de tableau associatif liés aux bases de données GDBM.

zsh/deltochar
Une fonction ZLE dupliquant EMACS' zapper en char.

zsh/exemple
Un exemple de la façon d'écrire un module.

zsh/fichiers
Certaines commandes de base de manipulation de fichiers en tant que commandes intégrées.

zsh/langinfo
Interface vers les informations locales.

zsh/fichier cartographique
Accès aux fichiers externes via un tableau associatif spécial.

zsh/foncmath
Fonctions scientifiques standard à utiliser dans les évaluations mathématiques.

zsh/nouvel utilisateur
Organisez l'installation des fichiers pour les nouveaux utilisateurs.

zsh/paramètre
Accès aux tables de hachage internes via des tableaux associatifs spéciaux.

zsh/pcre
Interface vers la librairie PCRE.

zsh/regex
Interface vers la bibliothèque de regex POSIX.

zsh/horaire
Une fonction intégrée qui fournit une fonction d'exécution chronométrée dans le shell.

zsh/net/socket
Manipulation de sockets de domaine Unix

zsh/stat
Une interface de commande intégrée au état appel système.

zsh/système
Une interface intégrée à diverses fonctionnalités système de bas niveau.

zsh/net/tcp
Manipulation de sockets TCP

zsh/termcap
Interface avec la base de données termcap.

zsh/termininfo
Interface avec la base de données terminfo.

zsh/zftp
Un client FTP intégré.

zsh/zle
L'éditeur de ligne Zsh, y compris le clé de liaison et varié intégrés.

zsh/zleparamètre
Accès aux éléments internes de l'éditeur de ligne Zsh via les paramètres.

zsh/zprof
Un module permettant le profilage des fonctions shell.

zsh/zpty
Une fonction intégrée pour démarrer une commande dans un pseudo-terminal.

zsh/zselect
Bloquer et retourner lorsque les descripteurs de fichiers sont prêts.

zsh/zutil
Certains utilitaires intégrés, par exemple celui pour prendre en charge la configuration via les styles.

L' ZSH/ATTR MODULE

Votre zsh/attr module est utilisé pour manipuler les attributs étendus. le -h l'option provoque
toutes les commandes à opérer sur des liens symboliques au lieu de leurs cibles. Les éléments intégrés dans ce
module sont:

zgetattr [ -h ] nom de fichier attribuer [ paramètre ]
Obtenir l'attribut étendu attribuer du spécifié nom de fichier. Si l'optionnel
argument paramètre est donné, l'attribut est défini sur ce paramètre au lieu de
en cours d'impression sur stdout.

zsetattr [ -h ] nom de fichier attribuer Plus-value
Définir l'attribut étendu attribuer sur le spécifié nom de fichier à Plus-value.

zdelattr [ -h ] nom de fichier attribuer
Supprimer l'attribut étendu attribuer du spécifié nom de fichier.

zlistattr [ -h ] nom de fichier [ paramètre ]
Répertorier les attributs étendus actuellement définis sur le spécifié nom de fichier. Si l'
argument optionnel paramètre est donnée, la liste des attributs est définie sur celle-ci
paramètre au lieu d'être imprimé sur stdout.

zgetattr et zlistattr allouer de la mémoire dynamiquement. Si l'attribut ou la liste de
les attributs grandissent entre l'allocation et l'appel pour les obtenir, ils renvoient 2. Sur tous
autres erreurs, 1 est renvoyé. Cela permet à la fonction appelante de vérifier ce cas et
réessayez.

L' ZSH/CAP MODULE

Votre zsh/cap module est utilisé pour manipuler les ensembles de capacités POSIX.1e (POSIX.6). Si la
système d'exploitation ne prend pas en charge cette interface, les fonctions intégrées définies par ce module
ne fais rien. Les éléments intégrés de ce module sont :

casquette [ capacités ]
Remplacez les ensembles de capacités de processus du shell par ceux spécifiés capacités, Autrement
afficher les capacités actuelles du shell.

capter nom de fichier
Il s'agit d'une implémentation intégrée de l'utilitaire standard POSIX. Il affiche le
ensembles de capacités sur chaque spécifié nom de fichier.

setcap capacités nom de fichier
Il s'agit d'une implémentation intégrée de l'utilitaire standard POSIX. Il définit le
ensembles de capacités sur chaque spécifié nom de fichier à l'spécifié capacités.

L' ZSH/CLONE MODULE

Votre zsh/cloner module rend disponible une commande intégrée :

cloner tty
Crée une instance fourchue du shell actuel, attachée au spécifié tty. En
la nouvelle coque, la PID, PPID et ATS les paramètres spéciaux sont modifiés en conséquence.
$! est mis à zéro dans le nouveau shell et au PID du nouveau shell dans l'original
coquille.

L'état de retour de la fonction intégrée est zéro dans les deux shells en cas de succès, et différent de zéro
en cas d'erreur.

La cible de cloner doit être un terminal inutilisé, comme une console virtuelle inutilisée
ou un terminal virtuel créé par

xterm -e sh -c 'piège : INT QUITTER TSTP ; tty ;
tout en :; do sleep 100000000; Fini'

Quelques mots d'explication sont justifiés à propos de cette longue ligne de commande xterm : lorsque
faire un clone sur un pseudo-terminal, une autre session ("session" signifiant comme un unix
groupe de session, ou SID) possède déjà le terminal. Par conséquent, le zsh cloné ne peut pas
acquérir le pseudo-terminal en tant que terminal de contrôle. Cela signifie deux choses :

· les signaux de contrôle de travail iront au groupe de processus sh-started-by-xterm
(c'est pourquoi nous désactivons INT QUIT et TSTP avec trap ; sinon la boucle while
pourrait être suspendu ou tué)

· le shell cloné aura le contrôle des tâches désactivé et les touches de contrôle des tâches
(contrôle-C, contrôle-\ et contrôle-Z) ne fonctionnera pas.

Ceci ne s'applique pas lors du clonage vers un inutilisé vc.

Le clonage sur un terminal utilisé (et non préparé) entraînera la lecture de deux processus
simultanément à partir du même terminal, avec des octets d'entrée allant aléatoirement à l'un ou l'autre
processus.

cloner est surtout utile en tant que remplacement intégré au shell pour openvt.

L' ZSH/COMPCTL MODULE

Votre zsh/compctl module rend disponible deux commandes intégrées. compctl, est l'ancien,
moyen déconseillé de contrôler les achèvements pour ZLE. Voir zshcompctl(1). L'autre intégré
commander, appel peut être utilisé dans les widgets de complétion définis par l'utilisateur, voir zshcompwid (1).

L' ZSH/COMPLET MODULE

Votre zsh/complet module rend disponible plusieurs commandes intégrées qui peuvent être utilisées dans
widgets de complétion définis par l'utilisateur, voir zshcompwid (1).

L' ZSH/COMPLISTE MODULE

Votre zsh/compliste Le module offre trois extensions aux listes d'achèvement : la possibilité de
mettre en évidence les correspondances dans une telle liste, la possibilité de faire défiler de longues listes et un autre
style d'achèvement du menu.

Coloré achèvement lieux
Chaque fois que l'un des paramètres ZLS_COLORS or ZLS_COULEURS est réglé et le zsh/compliste
module est chargé ou lié au shell, les listes de complétion seront colorées. Noter,
cependant, que compliquer ne sera pas automatiquement chargé s'il n'est pas lié dans : on
systèmes avec chargement dynamique, `zmodload zsh/compliste' est requis.

Les paramètres ZLS_COLORS et ZLS_COULEURS décrire comment les correspondances sont mises en évidence. Tourner
il suffit de surligner une valeur vide, auquel cas toutes les valeurs par défaut données ci-dessous
sera utilisé. Le format de la valeur de ces paramètres est le même que celui utilisé par le GNU
version de l' ls commande : une liste de spécifications séparées par des deux-points du formulaire
`prénom=Plus-value'. le prénom peut être l'une des chaînes suivantes, dont la plupart spécifient le fichier
types pour lesquels le Plus-value sera utilisé. Les chaînes et leurs valeurs par défaut sont :

aucune 0 pour du texte normal (c'est-à-dire lors de l'affichage d'autre chose qu'un fichier correspondant)

fi 0 pour les fichiers normaux

di 32 pour les répertoires

ln 36 pour les liens symboliques. Si cela a la valeur spéciale l'objectif, les liens symboliques sont
déréférencé et le fichier cible utilisé pour déterminer le format d'affichage.

pi 31 pour les canaux nommés (FIFO)

so 33 pour prises

bd 44; 37
pour les appareils en bloc

cd 44; 37
pour appareils de caractères

or aucun
pour un lien symbolique vers un fichier inexistant (la valeur par défaut est la valeur définie pour ln)

mi aucun
pour un fichier inexistant (la valeur par défaut est la valeur définie pour fi); ce code est
actuellement pas utilisé

su 37; 41
pour les fichiers avec setuid bit set

sg 30; 43
pour les fichiers avec setgid bit set

tw 30; 42
pour les répertoires inscriptibles dans le monde avec jeu de bits collants

ow 34; 43
pour les répertoires inscriptibles dans le monde sans jeu de bits collants

sa aucun
pour les fichiers avec un alias de suffixe associé ; ceci n'est testé qu'après des
suffixes, comme décrit ci-dessous

st 37; 44
pour les répertoires avec un ensemble de bits collants mais non accessibles en écriture dans le monde

ex 35 pour les fichiers exécutables

lc \e[ pour le code de gauche (voir ci-dessous)

rc m pour le bon code

tc 0 pour le caractère indiquant le type de fichier imprimé après les noms de fichiers si le
LIST_TYPES l'option est définie

sp 0 pour les espaces imprimés après les correspondances pour aligner la colonne suivante

ec aucun
pour le code de fin

En dehors de ces cordes, le prénom peut également être un astérisque (`*') suivi de n'importe quelle chaîne.
Votre Plus-value donné pour une telle chaîne sera utilisé pour tous les fichiers dont le nom se termine par le
chaîne de caractères. Les prénom peut aussi être un signe égal (`=') suivi d'un motif ; la
EXTENDED_GLOB sera activée pour l'évaluation du motif. le Plus-value donné pour
ce modèle sera utilisé pour toutes les correspondances (pas seulement les noms de fichiers) dont la chaîne d'affichage est
correspond au motif. Les définitions de la forme précédée du signe égal prennent
priorité sur les valeurs définies pour les types de fichiers, qui à leur tour ont priorité sur les
forme avec l'astérisque de tête (extensions de fichier).

La forme de début d'égalité permet également de colorer différentes parties des chaînes affichées
différemment. Pour cela, le modèle doit utiliser le `(#b)' drapeau global et paires de
parenthèses entourant les parties des cordes qui doivent être colorées différemment. Dans
ce cas le Plus-value peut consister en plusieurs codes de couleur séparés par des signes égaux. le
le premier code sera utilisé pour toutes les pièces pour lesquelles aucun code explicite n'est spécifié et le
les codes suivants seront utilisés pour les parties correspondant aux sous-modèles entre parenthèses.
Par exemple, la spécification `=(#b)(?)*(?)=0=3=7' sera utilisé pour tous les matchs qui sont
au moins deux caractères et utilisera le code `3' pour le premier caractère, `7' pour
le dernier caractère et `0' pour le reste.

Les trois formes de prénom peut être précédé d'un motif entre parenthèses. Si cela est donné,
le Plus-value sera utilisé uniquement pour les correspondances dans les groupes dont les noms correspondent au modèle
donné entre parenthèses. Par exemple, `(g*)m*=43' met en évidence tous les matchs commençant par
`m' dans les groupes dont les noms commencent par `g' en utilisant le code couleur '43'. En cas de `lc',
`rc', et 'ec', le modèle de groupe est ignoré.

Notez également que tous les modèles sont essayés dans l'ordre dans lequel ils apparaissent dans le paramètre
valeur jusqu'à ce que le premier corresponde qui est ensuite utilisé.

Lors de l'impression d'une correspondance, le code imprime la valeur de lc, la valeur du type de fichier ou le
dernière spécification correspondante avec un `*', la valeur de rc, la chaîne à afficher pour le
correspond à lui-même, puis la valeur de ec si cela est défini ou les valeurs de lc, aucune et rc
if ec n'est pas défini.

Les valeurs par défaut sont conformes à la norme ISO 6429 (ANSI) et peuvent être utilisées sur la compatibilité vt100
terminaux tels que xterms. Sur les terminaux monochromes, les valeurs par défaut n'auront pas
effet. La les couleurs la fonction de la contribution peut être utilisée pour obtenir des tableaux associatifs
contenant les codes des terminaux ANSI (voir la section « Autres fonctions » dans
zshcontrib(1)). Par exemple, après avoir chargé les couleurs, on pourrait utiliser `$couleurs[rouge]' pour obtenir
le code pour la couleur de premier plan rouge et `$couleurs[bg-vert]' pour le code du fond
la couleur verte.

Si le système de complétion invoqué par compinit est utilisé, ces paramètres ne doivent pas être définis
directement parce que le système les contrôle lui-même. Au lieu de cela, le liste-couleurs le style devrait
être utilisé (voir la section `Terminer la configuration du système' dans zshcompsys(1)).

Défilement in achèvement lieux
Pour permettre le défilement dans une liste de complétion, le INVITE LISTE paramètre doit être défini. Son
la valeur sera utilisée comme invite ; s'il s'agit de la chaîne vide, une invite par défaut sera
utilisé. La valeur peut contenir des échappements de la forme `%x'. Il supporte les fuites `%B',
`%b', '%S', '%s', '%U', '%u', '%F', '%f', '%K', '%k' et '%{ %}' utilisé aussi en shell
invites ainsi que trois paires de séquences supplémentaires : a `%l' ou '%L' est remplacé par le
numéro de la dernière ligne affichée et le nombre total de lignes sous la forme `nombre/la totalité de votre cycle de coaching doit être payée avant votre dernière session.'; une
`%m' ou '%M' est remplacé par le numéro de la dernière correspondance affichée et le nombre total de
allumettes; et `%p' ou '%P' est remplacé par 'Bien', 'Bas et Leggings' ou la position du premier
ligne affichée en pourcentage du nombre total de lignes, respectivement. Dans chacun de ces cas
le formulaire avec la lettre majuscule sera remplacé par une chaîne de largeur fixe, rembourrée
à droite avec des espaces, tandis que la forme minuscule ne sera pas remplie.

Si le paramètre INVITE LISTE est défini, le code d'achèvement ne demandera pas si la liste doit être
montré. Au lieu de cela, il commence immédiatement à afficher la liste, s'arrêtant après le premier
plein écran, affichant l'invite en bas, en attente d'une pression sur une touche après temporairement
passer à la défilement de listes carte du clavier. Certaines des fonctions zle ont une signification particulière
lors du défilement des listes :

envoi-pause
arrête la liste rejetant la touche enfoncée

ligne d'acceptation, bas-histoire, descendance-ou-histoire
downline-ou-recherche, vi-down-line-ou-historique
fait défiler une ligne vers l'avant

mot-complet, menu-complet, développer ou compléter
développer-ou-compléter-préfixe, menu-compléter-ou-développer
fait défiler vers l'avant d'un écran

accepter-rechercher
arrêter la liste mais ne prendre aucune autre mesure

Tous les autres caractères arrêtent la liste et traitent immédiatement la clé comme d'habitude. N'importe quelle clé
qui n'est pas lié dans le défilement de listes keymap ou qui est lié à clé-non définie est recherché
dans le clavier actuellement sélectionné.

Quant au ZLS_COLORS et ZLS_COULEURS paramètres, INVITE LISTE ne doit pas être réglé directement
lors de l'utilisation du système de complétion basé sur les fonctions du shell. Au lieu de cela, le liste-invite Catégorie
Devrait être utilisé.

Menu sélection
Votre zsh/compliste le module offre également un style alternatif de sélection de correspondances dans une liste,
appelée sélection de menu, qui peut être utilisée si le shell est configuré pour revenir au dernier
invite après avoir affiché une liste d'achèvement (voir le ALWAYS_LAST_PROMPT option
achats(1)).

La sélection de menu peut être invoquée directement par le widget menu-sélection défini par ce module.
Il s'agit d'un widget ZLE standard qui peut être lié à une clé de la manière habituelle décrite dans
zshzle (1).

Alternativement, le paramètre MENUSÉLECTIONNER peut être défini sur un nombre entier, ce qui donne le minimum
nombre de correspondances qui doivent être présentes avant que la sélection de menu soit automatiquement activée.
Cette deuxième méthode nécessite que l'achèvement du menu soit lancé, soit directement à partir d'un widget
tel que menu-complet, ou en raison de l'une des options MENU_COMPLET or AUTO_MENU en cours de définition.
If MENUSÉLECTIONNER est défini, mais est 0, 1 ou vide, la sélection de menu sera toujours lancée pendant
une fin de menu ambiguë.

Lors de l'utilisation du système de complétion basé sur des fonctions shell, le MENUSÉLECTIONNER paramètre doit
pas être utilisé (comme le ZLS_COLORS et ZLS_COULEURS paramètres décrits ci-dessus). Au lieu,
le menu style doit être utilisé avec le sélectionner = mot-clé.

Une fois la sélection du menu lancée, les correspondances seront répertoriées. S'il y a plus de correspondances
que de tenir sur l'écran, seul le premier écran est affiché. Les allumettes à insérer dans le
la ligne de commande peut être sélectionnée dans cette liste. Dans la liste, une correspondance est mise en évidence en utilisant
la valeur pour ma du ZLS_COLORS or ZLS_COULEURS paramètre. La valeur par défaut pour ce
est `7' qui force la correspondance sélectionnée à être mise en surbrillance en utilisant le mode standout sur un
terminal compatible vt100. Si ni l'un ni l'autre ZLS_COLORS ni ZLS_COULEURS est réglé, le même
séquence de contrôle du terminal comme pour le `%S' escape dans les invites est utilisé.

S'il y a plus de correspondances qu'il n'y en a sur l'écran et que le paramètre INVITE MENU est réglé, son
la valeur sera affichée sous les correspondances. Il prend en charge les mêmes séquences d'échappement que
INVITE LISTE, mais le numéro de la correspondance ou de la ligne affiché sera celui de celui où le
la marque est placée. Si sa valeur est la chaîne vide, une invite par défaut sera utilisée.

Votre DÉFILEMENT Le paramètre peut être utilisé pour spécifier comment la liste défile. Si la
le paramètre n'est pas défini, cela se fait ligne par ligne, s'il est défini sur `0' (zéro), la liste sera
faire défiler la moitié du nombre de lignes de l'écran. Si la valeur est positive, cela donne
nombre de lignes à faire défiler et s'il est négatif, la liste défilera le nombre de
lignes de l'écran moins la valeur (absolue).

Quant au ZLS_COLORS, ZLS_COULEURS et INVITE LISTE paramètres, ni INVITE MENU ni
DÉFILEMENT doit être défini directement lors de l'utilisation du système de complétion basé sur les fonctions du shell.
Au contraire, le invite de sélection et sélectionner-faire défiler les styles doivent être utilisés.

Le code d'achèvement décide parfois de ne pas afficher toutes les correspondances dans la liste. Ces
les correspondances cachées sont soit des correspondances pour lesquelles la fonction de complétion qui les a ajoutées
explicitement demandé qu'ils n'apparaissent pas dans la liste (en utilisant le -n choix du Compad
commande intégrée) ou ce sont des correspondances qui dupliquent une chaîne déjà dans la liste (parce que
ils ne diffèrent que par des éléments tels que des préfixes ou des suffixes qui ne sont pas affichés). Dans la liste
utilisé pour la sélection du menu, cependant, même ces correspondances sont affichées afin qu'il soit possible de
les sélectionner. Pour mettre en évidence ces correspondances, le hi et du capacités dans le ZLS_COLORS et
ZLS_COULEURS les paramètres sont pris en charge pour les correspondances cachées du premier et du deuxième type,
respectivement.

La sélection des correspondances se fait en déplaçant la marque à l'aide des fonctions de mouvement zle.
Lorsque tous les matchs ne peuvent pas être affichés à l'écran en même temps, la liste défile vers le haut
et vers le bas lorsque vous franchissez la ligne du haut ou du bas. Les fonctions zle suivantes ont des
sens lors de la sélection du menu. Notez que les suivants effectuent toujours la même tâche
dans la carte de sélection de menu et ne peut pas être remplacé par des widgets définis par l'utilisateur, pas plus que le
ensemble de fonctions être étendu :

ligne d'acceptation, accepter-rechercher
accepter la correspondance actuelle et quitter la sélection du menu (mais ne pas provoquer la commande
ligne à accepter)

envoi-pause
quitte la sélection du menu et restaure le contenu précédent de la ligne de commande

réafficher, écran propre
exécuter leur fonction normale sans quitter la sélection du menu

accepter et retenir, accepter-et-menu-complet
accepter la correspondance actuellement insérée et continuer la sélection permettant de sélectionner le
prochaine correspondance à insérer dans la ligne

accepter-et-inférer-histoire-suivante
accepte la correspondance actuelle, puis essaie à nouveau de terminer avec la sélection de menu ; dans
le cas des fichiers, cela permet de sélectionner un répertoire et d'essayer immédiatement de
remplir les fichiers qu'il contient ; s'il n'y a pas de correspondance, un message s'affiche et on peut utiliser
défaire pour revenir à l'achèvement au niveau précédent, une touche sur deux quitte le menu
sélection (y compris les autres fonctions zle qui sont par ailleurs spéciales pendant
sélection de menus)

défaire supprime les correspondances insérées lors de la sélection du menu par l'une des trois fonctions
avant

bas-histoire, descendance-ou-histoire
vi-down-line-ou-historique, downline-ou-recherche
déplace la marque d'une ligne vers le bas

historique, up-line-ou-historique
vi-up-line-ou-historique, up-line-ou-recherche
déplace la marque d'une ligne vers le haut

avant-char, vi-forward-char
déplace la marque d'une colonne vers la droite

caractère-arrière, vi-backward-char
déplace la marque d'une colonne vers la gauche

avant-mot, mot-avant-vi
vi-forward-mot-fin, emacs-avant-mot
déplace la marque d'un écran vers le bas

mot-arrière, vi-mot-arrière, emacs-mot-en arrière
déplace la marque d'un écran vers le haut

vi-forward-vierge-mot, vi-forward-vierge-mot-fin
déplace la marque à la première ligne du groupe de matchs suivant

vi-mot-vide-en arrière
déplace la marque à la dernière ligne du groupe de matchs précédent

début-de-l'histoire
déplace la marque à la première ligne

fin de l'histoire
déplace la marque à la dernière ligne

début-de-tampon-ou-historique, début de ligne
début-de-ligne-hist, vi-début-de-ligne
déplace la marque vers la colonne la plus à gauche

fin-de-tampon-ou-historique, fin de ligne
historique de fin de ligne, vi-fin de ligne
déplace la marque vers la colonne la plus à droite

mot-complet, menu-complet, développer ou compléter
développer-ou-compléter-préfixe, menu-développer-ou-compléter
déplace la marque au prochain match

menu-inverse-complet
déplace la marque à la correspondance précédente

vi-insérer
cela bascule entre le mode normal et interactif ; en mode interactif les touches
lié à auto-insertion et auto-insert-unmeta insérer dans la ligne de commande comme dans
mode d'édition normal mais sans quitter la sélection du menu ; après chaque caractère
l'achèvement est réessayé et la liste change pour ne contenir que les nouvelles correspondances ; la
les widgets de complétion permettent d'insérer la chaîne non ambiguë la plus longue dans la commande
ligne et défaire et back-delete-char revenir à la série de matchs précédente

historique-incrémental-recherche-avant
historique-recherche-incrémentale-en arrière
cela lance des recherches incrémentales dans la liste des complétions affichées ; dans ce
Mode, ligne d'acceptation ne laisse que la recherche incrémentale, retour au menu normal
mode de selection

Toutes les fonctions de mouvement s'enroulent sur les bords ; toute autre fonction zle non répertoriée laisse
sélection de menu et exécute cette fonction. Il est possible de faire des widgets dans ce qui précède
list faites de même en utilisant la forme du widget avec un `.' devant. Par exemple, le
widget `.accepter-ligne' a pour effet de quitter la sélection du menu et d'accepter l'intégralité
ligne de commande.

Lors de cette sélection, le widget utilise le keymap menusélectionner. Toute clé qui n'est pas définie
dans ce keymap ou qui est lié à clé-non définie est recherché dans le keymap actuellement
choisi. Ceci est utilisé pour s'assurer que les touches les plus importantes utilisées lors de la sélection
(à savoir les touches curseur, retour et TAB) ont des valeurs par défaut sensibles. Cependant, les clés du
menusélectionner keymap peut être modifié directement en utilisant le clé de liaison commande intégrée (voir
zshmodules(1)). Par exemple, pour que la touche retour quitte la sélection du menu sans accepter
le match actuellement sélectionné, on pourrait appeler

clé de liaison -M menusélectionner '^M' envoi-pause

après avoir chargé le zsh/compliste module.

L' ZSH/COMPUTIL MODULE

Votre zsh/compil module ajoute plusieurs commandes intégrées qui sont utilisées par certains des
fonctions de complétion dans le système de complétion basées sur des fonctions shell (voir zshcompsys(1)
). À l'exception de faire une citation ces commandes intégrées sont très spécialisées et donc pas très
intéressant lors de l'écriture de vos propres fonctions de complétion. En résumé, ces éléments intégrés
les commandes sont :

arguments comp
Ceci est utilisé par le _arguments fonction pour faire l'argument et la ligne de commande
l'analyse. Comme compdécrire il a une option -i pour faire l'analyse et initialiser
un état interne et diverses options pour accéder aux informations d'état pour décider
ce qui doit être complété.

compdécrire
Ceci est utilisé par le _décris fonction pour construire les affichages pour les matchs et pour
obtenir les chaînes à ajouter en tant que correspondances avec leurs options. Au premier appel, l'un des
Options -i or -I doit être fourni comme premier argument. Dans le premier cas,
des chaînes d'affichage sans les descriptions seront générées, dans le second cas, le
La chaîne utilisée pour séparer les correspondances de leurs descriptions doit être donnée comme
deuxième argument et les descriptions (le cas échéant) seront affichées. Tous les autres arguments
sont comme les arguments de définition à _décris elle-même.

Une fois compdécrire a été appelé avec soit le -i ou l' -I option, il peut être
appelé à plusieurs reprises avec le -g option et les noms de quatre paramètres comme son
arguments. Cela fera défiler les différents ensembles de correspondances et stockera les
valeur de compstate[liste] dans le premier scalaire, les options pour Compad dans la seconde
tableau, les correspondances dans le troisième tableau et les chaînes à afficher dans le
liste d'achèvement dans le quatrième tableau. Les tableaux peuvent alors être directement donnés à
Compad pour enregistrer les correspondances avec le code d'achèvement.

fichiers de compilation
Utilisé par le _chemin_fichiers fonction pour optimiser la génération de noms de fichiers récursifs complexes
(globe). Il fait trois choses. Avec le -p et -P options, il construit le glob
modèles à utiliser, y compris les chemins déjà traités et essayer d'optimiser le
modèles par rapport au préfixe et au suffixe de la ligne et de la correspondance
spécification actuellement utilisée. le -i l'option fait le répertoire des tests pour le
ignorer-parents le style et le -r l'option teste si un composant pour certaines des correspondances
sont égaux à la chaîne sur la ligne et supprime toutes les autres correspondances si cela est vrai.

groupes comp
Utilisé par le _Mots clés fonction pour mettre en œuvre les éléments internes de la commande-groupe de style.
Cela ne prend que ses arguments comme noms de groupes d'achèvement et crée les groupes
pour cela (tous les six types : triés et non triés, tous deux sans supprimer les doublons, avec
suppression de tous les doublons et suppression des doublons consécutifs).

faire une citation [ -p ] noms
Il peut y avoir des raisons d'écrire des fonctions de complétion qui doivent ajouter les correspondances
en utilisant l' -Q Option de Compad et effectuer eux-mêmes la citation. À la place de
interpréter le premier caractère du all_quotes clé de la faire état spécial
l'association et en utilisant le q indicateur pour les extensions de paramètres, on peut utiliser cette fonction intégrée
commander. Les arguments sont les noms des paramètres scalaires ou matriciels et les valeurs
de ces paramètres sont cités selon les besoins pour le niveau de cotation le plus interne. Si la
-p option est donnée, la citation est faite comme s'il y avait un préfixe avant les valeurs de
les paramètres, de sorte qu'un signe égal non significatif ne soit pas indiqué.

Le statut de retour est non nul en cas d'erreur et nul dans le cas contraire.

balises comp
pays
Ceux-ci implémentent les éléments internes du mécanisme des balises.

valeurs comp
J'aime arguments comp, mais pour le _valeurs la fonction.

L' ZSH/MALÉDICTION MODULE

Votre zsh/malédictions module rend disponible une commande intégrée et divers paramètres.

Intégré
les malédictions init
les malédictions fin
les malédictions ajouterwin cibler nlignes ncols commencer_y début_x [ parentwin ]
les malédictions Delwin cibler
les malédictions rafraîchir [ cibler ...]
les malédictions -nous cibler
les malédictions Bougez cibler nouvelle y nouveau_x
les malédictions clair cibler [ redessiner | eol | bot ]
les malédictions position cibler tableau
les malédictions carboniser cibler caractère
les malédictions un magnifique cibler un magnifique
les malédictions frontière cibler frontière
les malédictions attribut cibler [[+|-]attribuer | fg_col/bg_col ] [...] [...]
les malédictions bg cibler [[+|-]attribuer | fg_col/bg_col | @carboniser ] [...] [...]
les malédictions volute cibler [ on | de rabais | [+|-]lignes ]
les malédictions contribution cibler [ arrêter [ kparam [ mparam ] ] ]
les malédictions souris [ retarder num | [+|-]mouvement ]
les malédictions temps mort cibler intervalle
les malédictions char de requête cibler [ arrêter ]
Manipulez les fenêtres de malédictions. Toutes les utilisations de cette commande doivent être encadrées par
`les malédictions init' pour initialiser l'utilisation des malédictions, et `les malédictions fin' pour y mettre fin ; en omettant
`les malédictions fin' peut mettre le terminal dans un état indésirable.

La sous-commande ajouterwin crée une fenêtre avec nlignes lignes et ncols Colonnes. Son
le coin supérieur gauche sera placé à la ligne commencer_y et colonne début_x de l'écran.
cibler est une chaîne et fait référence au nom d'une fenêtre qui n'est pas actuellement
attribué. Notez en particulier la convention des malédictions selon laquelle les valeurs verticales apparaissent
avant les valeurs horizontales.

If ajouterwin reçoit une fenêtre existante comme argument final, la nouvelle fenêtre est
créé en tant que sous-fenêtre de parentwin. Cela diffère d'une nouvelle fenêtre ordinaire dans
que la mémoire du contenu de la fenêtre est partagée avec la mémoire des parents.
Les sous-fenêtres doivent être supprimées avant leur parent. Notez que les coordonnées de
les sous-fenêtres sont relatives à l'écran, pas au parent, comme avec les autres fenêtres.

Utilisez la sous-commande Delwin pour supprimer une fenêtre créée avec ajouterwin. Noter que fin
pas supprimer implicitement des fenêtres, et que Delwin n'efface pas l'image à l'écran
de la fenêtre.

La fenêtre correspondant à l'écran plein visible est appelée stdscr; c'est toujours
existe après `les malédictions init' et ne peut pas être supprimé avec Delwin.

La sous-commande rafraîchir rafraîchira la fenêtre cibler; cela est nécessaire pour faire tout
modifications en attente (comme les caractères que vous avez préparés pour la sortie avec carboniser) visibles
sur l'écran. rafraîchir sans argument provoque l'effacement de l'écran et
redessiné. Si plusieurs fenêtres sont données, l'écran est mis à jour une fois à la fin.

La sous-commande -nous marque le ciblerest répertorié comme modifié. Ceci est nécessaire
avant rafraîchirfenêtres si une fenêtre qui était devant une autre fenêtre (qui
peut être stdscr) est supprimé.

La sous-commande Bougez déplace la position du curseur dans cibler à de nouvelles coordonnées nouvelle y
et nouveau_x. Notez que la sous-commande un magnifique (mais pas la sous-commande carboniser) avance
la position du curseur sur les caractères ajoutés.

La sous-commande clair efface le contenu de cibler. Un (et pas plus d'un)
de trois options peuvent être spécifiées. Avec la possibilité redessiner, en plus du prochain
rafraîchir of cibler provoquera l'effacement et la repeinture de l'écran. Avec le
option eol, cibler n'est effacé que jusqu'à la fin de la ligne actuelle du curseur. Avec
l'option bot, cibler est effacé jusqu'à la fin de la fenêtre, c'est-à-dire tout à
à droite et en dessous le curseur est effacé.

La sous-commande position écrit diverses positions associées à cibler into the
tableau nommé tableau. Ce sont, dans l'ordre :
- Les coordonnées y et x du curseur par rapport au coin supérieur gauche de cibler
- Les coordonnées y et x du coin supérieur gauche de cibler sur l'écran
- La taille de cibler en dimensions y et x.

La sortie des caractères et des chaînes est réalisée par carboniser et un magnifique respectivement.

Pour dessiner une bordure autour de la fenêtre cibler, utilisation frontière. Notez que la frontière n'est pas
ensuite traité spécialement : en d'autres termes, la frontière n'est qu'un ensemble de
caractères affichés au bord de la fenêtre. Par conséquent, il peut être écrasé, peut
faire défiler la fenêtre, etc.

La sous-commande attribut va définir ciblerles attributs de ou la couleur de premier plan/arrière-plan
paire pour toute sortie de caractères successive. Chaque attribuer donné sur la ligne peut être
précédé d'un + à définir ou un - pour désactiver cet attribut ; + est supposé s'il est absent.
Les attributs pris en charge sont cligner des yeux, goupille, dim, inverser, standout et souligner.

Chaque fg_col/bg_col attribut (à lire comme `fg_col on bg_col') définit le premier plan
et la couleur d'arrière-plan pour la sortie des caractères. La couleur défaut est parfois
disponible (en particulier si la bibliothèque est ncurses), en précisant le premier plan ou
couleur de fond avec laquelle le terminal a démarré. La paire de couleurs par défaut/par défaut
est toujours disponible.

bg remplace la couleur et les autres attributs de tous les caractères de la fenêtre. Son
l'utilisation habituelle est de définir l'arrière-plan initialement, mais cela écrasera les attributs
de n'importe quel caractère au moment où il est appelé. En plus des arguments
autorisé avec attribut, une dispute @carboniser spécifie un caractère à afficher dans le cas contraire
zones vides de la fenêtre. En raison des limitations des malédictions, cela ne peut pas être un
caractère multi-octets (l'utilisation de caractères ASCII uniquement est recommandée). Comme le
l'ensemble d'attributs spécifié remplace l'arrière-plan existant, en transformant les attributs
off dans les arguments n'est pas utile, bien que cela ne provoque pas d'erreur.

La sous-commande volute peut être utilisé avec on or de rabais pour activer ou désactiver le défilement de
une fenêtre lorsque le curseur se déplacerait autrement sous la fenêtre en raison de la frappe ou
sortir. Il peut également être utilisé avec un entier positif ou négatif pour faire défiler le
fenêtre vers le haut ou vers le bas du nombre de lignes donné sans changer le curseur actuel
position (qui semble donc se déplacer en sens inverse par rapport à la
la fenêtre). Dans le second cas, si le défilement est de rabais il est temporairement tourné on à
permet de faire défiler la fenêtre.

La sous-commande contribution lit un seul caractère de la fenêtre sans lui faire écho
dos. Si arrêter est fourni le caractère est affecté au paramètre arrêter, autre
il est affecté au paramètre RÉPONDRE.

Si les deux arrêter et kparam sont fournis, la clé est lue en mode 'clavier'. Dans ce
les touches spéciales de mode telles que les touches de fonction et les touches fléchées renvoient le nom de la touche
dans le paramètre kparam. Les noms de clé sont les macros définies dans le malédictions.h or
ncurses.h avec le préfixe `CLÉ_' supprimé; voir aussi la description du paramètre
zcurses_keycodes au dessous de. D'autres clés entraînent la définition d'une valeur dans arrêter comme avant. Au
un retour réussi un seul des arrêter or kparam contient une chaîne non vide ; la
other est défini sur une chaîne vide.

If mparam est également fourni, contribution tente de gérer l'entrée de la souris. C'est seulement
disponible avec la bibliothèque ncurses ; la manipulation de la souris peut être détectée en vérifiant
l'état de sortie de `les malédictions souris' sans argument. Si un bouton de la souris est cliqué
(ou double ou triple clic, ou enfoncé ou relâché avec un délai configurable
d'être cliqué) puis kparam est défini sur la chaîne SOURIS et mparam est défini sur un
tableau composé des éléments suivants :
- un identifiant pour discriminer les différents périphériques d'entrée ; ce n'est que rarement
utile.
- Les coordonnées x, y et z du clic de souris par rapport au plein écran,
comme trois éléments dans cet ordre (c'est-à-dire que la coordonnée y est, exceptionnellement, après
la coordonnée x). La coordonnée z n'est disponible que pour quelques rares
périphériques d'entrée et est sinon mis à zéro.
- Tous les événements qui se sont produits en tant qu'éléments distincts ; généralement il n'y en aura qu'un.
Un événement consiste en PRESSÉ, LIBÉRÉ, CLIQUER, DOUBLE_CLIC or
TRIPLE_CLICKÉ suivi immédiatement (dans le même élément) du nombre de
le bouton.
- Si la touche majuscule a été enfoncée, la chaîne SHIFT.
- Si la touche de commande a été enfoncée, la chaîne CTRL.
- Si la touche alt a été enfoncée, la chaîne ALT.

Tous les événements de souris ne peuvent pas être transmis à la fenêtre du terminal ; la plupart des terminaux
les émulateurs gèrent eux-mêmes certains événements de souris. Notez que le manuel ncurses
implique que l'utilisation de l'entrée avec et sans manipulation de la souris peut entraîner la
curseur pour apparaître et disparaître.

La sous-commande souris peut être utilisé pour configurer l'utilisation de la souris. Il n'y a pas
argument de fenêtre ; les options de la souris sont globales. `les malédictions souris' sans argument
renvoie le statut 0 si la manipulation de la souris est possible, sinon le statut 1. Sinon, le
les arguments possibles (qui peuvent être combinés sur la même ligne de commande) sont les suivants.
retarder num définit le délai maximum en millisecondes entre les événements de presse et de relâchement
être considéré comme un clic ; la valeur 0 désactive la résolution des clics, et la valeur par défaut
est un sixième de seconde. mouvement précédé d'une option `+' (la valeur par défaut) ou -
active ou désactive le signalement des mouvements de la souris en plus des clics, pressions et
rejets, qui sont toujours signalés. Cependant, il apparaît des rapports pour le mouvement de la souris
ne sont pas actuellement mis en œuvre.

La sous-commande temps mort spécifie une valeur de délai d'attente pour l'entrée de cibler. Si
intervalle est négatif, `les malédictions contribution' attend indéfiniment qu'un caractère soit tapé ;
c'est la valeur par défaut. Si intervalle est zéro, `les malédictions contribution' revient immédiatement ; si
il y a une avance de frappe, il est renvoyé, sinon aucune entrée n'est effectuée et l'état 1 est renvoyé.
If intervalle est positif, `les malédictions contribution' attend intervalle millisecondes pour l'entrée et si
il n'y en a pas à la fin de cette période renvoie le statut 1.

La sous-commande char de requête interroge le caractère à la position actuelle du curseur. le
les valeurs de retour sont stockées dans le tableau nommé arrêter si fourni, sinon dans le tableau
répondre. La première valeur est le caractère (qui peut être un caractère multi-octets si le
système les prend en charge); la seconde est la paire de couleurs dans l'habituel fg_col/bg_col
notation, ou 0 si la couleur n'est pas prise en charge. Tout attribut autre que la couleur qui
appliquer au caractère, tel que défini avec la sous-commande attribut, apparaissent comme supplémentaires
éléments.

Paramètres
ZCURSES_COLORS
Entier en lecture seule. Le nombre maximum de couleurs que le terminal prend en charge. Cette valeur
est initialisé par la bibliothèque curses et n'est pas disponible avant la première fois
les malédictions init est exécuté.

ZCURSES_COLOR_PAIRS
Entier en lecture seule. Le nombre maximum de paires de couleurs fg_col/bg_col cela peut etre
défini dans `les malédictions attribut' commandes ; notez que cette limite s'applique à toutes les paires de couleurs qui
ont été utilisés, qu'ils soient actuellement actifs ou non. Cette valeur est initialisée
par la bibliothèque des malédictions et n'est pas disponible avant la première fois les malédictions init is
fonctionner.

zcurses_attrs
Tableau en lecture seule. Les attributs supportés par zsh/malédictions; disponible dès que le
module est chargé.

zcurses_colors
Tableau en lecture seule. Les couleurs soutenues par zsh/malédictions; disponible dès que le
module est chargé.

zcurses_keycodes
Tableau en lecture seule. Les valeurs qui peuvent être retournées dans le deuxième paramètre fourni
à `les malédictions contribution' dans l'ordre dans lequel ils sont définis en interne par les malédictions.
Toutes les touches de fonction ne sont pas répertoriées, seulement F0; les malédictions réservent de l'espace pour F0 jusqu'à F63.

zcurses_windows
Tableau en lecture seule. La liste actuelle des fenêtres, c'est-à-dire toutes les fenêtres qui ont été
créé avec `les malédictions ajouterwin' et non supprimé avec `les malédictions Delwin'.

L' ZSH/DATEHEURE MODULE

Votre zsh/dateheure module rend disponible une commande intégrée :

strftime [ -s scalaire ] le format époque
strftime -r [ -q ] [ -s scalaire ] le format chaîne de temps
Sortir la date indiquée par époque dans le le format spécifié. Voir strftime(3) pour
des détails. Les extensions zsh décrites dans la section EXPANSION DES SÉQUENCES D'INVITES
in zshmisc(1) sont également disponibles.

-q Courez tranquillement; supprimer l'impression de tous les messages d'erreur décrits ci-dessous.
Erreurs pour invalide époque les valeurs sont toujours imprimées.

-r Avec la possibilité -r (inverse), utiliser le format pour analyser la chaîne d'entrée
chaîne de temps et afficher le nombre de secondes depuis l'époque à laquelle le
le temps s'est passé. L'analyse est implémentée par la fonction système l'heure du strp;
sur le lien l'heure du strp(3). Cela signifie que les extensions au format zsh ne sont pas disponibles,
mais pour la recherche inversée, ils ne sont pas nécessaires.

Dans la plupart des implémentations de strftime n'importe quel fuseau horaire dans le chaîne de temps is
ignoré et le fuseau horaire local déclaré par le TZ variable d'environnement est
utilisé; les autres paramètres sont mis à zéro s'ils ne sont pas présents.

If chaîne de temps ne correspond pas le format la commande renvoie l'état 1 et imprime
un message d'erreur. Si chaîne de temps allumettes le format mais pas tous les personnages de
chaîne de temps ont été utilisés, la conversion réussit mais imprime également une erreur
par voie électronique.

Si l'un des fonctions du système l'heure du strp or mktime n'est pas disponible,
l'état 2 est renvoyé et un message d'erreur est imprimé.

-s scalaire
Attribuez la chaîne de date (ou l'heure d'époque en secondes si -r est donné) à scalaire
au lieu de l'imprimer.

Notez que selon le type de temps intégral déclaré par le système, strftime Au cours de cette réunion, Matthew a obtenu de précieux conseils et Linda lui a demandé de la tenir au courant de ses progrès.
produire des résultats incorrects pour les époques supérieures à 2147483647, ce qui correspond
to 2038-01-19 03:14:07 +0000.

Votre zsh/dateheure le module met à disposition plusieurs paramètres ; tous sont en lecture seule :

EPOCHRÉALTIME
Une valeur à virgule flottante représentant le nombre de secondes depuis l'époque. le
la précision notionnelle est de la nanoseconde si la horloge_gettime appel est disponible et à
microsecondes sinon, mais en pratique la gamme de double précision flottante
les latences d'ordonnancement des points et des shells peuvent être des effets importants.

TEMPS SECONDES
Une valeur entière représentant le nombre de secondes depuis l'époque.

époque
Une valeur de tableau contenant le nombre de secondes depuis l'époque dans le premier
élément et le reste du temps depuis l'époque en nanosecondes dans la seconde
élément. Pour s'assurer que les deux éléments sont cohérents, le tableau doit être copié ou
autrement référencé comme une substitution unique avant que les valeurs ne soient utilisées. le
l'idiome suivant peut être utilisé :

pour secondes nsecs in $époque; do

fait

L' ZSH/DB/GDBM MODULE

Votre zsh/db/gdbm module est utilisé pour créer des tableaux associatifs "liés" qui s'interfacent avec
fichiers de base de données. Si l'interface GDBM n'est pas disponible, les commandes intégrées définies par ce
module signalera une erreur. Ce module se veut également un prototype pour la création
interfaces de base de données supplémentaires, de sorte que le ztie Builtin peut passer à un module plus générique dans
l'avenir.

Les éléments intégrés de ce module sont :

ztie -d db/gdbm -f nom de fichier [ -r ] nom du tableau
Ouvrez la base de données GDBM identifiée par nom de fichier et, en cas de succès, créer le
tableau associatif nom du tableau lié au fichier. Pour créer un tableau lié local, le
paramètre doit d'abord être déclaré, donc des commandes similaires à ce qui suit seraient
exécuté à l'intérieur d'une portée de fonction :

locales -A échantillonnéb
ztie -d db/gdbm -f exemple.gdbm échantillonnéb

Votre -r L'option ouvre le fichier de base de données en lecture seule, créant un paramètre avec
l'attribut readonly. Sans cette option, en utilisant `ztie' sur un fichier pour lequel le
l'utilisateur n'a pas d'autorisation d'écriture est une erreur. Si accessible en écriture, la base de données est
ouvert de manière synchrone donc les champs ont changé dans nom du tableau sont immédiatement écrits à
nom de fichier.

Modifications des modes de fichier nom de fichier après son ouverture, ne modifiez pas l'état
of nom du tableau, mais `composer -r nom du tableau' fonctionne comme prévu.

Zuntie [ -u ] nom du tableau
Fermez la base de données GDBM associée à chaque nom du tableau puis désactivez le
paramètre. le -u L'option force un ensemble de paramètres en lecture seule avec `ztie
-r'.

Cela se produit automatiquement si le paramètre est explicitement désactivé ou sa portée locale
(fonction) se termine. Notez qu'un paramètre en lecture seule peut ne pas être explicitement désactivé, donc
le seul moyen de désactiver un paramètre global créé avec `ztie -r' est d'utiliser 'Zuntie
-u'.

Les champs d'un tableau associatif lié à GDBM ne sont ni mis en cache ni stockés autrement dans
mémoire, ils sont lus ou écrits dans la base de données sur chaque référence. Ainsi, pour
exemple, les valeurs d'un tableau en lecture seule peuvent être modifiées par un deuxième écrivain du même
fichier de base de données.

L' ZSH/DELTOCHAR MODULE

Votre zsh/deltochar module met à disposition deux fonctions ZLE :

supprimer-en-char
Lire un caractère sur le clavier et supprimer à partir de la position du curseur jusqu'à et
y compris le suivant (ou, avec le nombre de répétitions n, ne) instance de ce caractère.
Des nombres de répétitions négatifs signifient une suppression à l'envers.

zapper en char
Cela se comporte comme supprimer-en-char, sauf que l'occurrence finale du caractère
lui-même n'est pas supprimé.

L' ZSH/EXEMPLE MODULE

Votre zsh/exemple module rend disponible une commande intégrée :

(ici) [ -drapeaux ] [ args ...]
Affiche les indicateurs et les arguments avec lesquels il est invoqué.

Le but du module est de servir d'exemple sur la façon d'écrire un module.

L' ZSH/FICHIERS MODULE

Votre zsh/fichiers module rend disponible certaines commandes courantes pour la manipulation de fichiers comme
fonctions intégrées ; ces commandes ne sont probablement pas nécessaires dans de nombreuses situations normales mais peuvent être
utile dans les situations de relèvement d'urgence avec des ressources limitées. Les commandes ne
mettre en œuvre toutes les fonctionnalités désormais requises par les comités de normalisation concernés.

Pour toutes les commandes, une variante commençant zf_ est également disponible et chargé automatiquement.
L'utilisation des fonctionnalités de zmodload vous permettra de charger uniquement les noms que vous souhaitez.
Notez qu'il est possible de charger uniquement les fonctions intégrées avec des noms spécifiques à zsh en utilisant le
commande suivante :

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

Les commandes chargées par défaut sont :

chgrp [ -heures ] groupe nom de fichier
Modifie le groupe de fichiers spécifié. Ceci équivaut à chown avec spéc-utilisateur
argument de `:groupe'.

chown [ -heures ] spéc-utilisateur nom de fichier
Modifie la propriété et le groupe de fichiers spécifiés.

Votre spéc-utilisateur peut se présenter sous quatre formes :

utilisateur changer de propriétaire pour utilisateur; ne change pas de groupe
utilisateur:: changer de propriétaire pour utilisateur; ne change pas de groupe
utilisateur: changer de propriétaire pour utilisateur; changer de groupe en utilisateurle groupe principal de
utilisateur:groupe
changer de propriétaire pour utilisateur; changer de groupe en groupe
:groupe ne changez pas de propriétaire ; changer de groupe en groupe

Dans chaque cas, le `:' peut être à la place un '.'. La règle est que s'il y a un `:'
alors le séparateur est `:', sinon s'il y a un `.' alors le séparateur est `.',
sinon il n'y a pas de séparateur.

Chacun des utilisateur et groupe peut être un nom d'utilisateur (ou un nom de groupe, selon le cas) ou
un ID utilisateur décimal (ID de groupe). L'interprétation en tant que nom a préséance, s'il y a
est un nom d'utilisateur entièrement numérique (ou nom de groupe).

Si la cible est un lien symbolique, le -h l'option provoque chown définir la propriété
du lien au lieu de sa cible.

Votre -R l'option provoque chown pour descendre récursivement dans les répertoires, en changeant le
propriété de tous les fichiers du répertoire après avoir changé la propriété du
répertoire lui-même.

Votre -s option est une extension zsh à chown Fonctionnalité. Il permet paranoïaque
comportement, destiné à éviter les problèmes de sécurité impliquant un chown être trompé dans
affectant des fichiers autres que ceux prévus. Il refusera de suivre symbolique
liens, de sorte que (par exemple) ``chown utilisateur /tmp/foo/mot de passe'' ne peut pas accidentellement
chown / Etc / passwd if /tmp/toto se trouve être un lien vers / Etc. Il vérifiera également
où il est après avoir quitté les répertoires, de sorte qu'un chown récursif d'un profond
l'arborescence des répertoires ne peut pas finir par s'afficher de manière récursive / usr à la suite d'annuaires
être déplacé vers le haut de l'arbre.

ln [ -dfhins ] nom de fichier moins
ln [ -dfhins ] nom de fichier dir
Crée dur (ou, avec -s, symbolique). Dans la première forme, le spécifié
moinsest créé, en tant que lien vers le nom de fichier. Dans la seconde forme,
chacun de nom de fichiers est pris à son tour et lié à un chemin dans le
dirsecteur qui a le même dernier composant de nom de chemin.

Normalement, ln n'essaiera pas de créer des liens physiques vers des répertoires. Ce chèque peut
être remplacé à l'aide de la -d option. Généralement, seul le super-utilisateur peut réellement
réussir à créer des liens durs vers des annuaires. Cela ne s'applique pas aux symboles
liens en tout cas.

Par défaut, les fichiers existants ne peuvent pas être remplacés par des liens. le -i l'option provoque le
l'utilisateur à être interrogé sur le remplacement des fichiers existants. le -f l'option provoque l'existant
fichiers à supprimer silencieusement, sans interrogation. -f a la priorité.

Votre -h et -n les options sont identiques et les deux existent pour la compatibilité ; l'un ou l'autre
indique que si la cible est un lien symbolique, il ne doit pas être déréférencé.
Généralement, il est utilisé en combinaison avec -sf de sorte que si un lien existant pointe
dans un répertoire, il sera supprimé, au lieu d'être suivi. Si cette option est
utilisé avec plusieurs noms de fichiers et la cible est un lien symbolique pointant vers un
répertoire, le résultat est une erreur.

mkdir [ -p ] [ -m mode ] dir
Crée des répertoires. Avec le -p option, les répertoires parents non existants sont d'abord
créé si nécessaire, et il n'y aura pas de réclamation si le répertoire déjà
existe. le -m L'option peut être utilisée pour spécifier (en octal) un ensemble de permissions de fichiers
pour les répertoires créés, sinon le mode 777 modifié par le courant umask (voir
umask(2)) est utilisé.

mv [ -Fi ] nom de fichier moins
mv [ -Fi ] nom de fichier dir
Déplace les fichiers. Dans la première forme, le spécifié nom de fichier est déplacé vers le spécifié
moinsination. Dans la seconde forme, chacun des nom de fichiers est pris à son tour et déplacé
à un chemin d'accès dans le spécifié dirsecteur qui a le même dernier composant de nom de chemin.

Par défaut, l'utilisateur sera interrogé avant de remplacer tout fichier qu'il ne peut pas
écrire, mais les fichiers inscriptibles seront supprimés en silence. le -i l'option provoque le
à l'utilisateur d'être interrogé sur le remplacement de fichiers existants. le -f l'option provoque tout
les fichiers existants doivent être supprimés silencieusement, sans interrogation. -f a la priorité.

Notez ceci mv ne déplacera pas les fichiers entre les appareils. versions historiques de mv,
lorsque le renommage réel est impossible, repliez-vous sur la copie et la suppression de fichiers ; si
ce comportement est souhaité, utilisez cp et rm manuellement. Cela peut changer dans le futur
version.

rm [ -dfirs ] nom de fichier
Supprime les fichiers et répertoires spécifiés.

Normalement, rm ne supprimera pas les répertoires (sauf avec le -r option). Les -d
l'option provoque rm pour essayer de supprimer des répertoires avec dissocier (voir dissocier(2)), le même
méthode utilisée pour les fichiers. En règle générale, seul le super-utilisateur peut réellement réussir
dissocier les répertoires de cette manière. -d a préséance sur -r.

Par défaut, l'utilisateur sera interrogé avant de supprimer tout fichier qu'il ne peut pas
écrire, mais les fichiers inscriptibles seront supprimés en silence. le -i l'option provoque le
à l'utilisateur d'être interrogé sur la suppression de fichiers. le -f l'option provoque la création de fichiers
supprimé silencieusement, sans interrogation, et supprime toutes les indications d'erreur. -f prend
priorité.

Votre -r l'option provoque rm pour descendre récursivement dans les répertoires, en supprimant tous les fichiers
dans le répertoire avant de supprimer le répertoire avec le rmdir appel système (voir
rmdir(2)).

Votre -s option est une extension zsh à rm Fonctionnalité. Il permet paranoïaque
comportement, destiné à éviter les problèmes de sécurité courants impliquant un root-run rm qui est
trompé en supprimant des fichiers autres que ceux prévus. Il refusera de suivre
liens symboliques, de sorte que (par exemple) ``rm /tmp/foo/mot de passe'' ne peut pas accidentellement
supprimez / Etc / passwd if /tmp/toto se trouve être un lien vers / Etc. Il vérifiera également
où il se trouve après avoir quitté les répertoires, de sorte qu'une suppression récursive d'un
l'arborescence de répertoires ne peut pas finir par supprimer de manière récursive / usr à la suite d'annuaires
être déplacé vers le haut de l'arbre.

rmdir dir
Supprime les répertoires vides spécifiés.

synchroniser Appelle l'appel système du même nom (voir synchroniser(2)), qui vide les tampons sales
sur disque. Il peut revenir avant que les E/S ne soient réellement terminées.

L' ZSH/INFOLANG MODULE

Votre zsh/langinfo module rend disponible un paramètre :

informations sur la langue
Un tableau associatif qui mappe les éléments langinfo à leurs valeurs.

Votre implémentation peut prendre en charge un certain nombre des clés suivantes :

JEU DE CODES, D_T_FMT, D_FMT, T_FMT, CHAR RADIX, THOUSEP, OUIEXPR, NOEXPR, CRNCYSTR,
ABJOUR_{1..7}, JOUR_{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_CHIFFRES

L' ZSH/MAPFILE MODULE

Votre zsh/fichier cartographique module fournit un paramètre de tableau associatif spécial du même nom.

fichier de carte
Ce tableau associatif prend comme clés les noms de fichiers ; la valeur résultante est la
contenu du fichier. La valeur est traitée de manière identique à tout autre texte venant
à partir d'un paramètre. La valeur peut également être affectée à, auquel cas le fichier dans
la question est écrite (qu'elle existait ou non à l'origine) ; ou un élément peut être
unset, ce qui supprimera le fichier en question. Par exemple, `varié
mapfile[monfichier]' fonctionne comme prévu, en éditant le fichier 'mon fichier'.

Lorsque le tableau est accédé dans son ensemble, les clés sont les noms de fichiers dans le
répertoire courant, et les valeurs sont vides (pour économiser une énorme surcharge en mémoire).
Ainsi ${(k)fichier cartographique} a le même effet que l'opérateur glob *(RÉ), puisque les fichiers
commençant par un point ne sont pas spéciaux. Il faut être prudent avec des expressions telles que
rm ${(k)fichier cartographique}, qui supprimera tous les fichiers du répertoire courant sans le
habituel `rm *' test.

Le paramètre fichier de carte peut être en lecture seule ; dans ce cas, les fichiers référencés peuvent ne pas
être écrit ou supprimé.

Un fichier peut commodément être lu dans un tableau comme une ligne par élément avec la forme
`tableau=("${(f@)mapfile[nom de fichier]}")'. Les guillemets doubles et le `@' sont nécessaires
pour éviter que les lignes vides ne soient supprimées. Notez que si le fichier se termine par un
nouvelle ligne, le shell se divisera sur la nouvelle ligne finale, générant un vide supplémentaire
domaine; cela peut être supprimé en utilisant
`tableau=("${(f@)${mapfile[nom de fichier]%$'\n'}}")'.

Limites
Bien que la lecture et l'écriture du fichier en question soient gérées efficacement, les
la gestion de la mémoire interne peut être arbitrairement baroque ; pourtant, fichier de carte est généralement très
beaucoup plus efficace que tout ce qui implique une boucle. A noter en particulier que l'ensemble
le contenu du fichier résidera toujours physiquement en mémoire lors de l'accès (éventuellement
plusieurs fois, en raison d'opérations standard de substitution de paramètres). En particulier, ce
signifie manipuler des fichiers suffisamment longs (supérieurs à l'espace d'échange de la machine, ou
la plage du type de pointeur) sera incorrecte.

Aucune erreur n'est imprimée ou signalée pour les fichiers inexistants, illisibles ou non inscriptibles, car le
mécanisme de paramètre est trop bas dans la hiérarchie d'exécution du shell pour rendre cela pratique.

Il est dommage que le mécanisme de chargement des modules ne permette pas encore à l'utilisateur de
spécifiez le nom du paramètre shell à attribuer au comportement spécial.

L' ZSH/MATHFUNC MODULE

Votre zsh/foncmath module fournit des fonctions mathématiques standard à utiliser lors de l'évaluation
formules mathématiques. La syntaxe est en accord avec les conventions C et FORTRAN normales, pour
Par exemple,

(( f = péché(0.3) ))

affecte le sinus de 0.3 au paramètre f.

La plupart des fonctions prennent des arguments à virgule flottante et renvoient une valeur à virgule flottante. Pourtant,
toutes les conversions nécessaires de ou vers le type entier seront effectuées automatiquement par le
coquille. En dehors de un bronzage avec un deuxième argument et le Abdos, int et flotter fonctions, toutes
se comportent comme indiqué dans la page de manuel de la fonction C correspondante, sauf que
tous les arguments hors limites pour la fonction en question seront détectés par le shell et
une erreur signalée.

Les fonctions suivantes prennent un seul argument à virgule flottante : aços, Acosh, un péché, asinh,
un bronzage, atanh, cbrt, Ceil, cos, matraque, erf, erfc, exp, expm1, fabs, sol, gamma, j0, j1,
lgamma, enregistrer, Log10, log1p, journal, sans, sinh, sqrt, bronzage, Tanh, y0, y1L’ un bronzage fonction
peut éventuellement prendre un deuxième argument, auquel cas il se comporte comme la fonction C atan2.
Votre ilogb La fonction prend un seul argument à virgule flottante, mais renvoie un entier.

La fonction jeu de signalisation ne prend aucun argument et renvoie un entier, qui est la variable C
du même nom, comme décrit dans gamma(3). Notez qu'il n'est donc utile que
immédiatement après un appel à gamma or lgamma. Notez également que `signgam()' et 'jeu de signalisation' sommes
expressions distinctes.

Les fonctions suivantes prennent deux arguments à virgule flottante : signe de copie, fmod, hypothese,
après après.

Les éléments suivants prennent un premier argument entier et un deuxième argument à virgule flottante : jn, yn.

Les éléments suivants prennent un premier argument à virgule flottante et un deuxième argument entier : ldexp,
écaille.

La fonction Abdos ne convertit pas le type de son argument unique ; il renvoie l'absolu
valeur d'un nombre à virgule flottante ou d'un entier. Les fonctions flotter et int
convertir leurs arguments en virgule flottante ou en valeur entière (par troncature)
respectivement.

Notez que le C pow La fonction est disponible dans l'évaluation mathématique ordinaire en tant que `**'opérateur
et n'est pas fourni ici.

La fonction rand48 est disponible si la bibliothèque mathématique de votre système a la fonction
course48(3). Il renvoie un nombre à virgule flottante pseudo-aléatoire compris entre 0 et 1. Il faut
argument facultatif de chaîne unique.

Si l'argument n'est pas présent, la graine de nombre aléatoire est initialisée par trois appels à
le rand(3) fonction --- cela produit les mêmes nombres aléatoires que les trois valeurs suivantes de
$ ALÉATOIRE.

Si l'argument est présent, il donne le nom d'un paramètre scalaire où le courant
une graine de nombre aléatoire sera stockée. Au premier appel, la valeur doit contenir au moins
douze chiffres hexadécimaux (le reste de la chaîne est ignoré), ou la graine sera
initialisé de la même manière que pour un appel à rand48 sans argument. Appels ultérieurs
à rand48(arrêter) maintiendra alors la graine dans le paramètre arrêter comme une chaîne de douze
chiffres hexadécimaux, sans signifiant de base. Les séquences de nombres aléatoires pour différents
les paramètres sont complètement indépendants, et sont également indépendants de ceux utilisés par les appels à
rand48 sans argument.

Par exemple, considérons

impression $(( rand48 (graine) ))
impression $(( rand48() ))
impression $(( rand48 (graine) ))

En supposant $graine n'existe pas, il sera initialisé au premier appel. Dans la seconde
appel, la graine par défaut est initialisée ; noter, cependant, qu'en raison des propriétés de
rand () il y a une corrélation entre les graines utilisées pour les deux initialisations, donc pour
des utilisations plus sécurisées, vous devez générer votre propre graine de 12 octets. Le troisième appel revient à
la même séquence de nombres aléatoires utilisée dans le premier appel, non affectée par l'intervenant
rand48().

L' ZSH/NOUVEL UTILISATEUR MODULE

Votre zsh/nouvel utilisateur module est chargé au démarrage s'il est disponible, le RCS l'option est définie, et
le PRIVILÉGIÉ L'option n'est pas définie (les trois sont vraies par défaut). Cela a lieu
immédiatement après les commandes dans le global zshenv fichier (généralement /etc/zshenv), le cas échéant, avoir
été exécuté. Si le module n'est pas disponible, il est ignoré silencieusement par le shell ; la
le module peut être retiré en toute sécurité de $MODULE_PATH par l'administrateur si cela n'est pas nécessaire.

Au chargement, le module teste si l'un des fichiers de démarrage .zshenv, .zprofil, .zshrc or
.zlogin existent dans le répertoire donné par la variable d'environnement ZDOTDIR, ou celui de l'utilisateur
répertoire personnel s'il n'est pas défini. Le test n'est pas effectué et le module s'arrête
traitement si le shell était en mode émulation (c'est-à-dire qu'il avait été invoqué comme un autre
shell que zsh).

Si aucun des fichiers de démarrage n'a été trouvé, le module recherche alors le fichier nouvelutilisateur premier
dans un répertoire à l'échelle du site, généralement le répertoire parent du fonctions-site répertoire, et
s'il n'est pas trouvé, le module recherche dans un répertoire spécifique à la version, généralement le
parent du fonctions répertoire contenant des fonctions spécifiques à la version. (Ces
les répertoires peuvent être configurés lorsque zsh est construit en utilisant le --enable-site-scriptdir=dir et
--enable-scriptdir=dir drapeaux à configurer, respectivement; les valeurs par défaut sont préfixe/partager/zsh
et préfixe/share/zsh/$ZSH_VERSION où la valeur par défaut préfixe is / Usr / local.)

Si le fichier nouvelutilisateur est trouvé, il est alors sourcé de la même manière qu'un fichier de démarrage.
Le fichier devrait contenir du code pour installer les fichiers de démarrage pour l'utilisateur, cependant tout
un code shell valide sera exécuté.

Votre zsh/nouvel utilisateur le module est alors déchargé inconditionnellement.

Notez qu'il est possible d'obtenir exactement le même effet que le zsh/nouvel utilisateur moduler par
ajouter du code à /etc/zshenv. Le module existe simplement pour permettre au shell de faire
dispositions pour les nouveaux utilisateurs sans intervention des mainteneurs du paquet et
administrateurs système.

Le script fourni avec le module invoque la fonction shell zsh-newuser-install. Ce
peut être invoqué directement par l'utilisateur même si le zsh/nouvel utilisateur module est désactivé. Noter,
cependant, que si le module n'est pas installé, la fonction ne sera pas installée non plus.
La fonction est documentée dans la section Fonctions de configuration utilisateur dans zshcontrib (1).

L' ZSH/PARAMÈTRE MODULE

Votre zsh/paramètre module donne accès à certaines des tables de hachage internes utilisées par le
shell en définissant des paramètres spéciaux.

Options
Les clés de ce tableau associatif sont les noms des options qui peuvent être définies
et désarmé à l'aide du arrêter et perturber intégrés. La valeur de chaque clé est soit
la corde on si l'option est actuellement définie, ou la chaîne de rabais si l'option est
désarmé. Définir une clé sur l'une de ces chaînes revient à définir ou à désactiver le
option, respectivement. La désactivation d'une clé dans ce tableau revient à la définir sur la valeur
de rabais.

commandes
Ce tableau donne accès à la table de hachage des commandes. Les clés sont les noms de
commandes externes, les valeurs sont les chemins des fichiers qui seraient exécutés
quand la commande serait invoquée. La définition d'une clé dans ce tableau définit une nouvelle entrée
dans ce tableau de la même manière qu'avec le hachage intégré. Désactiver une clé comme dans
`unset "commandes[toto]"' supprime l'entrée pour la clé donnée du hachage de commande
tableau.

fonctions
Ce tableau associatif mappe les noms des fonctions activées à leurs définitions.
L'insertion d'une clé dans celle-ci revient à définir une fonction avec le nom donné par la clé et
le corps donné par la valeur. La désactivation d'une clé supprime la définition de la
fonction nommée par la touche.

dis_fonctions
J'aime fonctions mais pour les fonctions désactivées.

intégrés
Ce tableau associatif donne des informations sur les commandes intégrées actuellement
activée. Les clés sont les noms des commandes intégrées et les valeurs sont soit
`indéfini' pour les commandes intégrées qui seront automatiquement chargées depuis un module si
invoqué ou `défini' pour les commandes intégrées déjà chargées.

dis_builtins
J'aime intégrés mais pour les commandes intégrées désactivées.

mots de passe
Ce tableau contient les mots réservés activés.

dis_reswords
J'aime mots de passe mais pour les mots réservés désactivés.

patchs
Ce tableau contient les caractères de modèle activés.

dis_patchars
J'aime patchs mais pour les caractères de modèle désactivés.

alias
Cela mappe les noms des alias réguliers actuellement activés à leurs extensions.

dés_alias
J'aime alias mais pour les alias normaux désactivés.

galiases
J'aime alias, mais pour les alias globaux.

dis_galies
J'aime galiases mais pour les alias globaux désactivés.

salies
J'aime ralliés, mais pour les alias de suffixe.

dis_saliases
J'aime salies mais pour les alias de suffixe désactivés.

paramètres
Les clés de ce tableau associatif sont les noms des paramètres actuellement
défini. Les valeurs sont des chaînes décrivant le type du paramètre, dans le même
format utilisé par le t indicateur de paramètre, voir zshexpn(1) . Activation ou désactivation des touches dans
ce tableau n'est pas possible.

modules
Un tableau associatif donnant des informations sur les modules. Les clés sont les noms de
les modules chargés, enregistrés pour être chargés automatiquement ou aliasés. La valeur dit qui
indique que le module nommé est dans et est l'une des chaînes `chargé', 'chargé automatiquement', ou
`alias:prénom', où prénom est le nom auquel le module est aliasé.

L'activation ou la désactivation des clés dans ce tableau n'est pas possible.

tas de saletés
Un tableau normal contenant les éléments de la pile de répertoires. Notez que la sortie de
le dirs La commande intégrée inclut un autre répertoire, le répertoire de travail actuel
répertoire.

Histoire
Ce tableau associatif mappe les numéros d'événement d'historique aux lignes d'historique complètes.

mots d'histoire
Un tableau spécial contenant les mots stockés dans l'historique.

répertoires de travail
Ce tableau associatif mappe les numéros de tâche aux répertoires à partir desquels la tâche a été
démarré (qui peut ne pas être le répertoire courant du travail).

Les clés des tableaux associatifs sont généralement des numéros de travail valides, et ce sont les
valeurs sorties avec, par exemple, ${(k)répertoires de travail}. Les références d'emploi non numériques peuvent être
utilisé lors de la recherche d'une valeur ; par example, ${répertoires de travail[%+]} fait référence au courant
d'emplois.

textes d'emploi
Ce tableau associatif mappe les numéros de tâche aux textes des lignes de commande qui ont été
utilisé pour démarrer les travaux.

Le maniement des clés du tableau associatif est comme décrit pour répertoires de travail au dessus.

états de travail
Ce tableau associatif donne des informations sur les états des jobs actuellement
connu. Les clés sont les numéros de travail et les valeurs sont des chaînes de la forme
`état-emploi:marque:Pid=Etat...'. le état-emploi donne à l'état tout le travail est
actuellement dans, l'un des `Running', 'suspendu', ou 'fait'. le marque est `+' pour le
emploi actuel, `-' pour le travail précédent et vide sinon. Ceci est suivi d'un
`:Pid=Etat' pour chaque processus du travail. le Pids sont, bien sûr, les identifiants de processus
et la Etat décrit l'état de ce processus.

Le maniement des clés du tableau associatif est comme décrit pour répertoires de travail au dessus.

nommérépertoire
Ce tableau associatif mappe les noms des répertoires nommés aux chemins qu'ils
représenter.

répertoires utilisateurs
Ce tableau associatif mappe les noms d'utilisateurs aux chemins d'accès de leurs répertoires personnels.

Groupes d'utilisateurs
Ce tableau associatif mappe les noms des groupes système dont l'utilisateur actuel est un
membre aux identifiants de groupe correspondants. Le contenu est le même que le
groupes émis par le id commander.

tracefichierfonc
Ce tableau contient les numéros de ligne absolus et les noms de fichiers correspondants pour le
point où la fonction actuelle, le fichier sourcé ou (si EVAL_LINENO est défini) eval
la commande a été appelée. Le tableau a la même longueur que fonctionsourcetrace et
fonction, mais diffère de fonctionsourcetrace en ce que la ligne et le fichier sont le point
d'appel, pas le point de définition, et diffère de fonction en ce que toutes les valeurs
sont des numéros de ligne absolus dans les fichiers, plutôt que relatifs au début d'un
fonction, le cas échéant.

fonctionsourcetrace
Ce tableau contient les noms de fichiers et les numéros de ligne des points où le
fonctions, fichiers sourcés et (si EVAL_LINENO est défini) eval les commandes actuellement
exécutés ont été définis. Le numéro de ligne est la ligne où le `fonction prénom' ou alors
`prénom ()' a débuté. Dans le cas d'une fonction chargée automatiquement, le numéro de ligne est
signalé comme nul. Le format de chaque élément est nom de fichier:lin. Pour les fonctions
chargé automatiquement à partir d'un fichier au format natif zsh, où seul le corps de la fonction
se produit dans le fichier, ou pour les fichiers qui ont été exécutés par le source ou `.'
Builtins, les informations de trace sont affichées comme nom de fichier:0, puisque le fichier entier est
la définition.

La plupart des utilisateurs seront intéressés par les informations contenues dans le tracefichierfonc tableau
à la place.

pile de fonctions
Ce tableau contient les noms des fonctions, des fichiers sourcés et (si EVAL_LINENO
est défini) eval commandes. en cours d'exécution. Le premier élément est le nom de
la fonction à l'aide du paramètre.

Le tableau de shell standard zsh_eval_context peut être utilisé pour déterminer le type de
construction shell étant exécutée à chaque profondeur : notez, cependant, que c'est dans le
ordre inverse, avec l'élément le plus récent en dernier, et il est plus détaillé, pour
exemple comprenant une entrée pour haut niveau, le code shell principal étant exécuté soit
interactivement ou à partir d'un script, qui n'est pas présent dans $ funcstack.

fonction
Ce tableau contient les noms et numéros de ligne des appelants correspondant au
fonctions en cours d'exécution. Le format de chaque élément est prénom:lin.
Les appelants sont également affichés pour les fichiers sourcés ; l'appelant est le point où le source
ou `.' la commande a été exécutée.

L' ZSH/PCRE MODULE

Votre zsh/pcre module rend certaines commandes disponibles en tant que commandes intégrées :

pcre_compile [ -aimxs ] PCRE
Compile une expression régulière compatible perl.

Option -a forcera le motif à être ancré. Option -i compilera un
modèle insensible à la casse. Option -m compilera un modèle multi-lignes ; C'est, ^
et $ correspondra aux nouvelles lignes dans le motif. Option -x compilera une extension
motif, dans lequel les espaces et # les commentaires sont ignorés. Option -s fait le point
le métacaractère correspond à tous les caractères, y compris ceux qui indiquent une nouvelle ligne.

étude_pcre
Étudie le PCRE précédemment compilé, ce qui peut entraîner une correspondance plus rapide.

pcre_match [ -v var ] [ -a arr ] [ -n compenser ] [ -b ] un magnifique
Retourne avec succès si un magnifique correspond au PCRE précédemment compilé.

En cas de correspondance réussie, si l'expression capture des sous-chaînes entre parenthèses,
pcre_match définira le tableau rencontre à ces sous-chaînes, à moins que le -a option est
donné, auquel cas il définira le tableau arr. De même, la variable MATCH sera
être défini sur l'intégralité de la partie correspondante de la chaîne, à moins que le -v l'option est donnée,
auquel cas la variable var sera fixé. Aucune variable n'est modifiée s'il y a
pas de correspondance réussie. UNE -n l'option commence à rechercher une correspondance à partir de l'octet compenser
position dans un magnifique. Si l' -b l'option est donnée, la variable ZPCRE_OP sera fixé
à une chaîne de paire de décalage, représentant les positions de décalage d'octet de l'ensemble
partie correspondante dans le un magnifique. Par exemple, un ZPCRE_OP réglé sur "32 45"
indique que la partie appariée a commencé sur le décalage d'octet 32 ​​et s'est terminée sur le décalage d'octet
44. Ici, la position de décalage d'octet 45 est la position juste après le
portion. Gardez à l'esprit que la position de l'octet n'est pas nécessairement la même que la
position du caractère lorsque des caractères UTF-8 sont impliqués. Par conséquent, l'octet
les positions de décalage ne doivent être utilisées que dans le contexte de leur utilisation pour
recherches ultérieures sur un magnifique, en utilisant une position de décalage comme argument de la -n
option. Ceci est principalement utilisé pour implémenter le "trouver toutes les correspondances qui ne se chevauchent pas"
Fonctionnalité.

Un exemple simple de "trouver toutes les correspondances qui ne se chevauchent pas":

string="Le Abonnement Zip *: français codes: 78884 90210 99513
pcre_compile -m "\d{5}"
accumuler=()
pcre_match -b -- $chaîne
tout en [[ $? -eq 0 ]] do
b=($=ZPCRE_OP)
accumuler+=$MATCH
pcre_match -b -n $b[2] -- $chaîne
fait
impression -l $cum

Votre zsh/pcre module rend disponible la condition de test suivante :

expr -pcre-match pcre
Correspond à une chaîne avec une expression régulière compatible perl.

Par exemple,

[[ "$texte" -pcre-match ^d+$ ]] &&
impression texte variable contient uniquement "d's".

Si la REMATCH_PCRE l'option est définie, le =~ l'opérateur est équivalent à -pcre-match,
et la NO_CASE_MATCH option peut être utilisée. Noter que NO_CASE_MATCH ne s'applique jamais à
le pcre_match intégré, utilisez plutôt le -i interrupteur de pcre_compile.

L' ZSH/REGEX MODULE

Votre zsh/regex module rend disponible la condition de test suivante :

expr -correspondance d'expression régulière regex
Correspond à une chaîne avec une expression régulière étendue POSIX. En cas de match réussi,
la partie correspondante de la chaîne sera normalement placée dans le MATCH variable. Si
il y a des parenthèses de capture dans l'expression régulière, puis le rencontre variable de tableau
contiendra ceux-ci. Si la correspondance n'est pas réussie, les variables ne seront pas
modifié.

Par exemple,

[[ alphabétique -correspondance d'expression régulière ^une([^une]+)une([^une]+)une ]] &&
impression -l $ MATCH X $ match

Si l'option REMATCH_PCRE n'est pas défini, alors le =~ l'opérateur chargera automatiquement
ce module au besoin et invoquera le -correspondance d'expression régulière opérateur.

If BASH_REMATCH est défini, alors le tableau BASH_REMATCH sera défini au lieu de MATCH
et rencontre.

L' ZSH/HORAIRE MODULE

Votre zsh/horaire module rend disponible une commande intégrée et un paramètre.

calendrier [-o] [+]hh:mm[:ss] commander
calendrier [-o] [+]secondes commander
calendrier [ -Articles ]
Faites une entrée dans la liste planifiée des commandes à exécuter. Le temps peut être
spécifié en temps absolu ou relatif, et soit en heures, minutes et
(éventuellement) secondes séparées par deux points, ou secondes seules. Un nombre absolu de
les secondes indiquent le temps écoulé depuis l'époque (1970/01/01 00:00); c'est utile dans
combinaison avec les caractéristiques du zsh/dateheure module, voir le zsh/datetime
entrée de module dans zshmodules (1).

Sans arguments, imprime la liste des commandes planifiées. Si la commande planifiée
a l' -o flag défini, ceci est affiché au début de la commande.

Avec l'argument `-Articles', supprime l'élément donné de la liste. La numérotation de
la liste est continue et les entrées sont dans l'ordre chronologique, donc la numérotation peut changer
lorsque des entrées sont ajoutées ou supprimées.

Les commandes sont exécutées soit immédiatement avant une invite, soit pendant que la ligne du shell
l'éditeur attend une entrée. Dans ce dernier cas, il est utile de pouvoir produire
sortie qui n'interfère pas avec la ligne en cours d'édition. Offrir l'option -o
oblige le shell à effacer la ligne de commande avant l'événement et à le redessiner
après. Cela doit être utilisé avec tout événement programmé qui produit des
sortie vers le terminal ; il n'est pas nécessaire, par exemple, avec une sortie qui met à jour un
barre de titre de l'émulateur de terminal.

Votre calendrier Builtin n'est pas disponible par défaut lorsque le shell démarre dans un mode
émuler un autre shell. Il peut être rendu disponible avec la commande `zmodload -F
zsh/horaire b:plan'.

zsh_scheduled_events
Un tableau en lecture seule correspondant aux événements programmés par le calendrier intégré. le
les indices du tableau correspondent aux nombres affichés lorsque calendrier est exécuté sans
arguments (à condition que le KSH_ARRAYS option n'est pas définie). La valeur du tableau
se compose du temps programmé en secondes depuis l'époque (voir la section `Le
zsh/datetime Module' pour les facilités d'utilisation de ce numéro), suivi de deux points,
suivi de toutes les options (qui peuvent être vides mais seront précédées d'un `-'
sinon), suivi de deux points, suivi de la commande à exécuter.

Votre calendrier Builtin doit être utilisé pour manipuler les événements. Notez que cela va
avoir un effet immédiat sur le contenu du tableau, de sorte que les indices peuvent devenir
invalide.

L' ZSH/NET/PRISE MODULE

Votre zsh/net/socket module rend disponible une commande intégrée :

zsocket [ -altv ] [ -d fd ] [ args ]
zsocket est implémenté en tant que composant intégré pour permettre une utilisation complète de la ligne de commande du shell
mécanismes d'édition, d'E/S de fichiers et de contrôle des travaux.

Outbound Connexions
zsocket [ -v ] [ -d fd ] nom de fichier
Ouvrez une nouvelle connexion de domaine Unix à nom de fichier. Le paramètre shell RÉPONDRE sera
défini sur le descripteur de fichier associé à cette connexion. Actuellement, seul le flux
les connexions sont prises en charge.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

Inbound Connexions
zsocket -l [ -v ] [ -d fd ] nom de fichier
zsocket -l ouvrira une prise d'écoute sur nom de fichier. Le paramètre shell RÉPONDRE
sera défini sur le descripteur de fichier associé à cet écouteur.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

zsocket -a [ -la télé ] [ -d ciblefd ] ecoute
zsocket -a acceptera une connexion entrante vers le socket associé à
ecoute. Le paramètre shell RÉPONDRE sera défini sur le descripteur de fichier associé
avec la connexion entrante.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

If -t est spécifié, zsocket retournera si aucune connexion entrante n'est en attente.
Sinon, il en attendra un.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

L' ZSH/STAT MODULE

Votre zsh/stat module rend disponible une commande intégrée sous deux noms possibles :

zstat [ -gnNolLtTrs ] [ -f fd ] [ -H hachage ] [ -A tableau ] [ -F fmt ]
[ +un élément ] [ filet ...]
état
La commande agit comme un frontal au état appel système (voir état(2)). Le même
la commande est fournie avec deux noms ; comme nom état est souvent utilisé par un externe
commande, il est recommandé que seul le zstat forme de la commande est utilisée. Cette
peut être organisé en chargeant le module avec la commande `zmodload -F zsh/stat
b:zstat'.

Si la état l'appel échoue, le message d'erreur système approprié s'affiche et l'état 1
est retourné. Les champs de struct état donner des informations sur les fichiers fournis
comme arguments de la commande. En plus de ceux disponibles auprès du état appel, un
élément supplémentaire `lien' est fourni. Ces éléments sont :

dispositif Le numéro de l'appareil sur lequel réside le fichier.

inode Le numéro unique du fichier sur cet appareil (`inode' numéro).

mode Le mode du fichier ; c'est-à-dire le type de fichier et les autorisations d'accès. Avec
le -s option, celle-ci sera renvoyée sous la forme d'une chaîne correspondant à la première
colonne dans l'affichage de la ls -l commander.

lien Le nombre de liens physiques vers le fichier.

uid L'ID utilisateur du propriétaire du fichier. Avec le -s option, cela s'affiche
comme nom d'utilisateur.

gid L'ID de groupe du fichier. Avec le -s option, ceci est affiché comme un groupe
nom.

rdv Le numéro de périphérique brut. Ceci n'est utile que pour les appareils spéciaux.

Taille La taille du fichier en octets.

Atime
mtime
temps Les derniers temps d'accès, de modification et de changement d'inode du fichier,
respectivement, en nombre de secondes depuis minuit GMT le 1er janvier,
1970. Avec le -s option, ceux-ci sont imprimés sous forme de chaînes pour l'heure locale
zone; le format peut être modifié avec le -F option, et avec le -g option
les heures sont en GMT.

taille du bloc
Le nombre d'octets dans un bloc d'allocation sur le périphérique sur lequel le fichier
réside.

bloc Le nombre de blocs de disque utilisés par le fichier.

lien Si le fichier est un lien et que le -L l'option est en vigueur, elle contient le nom
du fichier lié, sinon il est vide. Notez que si cet élément est
sélectionné (``zstat +lien'') puis le -L l'option est automatiquement utilisée.

Un élément particulier peut être sélectionné en incluant son nom précédé d'un `+' dans le
liste d'options ; un seul élément est autorisé. L'élément peut être raccourci à n'importe quel
ensemble unique de personnages principaux. Sinon, tous les éléments seront affichés pour tous
fichiers.

Options:

-A tableau
Au lieu d'afficher les résultats sur la sortie standard, affectez-les à un
tableau, un expert en struct état élément par élément du tableau pour chaque fichier dans l'ordre. Dans
dans ce cas ni le nom de l'élément ni le nom des fichiers n'apparaissent
in tableau à moins que le -t or -n des options ont été données, respectivement. Si -t is
donné, le nom de l'élément apparaît comme préfixe du tableau approprié
élément; si -n est donné, le nom du fichier apparaît comme un élément de tableau séparé
précédant tous les autres. Les autres options de formatage sont respectées.

-H hachage
Similaire à -A, mais affectez plutôt les valeurs à hachage. Les clés sont les
éléments énumérés ci-dessus. Si la -n l'option est fournie, puis le nom du
le fichier est inclus dans le hachage avec la clé prénom.

-f fd Utiliser le fichier sur le descripteur de fichier fd au lieu de fichiers nommés ; pas de liste de fichier
les noms sont autorisés dans ce cas.

-F fmt Fournit un strftime (voir strftime(3)) chaîne pour le formatage de l'heure
éléments. le -s l'option est implicite.

-g Afficher les éléments horaires dans le fuseau horaire GMT. le -s l'option est implicite.

-l Répertoriez les noms des éléments de type (sur la sortie standard ou un tableau comme
approprié) et revenez immédiatement ; options autres que -A et les arguments sont
ignoré.

-L Effectuer un lstat (voir lstat(2)) plutôt qu'un état appel système. Dans ce
cas, si le fichier est un lien, des informations sur le lien lui-même plutôt que
le fichier cible est renvoyé. Cette option est nécessaire pour que le lien
élément utile. Il est important de noter que c'est exactement le contraire de
ls(1), etc...

-n Affichez toujours les noms des fichiers. Habituellement, ceux-ci ne sont affichés que lorsque la sortie est
à la sortie standard et il y a plus d'un fichier dans la liste.

-N Ne jamais afficher les noms de fichiers.

-o Si un mode de fichier brut est imprimé, affichez-le en octal, ce qui est plus utile pour
consommation humaine que la valeur par défaut de la décimale. Un zéro non significatif sera
imprimé dans ce cas. Notez que cela n'affecte pas le fait qu'un fichier brut ou
le mode de fichier formaté est affiché, qui est contrôlé par le -r et -s options,
ni si un mode est affiché du tout.

-r Imprimer les données brutes (le format par défaut) à côté des données de chaîne (le -s format);
les données de chaîne apparaissent entre parenthèses après les données brutes.

-s Imprimé mode, uid, gid et les trois éléments de temps sous forme de chaînes au lieu de
Nombres. Dans chaque cas, le format est semblable à celui de ls -l.

-t Toujours afficher les noms de type pour les éléments de struct état. Généralement ces
ne sont affichés que lorsque la sortie est à la sortie standard et aucun élément individuel
a été sélectionné.

-T Ne jamais afficher les noms de type du struct état éléments.

L' ZSH/SYSTÈME MODULE

Votre zsh/système module rend disponible diverses commandes et paramètres intégrés.

Intégrés
erreur système [ -e erreur ] [ -p préfixe ] [ errno | nom erroné ]
Cette commande imprime le message d'erreur associé à errno, une erreur système
numéro, suivi d'une nouvelle ligne à l'erreur standard.

Au lieu du numéro d'erreur, un nom nom erroné, Par exemple ÉNONCÉ, peut être utilisé. le
l'ensemble des noms est le même que le contenu du tableau erreur, voir ci-dessous.

Si la chaîne préfixe est donné, il est imprimé devant le message d'erreur, sans
espace intermédiaire.

If erreur est fourni, le message entier, sans saut de ligne, est affecté au
noms de paramètres erreur et rien n'est sorti.

Un état de retour de 0 indique que le message a été imprimé avec succès (bien qu'il
peut ne pas être utile si le numéro d'erreur était hors de la plage du système), un retour
l'état de 1 indique une erreur dans les paramètres, et un état de retour de 2
indique que le nom de l'erreur n'a pas été reconnu (aucun message n'est imprimé pour cela).

sysopen [ -arw ] [ -m autorisations ] [ -o Options ]
-u fd filet
Cette commande ouvre un fichier. le -r, -w et -a les drapeaux indiquent si le fichier doit
être ouvert pour la lecture, l'écriture et l'ajout, respectivement. le -m l'option permet
les autorisations initiales à utiliser lors de la création d'un fichier à spécifier sous forme octale.
Le descripteur de fichier est spécifié avec -u. Soit un descripteur de fichier explicite dans le
une plage de 0 à 9 peut être spécifiée ou un nom de variable peut être donné auquel le fichier
un numéro de descripteur sera attribué.

Votre -o L'option permet de spécifier diverses options spécifiques au système en tant que
liste séparée par des virgules. Ce qui suit est une liste d'options possibles. Noter que,
selon le système, certains peuvent ne pas être disponibles.
cloexec
marquer le fichier à fermer lorsque d'autres programmes sont exécutés

engendrent
creat créer un fichier s'il n'existe pas

excl créer un fichier, erreur s'il existe déjà

pas d'heure
supprimer la mise à jour du fichier atime

nofollow
échouer si filet est un lien symbolique

synchroniser demande qui écrit attend que les données aient été écrites physiquement

tronquer
tronc tronquer le fichier à la taille 0

Pour fermer le fichier, utilisez l'un des éléments suivants :

exec {fd}<&-
exec {fd}>&-

lecture système [ -c comptevar ] [ -i infd ] [ -o sortie ]
[ -s taille buf ] [ -t temps mort ] [ arrêter ]
Effectuer une seule lecture système à partir du descripteur de fichier infd, ou zéro si ce n'est pas
donné. Le résultat de la lecture est stocké dans arrêter or RÉPONDRE si ce n'est pas donné.
If comptevar est donné, le nombre d'octets lus est affecté au paramètre nommé
by comptevar.

Le nombre maximum d'octets lus est taille buf ou 8192 si cela n'est pas donné, cependant
la commande revient dès qu'un nombre quelconque d'octets a été lu avec succès.

If temps mort est donné, il spécifie un délai d'attente en secondes, qui peut être zéro pour interroger
le descripteur de fichier. Ceci est géré par le po appel système si disponible,
sinon le Sélectionner appel système si disponible.

If sortie est donné, une tentative est faite pour écrire tous les octets qui viennent d'être lus dans le fichier
descripteur sortie. Si cela échoue, en raison d'une erreur système autre que EINTR or
à cause d'une erreur zsh interne lors d'une interruption, les octets lus mais pas
écrites sont stockées dans le paramètre nommé par arrêter si fourni (aucune valeur par défaut n'est utilisée
dans ce cas), et le nombre d'octets lus mais non écrits est stocké dans le
paramètre nommé par comptevar si c'est fourni. Si c'est réussi, comptevar
contient le nombre total d'octets transférés, comme d'habitude, et arrêter n'est pas défini.

L'erreur EINTR (appel système interrompu) est géré en interne afin que le shell
les interruptions sont transparentes pour l'appelant. Toute autre erreur entraîne un retour.

Les statuts de retour possibles sont
0 Au moins un octet de données a été lu avec succès et, le cas échéant,
écrit.

1 Il y avait une erreur dans les paramètres de la commande. C'est la seule erreur
pour lequel un message est imprimé à l'erreur standard.

2 Une erreur s'est produite lors de la lecture ou de l'interrogation du descripteur de fichier d'entrée pour
un temps mort. Le paramètre ERREUR donne l'erreur.

3 Les données ont été lues avec succès, mais une erreur s'est produite lors de leur écriture dans sortie.
Le paramètre ERREUR donne l'erreur.

4 La tentative de lecture a expiré. Notez que cela ne définit pas ERREUR comme ce n'est pas
une erreur système.

5 Aucune erreur système ne s'est produite, mais aucun octet n'a été lu. Cela indique généralement
fin de fichier. Les paramètres sont définis selon les règles habituelles ; pas d'écriture
à sortie est tenté.

recherche de système [ -u fd ] [ -w Commencer|fin|actuel ] compenser
La position actuelle du fichier à laquelle les futures lectures et écritures auront lieu est
ajusté au décalage d'octet spécifié. le compenser est évalué comme un calcul
expression. le -u L'option permet de spécifier le descripteur de fichier. Par défaut
l'offset est spécifié par rapport au début ou au fichier mais, avec le -w option,
il est possible de spécifier que le décalage doit être relatif au courant
position ou la fin du fichier.

écriture système [ -c comptevar ] [ -o sortie ] données
Les données (une seule chaîne d'octets) sont écrites dans le descripteur de fichier sortieOu 1
si cela n'est pas donné, en utilisant le écrire appel système. Plusieurs opérations d'écriture peuvent
être utilisé si le premier n'écrit pas toutes les données.

If comptevar est donné, le nombre d'octet écrit est stocké dans le paramètre nommé
by comptevar; ce n'est peut-être pas toute la longueur de données si une erreur s'est produite.

L'erreur EINTR (appel système interrompu) est traité en interne par une nouvelle tentative ;
sinon, une erreur provoque le retour de la commande. Par exemple, si le fichier
le descripteur est défini sur une sortie non bloquante, une erreur ENCORE (sur certains systèmes,
EWOUBLOCK) peut entraîner le retour anticipé de la commande.

L'état de retour peut être 0 en cas de succès, 1 en cas d'erreur dans les paramètres du
commande, ou 2 pour une erreur sur l'écriture ; aucun message d'erreur n'est imprimé dans le dernier
cas, mais le paramètre ERREUR reflétera l'erreur qui s'est produite.

zsystème troupeau [ -t temps mort ] [ -f var ] [-Er] filet
zsystème troupeau -u fd_expr
Le intégré zsystèmesous-commande de troupeau effectue un verrouillage de fichier consultatif (via le
fctl(2) appel système) sur tout le contenu du fichier donné. Cette forme de
le verrouillage nécessite la coopération des processus accédant au fichier ; c'est le plus évident
use est entre deux instances du shell lui-même.

Dans la première forme le nommé filet, qui doit déjà exister, se verrouille en ouvrant un
descripteur de fichier au fichier et en appliquant un verrou au descripteur de fichier. Le verrou
se termine lorsque le processus shell qui a créé le verrou se termine ; il est donc
souvent pratique pour créer des verrous de fichiers dans des sous-shells, car le verrou est
automatiquement libéré lorsque le sous-shell se ferme. L'état 0 est renvoyé si le verrou
réussit, sinon statut 1.

Dans la seconde forme le descripteur de fichier donné par l'expression arithmétique fd_expr
est fermé, libérant un verrou. Le descripteur de fichier peut être interrogé en utilisant le `-f
var' forme pendant l'écluse; sur un verrouillage réussi, la variable shell var est fixé à
le descripteur de fichier utilisé pour le verrouillage. Le verrou sera libéré si le fichier
descripteur est fermé par tout autre moyen, par exemple en utilisant `exec {var}>&-';
cependant, le formulaire décrit ici effectue une vérification de sécurité que le descripteur de fichier
est utilisé pour le verrouillage de fichiers.

Par défaut, le shell attend indéfiniment la réussite du verrouillage. L'option -t
temps mort spécifie un délai d'attente pour le verrou en secondes ; actuellement cela doit être un
entier. Le shell tentera de verrouiller le fichier une fois par seconde pendant cette période.
Si la tentative expire, l'état 2 est renvoyé.

Si l'option -e est donné, le descripteur de fichier pour le verrou est conservé lorsque le
shell utilise exec démarrer un nouveau processus; sinon il est fermé à ce point et
le verrou s'est débloqué.

Si l'option -r est donné, le verrou n'est que pour la lecture, sinon c'est pour
lire et écrire. Le descripteur de fichier s'ouvre en conséquence.

zsystème supports sous-commande
Le intégré zsystèmesous-commande de supports teste si une sous-commande donnée est
prise en charge. Il renvoie l'état 0 si c'est le cas, sinon l'état 1. Il fonctionne en silence à moins que
il y a eu une erreur de syntaxe (c'est-à-dire le mauvais nombre d'arguments), auquel cas status
255 est renvoyé. Le statut 1 peut indiquer l'une des deux choses suivantes : sous-commande est connu mais
non pris en charge par le système d'exploitation actuel, ou sous-commande n'est pas connu (peut-être
car il s'agit d'une ancienne version du shell avant son implémentation).

Mathématique Les fonctions
système (fd)
La fonction mathématique systell renvoie la position actuelle du fichier pour le descripteur de fichier
passé en argument.

Paramètres
erreur Un tableau en lecture seule des noms d'erreurs définies sur le système. Ce sont typiquement
macros définies en C en incluant le fichier d'en-tête système erreur.h. L'indice de chaque
nom (en supposant l'option KSH_ARRAYS est désactivé) correspond au numéro d'erreur.
Numéros d'erreur num avant la dernière erreur connue qui n'a pas de nom reçoit le nom
Enum dans le tableau.

Notez que les alias pour les erreurs ne sont pas gérés ; seul le nom canonique est utilisé.

paramètres système
Un tableau associatif en lecture seule. Les clés sont :

Pid Renvoie l'ID de processus du processus en cours, même dans les sous-shells. Comparer
$$, qui renvoie l'ID de processus du processus shell principal.

ppd Renvoie l'ID de processus du parent du processus en cours, même dans
sous-shells. Comparer $PPID, qui renvoie l'ID de processus du parent du
processus shell principal.

L' ZSH/NET/TCP MODULE

Votre zsh/net/tcp module rend disponible une commande intégrée :

ztc [ -acflLtv ] [ -d fd ] [ args ]
ztc est implémenté en tant que module intégré pour permettre une utilisation complète de l'édition de la ligne de commande du shell,
les E/S de fichiers et les mécanismes de contrôle des travaux.

If ztc est exécuté sans option, il affichera le contenu de sa table de session.

S'il est exécuté avec uniquement l'option -L, il affichera le contenu de la session
table dans un format adapté à l'analyse automatique. L'option est ignorée si elle est donnée
avec une commande pour ouvrir ou fermer une session. La sortie se compose d'un ensemble de lignes,
un par session, chacun contenant les éléments suivants séparés par des espaces :

Descripteur de fichier
Le descripteur de fichier utilisé pour la connexion. Pour les appels entrants normaux (I) et
sortant (O) connexions cela peut être lu et écrit par le shell habituel
mécanismes. Cependant, il ne devrait être proche que de `ztc -c'.

Type de connexion
Une lettre indiquant comment la session a été créée :

Z Une session créée avec le zftp commander.

L Une connexion ouverte pour l'écoute avec `ztc -l'.

I Une connexion entrante acceptée avec `ztc -a'.

O Une connexion sortante créée avec `ztc hôte '.

L'hôte local
Ceci est généralement défini sur une adresse IP entièrement à zéro comme adresse du
localhost n'est pas pertinent.

Le port local
Il est probable que ce soit zéro, sauf si la connexion est destinée à l'écoute.

L'hôte distant
Il s'agit du nom de domaine complet de l'homologue, s'il est disponible, sinon un
Adresse IP. Il s'agit d'une adresse IP entièrement à zéro pour une session ouverte pour
écoute.

Le port distant
C'est zéro pour une connexion ouverte pour l'écoute.

Outbound Connexions
ztc [ -v ] [ -d fd ] hôte [ port ]
Ouvrez une nouvelle connexion TCP pour hôte. Si l' port est omis, il portera par défaut
23. La connexion sera ajoutée à la table de session et au paramètre shell
RÉPONDRE sera défini sur le descripteur de fichier associé à cette connexion.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

Inbound Connexions
ztc -l [ -v ] [ -d fd ] port
ztc -l ouvrira un socket à l'écoute sur TCP port. La prise sera ajoutée au
table de session et le paramètre shell RÉPONDRE sera défini sur le descripteur de fichier
associé à cet auditeur.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

ztc -a [ -la télé ] [ -d ciblefd ] ecoute
ztc -a acceptera une connexion entrante vers le port associé à ecoute.
La connexion sera ajoutée à la table de session et au paramètre shell RÉPONDRE
sera défini sur le descripteur de fichier associé à la connexion entrante.

If -d est spécifié, son argument sera pris comme descripteur de fichier cible pour
la connexion.

If -t est spécifié, ztc retournera si aucune connexion entrante n'est en attente.
Sinon, il en attendra un.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

Fermeture Connexions
ztc -cf [ -v ] [ fd ]
ztc -c [ -v ] [ fd ]
ztc -c fermera le socket associé à fd. La prise sera retirée de
le tableau des séances. Si fd n'est pas spécifié, ztc fermera tout dans le
tableau des séances.

Normalement, les sockets enregistrées par zftp (voir zshmodules(1) ) ne peut pas être fermé ce
chemin. Pour forcer la fermeture d'une telle prise, utilisez -f.

Afin d'obtenir une sortie plus détaillée, utilisez -v.

Exemple
Voici comment créer une connexion TCP entre deux instances de zsh. Nous devons choisir un
port non attribué ; ici, nous utilisons le 5123 choisi au hasard.

On host1,
zmodload zsh/net/tcp
ztc -l 5123
ecoutefd=$REPLY
ztc -a $écouterfd
fd=$RÉPONSE
La seconde de la dernière commande bloque jusqu'à ce qu'il y ait une connexion entrante.

Créez maintenant une connexion à partir de host2 (qui peut, bien sûr, être la même machine):
zmodload zsh/net/tcp
ztc host1 5123
fd=$RÉPONSE

Maintenant sur chaque hôte, $fd contient un descripteur de fichier pour parler à l'autre. Par example,
on host1:
impression Cette is a message >&$fd
et sur host2:
lire -r en ligne <&$fd; impression -r - $ligne
imprime `Cette is a message'.

Pour ranger, sur host1:
ztc -c $écouterfd
ztc -c $fd
et sur host2
ztc -c $fd

L' ZSH/TERMCAP MODULE

Votre zsh/termcap module rend disponible une commande intégrée :

échotc casquette [ arg ...]
Sortir la valeur termcap correspondant à la capacité casquette, avec en option
arguments.

Votre zsh/termcap module rend disponible un paramètre :

termecap
Un tableau associatif qui mappe les codes de capacité termcap à leurs valeurs.

L' ZSH/TERMINFO MODULE

Votre zsh/termininfo module rend disponible une commande intégrée :

échoti casquette [ arg ]
Sortir la valeur terminfo correspondant à la capacité casquette, instancié avec
arg le cas échéant.

Votre zsh/termininfo module rend disponible un paramètre :

infos sur le terme
Un tableau associatif qui mappe les noms de capacité terminfo à leurs valeurs.

L' ZSH/ZFTP MODULE

Votre zsh/zftp module rend disponible une commande intégrée :

zftp sous-commande [ args ]
Votre zsh/zftp module est un client pour FTP (protocole de transfert de fichiers). Il est
implémenté en tant que composant intégré pour permettre une utilisation complète de l'édition de la ligne de commande du shell, des E/S de fichiers,
et les mécanismes de contrôle des tâches. Souvent, les utilisateurs y accéderont via des fonctions shell
fournir une interface plus puissante ; un ensemble est fourni avec le zsh pour la distribution
et est décrit dans zshzftpsys(1). Cependant, le zftp commande est entièrement utilisable dans
son propre droit.

Toutes les commandes se composent du nom de la commande zftp suivi du nom d'une sous-commande.
Ceux-ci sont énumérés ci-dessous. Le statut de retour de chaque sous-commande est censé
reflètent le succès ou l'échec de l'opération à distance. Voir une description du
variable ZFTP_VERBOSE pour plus d'informations sur la façon dont les réponses du serveur peuvent être
imprimé.

Sous-commandes
ouvert hôte[:port] [ utilisateur [ Mot de passe [ Compte ] ] ]
Ouvrir une nouvelle session FTP pour hôte, qui peut être le nom d'un hôte connecté TCP/IP ou
un numéro IP dans la notation standard par points. Si l'argument est sous la forme
hôte:port, ouvrez une connexion au port TCP port au lieu du port FTP standard 21.
Il peut s'agir du nom d'un service TCP ou d'un numéro : voir la description de
ZFTP_PORT ci-dessous pour plus d'informations.

Si des adresses IPv6 au format deux-points sont utilisées, le hôte devrait être entouré de guillemets
crochets pour le distinguer du port, Par exemple
'[fe80::203:baff:fe02:8b56]'. Par souci de cohérence, cela est autorisé avec toutes les formes de
hôte.

Les arguments restants sont passés au vous connecter sous-commande. Notez que si aucun argument
dans tous hôte Sont fournis, ouvert sera pas appeler automatiquement vous connecter. Si aucun argument
du tout sont fournis, ouvert utilisera les paramètres définis par le params sous-commande.

Après une ouverture réussie, les variables shell ZFTP_HOST, ZFTP_PORT, ZFTP_IP et
ZFTP_SYSTEM sont disponibles; voir « Variables » ci-dessous.

vous connecter [ prénom [ Mot de passe [ Compte ] ] ]
utilisateur [ prénom [ Mot de passe [ Compte ] ] ]
Connectez-vous l'utilisateur prénom avec des paramètres Mot de passe et Compte. N'importe lequel des paramètres
peut être omis et sera lu à partir de l'entrée standard si nécessaire (prénom est toujours
avait besoin). Si l'entrée standard est un terminal, une invite pour chacun sera imprimée sur
erreur standard et Mot de passe ne sera pas repris. Si l'un des paramètres n'est pas
utilisé, un message d'avertissement est imprimé.

Après une connexion réussie, les variables shell ZFTP_USER, ZFTP_ACCOUNT et ZFTP_PWD
sont disponibles; voir « Variables » ci-dessous.

Cette commande peut être réémise lorsqu'un utilisateur est déjà connecté et le serveur
d'abord être réinitialisé pour un nouvel utilisateur.

params [ hôte [ utilisateur [ Mot de passe [ Compte ] ] ] ]
params -
Stocker les paramètres donnés pour plus tard ouvert commande sans argument. Seuls ceux
donné sur la ligne de commande sera mémorisé. Si aucun argument n'est donné, le
les paramètres actuellement définis sont imprimés, bien que le mot de passe apparaisse sous forme de ligne
d'étoiles ; le statut de retour est un si aucun paramètre n'a été défini, zéro sinon.

N'importe lequel des paramètres peut être spécifié comme un `?', qui peut devoir être cité à
le protéger de l'expansion de la coque. Dans ce cas, le paramètre approprié sera
lire à partir de stdin comme avec le vous connecter sous-commande, y compris la gestion spéciale de
Mot de passe. Si le `?' est suivi d'une chaîne, qui est utilisée comme invite pour
lire le paramètre au lieu du message par défaut (toute ponctuation et
un espace doit être inclus à la fin de l'invite). La première lettre du
le paramètre (uniquement) peut être entre guillemets `\'; d'où un argument "\\$mot" garantit
que la chaîne du paramètre shell $mot seront traités littéralement, que ce soit
ou pas il commence par un `?'.

Si à la place un seul `-' est donné, les paramètres existants, le cas échéant, sont supprimés. Dans
ce cas, appelant ouvert sans arguments provoquera une erreur.

La liste des paramètres n'est pas supprimée après un close, cependant il sera supprimé si
le zsh/zftp le module est déchargé.

Par exemple,

zftp params ftp.ailleurs.xx juste '?Mot de passe pour juste : '

stockera l'hôte ftp.ailleurs.xx et l'utilisateur juste puis inviter l'utilisateur
pour le mot de passe correspondant avec l'invite donnée.

tester Testez la connexion ; si le serveur a signalé qu'il a fermé la connexion
(peut-être en raison d'un délai d'attente), renvoie l'état 2 ; si aucune connexion n'était ouverte de toute façon, revenez
statut 1 ; sinon retourne l'état 0. Le tester la sous-commande est silencieuse, à part les messages
imprimé par le $ZFTP_VERBOSE mécanisme, ou des messages d'erreur si la connexion se ferme.
Il n'y a pas de surcharge réseau pour ce test.

Le test n'est pris en charge que sur les systèmes avec le Sélectionner(2) or po(2) Système
appels; sinon le message `pas soutenu on ceci. Système' est imprimé à la place.

Votre tester la sous-commande sera automatiquement appelée au début de tout autre
sous-commande pour la session en cours lorsqu'une connexion est ouverte.

cd annuaire
Remplacez le répertoire distant par annuaire. Modifie également la variable shell ZFTP_PWD.

cdup Remplacez le répertoire distant par celui situé plus haut dans l'arborescence des répertoires. Noter que cd
.. fonctionnera également correctement sur les systèmes non UNIX.

dir [ arg ...]
Donnez une liste (verbeuse) du répertoire distant. le args sont transmis directement à
le serveur. Le comportement de la commande dépend de l'implémentation, mais un serveur UNIX
interprétera généralement args comme arguments à la ls commande et sans arguments
renvoie le résultat de `ls -l'. Le répertoire est répertorié sur la sortie standard.

ls [ arg ...]
Donnez une (courte) liste du répertoire distant. Sans arg, produit une liste brute
des fichiers du répertoire, un par ligne. Sinon, jusqu'aux aléas de la
implémentation du serveur, se comporte comme dir.

type [ type ]
Changez le type de transfert en type, ou imprimer le type actuel si type is
absent. Les valeurs autorisées sont `A' (ASCII), 'I' (Image, c'est-à-dire binaire), ou `B' (une
synonyme de `I').

Le FTP par défaut pour un transfert est ASCII. Toutefois, si zftp constate que la télécommande
l'hôte est une machine UNIX avec des byes 8 bits, il passera automatiquement à l'utilisation
binaire pour les transferts de fichiers sur ouvert. Celui-ci peut ensuite être outrepassé.

Le type de transfert n'est transmis à l'hôte distant que lorsqu'une connexion de données est
établi; cette commande n'implique aucune surcharge de réseau.

ascii Le même que type A.

binaire Le même que type I.

mode [ S | B ]
Définissez le type de mode pour diffuser (S) ou bloquer (B). Le mode flux est le mode par défaut ; bloquer
le mode n'est pas largement pris en charge.

éloigné filet
locales [ filet ...]
Imprimer la taille et l'heure de la dernière modification des fichiers distants ou locaux. S'il y a
est plus d'un élément sur la liste, le nom du fichier est imprimé en premier. le
le premier nombre est la taille du fichier, le second est l'heure de la dernière modification du fichier
au format CCYAMMJJhhmmSS composé de l'année, du mois, de la date, de l'heure, des minutes et
secondes en GMT. Notez que ce format, y compris la longueur, est garanti, donc
que les chaînes de temps peuvent être directement comparées via le [[ intégré < et > les opérateurs,
même s'ils sont trop longs pour être représentés sous forme d'entiers.

Tous les serveurs ne prennent pas en charge les commandes de récupération de ces informations. Dans ce
cas, le éloigné la commande n'imprimera rien et renverra l'état 2, par rapport à
statut 1 pour un fichier introuvable.

Votre locales commande (mais pas éloigné) peut être utilisé sans argument, auquel cas le
les informations proviennent de l'examen du descripteur de fichier zéro. C'est le même fichier que
vu par un mettre commande sans autre redirection.

obtenez filet
Récupérer tout filets du serveur, les concaténer et les envoyer au standard
sortie.

mettre filet
Pour chaque filet, lire un fichier à partir de l'entrée standard et l'envoyer à l'hôte distant
avec le prénom.

ajouter filet
As mettre, mais si la télécommande filet existe déjà, des données y sont ajoutées au lieu de
en l'écrasant.

atteindre filet point
putain filet point
appendice filet point
Versions de obtenez, mettre et ajouter qui commencera le transfert à l'heure donnée point in
la télécommande filet. Ceci est utile pour ajouter à un fichier local incomplet.
Cependant, notez que cette capacité n'est pas universellement prise en charge par les serveurs (et n'est pas
tout à fait le comportement spécifié par la norme).

effacer filet
Supprimez la liste des fichiers sur le serveur.

mkdir annuaire
Créer un nouveau répertoire annuaire sur le serveur.

rmdir annuaire
Supprimer le répertoire annuaire sur le serveur.

rebaptiser ancien-nom nouveau nom
Renommer le fichier ancien-nom à nouveau nom sur le serveur.

site arg
Envoyez une commande spécifique à l'hôte au serveur. Vous n'en aurez probablement besoin que si
demandé par le serveur de l'utiliser.

Devis arg
Envoyez la séquence de commandes FTP brute au serveur. Vous devez être familiarisé avec le
Ensemble de commandes FTP tel que défini dans RFC959 avant de faire cela. Des commandes utiles peuvent
de Swanson comprennent STAT et AIDE. Notez également le mécanisme de retour des messages tel que décrit
pour la variable ZFTP_VERBOSE ci-dessous, en particulier que tous les messages du
connexion de contrôle sont envoyés à l'erreur standard.

close
quitter Fermez la connexion de données actuelle. Cela désactive les paramètres du shell ZFTP_HOST,
ZFTP_PORT, ZFTP_IP, ZFTP_SYSTEM, ZFTP_USER, ZFTP_ACCOUNT, ZFTP_PWD, ZFTP_TYPE et
ZFTP_MODE.

Session [ nom de session ]
Permet d'utiliser plusieurs sessions FTP à la fois. Le nom de la session est un
chaîne de caractères arbitraire ; la session par défaut s'appelle `défaut'. Si ce
La commande est appelée sans argument, elle listera toutes les sessions en cours ; avec
un argument, il passera soit à la session existante appelée nom de session, ou
créer une nouvelle session de ce nom.

Chaque session mémorise l'état de la connexion, l'ensemble des paramètres spécifiques à la connexion
paramètres shell (le même ensemble que ceux qui sont désactivés lorsqu'une connexion se ferme, comme indiqué dans
la description de close), et tous les paramètres utilisateur spécifiés avec le params
sous-commande. Le passage à une session précédente restaure ces valeurs ; changer pour un
nouvelle session les initialise de la même manière que si zftp venait d'être chargé. le
le nom de la session en cours est donné par le paramètre ZFTP_SESSION.

séance [ nom de session ]
Supprimer une session ; si aucun nom n'est donné, la session en cours est supprimée. Si la
session en cours est supprimée, la première session existante devient la nouvelle
session, sinon la session en cours n'est pas modifiée. Si la session étant
supprimé est le seul, une nouvelle session appelée `défaut' est créé et devient le
session actuelle; notez qu'il s'agit d'une nouvelle session même si la session est supprimée
s'appelle aussi 'défaut'. Il est recommandé de ne pas supprimer les sessions pendant
commandes d'arrière-plan qui utilisent zftp sont toujours actifs.

Paramètres
Les paramètres de shell suivants sont utilisés par zftp. Actuellement, aucun d'entre eux n'est spécial.

ZFTP_TMOUT
Entier. Le temps en secondes à attendre qu'une opération réseau se termine avant
renvoyer une erreur. Si ce n'est pas défini lorsque le module est chargé, il sera donné
la valeur par défaut 60. Une valeur de zéro désactive les délais d'attente. Si un délai d'attente se produit sur
la connexion de contrôle sera fermée. Utilisez une valeur plus élevée si cela se produit également
fréquemment.

ZFTP_IP
Lecture seulement. L'adresse IP de la connexion actuelle en notation par points.

ZFTP_HOST
Lecture seulement. Le nom d'hôte du serveur distant actuel. Si l'hôte a été ouvert en tant que
numéro IP, ZFTP_HOST contient cela à la place ; cela économise la surcharge pour un nom
recherche, car les numéros IP sont le plus souvent utilisés lorsqu'un serveur de noms n'est pas disponible.

ZFTP_PORT
Lecture seulement. Le numéro du port TCP distant sur lequel la connexion est ouverte (même
si le port a été spécifié à l'origine en tant que service nommé). Habituellement c'est le
port FTP standard, 21.

Dans le cas peu probable où votre système ne dispose pas de la conversion appropriée
fonctions, cela apparaît dans l'ordre des octets du réseau. Si votre système est little-endian,
le port se compose alors de deux octets permutés et le port standard sera signalé
comme 5376. Dans ce cas, les ports numériques transmis à zftp ouvert devra également être dans
ce format.

ZFTP_SYSTEM
Lecture seulement. La chaîne de type de système renvoyée par le serveur en réponse à un FTP SYSTÈME
demande. Le cas le plus intéressant est une chaîne commençant "UNIX Type : L8", Qui
assure une compatibilité maximale avec un hôte UNIX local.

ZFTP_TYPE
Lecture seulement. Le type à utiliser pour les transferts de données , soit `A' ou 'I'. Utilisez le
type sous-commande pour changer cela.

ZFTP_USER
Lecture seulement. Le nom d'utilisateur actuellement connecté, le cas échéant.

ZFTP_ACCOUNT
Lecture seulement. Le nom du compte de l'utilisateur actuel, le cas échéant. La plupart des serveurs ne
besoin d'un nom de compte.

ZFTP_PWD
Lecture seulement. Le répertoire courant sur le serveur.

ZFTP_CODE
Lecture seulement. Le code à trois chiffres de la dernière réponse FTP du serveur sous forme de chaîne.
Cela peut toujours être lu après la fermeture de la connexion et n'est pas modifié lorsque le
modifications de la session en cours.

ZFTP_REPLY
Lecture seulement. La dernière ligne de la dernière réponse envoyée par le serveur. Cela peut encore être
lu après la fermeture de la connexion, et n'est pas modifié lorsque la session en cours
changements.

ZFTP_SESSION
Lecture seulement. Le nom de la session FTP en cours ; voir le descriptif du Session
sous-commande.

ZFTP_PREFS
Une série de préférences pour modifier des aspects de zftple comportement. Chaque préférence
est un caractère unique. Sont définis :

P Passive : tente de faire en sorte que le serveur distant initie les transferts de données. Ce
est légèrement plus efficace que le mode sendport. Si la lettre S survient plus tard
dans la chaîne, zftp utilisera le mode sendport si le mode passif n'est pas disponible.

S Sendport : initier des transferts par le FTP PORT commander. Si cela se produit
avant tout P dans la chaîne, le mode passif ne sera jamais tenté.

D Dumb : n'utilisez que le strict minimum de commandes FTP. Cela empêche le
les variables ZFTP_SYSTEM et ZFTP_PWD d'être réglé, et signifiera tout
les connexions sont par défaut de type ASCII. Cela peut empêcher ZFTP_SIZE d'être fixé
pendant un transfert si le serveur ne l'envoie pas de toute façon (de nombreux serveurs le font).

If ZFTP_PREFS n'est pas défini lorsque zftp est chargé, il sera défini sur une valeur par défaut de `PS',
c'est-à-dire utiliser le mode passif s'il est disponible, sinon revenir au mode sendport.

ZFTP_VERBOSE
Une chaîne de chiffres entre 0 et 5 inclus, spécifiant quelles réponses de la
serveur doit être imprimé. Toutes les réponses vont à l'erreur standard. Si l'un des
les numéros 1 à 5 apparaissent dans la chaîne, les réponses brutes du serveur avec les codes de réponse
commençant par ce chiffre sera imprimé à l'erreur standard. Le premier chiffre de
le code de réponse à trois chiffres est défini par RFC959 pour correspondre à :

1. Une réponse préliminaire positive.

2. Une réponse d'achèvement positive.

3. Une réponse intermédiaire positive.

4. Une réponse d'achèvement négative transitoire.

5. Une réponse d'achèvement négative permanente.

Il convient de noter que, pour des raisons inconnues, la réponse "Service non disponible",
qui force l'arrêt d'une connexion, est classé comme 421, c'est-à-dire
négative", une interprétation intéressante du mot "transitoire".

Le code 0 est spécial : il indique que toutes les lignes de multiligne sauf la dernière
les réponses lues à partir du serveur seront imprimées à l'erreur standard dans un fichier traité
format. Par convention, les serveurs utilisent ce mécanisme pour envoyer des informations aux
utilisateur à lire. Le code de réponse approprié, s'il correspond à la même réponse, prend
priorité.

If ZFTP_VERBOSE n'est pas défini lorsque zftp est chargé, il sera défini sur la valeur par défaut
450, c'est-à-dire que les messages destinés à l'utilisateur et toutes les erreurs seront imprimés. Un nul
string est valide et spécifie qu'aucun message ne doit être imprimé.

Les fonctions
zftp_chpwd
Si cette fonction est définie par l'utilisateur, elle est appelée à chaque changement de répertoire
sur le serveur, y compris lorsqu'un utilisateur est connecté ou lorsqu'une connexion est fermée.
Dans le dernier cas, $ZFTP_PWD sera désactivé ; sinon il reflétera le nouveau
répertoire.

zftp_progress
Si cette fonction est définie par l'utilisateur, elle sera appelée lors d'une obtenez, mettre or ajouter
opération chaque fois que suffisamment de données ont été reçues de l'hôte. Au cours d'une obtenez,
les données sont envoyées sur la sortie standard, il est donc indispensable que cette fonction écrive
à l'erreur standard ou directement au terminal, pas à la sortie standard.

Lorsqu'il est appelé avec un transfert en cours, le shell supplémentaire suivant
les paramètres sont définis :

ZFTP_FILE
Le nom du fichier distant en cours de transfert depuis ou vers.

ZFTP_TRANSFER
A G | obtenez opération et une P | mettre fonctionnement.

ZFTP_SIZE
La taille totale du fichier complet en cours de transfert : identique à la première
valeur fournie par le éloigné et locales sous-commandes pour un fichier particulier.
Si le serveur ne peut pas fournir cette valeur pour un fichier distant en cours de récupération, il
ne sera pas défini. Si l'entrée provient d'un tuyau, la valeur peut être incorrecte et
correspondent simplement à un buffer de pipe plein.

ZFTP_COUNT
La quantité de données transférées jusqu'à présent ; un nombre compris entre zéro et $ZFTP_SIZE,
si cela est défini. Ce numéro est toujours disponible.

La fonction est initialement appelée avec ZFTP_TRANSFER réglé de manière appropriée et
ZFTP_COUNT mis à zéro. Une fois le transfert terminé, la fonction sera
appelé une fois de plus avec ZFTP_TRANSFER ajuster à GF or PF, au cas où il souhaite ranger
en haut. Il n'est autrement jamais appelé deux fois avec la même valeur de ZFTP_COUNT.

Parfois, le compteur de progression peut provoquer des perturbations. C'est à l'utilisateur de décider
si la fonction doit être définie et utiliser ne fonctionne pas quand c'est nécessaire.

Problèmes
Une connexion ne peut pas être ouverte sur le côté gauche d'un tuyau car cela se produit dans un
sous-shell et les informations de fichier ne sont pas mises à jour dans le shell principal. Dans le cas du genre
ou le mode change ou ferme la connexion dans un sous-shell, l'information est renvoyée mais
les variables ne sont pas mises à jour avant le prochain appel à zftp. Autres changements de statut dans les sous-shells
ne sera pas reflété par des modifications des variables (mais devrait être autrement inoffensif).

Suppression de sessions alors qu'un zftp la commande est active en arrière-plan peut avoir des
effets, même s'il n'utilise pas la session en cours de suppression. C'est parce que tout shell
les sous-processus partagent des informations sur l'état de toutes les connexions et la suppression d'une session
modifie l'ordre de ces informations.

Sur certains systèmes d'exploitation, la connexion de contrôle n'est pas valide après un fork(), de sorte que
les opérations dans les sous-shells, sur le côté gauche d'un pipeline ou en arrière-plan ne sont pas
possible, comme il se doit. Il s'agit vraisemblablement d'un bug du système d'exploitation.

L' ZSH/ZLE MODULE

Votre zsh/zle module contient l'éditeur de ligne Zsh. Voir zshzle (1).

L' PARAMÈTRE ZSH/ZLE MODULE

Votre zsh/zleparamètre module définit deux paramètres spéciaux qui peuvent être utilisés pour accéder
informations internes de l'éditeur de ligne Zsh (voir zshzle(1)).

mappages de touches
Ce tableau contient les noms des keymaps actuellement définis.

widgets
Ce tableau associatif contient une entrée par widget défini. Le nom du
widget est la clé et la valeur donne des informations sur le widget. C'est soit
la chaîne `builtin' pour les widgets intégrés, une chaîne de la forme `utilisateur:prénom' pour
widgets définis par l'utilisateur, où prénom est le nom de la fonction shell implémentant le
widget, ou c'est une chaîne de la forme `achèvement:type:prénom', pour l'achèvement
widgets. Dans le dernier cas type est le nom des widgets intégrés la complétion
widget imite dans son comportement et prénom est le nom de la fonction shell
implémentant le widget de complétion.

L' ZSH/ZPROF MODULE

Lorsqu'il est chargé, le zsh/zprof provoque le profilage des fonctions shell. Les résultats du profilage
peut être obtenue avec le zprof commande intégrée rendue disponible par ce module. Il n'y a pas
autre moyen de désactiver le profilage que de décharger le module.

zprof [ -c ]
Sans le -c option, zprof répertorie les résultats de profilage sur la sortie standard. le
format est comparable à celui des commandes comme gprof.

En haut, il y a un résumé listant toutes les fonctions qui ont été appelées au moins une fois.
Ce résumé est trié par ordre décroissant du temps passé dans chacun.
Les lignes contiennent le numéro de la fonction dans l'ordre, qui est utilisé dans d'autres parties
de la liste en suffixes de la forme `[num]', alors le nombre d'appels effectués vers le
une fonction. Les trois colonnes suivantes répertorient le temps en millisecondes passé dans le
fonction et ses descendants, le temps moyen en millisecondes passé dans la
fonction et ses descendants par appel et le pourcentage de temps passé dans tous les shell
fonctions utilisées dans cette fonction et ses descendants. Les trois colonnes suivantes
donnent les mêmes informations, mais en ne comptant que le temps passé dans la fonction elle-même.
La dernière colonne affiche le nom de la fonction.

Après le résumé, des informations détaillées sur chaque fonction invoquée sont
listés, triés par ordre décroissant du temps passé dans chaque fonction et
ses descendants. Chacune de ces entrées consiste en des descriptions des fonctions
qui a appelé la fonction décrite, la fonction elle-même et les fonctions qui
ont été appelés d'elle. La description de la fonction elle-même a le même format
comme dans le résumé (et affiche les mêmes informations). Les autres lignes n'affichent pas le
numéro de la fonction au début et ont leur fonction nommée en retrait pour
faciliter la distinction de la ligne indiquant la fonction décrite dans le
section des lignes environnantes.

Les informations affichées dans ce cas sont presque les mêmes que dans le résumé, mais seulement
fait référence à la hiérarchie des appels affichée. Par exemple, pour une fonction appelante
la colonne indiquant le temps de fonctionnement total répertorie le temps passé dans le
fonction et ses descendants uniquement pour les moments où elle a été appelée à partir de cette
fonction d'appel particulière. De même, pour une fonction appelée, cette colonne répertorie
le temps total passé dans la fonction appelée et ses descendants uniquement pour les temps
lorsqu'il a été appelé à partir de la fonction décrite.

Dans ce cas également, la colonne indiquant le nombre d'appels à une fonction affiche également
une barre oblique, puis le nombre total d'appels effectués à la fonction appelée.

Tant que le zsh/zprof module est chargé, le profilage sera effectué et plusieurs
invocations des zprof la commande intégrée affichera les heures et le nombre d'appels
puisque le module a été chargé. Avec le -c option, la zprof la commande intégrée
réinitialiser ses compteurs internes et n'affichera pas la liste.

L' ZSH/ZPTY MODULE

Votre zsh/zpty module offre un intégré :

zpty [ -e ] [ -b ] prénom [ arg ...]
Les arguments suivants prénom sont concaténés avec des espaces entre eux, puis exécutés comme
une commande, comme si elle était passée au eval intégré. La commande s'exécute sous un nouvel
pseudo-terminal affecté ; ceci est utile pour exécuter des commandes de manière non interactive
qui attendent un environnement interactif. le prénom ne fait pas partie de la commande, mais
est utilisé pour faire référence à cette commande dans les appels ultérieurs à zpty.

Le -e option, le pseudo-terminal est configuré de manière à ce que les caractères d'entrée soient
fait écho.

Le -b option, l'entrée et la sortie du pseudo-terminal sont effectuées
non bloquant.

Le paramètre shell RÉPONDRE est défini sur le descripteur de fichier attribué au côté maître
du pseudo-terminal. Cela permet de surveiller le terminal avec ZLE
gestionnaires de descripteurs (voir zshzle(1)) ou manipulé avec lecture système et écriture système (voir
LE MODULE ZSH/SYSTÈME dans zshmodules(1)). Avertissement: Utilisation de lecture système et écriture système is
pas utilisation recommandée zpty -r et zpty -w à moins que vous ne sachiez exactement ce que vous êtes
Faire.

zpty -d [ prénom ...]
La deuxième forme, avec le -d option, permet de supprimer des commandes précédemment lancées,
en fournissant une liste de leurs prénoms. Sinon prénom est donnée, toutes les commandes sont supprimées.
La suppression d'une commande entraîne l'envoi du signal HUP au processus correspondant.

zpty -w [ -n ] prénom [ un magnifique ...]
Votre -w l'option peut être utilisée pour envoyer la commande à prénom le donné un magnifiques comme entrée
(séparés par des espaces). Si la -n option est pas donné, une nouvelle ligne est ajoutée à la
fin.

Sinon un magnifique est fournie, l'entrée standard est copiée sur le pseudo-terminal ; ce
peut s'arrêter avant de copier l'entrée complète si le pseudo-terminal n'est pas bloquant.

Notez que la commande sous le pseudo-terminal voit cette entrée comme si elle était
tapé, alors méfiez-vous lors de l'envoi de caractères spéciaux du pilote tty tels que l'effacement de mots,
ligne-kill et fin de fichier.

zpty -r [ -mt ] prénom [ arrêter [ modèle ] ]
Votre -r L'option peut être utilisée pour lire la sortie de la commande prénom. Avec seulement un prénom
argument, la sortie lue est copiée sur la sortie standard. À moins que le
pseudo-terminal est non bloquant, la copie continue jusqu'à la commande sous le
les sorties pseudo-terminales ; lorsqu'il n'est pas bloquant, seulement autant de sortie qu'immédiatement
disponible est copié. L'état de retour est zéro si une sortie est copiée.

Lorsqu'on lui donne aussi un arrêter argument, au plus une ligne est lue et stockée dans l'argument
paramètre nommé arrêter. Moins d'une ligne complète peut être lue si le pseudo-terminal est
non bloquant. L'état de retour est zéro si au moins un caractère est stocké dans
arrêter.

Si un modèle est également donné, la sortie est lue jusqu'à ce que la chaîne entière lue corresponde
le modèle, même dans le cas non bloquant. Le statut de retour est zéro si le
la chaîne lue correspond au modèle, ou si la commande s'est terminée mais au moins une
caractère pouvait encore être lu. Si l'option -m est présent, le statut de retour est
zéro uniquement si le motif correspond. Au moment d'écrire ces lignes, un maximum d'un mégaoctet de
la sortie peut être consommée de cette façon ; si un mégaoctet complet est lu sans correspondre au
motif, le statut de retour est différent de zéro.

Dans tous les cas, le statut de retour est différent de zéro si rien n'a pu être lu, et est 2 if
c'est parce que la commande est terminée.

Si la -r l'option est combinée avec la -t option, zpty teste si la sortie est
disponible avant d'essayer de lire. Si aucune sortie n'est disponible, zpty immédiatement
retourne le statut 1. Lorsqu'il est utilisé avec un modèle, le comportement en cas d'échec du sondage est
similaire à la sortie de la commande : la valeur de retour est zéro si au moins un
Le caractère peut toujours être lu même si le motif ne correspond pas.

zpty -t prénom
Votre -t option sans le -r L'option peut être utilisée pour tester si la commande prénom is
cours toujours. Il renvoie un état zéro si la commande est en cours d'exécution et un état non nul
valeur autrement.

zpty [ -L ]
La dernière forme, sans aucun argument, permet de lister les commandes actuellement
défini. Si la -L l'option est donnée, cela se fait sous la forme d'appels au zpty
intégré.

L' ZSH/ZSELECT MODULE

Votre zsh/zselect module rend disponible une commande intégrée :

zselect [ -rwe ] [ -t temps mort ] [ -a tableau ] [ -A Assoc ] [ fd ...]
Votre zselect builtin est une interface pour l'appel système `select', qui bloque jusqu'à ce que
un descripteur de fichier est prêt pour la lecture ou l'écriture, ou a une condition d'erreur, avec
un délai d'attente facultatif. Si cela n'est pas disponible sur votre système, la commande imprime
un message d'erreur et renvoie l'état 2 (les erreurs normales renvoient l'état 1). Pour plus
informations, consultez la documentation de votre système pour Sélectionner(3). Remarque il n'y a pas
connexion avec le shell intégré du même nom.

Les arguments et les options peuvent être entremêlés dans n'importe quel ordre. Les arguments non optionnels sont
descripteurs de fichiers, qui doivent être des entiers décimaux. Par défaut, les descripteurs de fichiers sont
être testé pour la lecture, c'est-à-dire zselect reviendra lorsque les données seront disponibles pour être
lu à partir du descripteur de fichier, ou plus précisément, lorsqu'une opération de lecture à partir du
le descripteur de fichier ne bloquera pas. Après un -r, -w et -e, les descripteurs de fichiers donnés
doivent être testés pour la lecture, l'écriture ou les conditions d'erreur. Ces options et un
une liste arbitraire de descripteurs de fichiers peut être donnée dans n'importe quel ordre.

(La présence d'une "condition d'erreur" n'est pas bien définie dans la documentation pour
de nombreuses implémentations de l'appel système select. Selon les dernières versions de
la spécification POSIX, c'est vraiment un exception état, dont le seul
l'exemple standard est celui des données hors bande reçues sur une prise. Les utilisateurs de zsh sont donc
peu de chances de trouver le -e option utile.)

L'option `-t temps mort' spécifie un délai d'attente en centièmes de seconde. Cela peut être
zéro, auquel cas les descripteurs de fichiers seront simplement interrogés et zselect sera
reviens immédiatement. Il est possible d'appeler zselect sans descripteur de fichier et avec un
délai d'attente non nul pour une utilisation en remplacement plus fin de `sleep' ; notez cependant que
le statut de retour est toujours 1 pour un timeout.

L'option `-a tableau' indique que tableau doit être défini pour indiquer le fichier
descripteur(s) qui sont prêts. Si l'option n'est pas donnée, le tableau répondre sera
utilisé à cette fin. Le tableau contiendra une chaîne similaire aux arguments
pour zselect. Par exemple,

zselect -t 0 -r 0 -w 1

pourrait revenir immédiatement avec le statut 0 et $répondre contenant `-r 0 -w 1' montrer
que les deux descripteurs de fichier sont prêts pour les opérations demandées.

L'option `-A Assoc' indique que le tableau associatif Assoc devrait être réglé sur
indiquer le(s) descripteur(s) de fichier qui sont prêts. Cette option remplace l'option
-a, ni ne répondre être modifié. Les clés de Assoc sont les descripteurs de fichiers, et
les valeurs correspondantes sont l'un des caractères `rwe' pour indiquer l'état.

La commande renvoie l'état 0 si certains descripteurs de fichiers sont prêts à être lus. Si
l'opération a expiré, ou un délai de 0 a été donné et aucun descripteur de fichier n'a été
prêt, ou il y a eu une erreur, il renvoie l'état 1 et le tableau ne sera pas défini
(ni modifié de quelque manière que ce soit). S'il y a eu une erreur dans l'opération de sélection,
message d'erreur approprié est imprimé.

L' ZSH/ZUTIL MODULE

Votre zsh/zutil module n'ajoute que quelques éléments intégrés :

stylez [ -L [ modèle [ Catégorie ] ] ]
stylez [ -e | - | -- ] modèle Catégorie un magnifique
stylez -d [ modèle [ Catégorie ... ] ]
stylez -g prénom [ modèle [ Catégorie ] ]
stylez -{a|b|s} aux contextes Catégorie prénom [ sep ]
stylez -{T|t} aux contextes Catégorie [ un magnifique ...]
stylez -m aux contextes Catégorie modèle
Cette commande intégrée est utilisée pour définir et rechercher des styles. Les styles sont des paires de
noms et valeurs, où les valeurs consistent en un nombre quelconque de chaînes. Elles sont
stocké avec des modèles et la recherche se fait en donnant une chaîne, appelée le
`context', qui est comparé aux modèles. La définition stockée pour le premier
le motif correspondant sera renvoyé.

Pour l'ordre des comparaisons, les modèles sont recherchés du plus spécifique au moins
spécifiques, et les modèles qui sont également spécifiques conservent l'ordre dans lequel ils ont été
défini. Un motif est considéré comme plus spécifique qu'un autre s'il contient
plusieurs composants (sous-chaînes séparées par des deux-points) ou si les modèles pour le
les composants sont plus spécifiques, où les chaînes simples sont considérées comme plus
spécifiques que les modèles et les modèles complexes sont considérés comme plus spécifiques que
le motif `*'.

La première forme (sans arguments) liste les définitions. Les styles sont affichés dans
l'ordre alphabétique et les motifs sont affichés dans l'ordre stylez va les tester.

Si la -L l'option est donnée, le listage se fait sous la forme d'appels à stylezL’
le premier argument facultatif est un modèle qui sera mis en correspondance avec la chaîne
fourni comme modèle pour le contexte ; notez que cela signifie, par exemple, `stylez
-L ":achèvement:*"' correspondra à tout modèle fourni commençant par `:achèvement:', ne pas
juste ":achèvement:*": utilisation ":achèvement:\*" pour correspondre à cela. La seconde optionnelle
l'argument limite la sortie à une valeur spécifique Catégorie (pas un modèle). -L n'est pas
compatible avec toutes les autres options.

Les autres formulaires sont les suivants :

stylez [ - | -- | -e ] modèle Catégorie un magnifique
Définit le donné Catégorie pour modèle couplé à un magnifiques comme valeur. Si
le -e l'option est donnée, le un magnifiques seront concaténés (séparés par
espaces) et la chaîne résultante sera évaluée (de la même manière qu'elle est
fait par le eval commande intégrée) lorsque le style est recherché. Dans ce cas
le paramètre `répondre' doit être affecté pour définir les chaînes renvoyées après le
évaluation. Avant d'évaluer la valeur, répondre n'est pas défini, et s'il est toujours
non défini après l'évaluation, le style est traité comme s'il n'était pas défini.

stylez -d [ modèle [ Catégorie ... ] ]
Supprimer les définitions de style. Sans arguments toutes les définitions sont supprimées,
avec modèle toutes les définitions de ce modèle sont supprimées et le cas échéant
Catégories sont donnés, seuls ces styles sont supprimés pour le modèle.

stylez -g prénom [ modèle [ Catégorie ] ]
Récupérer une définition de style. le prénom est utilisé comme nom d'un tableau dans
dans lequel les résultats sont stockés. Sans autre argument, tous les modèles
définis sont renvoyés. Avec un modèle les styles définis pour ce motif sont
de retour et avec à la fois un modèle et Catégorie, les chaînes de valeur de ce
combinaison est renvoyée.

Les autres formulaires peuvent être utilisés pour rechercher ou tester des modèles.

stylez -s aux contextes Catégorie prénom [ sep ]
Le paramètre prénom est défini sur la valeur du style interprété comme une chaîne.
Si la valeur contient plusieurs chaînes, elles sont concaténées avec des espaces (ou
couplé à sep chaîne si elle est donnée) entre eux.

stylez -b aux contextes Catégorie prénom
La valeur est stockée dans prénom comme un booléen, c'est-à-dire comme la chaîne `oui' si la
value n'a qu'une seule chaîne et cette chaîne est égale à l'un des `oui', 'oui',
`on', ou '1'. Si la valeur est une autre chaîne ou a plus d'une chaîne,
le paramètre est défini sur `aucune'.

stylez -a aux contextes Catégorie prénom
La valeur est stockée dans prénom sous forme de tableau. Si prénom est déclaré comme un
tableau associatif, les première, troisième, etc. chaînes sont utilisées comme clés et
les autres chaînes sont utilisées comme valeurs.

stylez -t aux contextes Catégorie [ un magnifique ...]
stylez -T aux contextes Catégorie [ un magnifique ...]
Testez la valeur d'un style, c'est-à-dire -t l'option ne renvoie qu'un statut (définit
$?). Sans aucun un magnifique le statut de retour est zéro si le style est défini
pour au moins un motif correspondant, n'a qu'une seule chaîne dans sa valeur, et
qui est égal à l'un des `oui', 'oui', 'on' ou '1'. Si seulement un magnifiques sont donnés
le statut est nul si et seulement si au moins un des un magnifiques est égal à à
au moins une des chaînes de la valeur. Si le style est défini mais pas
match, le statut de retour est 1. Si le style n'est pas défini, le statut est 2.

Votre -T option teste les valeurs du style comme -t, mais il renvoie le statut
zéro (plutôt que 2) si le style n'est défini pour aucun motif correspondant.

stylez -m aux contextes Catégorie modèle
Faites correspondre une valeur. Renvoie l'état zéro si le modèle correspond à au moins un des
les chaînes dans la valeur.

formatz -f arrêter le format spec
formatz -a tableau sep spec
Cette fonction intégrée fournit deux formes différentes de formatage. Le premier formulaire est sélectionné
couplé à -f option. Dans ce cas le le format chaîne sera modifiée en remplaçant
séquences commençant par un signe de pourcentage avec des chaînes de la specs. Chaque
spec doit être de la forme 'carboniser:un magnifique' qui causera chaque apparition du
séquence `%carboniser' dans le format être remplacé par le un magnifique. Le `%' séquence peut également
contiennent des spécifications facultatives de largeur de champ minimum et maximum entre le `%' et
le `carboniser' sous la forme `%m..maxc', c'est-à-dire que la largeur de champ minimale est donnée en premier et
si la largeur de champ maximale est utilisée, elle doit être précédée d'un point. Spécification d'un
la largeur de champ minimale fait que le résultat soit rempli d'espaces à droite si le
un magnifique est plus courte que la largeur demandée. Le rembourrage à gauche peut être obtenu en
donnant une largeur de champ minimale négative. Si une largeur de champ maximale est spécifiée, le
un magnifique sera tronqué après ce nombre de caractères. Après tout `%' séquences pour
le donné specs ont été traités, la chaîne résultante est stockée dans le
paramètre arrêter.

Votre %-escapes comprend également les expressions ternaires sous la forme utilisée par les invites. le
% est suivi d'un `(' puis un caractère spécificateur de format ordinaire comme décrit
au dessus. Il peut y avoir un ensemble de chiffres avant ou après le `('; ceux-ci précisent
un numéro de test, qui est zéro par défaut. Les nombres négatifs sont également autorisés. Une
caractère de délimitation arbitraire suit le spécificateur de format, qui est suivi d'un
morceau de texte « vrai », le caractère délimiteur à nouveau, un morceau de texte « faux » et un
parenthèse fermante. L'expression complète (sans les chiffres) ressemble donc à
`%(X.text1.text2)', sauf que le `.' est arbitraire. La valeur donnée
pour le spécificateur de format dans le carboniser:un magnifique expressions est évalué comme un
expression mathématique, et comparée au numéro du test. S'ils sont identiques,
text1 est sortie, sinon text2 est sortie. Une parenthèse peut être échappée dans text2 as
%). Soit de text1 or text2 peut contenir imbriqué %-évasions.

Par exemple :

formatz -f RÉPONDRE "La répondre is '%3(c.oui.non)'." c:3

affiche "La réponse est 'oui'." pour RÉPONDRE puisque la valeur du spécificateur de format c
est 3, en accord avec l'argument numérique de l'expression ternaire.

La deuxième forme, en utilisant le -a option, peut être utilisée pour aligner les chaînes. Ici le
specs sont de la forme `à gauche:bon' où 'à gauche' et 'bon' sont des chaînes arbitraires.
Ces chaînes sont modifiées en remplaçant les deux-points par le sep corde et rembourrage
le à gauche chaînes avec des espaces à droite pour que le sep chaînes dans le résultat
(et donc le bon chaînes après eux) sont tous alignés si les chaînes sont imprimées
l'un en dessous de l'autre. Toutes les chaînes sans deux-points restent inchangées et toutes les chaînes
avec un vide bon string ont les deux-points de fin supprimés. Dans les deux cas le
les longueurs des chaînes ne sont pas utilisées pour déterminer comment les autres chaînes doivent être
aligné. Les chaînes résultantes sont stockées dans le tableau.

zregexparse
Cela implémente certains éléments internes du _regex_arguments la fonction.

zparseopts [ -DKME ] [ -a tableau ] [ -A Assoc ] spec
Cette fonction intégrée simplifie l'analyse des options dans les paramètres de position, c'est-à-dire le
ensemble d'arguments donné par $*. Chaque spec décrit une option et doit être du
forme `opter[=tableau]'. Si une option décrite par opter se trouve dans la position
paramètres, il est copié dans le tableau spécifié avec le -a option; si la
facultatif `=tableau' est donné, il est à la place copié dans ce tableau.

Notez que c'est une erreur de donner spec sans `=tableau' à moins que l'un des -a
or -A options est utilisé.

Sauf si -E option est donnée, l'analyse s'arrête à la première chaîne qui n'est pas
décrit par l'un des specs. Même avec -E, l'analyse s'arrête toujours à une position
paramètre égal à `-' ou '--'.

Votre opter description doit être l'une des suivantes. N'importe lequel des caractères spéciaux
peut apparaître dans le nom de l'option à condition qu'il soit précédé d'une barre oblique inverse.

prénom
prénom+ Votre prénom est le nom de l'option sans le `-'. Pour spécifier un
Option longue de style GNU, l'une des deux habituelles `-' doit être inclus dans
prénom; par exemple, un `--déposer' l'option est représentée par un prénom de `-fichier'.

Si un `+' apparaît après prénom, l'option est ajoutée à tableau à chaque fois c'est
trouvé dans les paramètres de position ; sans le `+' seulement le dernier événement
de l'option est préservée.

Si l'une de ces formes est utilisée, l'option ne prend aucun argument, donc l'analyse
s'arrête si le paramètre positionnel suivant ne commence pas aussi par `-' (à moins que
le -E option est utilisée).

prénom:
prénom:-
prénom:: Si un ou deux deux-points sont donnés, l'option prend un argument ; avec un
deux-points, l'argument est obligatoire et avec deux deux-points, il est facultatif. le
l'argument est annexé au tableau après l'option elle-même.

Un argument facultatif est placé dans le même élément de tableau que le nom de l'option
(notez que cela rend les chaînes vides en tant qu'arguments indiscernables). UNE
l'argument obligatoire est ajouté en tant qu'élément séparé à moins que le `:-' la forme est
utilisé, auquel cas l'argument est placé dans le même élément.

Un `+' tel que décrit ci-dessus peut apparaître entre le prénom et le premier côlon.

Les options de zparseopts sont eux-mêmes :

-a tableau
Comme décrit ci-dessus, cela nomme le tableau par défaut dans lequel stocker le
choix reconnus.

-A Assoc
Si cela est donné, les options et leurs valeurs sont également mises dans un
tableau associatif avec les noms d'options comme clés et les arguments (le cas échéant)
comme les valeurs.

-D Si cette option est donnée, toutes les options trouvées sont supprimées de la position
paramètres du shell appelant ou de la fonction shell, jusqu'à mais non compris
tout non décrit par le specs. Ceci est similaire à l'utilisation de la décalage intégré.

-K Avec cette option, les tableaux spécifiés avec le -a option et avec la
`=tableau' les formulaires restent inchangés lorsqu'aucun des specs pour eux est utilisé.
Sinon, le tableau entier est remplacé lorsque l'un des specs est utilisé.
Les éléments individuels des tableaux associatifs spécifiés avec le -A l'option sont
préservé par -K. Cela permet d'assigner des valeurs par défaut aux tableaux avant
appel zparseopts.

-M Cela modifie les règles d'affectation pour implémenter une carte parmi les options équivalentes
des noms. Si seulement spec utilise le `=tableau' forme, la chaîne tableau est interprété
comme le nom d'un autre spec, qui est utilisé pour choisir où stocker le
valeurs. Si aucun autre spec est trouvé, les valeurs sont stockées comme d'habitude. Ce
ne change que la façon dont les valeurs sont stockées, pas la façon dont $* est analysé, donc
les résultats peuvent être imprévisibles si le `prénom+' le spécificateur est utilisé
de manière incohérente.

-E Cela modifie les règles d'analyse en pas s'arrêter à la première chaîne qui n'est pas
décrit par l'un des specs. Il peut être utilisé pour tester ou (si utilisé
avec -D) extraire les options et leurs arguments, en ignorant tous les autres
options et arguments qui peuvent se trouver dans les paramètres positionnels.

Par exemple,

set -- -a -bx -c y -cz baz -cend
zparseopts un=foo b:=barre c+:=barre

aura pour effet de

truc=(-a)
barre=(-b x -c y -c z)

Les arguments de `baz' sur ne sera pas utilisé.

A titre d'exemple pour le -E possibilité, pensez à :

set -- -a x -b y -c z argument1 argument2
zparseopts -E -D b:=barre

aura pour effet de

barre=(-b y)
set -- -a x -c z argument1 argument2

c'est-à-dire l'option -b et ses arguments sont tirés des paramètres positionnels et
mettre dans le tableau Bar.

Votre -M L'option peut être utilisée comme ceci :

set -- -a -bx -c y -cz baz -cend
zparseopts -A Bar -M un=foo b+ : c:=b

avoir pour effet de

truc=(-a)
barre=(-a '' -b xyz)

Utiliser zshmodules en ligne à l'aide des services onworks.net