zshmodules - מקוון בענן

תָכְנִית:

שֵׁם

zshmodules - מודולים הניתנים לטעינה של zsh

תיאור

חלקים אופציונליים מסוימים של zsh נמצאים במודולים, נפרדים מליבת המעטפת. כל אחד מ
מודולים אלה עשויים להיות מקושרים למעטפת בזמן הבנייה, או שניתן לקשר אותם באופן דינמי
בזמן שהמעטפת פועלת אם ההתקנה תומכת בתכונה זו. מודולים מקושרים
בזמן ריצה עם zmodload פקודה, ראה zshbuiltins(1).

המודולים המצורפים להפצת zsh הם:

zsh/attr
מבנים עבור מניפולציה של תכונות מורחבות (xattr).

zsh/cap
מובנה עבור מניפולציה של ערכות יכולות (הרשאות) של POSIX.1e (POSIX.6).

zsh/clone
מובנה שיכול לשכפל מעטפת פועלת על טרמינל אחר.

zsh/compctl
השמיים compctl מובנה לשליטה בהשלמה.

zsh/complete
קוד ההשלמה הבסיסי.

zsh/complist
הרחבות רישום השלמה.

zsh/computil
מודול עם רכיבי עזר מובנים הדרושים להשלמת פונקציית המעטפת
מערכת.

zsh/קללות
מקלל פקודות חלונות

zsh/datetime
כמה פקודות ופרמטרים של תאריך/שעה.

zsh/db/gdbm
מובנה לניהול פרמטרי מערך אסוציאטיביים הקשורים לבסיסי נתונים של GDBM.

zsh/deltochar
פונקציית ZLE משכפלת EMACS' zap-to-char.

zsh/example
דוגמה לכתיבת מודול.

zsh/files
כמה פקודות מניפולציה בסיסיות של קבצים כמו מובנה.

zsh/langinfo
ממשק למידע מקומי.

zsh/mapfile
גישה לקבצים חיצוניים באמצעות מערך אסוציאטיבי מיוחד.

zsh/mathfunc
פונקציות מדעיות סטנדרטיות לשימוש בהערכות מתמטיות.

zsh/newuser
ארגן התקנת קבצים עבור משתמשים חדשים.

zsh/פרמטר
גישה לטבלאות Hash פנימיות באמצעות מערכים אסוציאטיביים מיוחדים.

zsh/pcre
ממשק לספריית PCRE.

zsh/regex
ממשק לספריית POSIX regex.

zsh/sched
מובנה המספק מתקן ביצוע מתוזמן בתוך המעטפת.

zsh/net/socket
מניפולציה של שקעי תחום יוניקס

zsh/stat
ממשק פקודה מובנה ל- stat שיחת מערכת.

zsh/system
ממשק מובנה לתכונות מערכת שונות ברמה נמוכה.

zsh/net/tcp
מניפולציה של שקעי TCP

zsh/termcap
ממשק למסד הנתונים termcap.

zsh/termininfo
ממשק למסד הנתונים terminfo.

zsh/zftp
לקוח FTP מובנה.

zsh/zle
עורך קו Zsh, כולל ה bindkey ו מגוון מובנה.

zsh/zleparameter
גישה לפרמטרים הפנימיים של עורך הקו של Zsh באמצעות פרמטרים.

zsh/zprof
מודול המאפשר יצירת פרופילים עבור פונקציות מעטפת.

zsh/zpty
מובנה להפעלת פקודה בפסאודו-טרמינל.

zsh/zselect
חסום והחזר כאשר מתארי הקבצים מוכנים.

זש/זוטיל
כמה מבנים של כלי שירות, למשל זה לתמיכה בתצורה באמצעות סגנונות.

LA ZSH/ATTR מודול

השמיים zsh/attr מודול משמש למניפולציה של תכונות מורחבות. ה -h אופציות גורמות
כל הפקודות לפעול על קישורים סמליים במקום המטרות שלהם. המובנים בזה
המודול הם:

zgetattr [ -h ] שם הקובץ תכונה [ פרמטר ]
קבל את התכונה המורחבת תכונה מהמצוין שם הקובץ. אם האופציונלי
טענה פרמטר נתון, התכונה מוגדרת על הפרמטר הזה במקום
מודפס ל-stdout.

zsetattr [ -h ] שם הקובץ תכונה ערך
הגדר את התכונה המורחבת תכונה על המצוין שם הקובץ ל ערך.

zdelattr [ -h ] שם הקובץ תכונה
הסר את התכונה המורחבת תכונה מהמצוין שם הקובץ.

זליסטטר [ -h ] שם הקובץ [ פרמטר ]
רשום את התכונות המורחבות המוגדרות כעת על המצוין שם הקובץ. אם
טיעון אופציונלי פרמטר נתון, רשימת התכונות מוגדרת על זה
פרמטר במקום להיות מודפס ל-stdout.

zgetattr ו זליסטטר הקצאת זיכרון באופן דינמי. אם התכונה או רשימה של
תכונות גדלות בין ההקצאה לקריאה לקבל אותן, הן חוזרות 2. על הכל
שגיאות אחרות, 1 מוחזר. זה מאפשר לפונקציה המתקשרת לבדוק את המקרה הזה ו
נסה שוב.

LA ZSH/CAP מודול

השמיים zsh/cap מודול משמש למניפולציה של ערכות יכולות POSIX.1e (POSIX.6). אם ה
מערכת ההפעלה אינה תומכת בממשק זה, המובנים המוגדרים על ידי מודול זה יעשו זאת
לעשות כלום. הרכיבים המובנים במודול זה הם:

כּוֹבַע [ יכולות ]
שנה את ערכות יכולות התהליך של המעטפת למצוין יכולות, אחרת
להציג את היכולות הנוכחיות של המעטפת.

getcap שם הקובץ ...
זהו יישום מובנה של כלי השירות הסטנדרטי POSIX. הוא מציג את
ערכות יכולות בכל אחד שצוין שם הקובץ.

setcap יכולות שם הקובץ ...
זהו יישום מובנה של כלי השירות הסטנדרטי POSIX. זה קובע את
ערכות יכולות בכל אחד שצוין שם הקובץ לצוין יכולות.

LA ZSH/CLONE מודול

השמיים zsh/clone מודול זמין פקודה מובנית אחת:

לשבט tty
יוצר מופע מזולג של המעטפת הנוכחית, מצורף למצוין tty,
הקליפה החדשה, ה מח"ש, PPID ו TTY פרמטרים מיוחדים משתנים כראוי.
$! מוגדר לאפס במעטפת החדשה, ול-PID של המעטפת החדשה במקור
צדף.

סטטוס ההחזרה של ה-buildin הוא אפס בשתי הקונכיות אם מצליח, ולא אפס
על טעות.

היעד של לשבט צריך להיות מסוף שאינו בשימוש, כגון קונסולה וירטואלית שאינה בשימוש
או מסוף וירטואלי שנוצר על ידי

x מונח -e sh -c 'מַלכּוֹדֶת : INT תיכנע TSTP; tty;
בזמן :; do לִישׁוֹן 100000000; בוצע'

יש צורך בכמה מילות הסבר לגבי שורת הפקודה ארוכת הטווח הזו: when
עושה שיבוט על פסאודו-טרמינל, סשן אחר ("סשן" פירושו יוניקס
קבוצת session, או SID) כבר הבעלים של הטרמינל. מכאן שה-zsh המשובט לא יכול
לרכוש את הפסאודו-טרמינל כ-tty שולט. זה אומר שני דברים:

· אותות בקרת העבודה יעברו לקבוצת התהליך sh-started-by-xterm
(זו הסיבה שאנו משביתים את INT QUIT ו-TSTP עם trap; אחרת לולאת while
עלול להיות מושעה או להיהרג)

· במעטפת המשובטת תהיה בקרת העבודה מושבתת, ומקשי בקרת העבודה
(control-C, control-\ ו-control-Z) לא יפעלו.

זה לא חל בעת שיבוט ל-an לא בשימוש vc.

שיבוט למסוף משומש (ולא מוכן) יביא לקריאת שני תהליכים
בו זמנית מאותו מסוף, כאשר בייטי קלט עוברים באופן אקראי לכל אחד מהם
התהליך.

לשבט שימושי בעיקר כתחליף מובנה במעטפת עבור openvt.

LA ZSH/COMPCTL מודול

השמיים zsh/compctl מודול מאפשר שתי פקודות מובנות. compctl, האם הישן,
דרך מיושנת לשלוט בהשלמות עבור ZLE. לִרְאוֹת zshcompctl(1). השני מובנה
פקודה, compcall ניתן להשתמש בווידג'טים של השלמה המוגדרים על ידי המשתמש, ראה zshcompwid(1).

LA ZSH/השלם מודול

השמיים zsh/complete מודול זמין מספר פקודות מובנות בהן ניתן להשתמש ב
ווידג'טים להשלמה המוגדרים על ידי המשתמש, ראה zshcompwid(1).

LA ZSH/COMPLIST מודול

השמיים zsh/complist מודול מציע שלוש הרחבות לרשימות השלמה: היכולת
הדגשת התאמות ברשימה כזו, היכולת לגלול בין רשימות ארוכות ושונה
סגנון השלמת התפריט.

צבע השלמה רישומים
בכל פעם שאחד מהפרמטרים ZLS_COLORS or ZLS_COLOURS מוגדר ואת zsh/complist
מודול נטען או מקושר למעטפת, רשימות ההשלמות יהיו צבעוניות. הערה,
אולם, זאת קומפלסט לא ייטען אוטומטית אם הוא לא מקושר ב: on
מערכות עם טעינה דינמית, `zmodload zsh/complist' נדרש.

הפרמטרים ZLS_COLORS ו ZLS_COLOURS לתאר כיצד התאמות מודגשות. לפנות
די בהדגשת ערך ריק, ובמקרה זה כל ערכי ברירת המחדל המפורטים להלן
יהיה בשימוש. הפורמט של הערך של פרמטרים אלה זהה לפורמט של ה-GNU
גרסה של ls פקודה: רשימה מופרדת בנקודתיים של מפרטים של הטופס
`שם=ערך'. ה שם עשויה להיות אחת מהמחרוזות הבאות, רובן מציינות קובץ
סוגים שעבורם ה ערך יהיה בשימוש. המחרוזות וערכי ברירת המחדל שלהן הם:

לא 0 עבור טקסט רגיל (כלומר כאשר מציגים משהו שאינו קובץ תואם)

fi 0 עבור קבצים רגילים

di 32 עבור ספריות

ln 36 לקישורים סמליים. אם יש לזה ערך מיוחד יעד, קישורים סמליים הם
derreferenced וקובץ היעד המשמש לקביעת פורמט התצוגה.

pi 31 עבור צינורות עם שם (FIFOs)

so 33 עבור שקעים

bd 44; 37
עבור התקני חסימה

cd 44; 37
עבור מכשירי אופי

or אף לא אחד
עבור קישור סימול לקובץ לא קיים (ברירת המחדל היא הערך שהוגדר עבור ln)

mi אף לא אחד
עבור קובץ לא קיים (ברירת המחדל היא הערך שהוגדר עבור fi); הקוד הזה הוא
כרגע לא בשימוש

su 37; 41
עבור קבצים עם setuid bit set

sg 30; 43
עבור קבצים עם setgid bit set

tw 30; 42
עבור ספריות לכתיבה עולמיות עם סט סיביות דביקות

ow 34; 43
עבור ספריות לכתיבה עולמיות ללא סט סיביות דביקות

sa אף לא אחד
עבור קבצים עם כינוי סיומת משויך; זה נבדק רק לאחר ספציפי
סיומות, כמתואר להלן

st 37; 44
עבור ספריות עם סט סיביות דביקות אך לא ניתנות לכתיבה בעולם

ex 35 עבור קבצי הפעלה

lc \ה[ עבור הקוד השמאלי (ראה למטה)

rc m עבור הקוד הנכון

tc 0 עבור התו המציין את סוג הקובץ המודפס אחרי שמות הקבצים אם
LIST_TYPES האפשרות מוגדרת

sp 0 עבור הרווחים המודפסים לאחר התאמות כדי ליישר את העמודה הבאה

ec אף לא אחד
עבור קוד הסיום

מלבד המיתרים הללו, ה שם עשויה להיות גם כוכבית (`*') ואחריו כל מחרוזת.
השמיים ערך נתון עבור מחרוזת כזו ישמש עבור כל הקבצים ששמם מסתיים ב-
חוּט. ה שם יכול להיות גם סימן שוויון (`=') ואחריו דפוס; ה
EXTENDED_GLOB האפשרות תופעל להערכת הדפוס. ה ערך ניתן עבור
דפוס זה ישמש עבור כל ההתאמות (לא רק שמות הקבצים) שהמחרוזת לתצוגה שלהן
מותאם לפי התבנית. הגדרות לטופס עם סימן השוויון המוביל
עדיפות על הערכים שהוגדרו עבור סוגי קבצים, אשר בתורם מקבלים עדיפות על פני ה-
טופס עם הכוכבית המובילה (הרחבות קובץ).

הצורה המובילה-שווה מאפשרת גם לצבוע חלקים שונים של המחרוזות המוצגות
באופן שונה. לשם כך, התבנית צריכה להשתמש ב- `(#b)דגל מתגלגל וזוגות של
סוגריים המקיפים את חלקי המיתרים שיש לצבוע אחרת. ב
המקרה הזה ה ערך עשוי להיות מורכב מיותר מקוד צבע אחד מופרד בסימני שוויון. ה
הקוד הראשון ישמש עבור כל החלקים שעבורם לא צוין קוד מפורש וה-
הקודים הבאים ישמשו עבור החלקים המותאמים על ידי תבניות המשנה בסוגריים.
לדוגמה, המפרט `=(#b)(?)*(?)=0=3=7' ישמש עבור כל ההתאמות שהן
באורך שני תווים לפחות וישתמש בקוד `3' עבור הדמות הראשונה, '7' ל
הדמות האחרונה ו`0' לכל השאר.

כל שלוש הצורות של שם עשויה להיות קודמת לתבנית בסוגריים. אם זה ניתן,
מה היא ערך ישמש רק עבור התאמות בקבוצות ששמותיהן תואמים לדפוס
נתון בסוגריים. לדוגמה, `(g*)m*=43' מדגיש את כל ההתאמות שמתחילות ב
`m' בקבוצות ששמותיהן מתחילים ב'g' באמצעות קוד הצבע '43'. במקרה של `lc',
`rc', ו'ec' קודים, מתעלמים מדפוס הקבוצה.

שימו לב גם שכל הדפוסים מנוסים לפי סדר הופעתם בפרמטר
ערך עד שהראשון תואם ולאחר מכן נעשה בו שימוש.

בעת הדפסת התאמה, הקוד מדפיס את הערך של lc, הערך עבור סוג הקובץ או ה-
מפרט תואם אחרון עם '*', הערך של rc, המחרוזת להצגה עבור
להתאים את עצמו, ולאחר מכן את הערך של ec אם זה מוגדר או הערכים של lc, לא, ו rc
if ec אינו מוגדר.

ערכי ברירת המחדל הם תואמי ISO 6429 (ANSI) וניתן להשתמש בהם ב-vt100 תואם
מסופים כגון x מונחס. במסופי מונוכרום ערכי ברירת המחדל לא יהיו גלויים
השפעה. ה צבעים ניתן להשתמש בפונקציה מהתרומה כדי לקבל מערכים אסוציאטיביים
המכיל את הקודים עבור מסופי ANSI (ראה סעיף 'פונקציות אחרות' ב
zshcontrib(1)). למשל, לאחר טעינה צבעים, אפשר להשתמש ב`$colors[red]' להשיג
הקוד עבור צבע הקדמי אדום ו-`$colors[bg-green]' עבור הקוד לרקע
צבע ירוק.

אם נעשה שימוש במערכת ההשלמה שהופעלה על ידי compinit, אין להגדיר פרמטרים אלה
ישירות כי המערכת שולטת בהם בעצמה. במקום זאת, ה רשימה-צבעים סגנון צריך
להשתמש (ראה סעיף 'תצורת מערכת השלמה' ב zshcompsys(1)).

גלילה in השלמה רישומים
כדי לאפשר גלילה ברשימת השלמות, רשימה יש להגדיר פרמטר. שֶׁלָה
הערך ישמש כהנחיה; אם זו המחרוזת הריקה, הנחיה כברירת מחדל תהיה
בשימוש. הערך עשוי להכיל בריחה מהטופס `%x'. זה תומך בריחות `%B',
`%b', `%S', `%s', `%U', `%u', `%F', `%f', `%K', `%k'ו'%{...%}' משמש גם במעטפת
הנחיות וכן שלושה זוגות של רצפים נוספים: a `%l' או '%L' מוחלף ב-
מספר השורה האחרונה המוצגת והמספר הכולל של השורות בטופס `מספר/סה"כ'; א
`%m' או '%M' מוחלף במספר של ההתאמה האחרונה שהוצגה ובמספר הכולל של
התאמות; ו`%p' או '%P' מוחלף ב'חולצות', `תַחתִית' או המיקום של הראשון
קו מוצג באחוזים מסך השורות, בהתאמה. בכל אחד מהמקרים הללו
הטופס עם האות הגדולה יוחלף במחרוזת ברוחב קבוע, מרופד
מימין עם רווחים, בעוד שהצורה של האותיות הקטנות לא תהיה מרופדת.

אם הפרמטר רשימה מוגדר, קוד ההשלמה לא ישאל אם הרשימה צריכה להיות
מוצג. במקום זאת הוא מתחיל מיד להציג את הרשימה, ומפסיק לאחר הראשון
מסך, מציג את ההנחיה בתחתית, ממתין ללחיצת מקש לאחר זמנית
מעבר ל- listsroll מפת מקשים. לחלק מפונקציות zle יש משמעות מיוחדת
תוך כדי גלילה ברשימות:

שלח-הפסק
מפסיק את הרישום ומבטל את המקש שנלחץ

קבל-שורה, היסטוריה למטה, down-line-או-היסטוריה
down-line-או-חיפוש, vi-down-line-or-history
גלילה קדימה שורה אחת

מילה שלמה, תפריט מלא, להרחיב-או-להשלים
הרחבה-או-השלמה-קידומת, תפריט-השלם-או-הרחב
גלילה קדימה מסך אחד

קבל-חיפוש
להפסיק לרשום אבל לא לנקוט פעולה אחרת

כל דמות אחרת מפסיקה לרשום ומיד מעבדת את המפתח כרגיל. כל מפתח
שאינו מחויב ב listsroll מפת מפתח או זה מחויב מפתח לא מוגדר מסתכל למעלה
במפת המקשים שנבחרה כעת.

באשר ZLS_COLORS ו ZLS_COLOURS פרמטרים, רשימה לא צריך להיות מוגדר ישירות
בעת שימוש במערכת השלמה מבוססת פונקציות מעטפת. במקום זאת, ה הנחיה לרשימה סגנון
יש להשתמש.

תפריט מבחר
השמיים zsh/complist מודול מציע גם סגנון חלופי של בחירת התאמות מרשימה,
הנקראת בחירת תפריט, שבה ניתן להשתמש אם המעטפת מוגדרת לחזור אל האחרונה
הנחיה לאחר הצגת רשימת השלמות (ראה את ALWAYS_LAST_PROMPT אפשרות ב
zshoptions(1)).

ניתן להפעיל את בחירת התפריט ישירות על ידי הווידג'ט תפריט-בחר מוגדר על ידי מודול זה.
זהו יישומון ZLE סטנדרטי שניתן לקשור למפתח בדרך הרגילה כפי שמתואר ב
zshzle(1).

לחילופין, הפרמטר תפריט בחירה ניתן להגדיר למספר שלם, מה שנותן את המינימום
מספר התאמות שחייבות להיות נוכחות לפני בחירת תפריט מופעלת אוטומטית.
שיטה שנייה זו מחייבת להתחיל את השלמת התפריט, ישירות מווידג'ט
כמו תפריט מלא, או עקב אחת מהאפשרויות MENU_COMPLETE or AUTO_MENU מוגדר.
If תפריט בחירה מוגדר, אבל הוא 0, 1 או ריק, בחירת התפריט תמיד תתחיל במהלך
השלמת תפריט מעורפלת.

בעת שימוש במערכת ההשלמה המבוססת על פונקציות מעטפת, ה תפריט בחירה פרמטר צריך
לא לשמש (כמו ה ZLS_COLORS ו ZLS_COLOURS פרמטרים שתוארו לעיל). במקום זאת,
מה היא תפריט יש להשתמש בסגנון עם ה בחר=... מילת מפתח.

לאחר תחילת בחירת התפריט, ההתאמות יופיעו. אם יש עוד התאמות
מלהתאים למסך, רק המסך הראשון מוצג. הגפרורים להכנס לתוך
ניתן לבחור בשורת הפקודה מתוך רשימה זו. ברשימה התאמה אחת מסומנת באמצעות
הערך עבור ma מ ZLS_COLORS or ZLS_COLOURS פָּרָמֶטֶר. ערך ברירת המחדל עבור זה
הוא `7' מה שמאלץ את ההתאמה שנבחרה להדגיש באמצעות מצב בולט ב-a
מסוף תואם vt100. אם לא אחת ZLS_COLORS ולא ZLS_COLOURS מוגדר, אותו הדבר
רצף בקרת מסוף כמו עבור `%Sנעשה שימוש בבריחה בהנחיות.

אם יש יותר התאמות מההתאמה על המסך והפרמטר תפריט תפריט מוגדר, שלה
הערך יוצג מתחת להתאמות. זה תומך באותם רצפי בריחה כמו
רשימה, אבל המספר של ההתאמה או הקו המוצג יהיה זה של זה שבו ה-
סימן מוצב. אם הערך שלו הוא המחרוזת הריקה, ייעשה שימוש בהנחיית ברירת מחדל.

השמיים תפריט תפריט ניתן להשתמש בפרמטר כדי לציין את אופן הגלילה ברשימה. אם ה
הפרמטר לא מוגדר, זה נעשה שורה אחר שורה, אם הוא מוגדר ל- `0' (אפס), הרשימה תהיה
גלול חצי ממספר השורות של המסך. אם הערך חיובי, הוא נותן את
מספר השורות לגלילה ואם היא שלילית, הרשימה תגולל במספר
קווים של המסך פחות הערך (המוחלט).

באשר ZLS_COLORS, ZLS_COLOURS ו רשימה פרמטרים, גם לא תפריט תפריט ולא
תפריט תפריט יש להגדיר ישירות בעת שימוש במערכת השלמה מבוססת פונקציות מעטפת.
במקום זאת, בחר-הנחיה ו בחר-גלול יש להשתמש בסגנונות.

קוד ההשלמה לפעמים מחליט לא להציג את כל ההתאמות ברשימה. אלה
התאמות נסתרות הן התאמות שעבורן פונקציית ההשלמה שהוסיפה אותן
ביקשו במפורש שהם לא יופיעו ברשימה (באמצעות ה -n אופציה של קומפד
הפקודה מובנית) או שהן התאמות שמכפילות מחרוזת שכבר נמצאת ברשימה (מכיוון
הם שונים רק בדברים כמו קידומות או סיומות שאינן מוצגות). ברשימה
משמש לבחירת תפריט, עם זאת, אפילו התאמות אלה מוצגות כך שניתן
לבחור אותם. כדי להדגיש התאמות כאלה hi ו du יכולות ב ZLS_COLORS ו
ZLS_COLOURS פרמטרים נתמכים עבור התאמות נסתרות מהסוג הראשון והשני,
בהתאמה.

בחירת התאמות נעשית על ידי הזזת הסימון באמצעות פונקציות תנועת zle.
כאשר לא ניתן להציג את כל ההתאמות על המסך בו-זמנית, הרשימה תגלול למעלה
ולמטה כאשר חוצים את השורה העליונה או התחתונה. לפונקציות zle הבאות יש מיוחדות
כלומר במהלך בחירת התפריט. שים לב שהפעולות הבאות תמיד מבצעות את אותה משימה
בתוך מפת בחירת התפריט ולא ניתן להחליף אותם בווידג'טים המוגדרים על ידי המשתמש, וגם לא את
מערכת פונקציות יורחב:

קבל-שורה, קבל-חיפוש
קבל את ההתאמה הנוכחית ועזוב את בחירת התפריט (אך אל תגרום לפקודה
שורה להתקבל)

שלח-הפסק
עוזב את בחירת התפריט ומשחזר את התוכן הקודם של שורת הפקודה

תצוגה מחודשת, מסך נקי
לבצע את הפונקציה הרגילה שלהם מבלי לעזוב את בחירת התפריט

קבל והחזק, קבל-והשלם-התפריט
קבל את ההתאמה המוכנסת כעת והמשך בבחירה ומאפשר לבחור את
הגפרור הבא להכנס לתוך השורה

לקבל- ולהסיק-ההיסטוריה-הבא
מקבל את ההתאמה הנוכחית ולאחר מכן מנסה להשלים עם בחירת תפריט שוב; ב
במקרה של קבצים זה מאפשר לבחור ספרייה ולנסות מיד
קבצים מלאים בו; אם אין התאמות, מוצגת הודעה וניתן להשתמש בה
לבטל כדי לחזור להשלמה ברמה הקודמת, כל מקש אחר עוזב את התפריט
בחירה (כולל שאר פונקציות zle שהן מיוחדות במהלך
בחירת תפריט)

לבטל מסיר התאמות שהוכנסו במהלך בחירת התפריט על ידי אחת משלוש הפונקציות
לפני

היסטוריה למטה, down-line-או-היסטוריה
vi-down-line-or-history, down-line-או-חיפוש
מזיז את הסימון שורה אחת למטה

up-היסטוריה, up-line-או-history
vi-up-line-or-history, למעלה-שורה-או-חיפוש
מזיז את הסימון שורה אחת למעלה

קדימה-char, vi-forward-char
מזיז את הסימון עמודה אחת ימינה

אחורה-char, vi-backward-char
מזיז את הסימון עמודה אחת שמאלה

מילה קדימה, vi-forward-word
vi-forward-word-end, emacs-forward-word
מזיז את הסימון מסך אחד למטה

מילה לאחור, מילה אחורנית, emacs-backward-word
מזיז את הסימון במסך אחד למעלה

vi-forward-blank-word, vi-forward-blank-word-end
מעביר את הסימון לשורה הראשונה של קבוצת הגפרורים הבאה

vi-לאחור-ריק-מילה
מעביר את הסימון לשורה האחרונה של קבוצת ההתאמות הקודמת

תחילת ההיסטוריה
מעביר את הסימון לשורה הראשונה

סוף ההיסטוריה
מעביר את הסימון לשורה האחרונה

התחלה-של-חיץ-או-היסטוריה, תחילת השורה
תחילת-קו-היסט, vi-beginning-of-line
מעביר את הסימון לעמודה השמאלית ביותר

סוף-חיץ-או-היסטוריה, סוף השורה
סוף-שורה-היסט, vi-end-of-line
מעביר את הסימון לעמודה הימנית ביותר

מילה שלמה, תפריט מלא, להרחיב-או-להשלים
הרחבה-או-השלמה-קידומת, תפריט-הרחב-או-השלם
מעביר את הסימון למשחק הבא

הפוך-תפריט-שלם
מעביר את הסימון להתאמה הקודמת

וי-הכנס
זה עובר בין מצב רגיל לאינטראקטיבי; במצב אינטראקטיבי המקשים
מחויב ל הכנסה עצמית ו הכנסה עצמית-unmeta הכנס לשורת הפקודה כמו ב
מצב עריכה רגיל אך מבלי לצאת מבחירת התפריט; אחרי כל דמות
ההשלמה נוסתה שוב והרשימה משתנה כך שתכיל רק את ההתאמות החדשות; ה
ווידג'טים של השלמה גורמים למחרוזת החד-משמעית הארוכה ביותר להיות מוכנסת בפקודה
קו ו לבטל ו אחורה-מחק-char חזור לקבוצת ההתאמות הקודמת

היסטוריה-חיפוש מצטבר-קדימה
היסטוריה-חיפוש מצטבר-לאחור
זה מתחיל חיפושים מצטברים ברשימת ההשלמות המוצגות; בזה
מצב, קבל-שורה משאיר רק חיפוש מצטבר, חוזר לתפריט הרגיל
מצב בחירה

כל פונקציות התנועה עוטפות בקצוות; כל פונקציית zle אחרת שאינה מופיעה עוזבת
בחירת תפריט ומבצעת פונקציה זו. אפשר לעשות ווידג'טים לעיל
עשה את אותו הדבר על ידי שימוש בצורת הווידג'ט עם `.' מלפנים. לדוגמה, ה
יישומון `.accept-lineיש את ההשפעה של עזיבת בחירת התפריט וקבלת כולו
שורת הפקודה.

במהלך בחירה זו הווידג'ט משתמש במפת המקשים בחירת תפריטים. כל מפתח שאינו מוגדר
במפת המקשים הזו או בה מחויב מפתח לא מוגדר נמצא כעת במפת המקשים
נבחר. זה משמש כדי להבטיח את המפתחות החשובים ביותר בשימוש במהלך הבחירה
(כלומר למקשי הסמן, חזרה ו-TAB) יש ברירות מחדל הגיוניות. עם זאת, מפתחות ב-
בחירת תפריטים ניתן לשנות את מפת המקשים ישירות באמצעות bindkey פקודה מובנית (ראה
zshmodules(1)). לדוגמה, כדי לבצע את מקש החזרה עזוב את בחירת התפריט מבלי לקבל
את המשחק שנבחר כרגע אפשר להתקשר

bindkey -M בחירת תפריטים '^M' שלח-הפסק

לאחר טעינת ה zsh/complist מודול.

LA ZSH/COMPUTIL מודול

השמיים zsh/computil מודול מוסיף מספר פקודות מובנות המשמשות חלק מה-
פונקציות השלמה במערכת ההשלמה המבוססות על פונקציות מעטפת (ראה zshcompsys(1)
). למעט מורכב הפקודות המובנות הללו מאוד מיוחדות ולכן לא מאוד
מעניין בעת ​​כתיבת פונקציות השלמה משלך. לסיכום, אלה מובנים
הפקודות הן:

השוואות
זה משמש את _טיעונים פונקציה כדי לבצע את הארגומנט ושורת הפקודה
ניתוח. כמו לתאר יש לו אפשרות -i לעשות את הניתוח ואתחול
כמה מצב פנימי ואפשרויות שונות לגשת למידע המדינה כדי להחליט
מה צריך להשלים.

לתאר
זה משמש את _לְתַאֵר פונקציה לבניית התצוגות עבור הגפרורים ול
קבל את המחרוזות להוסיף כהתאמות עם האפשרויות שלהן. בשיחה הראשונה אחד מה
אפשרויות -i or -I יש לספק כטיעון הראשון. במקרה הראשון,
מחרוזות תצוגה ללא התיאורים ייווצרו, במקרה השני, ה-
המחרוזת המשמשת להפרדת ההתאמות מהתיאורים שלהן חייבת להינתן בתור
ארגומנט שני והתיאורים (אם יש) יוצגו. כל שאר הטיעונים
הם כמו טיעוני ההגדרה ל _לְתַאֵר עצמו.

פעם לתאר נקרא עם או את -i או -I אפשרות, זה יכול להיות
התקשר שוב ושוב עם -g אפשרות ושמותיהם של ארבעה פרמטרים כמו שלה
טיעונים. זה יעבור דרך הקבוצות השונות של הגפרורים ויאחסן את
ערך של compstate[list] בסקלר הראשון, האפשרויות עבור קומפד בשנייה
מערך, ההתאמות במערך השלישי והמחרוזות שיוצגו ב-
רישום השלמה במערך הרביעי. לאחר מכן ניתן לתת למערכים ישירות
קומפד כדי לרשום את ההתאמות עם קוד ההשלמה.

compfiles
בשימוש על ידי _path_files פונקציה לייעל יצירת שמות קבצים רקורסיביים מורכבים
(גלובב). זה עושה שלושה דברים. עם ה -p ו -P אפשרויות זה בונה את העולם
דפוסים לשימוש, כולל הנתיבים שכבר טופלו וניסיון לייעל את
דפוסים ביחס לקידומת ולסיומת מהשורה ומההתאמה
המפרט בשימוש כרגע. ה -i אפשרות מבצעת את בדיקות הספרייה עבור
התעלמות-הורים סגנון ואת -r בדיקות אופציות אם הוא רכיב עבור חלק מההתאמות
שווים למחרוזת על הקו ומסירים את כל ההתאמות האחרות אם זה נכון.

קבוצות קומבינציה
בשימוש על ידי _tags פונקציה ליישם את הפנימיות של סדר קבוצתי סגנון.
זה לוקח רק את הטיעונים שלו בתור שמות של קבוצות השלמה ויוצר את הקבוצות
עבורו (כל ששת הסוגים: ממוינים ולא ממוינים, שניהם מבלי להסיר כפילויות, עם
הסרת כל הכפילויות ועם הסרת כפילויות עוקבות).

מורכב [ -p ] שמות ...
יכולות להיות סיבות לכתוב פונקציות השלמה שצריכות להוסיף את ההתאמות
באמצעות -Q אפשרות ל קומפד ולבצע ציטוט בעצמם. במקום
לפרש את הדמות הראשונה של כל_המרכאות מפתח של קומסטייט מיוחד
אסוציאציה ושימוש ב q דגל להרחבות פרמטרים, אפשר להשתמש במובנה הזה
פקודה. הארגומנטים הם שמות של פרמטרים סקלרים או מערכים והערכים
מהפרמטרים הללו מצוטט לפי הצורך עבור רמת הציטוט הפנימית ביותר. אם ה
-p ניתנת אפשרות, הציטוט נעשה כאילו יש קידומת כלשהי לפני הערכים של
את הפרמטרים, כך שלא יצוטט סימן שוויון מוביל.

מצב ההחזרה אינו אפס במקרה של שגיאה ואפס אחרת.

קומטאגים
comptry
אלה מיישמים את הפנימיות של מנגנון התגים.

ערכי ערך
כמו השוואות, אלא עבור ה _ערכים פונקציה.

LA ZSH/קללות מודול

השמיים zsh/קללות מודול זמין פקודה מובנית אחת ופרמטרים שונים.

מובנה
zcurses init
zcurses סוף
zcurses addwin targetwin שורות ncols מתחיל_י begin_x [ parentwin ]
zcurses דלווין targetwin
zcurses לרענן [ targetwin ... ]
zcurses לגעת targetwin ...
zcurses המהלך targetwin new_y new_x
zcurses ברור targetwin [ לצייר מחדש | eol | לוע ]
zcurses עמדה targetwin מערך
zcurses char targetwin אופי
zcurses מחרוזת targetwin מחרוזת
zcurses גבול targetwin גבול
zcurses attr targetwin [[+|-]תכונה | fg_col/bg_col ] [...]
zcurses bg targetwin [[+|-]תכונה | fg_col/bg_col | @char ] [...]
zcurses לגלול targetwin [ on | כבוי | [+|-]קווים ]
zcurses קלט targetwin [ להפסיק [ kparam [ mparam ] ] ]
zcurses עכבר [ עיכוב NUM | [+|-]תנועה ]
zcurses פסק זמן targetwin מרווח
zcurses querychar targetwin [ להפסיק ]
מניפולציות קללות חלונות. כל השימושים בפקודה זו צריכים להיות בסוגריים של
`zcurses init' כדי לאתחל את השימוש בקללות, ו-'zcurses סוףכדי לסיים את זה; פְּסִיחָה
`zcurses סוף' יכול לגרום למסוף להיות במצב לא רצוי.

תת-פקודה addwin יוצר חלון עם שורות קווים ו ncols עמודות. שֶׁלָה
הפינה השמאלית העליונה תמוקם בשורה מתחיל_י ועמודה begin_x של המסך.
targetwin הוא מחרוזת ומתייחס לשם של חלון שאינו כרגע
שהוקצה. שימו לב במיוחד למוסכמות הקללות שמופיעות ערכים אנכיים
לפני ערכים אופקיים.

If addwin מקבל חלון קיים כארגומנט הסופי, החלון החדש הוא
נוצר כחלון משנה של parentwin. זה שונה מחלון חדש רגיל פנימה
שהזיכרון של תוכן החלון משותף עם הזיכרון של ההורה.
יש למחוק חלונות משנה לפני ההורה שלהם. שימו לב שהקואורדינטות של
חלונות משנה הם יחסית למסך, לא להורה, כמו בחלונות אחרים.

השתמש בפקודה המשנה דלווין כדי למחוק חלון שנוצר באמצעותו addwin. שים לב ש סוף
עושה לֹא למחוק חלונות באופן מרומז, וזה דלווין אינו מוחק את תמונת המסך
של החלון.

החלון המתאים למסך הגלוי המלא נקרא stdscr; זה תמיד
קיים אחרי `zcurses init' ולא ניתן למחוק באמצעותו דלווין.

תת-פקודה לרענן ירענן את החלון targetwin; זה הכרחי כדי לעשות כל
שינויים ממתינים (כגון תווים שהכנתם לפלט איתם char) גלוי
על המסך. לרענן ללא ויכוח גורם לניקוי המסך ו
צויר מחדש. אם ניתנים מספר חלונות, המסך מתעדכן פעם אחת בסוף.

תת-פקודה לגעת מסמן את targetwinמופיעים כשנו. זה הכרחי
לפני לרענןing windows אם חלון שהיה מול חלון אחר (אשר
יכול להיות stdscr) מחוק.

תת-פקודה המהלך מזיז את מיקום הסמן פנימה targetwin לקואורדינטות חדשות new_y
ו new_x. שימו לב שהפקודה המשנה מחרוזת (אבל לא פקודה המשנה char) מתקדמים
מיקום הסמן מעל התווים שנוספו.

תת-פקודה ברור מוחק את התוכן של targetwin. אחד (ולא יותר מאחד)
ניתן לציין שלוש אפשרויות. עם האופציה לצייר מחדש, בנוסף הבא
לרענן of targetwin יגרום לניקוי המסך וצביעה מחדש. עם ה
אוֹפְּצִיָה eol, targetwin מנוקה רק עד סוף שורת הסמן הנוכחית. עם
האפשרות לוע, targetwin מסולק עד קצה החלון, כלומר הכל כדי
הסמן מימין ומתחת נמחק.

תת-פקודה עמדה כותב עמדות שונות הקשורות targetwin אל
מערך בשם מערך. אלו הם, לפי הסדר:
- קואורדינטות y ו-x של הסמן ביחס לחלק השמאלי העליון של targetwin
- קואורדינטות y ו-x של החלק השמאלי העליון של targetwin על המסך
- הגודל של targetwin במידות y ו-x.

תווים פלט ומיתרים מושגים על ידי char ו מחרוזת בהתאמה.

לצייר גבול מסביב לחלון targetwin, להשתמש גבול. שימו לב שהגבול אינו
לאחר מכן טופלו במיוחד: במילים אחרות, הגבול הוא פשוט קבוצה של
פלט תווים בקצה החלון. מכאן שאפשר לדרוס אותו, אפשר
לגלול מהחלון וכו'.

תת-פקודה attr יקבע targetwinתכונות של או צבע קדמה/רקע
זוג עבור כל פלט תו עוקב. כל אחד תכונה נתון על הקו עשוי להיות
מונח על ידי א + להגדיר או א - לבטל את הגדרת התכונה הזו; + מניחים אם נעדר.
התכונות הנתמכות הן למצמץ, סיכה, שמש, להפוך, לבלוט, ו לָשִׂים דָגֵשׁ.

כל אחד fg_col/bg_col תכונה (להיקרא בתור `fg_col on bg_col') קובע את החזית
וצבע רקע לפלט תווים. הצבע ברירת מחדל לפעמים
זמין (במיוחד אם הספרייה היא ncurses), תוך ציון החזית או
צבע הרקע איתו התחיל הטרמינל. צמד הצבעים ברירת מחדל/ברירת מחדל
זמין תמיד.

bg עוקף את הצבע ותכונות אחרות של כל התווים בחלון. שֶׁלָה
השימוש הרגיל הוא להגדיר את הרקע בהתחלה, אבל זה יחליף את התכונות
של תווים כלשהם בזמן שהוא נקרא. בנוסף לטיעונים
מותר עם attr, ויכוח @char מציין תו שיוצג בו אחרת
אזורים ריקים בחלון. בגלל מגבלות של קללות זה לא יכול להיות א
תו רב-בתים (מומלץ להשתמש בתווי ASCII בלבד). בתור ה
קבוצת התכונות שצוינה עוקפת את הרקע הקיים, והופך את התכונות
off in the arguments אינו שימושי, אם כי זה לא גורם לשגיאה.

תת-פקודה לגלול ניתן להשתמש עם on or כבוי כדי להפעיל או לבטל את הגלילה של
חלון כאשר הסמן היה נע מתחת לחלון עקב הקלדה או
תְפוּקָה. ניתן להשתמש בו גם עם מספר שלם חיובי או שלילי כדי לגלול את
חלון למעלה או למטה את מספר השורות הנתון מבלי לשנות את הסמן הנוכחי
מיקום (שנראה אם ​​כן נע בכיוון ההפוך ביחס ל-
חַלוֹן). במקרה השני, אם גלילה היא כבוי הוא הופך זמנית on ל
אפשר לגלול את החלון.

תת-פקודה קלט קורא תו בודד מהחלון מבלי להדהד אותו
חזור. אם להפסיק מסופק התו מוקצה לפרמטר להפסיק, אחרת
הוא מוקצה לפרמטר תשובה.

אם שניהם להפסיק ו kparam מסופקים, המפתח נקרא במצב 'לוח מקשים'. בזה
מצב מקשים מיוחדים כגון מקשי פונקציה ומקשי חצים מחזירים את שם המפתח
בפרמטר kparam. שמות המפתח הם פקודות המאקרו המוגדרות ב- קללות.ח or
ncurses.h עם הקידומת `מַפְתֵחַ_' הוסר; ראה גם את תיאור הפרמטר
zcurses_keycodes לְהַלָן. מפתחות אחרים גורמים להגדרת ערך להפסיק כמו קודם. עַל
החזרה מוצלחת רק אחד מהם להפסיק or kparam מכיל מחרוזת לא ריקה; ה
אחר מוגדר למחרוזת ריקה.

If mparam מסופק גם, קלט מנסה לטפל בקלט עכבר. זה רק
זמין עם ספריית ncurses; ניתן לזהות טיפול בעכבר על ידי בדיקה של
מצב היציאה של `zcurses עכבר' בלי ויכוחים. אם לוחצים על כפתור עכבר
(או לחיצה כפולה או משולשת, או לחיצה או שחרור בהשהיה הניתנת להגדרה
מלחיצה) אז kparam מוגדר למחרוזת MOUSE, ו mparam מוגדר ל-
מערך המורכב מהאלמנטים הבאים:
- מזהה כדי להבחין בין התקני קלט שונים; זה רק לעתים רחוקות
מוֹעִיל.
- קואורדינטות x, y ו-z של לחיצת העכבר ביחס למסך המלא,
בתור שלושה אלמנטים בסדר הזה (כלומר, קואורדינטת ה-y היא, באופן יוצא דופן, אחרי
קואורדינטת x). קואורדינטת z זמינה רק לכמה יוצאי דופן
התקני קלט ומוגדר אחרת לאפס.
- כל אירועים שהתרחשו כפריטים נפרדים; בדרך כלל יהיה רק ​​אחד.
אירוע מורכב מ לחוץ, RELEASED, לחצו, DOUBLE_CLICKED or
TRIPLE_CLICKED אחריו מיד (באותו אלמנט) המספר של
הכפתור.
- אם מקש Shift נלחץ, המחרוזת SHIFT.
- אם מקש הבקרה נלחץ, המחרוזת CTRL.
- אם מקש alt נלחץ, המחרוזת ALT.

ייתכן שלא כל אירועי העכבר יעברו לחלון הטרמינל; הכי טרמינלי
אמולטורים מטפלים בכמה אירועי עכבר בעצמם. שימו לב שהמדריך ל-ncurses
מרמז ששימוש בקלט גם עם וגם בלי טיפול בעכבר עלול לגרום לעכבר
הסמן להופיע ולהיעלם.

תת-פקודה עכבר ניתן להשתמש כדי להגדיר את השימוש בעכבר. אין
ארגומנט חלון; אפשרויות העכבר הן גלובליות. `zcurses עכבר' בלי ויכוחים
מחזיר סטטוס 0 אם טיפול בעכבר אפשרי, אחרת מצב 1. אחרת, ה
ארגומנטים אפשריים (שעשויים להיות משולבים באותה שורת פקודה) הם כדלקמן.
עיכוב NUM מגדיר את ההשהיה המקסימלית באלפיות שניות בין אירועי עיתונות לפרסום
להיחשב כקליק; הערך 0 משבית את רזולוציית הקליקים ואת ברירת המחדל
הוא שישית שנייה. תנועה המשיך על ידי `+' (ברירת המחדל) או -
מפעיל או מכבה דיווח על תנועת עכבר בנוסף ללחיצות, לחיצות ו
שחרורים, אשר תמיד מדווחים. עם זאת, מופיעים דיווחים על תנועת עכבר
אינם מיושמים כעת.

תת-פקודה פסק זמן מציין ערך פסק זמן עבור קלט מ targetwin. אם
מרווח הוא שלילי, `zcurses קלט' מחכה ללא הגבלת זמן להקלדת תו;
זוהי ברירת המחדל. אם מרווח הוא אפס, `zcurses קלטחוזר מיד; אם
יש typeahead זה מוחזר, אחרת לא נעשה קלט ומצב 1 מוחזר.
If מרווח הוא חיובי, `zcurses קלט' מחכה מרווח אלפיות שניות עבור קלט ואם
אין אחד בסוף אותה תקופה מחזיר סטטוס 1.

תת-פקודה querychar שואל את התו במיקום הסמן הנוכחי. ה
ערכי החזרה מאוחסנים במערך ששמו להפסיק אם מסופק, אחר במערך
תשובה. הערך הראשון הוא התו (שעשוי להיות תו רב-בתים אם
המערכת תומכת בהם); השני הוא צמד הצבעים ברגיל fg_col/bg_col
סימון, או 0 אם הצבע אינו נתמך. כל תכונות מלבד צבע זה
החל על התו, כפי שהוגדר בפקודה המשנה attr, מופיעים כנוספים
אלמנטים.

פרמטרים
ZCURSES_COLORS
מספר שלם לקריאה בלבד. המספר המרבי של צבעים שהמסוף תומך. הערך הזה
מאותחל על ידי ספריית הקללות ואינו זמין עד הפעם הראשונה
zcurses init רץ.

ZCURSES_COLOR_PAIRS
מספר שלם לקריאה בלבד. המספר המרבי של זוגות צבעים fg_col/bg_col זה יכול להיות
מוגדר ב`zcurses attr' פקודות; שימו לב מגבלה זו חלה על כל זוגות הצבעים
נעשה שימוש בין אם הם פעילים כעת ובין אם לאו. ערך זה מאותחל
על ידי ספריית הקללות ואינו זמין עד הפעם הראשונה zcurses init is
לָרוּץ.

zcurses_attrs
מערך לקריאה בלבד. התכונות הנתמכות על ידי zsh/קללות; זמין ברגע שה
מודול נטען.

zcurses_colors
מערך לקריאה בלבד. הצבעים נתמכים על ידי zsh/קללות; זמין ברגע שה
מודול נטען.

zcurses_keycodes
מערך לקריאה בלבד. הערכים שעשויים להיות מוחזרים בפרמטר השני שסופק
אל `zcurses קלטלפי הסדר שבו הם מוגדרים באופן פנימי על ידי קללות.
לא כל מקשי הפונקציות מופיעים ברשימה, בלבד F0; קללות שומרת מקום עבור F0 עד ל F63.

zcurses_windows
מערך לקריאה בלבד. רשימת החלונות הנוכחית, כלומר כל החלונות שהיו
נוצר עם `zcurses addwin' ולא הוסר עם `zcurses דלווין'.

LA ZSH/DATETIME מודול

השמיים zsh/datetime מודול זמין פקודה מובנית אחת:

זמן אחסון [ -s סקלר ] פוּרמָט תקופה
זמן אחסון -r [ -q ] [ -s סקלר ] פוּרמָט זמן זמן
פלט את התאריך המסומן ב תקופה ב פוּרמָט נָקוּב. לִרְאוֹת זמן אחסון(3) עבור
פרטים. הרחבות zsh המתוארות בסעיף הרחבה של רצפי הנחיות
in זשמיסק(1) זמינים גם.

-q רוץ בשקט; לדכא הדפסה של כל הודעות השגיאה המתוארות להלן.
שגיאות עבור לא חוקי תקופה ערכים מודפסים תמיד.

-r עם האופציה -r (הפוך), השתמש פוּרמָט לנתח את מחרוזת הקלט
זמן זמן ופלט את מספר השניות מאז התקופה שבה ה
זמן התרחש. הניתוח מיושם על ידי פונקציית המערכת זמן זמן;
לִרְאוֹת זמן זמן(3). המשמעות היא שהרחבות בפורמט zsh אינן זמינות,
אבל עבור חיפוש הפוך הם אינם נדרשים.

ברוב המימושים של זמן אחסון כל אזור זמן ב- זמן זמן is
התעלמו ואזור הזמן המקומי שהוכרז על ידי TZ משתנה הסביבה הוא
בשימוש; פרמטרים אחרים מוגדרים לאפס אם אינם קיימים.

If זמן זמן לא מתאים פוּרמָט הפקודה מחזירה מצב 1 ומדפיסה
הודעת שגיאה. אם זמן זמן גפרורים פוּרמָט אבל לא כל הדמויות ב
זמן זמן היו בשימוש, ההמרה מצליחה אך גם מדפיסה שגיאה
הוֹדָעָה.

אם אחת מהמערכת פועלת זמן זמן or זמן מקומי לא זמין,
מצב 2 מוחזר והודעת שגיאה מודפסת.

-s סקלר
הקצה את מחרוזת התאריך (או זמן עידן בשניות אם -r ניתן) ל סקלר
במקום להדפיס אותו.

שימו לב שבהתאם לסוג הזמן האינטגרלי המוצהר של המערכת, זמן אחסון אולי
הפקת תוצאות שגויות עבור זמני עידן גדולים מ-2147483647 המתאים
to 2038-01-19 03:14:07 +0000.

השמיים zsh/datetime מודול זמין מספר פרמטרים; כולם לקריאה בלבד:

EPOCHREALTIME
ערך נקודה צפה המייצג את מספר השניות מאז התקופה. ה
הדיוק הרעיוני הוא לננו-שניות אם שעון_זמן שיחה זמינה ואל
מיקרו שניות אחרת, אבל בפועל הטווח של צף דיוק כפול
זמן השהייה של תזמון נקודות ופגז עשויות להיות השפעות משמעותיות.

EPOCHSECONDS
ערך מספר שלם המייצג את מספר השניות מאז התקופה.

תקופה
ערך מערך המכיל את מספר השניות מאז התקופה הראשונה
אלמנט ושארית הזמן מאז התקופה בננו-שניות בשנייה
אֵלֵמֶנט. כדי להבטיח ששני האלמנטים עקביים יש להעתיק את המערך או
אחרת מתייחסים כהחלפה יחידה לפני השימוש בערכים. ה
ניתן להשתמש בביטוי הבא:

ל שניות nsecs in $epochtime; do
...
עשה

LA ZSH/DB/GDBM מודול

השמיים zsh/db/gdbm מודול משמש ליצירת מערכים אסוציאטיביים "קשורים" שמתממשקים אליהם
קבצי מסד נתונים. אם ממשק GDBM אינו זמין, המובנים המוגדרים על ידי זה
המודול ידווח על שגיאה. מודול זה נועד גם כאב טיפוס ליצירה
ממשקי מסד נתונים נוספים, כך שה זטי מובנה עשוי לעבור למודול גנרי יותר ב
העתיד.

הרכיבים המובנים במודול זה הם:

זטי -d db/gdbm -f שם הקובץ [ -r ] שם מערך
פתח את מסד הנתונים של GDBM שזוהה על ידי שם הקובץ ואם מצליח, צור את
מערך אסוציאטיבי שם מערך מקושר לקובץ. כדי ליצור מערך מקושר מקומי, ה-
תחילה יש להכריז על פרמטר, כך שפקודות דומות לפקודות הבאות יהיו
מבוצע בתוך טווח פונקציות:

מקומי -A sampledb
זטי -d db/gdbm -f sample.gdbm sampledb

השמיים -r אפשרות פותחת את קובץ מסד הנתונים לקריאה בלבד, יצירת פרמטר עם
התכונה לקריאה בלבד. ללא אפשרות זו, באמצעות `זטי' על קובץ שעבורו ה
למשתמש אין הרשאת כתיבה זו שגיאה. אם ניתן לכתיבה, מסד הנתונים הוא
נפתח באופן סינכרוני כך שהשדות השתנו שם מערך נכתבים מיד
שם הקובץ.

שינויים במצבי הקובץ שם הקובץ לאחר פתיחתו אל תשנה את המצב
of שם מערך, אבל `ערכת סוגים -r שם מערך' עובד כצפוי.

zuntie [ -u ] שם מערך ...
סגור את מסד הנתונים של GDBM המשויך לכל אחד מהם שם מערך ולאחר מכן בטל את ההגדרה של
פָּרָמֶטֶר. ה -u אפשרות מאלצת ביטול של פרמטרים שנעשה לקריאה בלבד עם `זטי
-r'.

זה קורה באופן אוטומטי אם הפרמטר אינו מוגדר במפורש או ההיקף המקומי שלו
(פונקציה) מסתיימת. שים לב שלא ניתן לבטל במפורש פרמטר לקריאה בלבד, אז
הדרך היחידה לבטל הגדרה של פרמטר גלובלי שנוצר עם `זטי -r' זה להשתמש ב'zuntie
-u'.

השדות של מערך אסוציאטיבי הקשור ל-GDBM אינם מאוחסנים במטמון או מאוחסנים בדרך אחרת ב-
זיכרון, הם נקראים או נכתבים למסד הנתונים בכל הפניה. לפיכך, עבור
לדוגמה, הערכים במערך לקריאה בלבד עשויים להשתנות על ידי כותב שני של אותו
קובץ מסד הנתונים.

LA ZSH/DELTOCHAR מודול

השמיים zsh/deltochar מודול זמין שתי פונקציות ZLE:

מחק-ל-char
קרא תו מהמקלדת, ומחק ממיקום הסמן עד ו
כולל הבא (או, עם ספירה חוזרת n, ה nהמופע של אותו דמות.
ספירת חזרות שליליות פירושה מחיקה לאחור.

zap-to-char
זה מתנהג כמו מחק-ל-char, אלא שההתרחשות הסופית של הדמות
עצמו לא נמחק.

LA ZSH/דוגמה מודול

השמיים zsh/example מודול זמין פקודה מובנית אחת:

דוגמה [ -דגלים ] [ טוען ... ]
מציג את הדגלים והארגומנטים שאיתם הוא מופעל.

מטרת המודול היא לשמש דוגמה לכתיבת מודול.

LA ZSH/קבצים מודול

השמיים zsh/files מודול זמין כמה פקודות נפוצות עבור מניפולציה של קבצים כמו
מבנים; פקודות אלה כנראה אינן נחוצות עבור מצבים רגילים רבים, אך הן יכולות להיות
שימושי במצבי התאוששות חירום עם משאבים מוגבלים. הפקודות לא
ליישם את כל התכונות הנדרשות כעת על ידי ועדות התקנים הרלוונטיות.

עבור כל הפקודות, התחלה וריאנטית zf_ זמין גם נטען אוטומטית.
שימוש ביכולת התכונות של zmodload תאפשר לך לטעון רק את השמות שאתה רוצה.
שימו לב שאפשר לטעון רק את הרכיבים המובנים עם שמות ספציפיים ל-zsh באמצעות ה-
הפקודה הבאה:

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

הפקודות הנטענות כברירת מחדל הן:

chgrp [ -hRs ] קבוצה שם הקובץ ...
משנה את קבוצת הקבצים שצוינה. זה שווה ערך ל chown עם מפרט משתמש
טיעון של `:קבוצה'.

chown [ -hRs ] מפרט משתמש שם הקובץ ...
משנה בעלות וקבוצת קבצים שצוינו.

השמיים מפרט משתמש יכול להיות בארבע צורות:

המשתמש לשנות בעלים ל המשתמש; לא להחליף קבוצה
המשתמש:: לשנות בעלים ל המשתמש; לא להחליף קבוצה
המשתמש: לשנות בעלים ל המשתמש; לשנות קבוצה ל המשתמשהקבוצה העיקרית של
המשתמש:קבוצה
לשנות בעלים ל המשתמש; לשנות קבוצה ל קבוצה
:קבוצה אל תחליף בעלים; לשנות קבוצה ל קבוצה

בכל מקרה, ה- `:' יכול במקום זאת להיות '.'. הכלל הוא שאם יש `:'
אז המפריד הוא `:', אחרת אם יש `.' ואז המפריד הוא `.',
אחרת אין מפריד.

כל אחד מ המשתמש ו קבוצה יכול להיות שם משתמש (או שם קבוצה, לפי המתאים) או
מזהה משתמש עשרוני (מזהה קבוצה). פרשנות כשם מקבלת עדיפות, אם יש
הוא שם משתמש בסך הכל (או שם קבוצה).

אם המטרה היא קישור סמלי, ה -h אופציות גורמות chown לקבוע את הבעלות
של הקישור במקום היעד שלו.

השמיים -R אופציות גורמות chown לרדת רקורסיבית לתוך ספריות, לשנות את
בעלות על כל הקבצים בספרייה לאחר שינוי הבעלות על
הספרייה עצמה.

השמיים -s אפשרות היא סיומת zsh ל chown פונקציונליות. זה מאפשר פרנואיד
התנהגות, שנועדה למנוע בעיות אבטחה הכרוכות בא chown מרמים אותו
משפיעים על קבצים אחרים מאלו שנועדו. הוא יסרב לעקוב אחר סימבולי
קישורים, כך (לדוגמה) ``chown מתלה /tmp/foo/passwd''לא יכול בטעות
chown / etc / passwd if /tmp/foo זה במקרה קישור ל /וכו. זה גם יבדוק
היכן הוא נמצא לאחר עזיבת ספריות, כך שצ'און רקורסיבי של עומק
עץ ספריות לא יכול בסופו של דבר לחטט רקורסיבית / usr כתוצאה ממדריכים
מוזזים במעלה העץ.

ln [ -dfhins ] שם הקובץ dest
ln [ -dfhins ] שם הקובץ ... dir
יוצר קשה (או, עם -s, סימבוליים) קישורים. בטופס הראשון, המצוין
destination נוצר, כקישור לצוין שם הקובץ. בצורה השנייה,
כל אחד מה שם הקובץs נלקח בתורו, ומקושר לשם נתיב במפורט
directory שיש לו את אותו רכיב שם נתיב אחרון.

בדרך כלל, ln לא ינסה ליצור קישורים קשים לספריות. המחאה הזו יכולה
לעקוף באמצעות -d אוֹפְּצִיָה. בדרך כלל רק משתמש העל יכול למעשה
להצליח ליצור קישורים קשים לספריות. זה לא חל על סמלי
קישורים בכל מקרה.

כברירת מחדל, לא ניתן להחליף קבצים קיימים בקישורים. ה -i אפשרות גורמת ל
למשתמש יש לשאול לגבי החלפת קבצים קיימים. ה -f אפשרות גורמת לקיים
קבצים שיימחקו בשקט, ללא שאילתות. -f מקבל עדיפות.

השמיים -h ו -n האפשרויות זהות ושתיהן קיימות עבור תאימות; כל אחד מהם
מציין שאם היעד הוא סימן-קישור אז אין להפנות אותו.
בדרך כלל זה משמש בשילוב עם -SF כך שאם קישור קיים מצביע
לספרייה אז היא תוסר, במקום אחריה. אם אפשרות זו היא
משמש עם מספר שמות קבצים והיעד הוא קישור סמלי המצביע על א
ספרייה אז התוצאה היא שגיאה.

mkdir [ -p ] [ -m מצב ] dir ...
יוצר ספריות. עם ה -p אפשרות, ספריות אב שאינן קיימות הן הראשונות
נוצר במידת הצורך, ולא תהיה תלונה אם המדריך כבר
קיים. ה -m ניתן להשתמש באפשרות כדי לציין (באוקטלית) קבוצה של הרשאות קובץ
עבור הספריות שנוצרו, אחרת מצב 777 שונה על ידי הנוכחי אומסק (ראה
אומסק(2)) נעשה שימוש.

mv [ -פי ] שם הקובץ dest
mv [ -פי ] שם הקובץ ... dir
מעביר קבצים. בטופס הראשון, המצוין שם הקובץ מועבר לצוין
destאינציה. בצורה השנייה, כל אחד מה- שם הקובץs נלקח בתורו, ומוזז
לשם נתיב במצוין directory שיש לו את אותו רכיב שם נתיב אחרון.

כברירת מחדל, המשתמש יישאל לפני החלפת כל קובץ שהמשתמש לא יכול
כתוב אל, אך קבצים הניתנים לכתיבה יוסרו בשקט. ה -i אפשרות גורמת ל
למשתמש יש לשאול לגבי החלפת קבצים קיימים. ה -f אפשרות גורמת לכל
קבצים קיימים שיימחקו בשקט, ללא שאילתות. -f מקבל עדיפות.

שים לב לכך mv לא יעביר קבצים בין מכשירים. גרסאות היסטוריות של mv,
כאשר שינוי שם בפועל בלתי אפשרי, חזור על העתקה והסרה של קבצים; אם
התנהגות זו רצויה, השתמש cp ו rm באופן ידני. זה עשוי להשתנות בעתיד
הגירסה.

rm [ -dfirs ] שם הקובץ ...
מסיר קבצים וספריות שצוינו.

בדרך כלל, rm לא יסיר ספריות (למעט עם -r אוֹפְּצִיָה). ה -d
אופציות גורמות rm כדי לנסות להסיר ספריות עם הקישור (ראה הקישור(2)), אותו הדבר
שיטה המשמשת לקבצים. בדרך כלל רק משתמש העל יכול באמת להצליח
ביטול הקישור של ספריות בדרך זו. -d מקבל עדיפות על פני -r.

כברירת מחדל, המשתמש יישאל לפני הסרת כל קובץ שהמשתמש לא יכול
כתוב אל, אך קבצים הניתנים לכתיבה יוסרו בשקט. ה -i אפשרות גורמת ל
למשתמש יש לשאול לגבי הסרת קבצים כלשהם. ה -f אפשרות גורמת לקבצים להיות
נמחק בשקט, ללא שאילתה, ומדכא את כל אינדיקציות השגיאה. -f לוקח
עֲדִיפוּת.

השמיים -r אופציות גורמות rm כדי לרדת רקורסיבית לתוך ספריות, למחוק את כל הקבצים
בספרייה לפני הסרת הספרייה עם ה- הוא rm שיחת מערכת (ראה
הוא rm(2)).

השמיים -s אפשרות היא סיומת zsh ל rm פונקציונליות. זה מאפשר פרנואיד
התנהגות, שנועדה למנוע בעיות אבטחה נפוצות הכרוכות בהרצה שורש rm להיות
שולל להסיר קבצים אחרים מאלו שנועדו. זה יסרב לעקוב
קישורים סמליים, כך (לדוגמה) ``rm /tmp/foo/passwd''לא יכול בטעות
להסיר / etc / passwd if /tmp/foo זה במקרה קישור ל /וכו. זה גם יבדוק
היכן הוא נמצא לאחר עזיבת ספריות, כך שהסרה רקורסיבית של עומק
עץ ספריות לא יכול בסופו של דבר להסיר באופן רקורסיבי / usr כתוצאה ממדריכים
מוזזים במעלה העץ.

הוא rm dir ...
מסיר ספריות ריקות שצוינו.

לסנכרן קורא לקריאת המערכת באותו שם (ראה לסנכרן(2)), אשר שוטפת חוצצים מלוכלכים
לדיסק. זה עשוי לחזור לפני שהקלט/פלט הושלם בפועל.

LA ZSH/LANGINFO מודול

השמיים zsh/langinfo מודול זמין פרמטר אחד:

langinfo
מערך אסוציאטיבי הממפה אלמנטים של langinfo לערכים שלהם.

היישום שלך עשוי לתמוך במספר מהמפתחות הבאים:

CODESET, D_T_FMT, D_FMT, T_FMT, RADIXCHAR, אלף, YESEXPR, NOEXPR, CRNCYSTR,
ABDAY_{1..7}, DAY_{1..7}, ABMON_{1..12}, MON_{1..12}, T_FMT_AMPM, AM_STR, PM_STR,
ERA, ERA_D_FMT, ERA_D_T_FMT, ERA_T_FMT, ALT_DIGITS

LA ZSH/MAPFILE מודול

השמיים zsh/mapfile מודול מספק פרמטר אחד מיוחד של מערך אסוציאטיבי באותו שם.

קובץ map
מערך אסוציאטיבי זה לוקח כמפתחות את שמות הקבצים; הערך המתקבל הוא ה-
תוכן הקובץ. הערך מטופל באופן זהה לכל טקסט אחר שמגיע
מתוך פרמטר. ניתן גם להקצות את הערך, ובמקרה זה הקובץ ב-
השאלה כתובה (בין אם היא הייתה קיימת במקור ובין אם לאו); או אלמנט עשוי להיות
unset, אשר ימחק את הקובץ המדובר. לדוגמה, `מגוון
mapfile[הקובץ שלי]' פועל כצפוי, עורך את הקובץ `המסמך שלי'.

כאשר הגישה למערך כולו, המפתחות הם שמות הקבצים ב-
הספרייה הנוכחית, והערכים ריקים (כדי לחסוך תקורה ענקית בזיכרון).
כָּך ${(k)mapfile} יש השפעה זהה לאופרטור הגלוב *(ד), מאז קבצים
שמתחיל בנקודה אינן מיוחדות. יש להקפיד על ביטויים כגון
rm ${(k)mapfile}, אשר תמחק כל קובץ בספרייה הנוכחית ללא ה
רגיל `rm *' מבחן.

הפרמטר קובץ map ניתן להפוך לקריאה בלבד; במקרה זה, ייתכן שלא יתכן שהקבצים שאליהם יש התייחסות
להיכתב או למחוק.

ניתן לקרוא קובץ בצורה נוחה לתוך מערך כשורה אחת לכל אלמנט עם הטופס
`מערך=("${(f@)mapfile[שם הקובץ]}")'. המירכאות הכפולות וה-`@' נחוצים
כדי למנוע הסרת שורות ריקות. שימו לב שאם הקובץ מסתיים ב-a
newline, המעטפת תתפצל בשורה החדשה האחרונה, וייצור ריק נוסף
שדה; ניתן לדכא את זה על ידי שימוש
`מערך=("${(f@)${mapfile[שם הקובץ]%$'\n'}}")'.

מגבלות
למרות שהקריאה והכתיבה של הקובץ המדובר מטופלות ביעילות, ז.ש
ניהול זיכרון פנימי עשוי להיות בארוקי באופן שרירותי; למרות זאת, קובץ map הוא בדרך כלל מאוד
הרבה יותר יעיל מכל דבר הכולל לולאה. שימו לב במיוחד שהשלם
תוכן הקובץ תמיד יישאר פיזית בזיכרון בעת ​​גישה אליו (אפשר
מספר פעמים, עקב פעולות החלפת פרמטרים סטנדרטיות). בפרט, זה
פירושו טיפול בקבצים ארוכים מספיק (גדולים משטח ההחלפה של המכשיר, או מ-
הטווח של סוג המצביע) יהיה שגוי.

אין שגיאות מודפסות או מסומנות עבור קבצים לא קיימים, בלתי קריאים או בלתי ניתנים לכתיבה, שכן
מנגנון הפרמטר נמוך מדי בהיררכיית ביצוע המעטפת כדי לעשות זאת נוח.

מצער שהמנגנון לטעינת מודולים עדיין לא מאפשר למשתמש לעשות זאת
ציין את שם פרמטר המעטפת שיקבל את ההתנהגות המיוחדת.

LA ZSH/MATHFUNC מודול

השמיים zsh/mathfunc מודול מספק פונקציות מתמטיות סטנדרטיות לשימוש בעת הערכה
נוסחאות מתמטיות. התחביר מתאים למוסכמות הרגילות של C ו- FORTRAN, עבור
דוגמא,

(( f = חטא(0.3) ))

מקצה את הסינוס של 0.3 לפרמטר f.

רוב הפונקציות לוקחות ארגומנטים של נקודה צפה ומחזירות ערך נקודה צפה. למרות זאת,
כל ההמרה הדרושה מסוג מספר שלם או לסוג מספר שלם תבוצע אוטומטית על ידי
צדף. חוץ מ אטאן עם טיעון שני וה שרירי הבטן, int ו לצוף פונקציות, הכל
פונקציות מתנהגות כפי שמצוין בדף המדריך עבור פונקציית C המקבילה, מלבד זאת
כל ארגומנטים מחוץ לטווח עבור הפונקציה המדוברת יתגלו על ידי המעטפת ו
שגיאה שדווחה.

הפונקציות הבאות לוקחות ארגומנט נקודה צפה יחידה: acos, אקוש, אסין, asinh,
אטאן, atanh, cbrt, תקרה, cos, קוש, ERF, erfc, exp, expm1, נהדרים, קומה, גמא, j0, j1,
לגמא, היכנס, log10, log1p, logb, חטא, סינה, מ"ר, שזוף, טאנה, y0, y1. ה אטאן פונקציה
יכול אופציונלי לקחת ארגומנט שני, ובמקרה זה הוא מתנהג כמו הפונקציה C atan2.
השמיים ilogb הפונקציה לוקחת ארגומנט נקודה צפה יחידה, אך מחזירה מספר שלם.

הפונקציה signgam לא לוקח ארגומנטים, ומחזיר מספר שלם, שהוא המשתנה C
בעל אותו שם, כמתואר ב גמא(3). שימו לב שזה רק שימושי
מיד לאחר שיחה אל גמא or לגמא. שימו לב גם כי `signgam()'ו'signgam' הם
ביטויים מובהקים.

הפונקציות הבאות לוקחות שני ארגומנטים של נקודה צפה: העתק, fmod, hypot,
לאחר מכן.

הדברים הבאים לוקחים ארגומנט ראשון של מספר שלם וארגומנט שני בנקודה צפה: jn, yn.

הבאות לוקחות ארגומנט ראשון בנקודה צפה וארגומנט שני במספר שלם: ldexp,
קשקשת.

הפונקציה שרירי הבטן אינו ממיר את סוג הארגומנט היחיד שלו; זה מחזיר את המוחלט
ערך של מספר נקודה צפה או מספר שלם. הפונקציות לצוף ו int
המירו את הארגומנטים שלהם לנקודה צפה או לערך שלם (על ידי חיתוך)
בהתאמה.

שימו לב שה-C שבויים הפונקציה זמינה בהערכה מתמטית רגילה בתור `**' מפעיל
ואינו מסופק כאן.

הפונקציה ראנד48 זמין אם הספרייה המתמטית של המערכת שלך כוללת את הפונקציה
erand48(3). זה מחזיר מספר נקודה צפה פסאודו אקראית בין 0 ל-1. זה לוקח a
ארגומנט אופציונלי של מחרוזת אחת.

אם הארגומנט אינו קיים, מקור המספר האקראי מאותחל על ידי שלוש קריאות אל
מה היא שורה(3) פונקציה --- זה מייצר את אותם מספרים אקראיים כמו שלושת הערכים הבאים של
$ RANDOM.

אם הארגומנט קיים, הוא נותן את השם של פרמטר סקלרי שבו הנוכחי
זרע מספר אקראי יאוחסן. בשיחה הראשונה, הערך חייב להכיל לפחות
שתים עשרה ספרות הקסדצימליות (מתעלמים מהשארית של המחרוזת), או שהזרע יהיה
אתחול באותו אופן כמו עבור שיחה אל ראנד48 ללא ויכוח. שיחות עוקבות
ל ראנד48(להפסיק) לאחר מכן ישמור על ה-seed בפרמטר להפסיק כמחרוזת של שתים עשרה
ספרות הקסדצימליות, ללא מסמן בסיס. רצפי המספרים האקראיים עבור שונים
פרמטרים עצמאיים לחלוטין, והם גם בלתי תלויים מזה המשמש את קריאות אל
ראנד48 ללא ויכוח.

למשל, שקול

הדפסה $(( ראנד48 (זרע) ))
הדפסה $(( rand48() ))
הדפסה $(( ראנד48 (זרע) ))

בהנחה $זרע אינו קיים, הוא יאותחל בשיחה הראשונה. בשנייה
להתקשר, ה-Seed כברירת מחדל מאותחל; שים לב, עם זאת, כי בגלל המאפיינים של
ראנד () יש מתאם בין הזרעים המשמשים עבור שני האתחולים, כך עבור
שימושים מאובטחים יותר, עליך ליצור סיד משלך של 12 בתים. השיחה השלישית חוזרת ל
אותו רצף של מספרים אקראיים שנעשה בו שימוש בשיחה הראשונה, לא מושפע מההתערבות
rand48().

LA ZSH/NEWUSER מודול

השמיים zsh/newuser מודול נטען באתחול אם הוא זמין, ה RCS האפשרות מוגדרת, ו
מה היא חָסוּי האפשרות לא מוגדרת (כל השלושה הם אמת כברירת מחדל). זה מתרחש
מיד לאחר פקודות בעולם zshenv קובץ (בדרך כלל /etc/zshenv), אם יש, יש
הוצא להורג. אם המודול אינו זמין הוא מתעלם בשקט על ידי המעטפת; ה
ניתן להסיר בבטחה את המודול $MODULE_PATH על ידי המנהל אם זה לא נדרש.

בטעינה, המודול בודק אם יש מקבצי ההפעלה .zshenv, .zprofile, .zshrc or
.zlogin קיימים בספרייה הניתנת על ידי משתנה הסביבה ZDOTDIR, או של המשתמש
ספריית הבית אם זה לא מוגדר. הבדיקה לא מבוצעת והמודול נעצר
עיבוד אם המעטפת הייתה במצב אמולציה (כלומר הופעלה כאחרת
מעטפת מאשר zsh).

אם אף אחד מקבצי ההפעלה לא נמצא, המודול מחפש את הקובץ משתמש חדש ראשון
בספרייה ברחבי האתר, בדרך כלל ספריית האב של ה- פונקציות אתר מדריך, וכן
אם זה לא נמצא, המודול מחפש בספריה ספציפית לגרסה, בדרך כלל
הורה של פונקציות ספרייה המכילה פונקציות ספציפיות לגרסה. (אלה
ניתן להגדיר ספריות כאשר zsh נבנה באמצעות ה --enable-site-scriptdir=dir ו
--enable-scriptdir=dir דגלים אל להגדיר, בהתאמה; ברירות המחדל הן קידומת/share/zsh
ו קידומת/share/zsh/$ZSH_VERSION שבו ברירת המחדל קידומת is / usr / local.)

אם הקובץ משתמש חדש נמצא, הוא מובא באותו אופן כמו קובץ הפעלה.
הקובץ צפוי להכיל קוד להתקנת קבצי הפעלה עבור המשתמש, ככל שיהיה
קוד מעטפת חוקי יבוצע.

השמיים zsh/newuser לאחר מכן, מודול נפרק ללא תנאי.

שימו לב שאפשר להשיג בדיוק את אותו אפקט כמו ה- zsh/newuser מודול מאת
הוספת קוד ל /etc/zshenv. המודול קיים פשוט כדי לאפשר לקליפה ליצור
הסדרים למשתמשים חדשים ללא צורך בהתערבות של מנהלי חבילות ו
מנהלי מערכות.

הסקריפט שסופק עם המודול מפעיל את פונקציית המעטפת zsh-newuser-install. זֶה
ניתן להפעיל ישירות על ידי המשתמש גם אם zsh/newuser המודול מושבת. הערה,
עם זאת, שאם המודול לא מותקן גם הפונקציה לא תותקן.
הפונקציה מתועדת בסעיף פונקציות תצורת משתמש ב zshcontrib(1).

LA ZSH/פרמטר מודול

השמיים zsh/פרמטר מודול נותן גישה לחלק מטבלאות ה-hash הפנימיות שבהן משתמש
מעטפת על ידי הגדרת כמה פרמטרים מיוחדים.

אפשרויות
המפתחות עבור מערך אסוציאטיבי זה הם שמות האפשרויות שניתן להגדיר
ובטל את ההגדרה באמצעות setopt ו נטרל מובנה. הערך של כל מפתח הוא או
המיתר on אם האפשרות מוגדרת כעת, או המחרוזת כבוי אם האפשרות היא
לא מוגדר. הגדרת מפתח לאחת מהמחרוזות הללו היא כמו הגדרה או ביטול של ההגדרה של
אפשרות, בהתאמה. ביטול של מפתח במערך זה כמו הגדרתו לערך
כבוי.

פקודות
מערך זה נותן גישה לטבלת ה-hash של הפקודות. המפתחות הם שמותיהם של
פקודות חיצוניות, הערכים הם שמות הנתיבים של הקבצים שיבוצעו
מתי הפקודה תופעל. הגדרת מפתח במערך זה מגדירה ערך חדש
בטבלה זו באותו אופן כמו עם ה שירים מובנה. ביטול הגדרה של מפתח כמו ב
`ביטול ההגדרה "פקודות[foo]"' מסיר את הערך עבור המפתח הנתון מה-hash של הפקודה
השולחן.

פונקציות
מערך אסוציאטיבי זה ממפה שמות של פונקציות מופעלות להגדרות שלהן.
הגדרת מפתח בו זה כמו הגדרת פונקציה עם השם שניתן על ידי המקש ו
הגוף שניתן על ידי הערך. ביטול ההגדרה של מפתח מסיר את ההגדרה עבור
פונקציה הנקראת על ידי המפתח.

חוסר_פונקציות
כמו פונקציות אלא עבור פונקציות מושבתות.

בניינים
מערך אסוציאטיבי זה נותן מידע על הפקודות המובנות כרגע
מופעל. המפתחות הם שמות הפקודות המובנות והערכים הם גם
`לא מוגדר' עבור פקודות מובנות שיטענו אוטומטית ממודול if
מופעל או `מוגדר' עבור פקודות מובנות שכבר נטענו.

dis_builtins
כמו בניינים אלא עבור פקודות מובנות מושבתות.

סיסמאות
מערך זה מכיל את המילים השמורות המופעלות.

dis_reswords
כמו סיסמאות אלא למילים שמורות לנכים.

פאצ'רים
מערך זה מכיל את תווי הדפוס המופעלים.

dispatchars
כמו פאצ'רים אלא עבור תווי דפוס מושבתים.

כינויים
זה ממפה את שמות הכינויים הרגילים המופעלים כעת להרחבות שלהם.

dis_aliases
כמו כינויים אלא עבור כינויים רגילים נכים.

גליאזות
כמו כינויים, אלא עבור כינויים גלובליים.

dis_galiases
כמו גליאזות אלא עבור כינויים גלובליים מושבתים.

סלייסים
כמו ראליאסים, אבל עבור כינויים של סיומת.

dis_saliases
כמו סלייסים אלא עבור כינויים של סיומת מושבתת.

פרמטרים
המפתחות במערך אסוציאטיבי זה הם שמות הפרמטרים כרגע
מוּגדָר. הערכים הם מחרוזות המתארות את סוג הפרמטר, באותו אופן
פורמט המשמש את t דגל פרמטר, ראה zshexpn(1) . הגדרה או ביטול של מפתחות פנימה
מערך זה אינו אפשרי.

מודולים
מערך אסוציאטיבי נותן מידע על מודולים. המפתחות הם שמותיהם של
המודולים נטענו, נרשמו לטעינה אוטומטית או בכינוי. הערך אומר איזה
ציין שהמודול בעל השם נמצא והוא אחד מהמחרוזות `נטען', `נטען אוטומטית', או
`כינוי:שם', איפה שם הוא השם שאליו מכונה המודול.

הגדרה או ביטול של מפתחות במערך זה אינו אפשרי.

ערימת dirstack
מערך רגיל המכיל את הרכיבים של ערימת הספריות. שימו לב שהפלט של
מה היא דירס הפקודה מובנית כוללת עוד ספרייה אחת, הנוכחית עובדת
במדריך.

היסטוריה
מערך אסוציאטיבי זה ממפה את מספרי אירועי ההיסטוריה לשורות ההיסטוריה המלאות.

מילות היסטוריה
מערך מיוחד המכיל את המילים המאוחסנות בהיסטוריה.

jobdirs
מערך אסוציאטיבי זה ממפה את מספרי העבודות לספריות מהן המשימה הייתה
התחיל (שאולי אינו הספרייה הנוכחית של העבודה).

המפתחות של המערכים האסוציאטיביים הם בדרך כלל מספרי עבודה חוקיים, ואלה הם
ערכים פלט עם, למשל, ${(k)jobdirs}. ייתכן שהפניות לעבודה לא מספריות
משמש בעת חיפוש ערך; לדוגמה, ${jobdirs[%+]} מתייחס לזרם
עבודה.

טקסטים לעבודה
מערך אסוציאטיבי זה ממפה מספרי עבודה לטקסטים של שורות הפקודה שהיו
משמש כדי להתחיל את העבודות.

הטיפול במפתחות של המערך האסוציאטיבי הוא כמתואר עבור jobdirs מֵעַל.

מדינות עבודה
מערך אסוציאטיבי זה נותן מידע על מצבי המשרות כרגע
ידוע. המפתחות הם מספרי העבודה והערכים הם מחרוזות של הטופס
`עבודה-מדינה:סימן:PID=היו...'. ה עבודה-מדינה נותן למדינה את כל העבודה
כרגע ב, אחד מ`ריצה', `תלוי', או 'עשה'. ה סימן הוא `+' בשביל ה
העבודה הנוכחית, `-' עבור העבודה הקודמת וריק אחרת. זה מלווה באחד
`:PID=היולכל תהליך בעבודה. ה PIDs הם, כמובן, מזהי התהליך
ו היו מתאר את המצב של תהליך זה.

הטיפול במפתחות של המערך האסוציאטיבי הוא כמתואר עבור jobdirs מֵעַל.

nameddirs
מערך אסוציאטיבי זה ממפה את השמות של ספריות עם שם לשמות הנתיבים שהם
לעמוד עבור.

מנהלי משתמשים
מערך אסוציאטיבי זה ממפה שמות משתמשים לשמות הנתיבים של ספריות הבית שלהם.

קבוצות משתמש
מערך אסוציאטיבי זה ממפה שמות של קבוצות מערכת שבהן המשתמש הנוכחי הוא א
חבר במזהי הקבוצה המתאימים. התוכן זהה ל-
פלט קבוצות על ידי ה id פקודה.

funcfiletrace
מערך זה מכיל את מספרי השורות האבסולוטיים ושמות הקבצים המתאימים עבור
נקודה שבה הפונקציה הנוכחית, קובץ המקור, או (אם EVAL_LINENO מוגדר) הערכה
הפקודה נקראה. המערך הוא באותו אורך כמו funcsourcetrace ו
functrace, אבל שונה מ funcsourcetrace בכך שהקו והקובץ הם הנקודה
של קריאה, לא נקודת ההגדרה, ושונה מ functrace בכך שכל הערכים
הם מספרי שורה מוחלטים בקבצים, ולא ביחס לתחילתה של a
פונקציה, אם בכלל.

funcsourcetrace
מערך זה מכיל את שמות הקבצים ומספרי השורות של הנקודות שבהן
פונקציות, קבצי מקור ו-(אם EVAL_LINENO מוגדר) הערכה פקודות כרגע
הוגדרו. מספר השורה הוא הקו שבו ה-`פונקציה שם'או
`שם ()' התחיל. במקרה של פונקציה הנטענת אוטומטית מספר השורה הוא
דווח כאפס. הפורמט של כל אלמנט הוא שם הקובץ:לינו. עבור פונקציות
נטען אוטומטית מקובץ בפורמט zsh מקורי, שבו רק גוף הפונקציה
מתרחש בקובץ, או עבור קבצים שהופעלו על ידי ה מָקוֹר או `.'
מובנה, מידע המעקב מוצג בתור שם הקובץ:0, מכיוון שהקובץ כולו הוא
ההגדרה.

רוב המשתמשים יתעניינו במידע ב- funcfiletrace מערך
במקום.

funcstack
מערך זה מכיל את שמות הפונקציות, קבצי המקור ו-(אם EVAL_LINENO
מוגדר) הערכה פקודות. מבוצע כעת. האלמנט הראשון הוא השם של
הפונקציה באמצעות הפרמטר.

מערך המעטפת הסטנדרטי zsh_eval_context ניתן להשתמש כדי לקבוע את סוג
בניית מעטפת מבוצעת בכל עומק: שימו לב, עם זאת, שזה ב-
סדר הפוך, כשהפריט האחרון האחרון, והוא מפורט יותר, עבור
דוגמה כולל ערך עבור הרמה העליונה, גם קוד המעטפת הראשי מבוצע
באופן אינטראקטיבי או מתסריט, שאינו קיים ב $funcstack.

functrace
מערך זה מכיל את השמות ומספרי הקווים של המתקשרים המתאימים ל
פונקציות שמתבצעות כעת. הפורמט של כל אלמנט הוא שם:לינו.
מתקשרים מוצגים גם עבור קבצי מקור; המתקשר הוא הנקודה שבה מָקוֹר
או `.' הפקודה בוצעה.

LA ZSH/PCRE מודול

השמיים zsh/pcre מודול הופך כמה פקודות לזמינות כמובנה:

pcre_compile [ -aimxs ] PCRE
קומפילציה של ביטוי רגולרי תואם perl.

אפשרות -a יאלץ את התבנית להיות מעוגנת. אוֹפְּצִיָה -i ירכיב א
דפוס חסר רגישות לאותיות גדולות. אוֹפְּצִיָה -m ירכיב דפוס רב-קו; זה, ^
ו $ יתאים קווים חדשים בתוך התבנית. אוֹפְּצִיָה -x ירכיב מורחב
דפוס, שבו רווח לבן ו # מתעלמים מהתגובות. אוֹפְּצִיָה -s עושה את הנקודה
מטא-תווים תואמים לכל התווים, כולל אלו שמציינים שורה חדשה.

pcre_study
בוחן את ה-PCRE שהורכב בעבר, מה שעשוי לגרום להתאמה מהירה יותר.

pcre_match [ -v היה ] [ -a arr ] [ -n לקזז ] [ -b ] מחרוזת
מחזיר בהצלחה אם מחרוזת תואם ל-PCRE שהורכב בעבר.

לאחר התאמה מוצלחת, אם הביטוי לוכד מחרוזות משנה בתוך סוגריים,
pcre_match יגדיר את המערך להתאים למחרוזות המשנה האלה, אלא אם כן -a האפשרות היא
נתון, ובמקרה זה הוא יגדיר את המערך arr. באופן דומה, המשתנה MATCH יצטרך
להיות מוגדר לכל החלק התואם של המחרוזת, אלא אם כן -v ניתנת אפשרות,
במקרה זה המשתנה היה יוגדר. אין משתנים אם ישנו
אין התאמה מוצלחת. א -n אפשרות מתחילה לחפש התאמה מהבית לקזז
מיקום ב מחרוזת. אם -b ניתנת אפשרות, המשתנה ZPCRE_OP יוגדר
למחרוזת זוג היסט, המייצגת את מיקומי היסט הבתים של כולו
חלק מותאם בתוך מחרוזת. לדוגמא, א ZPCRE_OP מוגדר ל-"32 45"
מציין שהחלק המותאם התחיל בהיסט בתים 32 והסתיים בהיסט בתים
44. כאן, מיקום היסט בתים 45 הוא המיקום ישירות אחרי ההתאמה
חֵלֶק. זכור שמיקום הבתים אינו בהכרח זהה ל-
מיקום התווים כאשר מעורבים תווי UTF-8. כתוצאה מכך, ה-byte
יש להסתמך על עמדות קיזוז רק בהקשר של השימוש בהן
החיפושים הבאים על מחרוזת, תוך שימוש במיקום היסט כטיעון ל- -n
אוֹפְּצִיָה. זה משמש בעיקר כדי ליישם את "מצא את כל ההתאמות שאינן חופפות"
פונקציונליות.

דוגמה פשוטה של ​​"מצא את כל ההתאמות שאינן חופפות":

string="ה הבא zip קודים: 78884 90210 99513 "
pcre_compile -m "\d{5}"
accum=()
pcre_match -b -- מחרוזת $
בזמן [[ $? -eq 0 ]] do
b=($=ZPCRE_OP)
accum+=$MATCH
pcre_match -b -n $b[2] -- מחרוזת $
עשה
הדפסה -l $accum

השמיים zsh/pcre מודול הופך את תנאי הבדיקה הבא לזמין:

ביטוי -pcre-match PCRE
התאמת מחרוזת לביטוי רגולרי תואם perl.

לדוגמה,

[[ "$טקסט" -pcre-match ^d+$ ]] &&
הדפסה טֶקסט משתנה מכיל רק "ד'ס".

אם REMATCH_PCRE האפשרות מוגדרת, ה =~ אופרטור שווה ערך ל -pcre-match,
ו NO_CASE_MATCH ניתן להשתמש באפשרות. ציין זאת NO_CASE_MATCH אף פעם לא חל על
מה היא pcre_match מובנה, במקום זאת השתמש ב- -i מתג של pcre_compile.

LA ZSH/REGEX מודול

השמיים zsh/regex מודול הופך את תנאי הבדיקה הבא לזמין:

ביטוי התאמה רגקס regex
התאמה של מחרוזת לביטוי רגולרי מורחב של POSIX. בהתאמה מוצלחת,
חלק מותאם של המחרוזת ימוקם בדרך כלל ב- MATCH מִשְׁתַנֶה. אם
יש סוגריים לכידה בתוך הביטוי הרגולרי, ואז ה- להתאים משתנה מערך
יכיל את אלה. אם ההתאמה לא תצליח, אז המשתנים לא יהיו
השתנה.

לדוגמה,

[[ אלפביתי התאמה רגקס ^a([^a]+)a([^a]+)a ]] &&
הדפסה -l $MATCH X התאמה $

אם האפשרות REMATCH_PCRE לא מוגדר, אז ה =~ המפעיל ייטען אוטומטית
מודול זה לפי הצורך ויפעיל את התאמה רגקס מפעיל.

If BASH_REMATCH מוגדר, ואז המערך BASH_REMATCH יוגדר במקום MATCH
ו להתאים.

LA ZSH/SCHED מודול

השמיים zsh/sched מודול זמין פקודה מובנית אחת ופרמטר אחד.

לוח זמנים [-o] [+]hh:mm[:ss] הפקודה ...
לוח זמנים [-o] [+]שניות הפקודה ...
לוח זמנים [ -פריט ]
רשום ברשימה המתוזמנת של הפקודות לביצוע. הזמן יכול להיות
המצוין בזמן מוחלט או יחסי, וגם כשעות, דקות ו
(אופציונלי) שניות מופרדות על ידי נקודתיים, או שניות לבד. מספר מוחלט של
שניות מציינת את הזמן מאז התקופה (1970/01/01 00:00); זה שימושי ב
שילוב עם התכונות ב- zsh/datetime מודול, ראה את zsh/datetime
כניסת מודול ב zshmodules(1).

ללא ארגומנטים, מדפיס את רשימת הפקודות המתוזמנות. אם הפקודה המתוזמנת
יש -o סט דגל, זה מוצג בתחילת הפקודה.

עם הטיעון `-פריט', מסיר את הפריט הנתון מהרשימה. המספור של
הרשימה רציפה והכניסות הן בסדר זמן, כך שהמספור יכול להשתנות
כאשר ערכים מתווספים או נמחקים.

הפקודות מבוצעות מיד לפני הנחיה, או תוך כדי קו המעטפת
העורך ממתין לקלט. במקרה האחרון זה שימושי להיות מסוגל לייצר
פלט שאינו מפריע לשורה הנערכת. מתן האפשרות -o
גורם למעטפת לנקות את שורת הפקודה לפני האירוע ולצייר אותה מחדש
לאחר מכן. יש להשתמש בזה עם כל אירוע מתוזמן שמייצר גלוי
פלט למסוף; זה לא נחוץ, למשל, עם פלט שמעדכן את a
שורת הכותרת של אמולטור מסוף.

השמיים לוח זמנים מובנה אינו זמין כברירת מחדל כאשר המעטפת מתחילה במצב
מחקה קליפה אחרת. זה יכול להיות זמין עם הפקודה `zmodload -F
zsh/sched b:sched'.

zsh_scheduled_events
מערך לקריאה בלבד המתאים לאירועים שתוזמנו על ידי לוח זמנים מובנה. ה
המדדים של המערך תואמים למספרים המוצגים כאשר לוח זמנים מתנהל עם לא
טיעונים (בתנאי שה KSH_ARRAYS האפשרות לא מוגדרת). הערך של המערך
מורכב מהזמן המתוכנן בשניות מאז התקופה (ראה סעיף `ה
zsh/datetime Module' עבור מתקנים לשימוש במספר זה), ואחריו נקודתיים,
ואחריו כל האפשרויות (שעשויות להיות ריקות, אך יקדמו את ה-`-'
אחרת), ואחריו נקודתיים, ואחריו הפקודה שיש לבצע.

השמיים לוח זמנים מובנה צריך לשמש למניפולציה של האירועים. שימו לב שזה יהיה
יש השפעה מיידית על תוכן המערך, כך שהמדדים עשויים להפוך
לא חוקי.

LA ZSH/NET/SOCKET מודול

השמיים zsh/net/socket מודול זמין פקודה מובנית אחת:

zsocket [ -altv ] [ -d fd ] [ טוען ]
zsocket מיושם כמובנה כדי לאפשר שימוש מלא בשורת הפקודה של מעטפת
מנגנוני עריכה, קלט/פלט של קבצים ומנגנוני בקרת עבודה.

יוצא חיבורי
zsocket [ -v ] [ -d fd ] שם הקובץ
פתח חיבור דומיין חדש ל-Unix שם הקובץ. פרמטר המעטפת תשובה יהיה
מוגדר לתיאור הקובץ המשויך לחיבור זה. כרגע, רק זרם
חיבורים נתמכים.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

על מנת לעורר פלט רב יותר, השתמש -v.

נכנס חיבורי
zsocket -l [ -v ] [ -d fd ] שם הקובץ
zsocket -l יפתח שקע בהאזנה שם הקובץ. פרמטר המעטפת תשובה
יוגדר לתיאור הקובץ המשויך לאותו מאזין.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

על מנת לעורר פלט רב יותר, השתמש -v.

zsocket -a [ -טֵלֶוִיזִיָה ] [ -d targetfd ] להאזיןfd
zsocket -a יקבל חיבור נכנס לשקע המשויך אליו
להאזיןfd. פרמטר המעטפת תשובה יוגדר לתיאור הקובץ המשויך
עם החיבור הנכנס.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

If -t מצוין, zsocket יחזור אם אין חיבור נכנס בהמתנה.
אחרת זה יחכה לאחד.

על מנת לעורר פלט רב יותר, השתמש -v.

LA ZSH/STAT מודול

השמיים zsh/stat מודול הופך פקודה מובנית אחת לזמינה תחת שני שמות אפשריים:

zstat [ -gnNolLtTrs ] [ -f fd ] [ -H שירים ] [ -A מערך ] [ -F fmt ]
[ +אלמנט ] [ פילה ... ]
stat ...
הפקודה פועלת כחזית ל- stat שיחת מערכת (ראה stat(2)). אותו הדבר
הפקודה מסופקת בשני שמות; בתור השם stat משמש לעתים קרובות על ידי חיצוני
פקודה מומלץ שרק את zstat נעשה שימוש בצורת הפקודה. זֶה
ניתן לארגן על ידי טעינת המודול עם הפקודה `zmodload -F zsh/stat
b:zstat'.

אם stat השיחה נכשלה, הודעת שגיאת המערכת המתאימה הודפסה ומצב 1
מוחזר. השדות של מבנה stat לתת מידע על הקבצים שסופקו
כטיעונים לפקודה. בנוסף לאלו הזמינים מ- stat להתקשר, א
אלמנט נוסף `קישור' מסופק. אלמנטים אלו הם:

מכשיר מספר המכשיר שבו נמצא הקובץ.

inode המספר הייחודי של הקובץ במכשיר זה (`inode' מספר).

מצב מצב הקובץ; כלומר, סוג הקובץ והרשאות הגישה שלו. עם
מה היא -s אפשרות, זו תוחזר כמחרוזת המתאימה לראשונה
עמודה בתצוגה של ls -l פקודה.

nlink מספר הקישורים הקשיחים לקובץ.

uid מזהה המשתמש של הבעלים של הקובץ. עם ה -s אפשרות זו מוצגת
כשם משתמש.

gid מזהה הקבוצה של הקובץ. עם ה -s אפשרות זו מוצגת כקבוצה
שם.

rdev מספר המכשיר הגולמי. זה שימושי רק עבור מכשירים מיוחדים.

גודל גודל הקובץ בבתים.

זמן
mtime
זמן זמני הגישה, השינוי ושינוי האינוד האחרונים של הקובץ,
בהתאמה, כמספר השניות מאז חצות GMT ב-1 בינואר,
1970. עם -s אפשרות, אלה מודפסים כמחרוזות עבור הזמן המקומי
אֵזוֹר; ניתן לשנות את הפורמט באמצעות -F אפשרות, ועם -g אוֹפְּצִיָה
הזמנים הם ב-GMT.

blksize
מספר הבתים בבלוק הקצאה אחד במכשיר שבו הקובץ
מתגורר.

בלוק מספר בלוקי הדיסקים שבהם השתמש הקובץ.

קישור אם הקובץ הוא קישור וה- -L האפשרות בתוקף, זה מכיל את השם
של הקובץ שמקושר אליו, אחרת הוא ריק. שים לב שאם אלמנט זה הוא
נבחר (``zstat +קישור'') אז ה -L האפשרות משמשת אוטומטית.

ניתן לבחור אלמנט מסוים על ידי הכללת שמו שלפניו א'+' בתוך ה
רשימת אפשרויות; רק אלמנט אחד מותר. ניתן לקצר את האלמנט לכל
סט ייחודי של דמויות מובילות. אחרת, כל הרכיבים יוצגו עבור כולם
קבצים.

אפשרויות:

-A מערך
במקום להציג את התוצאות בפלט סטנדרטי, הקצה אותן ל-an
מערך, אחד מבנה stat אלמנט לכל רכיב מערך עבור כל קובץ לפי הסדר. ב
במקרה זה לא מופיע שם האלמנט ולא שם הקבצים
in מערך אלא אם כן ה -t or -n ניתנו אפשרויות, בהתאמה. אם -t is
בהינתן, שם הרכיב מופיע בתור קידומת למערך המתאים
אֵלֵמֶנט; אם -n נתון, שם הקובץ מופיע כרכיב מערך נפרד
לפני כל האחרים. אפשרויות עיצוב אחרות מכבדות.

-H שירים
דומה -A, אך במקום זאת הקצה את הערכים ל שירים. המפתחות הם ה
אלמנטים המפורטים למעלה. אם ה -n האפשרות מסופקת ואז השם של
הקובץ כלול ב-hash עם מפתח שם.

-f fd השתמש בקובץ על מתאר הקובץ fd במקום קבצים בעלי שם; אין רשימה של קבצים
שמות מותרים במקרה זה.

-F fmt אספקה ​​א זמן אחסון (ראה זמן אחסון(3)) מחרוזת עבור העיצוב של הזמן
אלמנטים. ה -s אפשרות משתמעת.

-g הצג את רכיבי הזמן באזור הזמן של GMT. ה -s אפשרות משתמעת.

-l רשום את השמות של רכיבי הסוג (לפלט סטנדרטי או מערך as
מתאים) וחזור מיד; אפשרויות מלבד -A וטיעונים הם
התעלם.

-L בצע א lstat (ראה lstat(2)) במקום א stat שיחת מערכת. בזה
במקרה, אם הקובץ הוא קישור, מידע על הקישור עצמו ולא
קובץ היעד מוחזר. אפשרות זו נדרשת כדי להפוך את קישור
אלמנט שימושי. חשוב לציין שזה בדיוק ההפך מ
ls(1) וכו '.

-n הצג תמיד את שמות הקבצים. בדרך כלל אלה מוצגים רק כאשר הפלט הוא
לפלט סטנדרטי ויש יותר מקובץ אחד ברשימה.

-N לעולם אל תציג את שמות הקבצים.

-o אם מודפס מצב קובץ גולמי, הצג אותו באוקטלי, וזה שימושי יותר עבור
צריכת אדם מאשר ברירת המחדל של עשרוני. אפס מוביל יהיה
מודפס במקרה זה. שים לב שזה לא משפיע אם גולמי או
מוצג מצב קובץ מעוצב, שנשלט על ידי ה- -r ו -s אפשרויות,
וגם לא אם מוצג מצב בכלל.

-r הדפס נתונים גולמיים (פורמט ברירת המחדל) לצד נתוני מחרוזת (ה -s פוּרמָט);
נתוני המחרוזת מופיעים בסוגריים אחרי הנתונים הגולמיים.

-s קופונים להדפסה מצב, uid, gid ושלושת מרכיבי הזמן כמחרוזות במקום
מספרים. בכל מקרה הפורמט הוא כמו של ls -l.

-t הצג תמיד את שמות הסוגים עבור הרכיבים של מבנה stat. בדרך כלל אלה
מוצגים רק כאשר הפלט הוא לפלט סטנדרטי וללא רכיב בודד
נבחר.

-T לעולם אל תציג את שמות הסוגים של ה מבנה stat אלמנטים.

LA ZSH/SYSTEM מודול

השמיים zsh/system מודול מעמיד פקודות ופרמטרים מובנים שונים.

מובנה
שגיאת מערכת [ -e errvar ] [ -p קידומת ] [ ארנו | שם שגיאה ]
פקודה זו מדפיסה את הודעת השגיאה הקשורה אליה ארנו, שגיאת מערכת
מספר, ואחריו שורה חדשה לשגיאה רגילה.

במקום מספר השגיאה, שם שם שגיאה, למשל ENOENT, עשוי להיות בשימוש. ה
קבוצת השמות זהה לתוכן המערך טעות, ראה למטה.

אם המחרוזת קידומת נתון, הוא מודפס מול הודעת השגיאה, עם לא
חלל התערבות.

If errvar מסופק, כל ההודעה, ללא שורה חדשה, מוקצית ל-
שמות פרמטרים errvar ושום דבר אינו פלט.

מצב החזרה של 0 מציין שההודעה הודפסה בהצלחה (למרות שהיא
ייתכן שלא יהיה שימושי אם מספר השגיאה היה מחוץ לטווח המערכת), החזרה
מצב של 1 מציין שגיאה בפרמטרים, ומצב החזרה של 2
מציין ששם השגיאה לא זוהה (לא מודפסת הודעה על כך).

sysopen [ -arw ] [ -m הרשאות ] [ -o אפשרויות ]
-u fd פילה
פקודה זו פותחת קובץ. ה -r, -w ו -a דגלים מציינים אם הקובץ צריך
ייפתח לקריאה, כתיבה והוספה, בהתאמה. ה -m האפשרות מאפשרת
ההרשאות הראשוניות לשימוש בעת יצירת קובץ שיצוין בצורה אוקטלית.
מתאר הקובץ מצוין עם -u. או מתאר קובץ מפורש ב-
ניתן לציין טווח 0 עד 9 או לתת שם משתנה שאליו הקובץ
יוקצה מספר מתאר.

השמיים -o אפשרות מאפשרת לציין אפשרויות שונות ספציפיות למערכת בתור א
רשימה מופרדת בפסיקים. להלן רשימה של אפשרויות אפשריות. ציין זאת,
בהתאם למערכת, ייתכן שחלקם לא יהיו זמינים.
cloexec
סמן את הקובץ לסגירה בעת הפעלת תוכניות אחרות

לִיצוֹר
creat צור קובץ אם הוא לא קיים

לא כולל צור קובץ, שגיאה אם ​​הוא כבר קיים

Noatime
לדכא את עדכון הקובץ בכל פעם

nofollow
להיכשל אם פילה הוא קישור סמלי

לסנכרן בקשה שכותבת חכה עד שהנתונים נכתבו פיזית

לקטוע
TRUNC חתוך את הקובץ לגודל 0

כדי לסגור את הקובץ, השתמש באחת מהאפשרויות הבאות:

Exec {fd}<&-
Exec {fd}>&-

sysread [ -c countvar ] [ -i infd ] [ -o outfd ]
[ -s גודל bufsize ] [ -t פסק זמן ] [ להפסיק ]
בצע קריאת מערכת אחת מתאר קובץ infd, או אפס אם זה לא
נָתוּן. תוצאת הקריאה נשמרת ב להפסיק or תשובה אם זה לא ניתן.
If countvar נתון, מספר הבתים הנקראים מוקצה לפרמטר הנקרא
by countvar.

המספר המרבי של בתים שנקרא הוא גודל bufsize או 8192 אם זה לא ניתן, עם זאת
הפקודה חוזרת ברגע שכל מספר בתים נקרא בהצלחה.

If פסק זמן נתון, הוא מציין פסק זמן בשניות, שעשוי להיות אפס לסקר
מתאר הקובץ. זה מטופל על ידי בו שיחת מערכת אם זמינה,
אחרת ה בחר שיחת מערכת אם זמינה.

If outfd נתון, נעשה ניסיון לכתוב את כל הבתים שזה עתה נקראו לקובץ
מתאר outfd. אם זה נכשל, בגלל שגיאת מערכת אחרת מאשר EINTR or
בגלל שגיאת zsh פנימית במהלך פסיקה, הבייטים קוראים אבל לא
שנכתבו מאוחסנים בפרמטר בשם על ידי להפסיק אם מסופק (לא נעשה שימוש ברירת מחדל
במקרה זה), ומספר הבתים שנקראו אך לא נכתבו מאוחסן ב-
פרמטר בשם על ידי countvar אם זה מסופק. אם זה היה מוצלח, countvar
מכיל את המספר המלא של בתים שהועברו, כרגיל, ו להפסיק אינו מוגדר.

הטעות EINTR (שיחת מערכת מופרעת) מטופלת באופן פנימי כך שהמעטפת
ההפסקות שקופות למתקשר. כל שגיאה אחרת גורמת להחזרה.

סטטוסי ההחזרה האפשריים הם
0 לפחות בייט אחד של נתונים נקרא בהצלחה, ואם מתאים,
כתוב.

1 הייתה שגיאה בפרמטרים של הפקודה. זו השגיאה היחידה
שעבורו מודפסת הודעה לפי שגיאת תקן.

2 אירעה שגיאה בקריאה או בסקר מתאר קובץ הקלט עבור
פסק זמן. הפרמטר שגיאה נותן את השגיאה.

3 הנתונים נקראו בהצלחה, אך אירעה שגיאה בכתיבה אליהם outfd.
הפרמטר שגיאה נותן את השגיאה.

4 פסק הזמן הקצוב לניסיון הקריאה. שימו לב שזה לא מוגדר שגיאה כפי שזה לא
שגיאת מערכת.

5 לא אירעה שגיאת מערכת, אך נקראו אפס בתים. זה בדרך כלל מעיד
סוף הקובץ. הפרמטרים נקבעים על פי הכללים הרגילים; לא לכתוב
ל outfd מנסים.

sysseek [ -u fd ] [ -w התחלה|סוף|נוֹכְחִי ] לקזז
מיקום הקובץ הנוכחי שבו יתבצעו קריאה וכתיבה עתידית היא
מותאם לקיזוז הבתים שצוין. ה לקזז מוערך כמתמטיקה
ביטוי. ה -u האפשרות מאפשרת לציין את מתאר הקובץ. כברירת מחדל
ההיסט מצוין ביחס להתחלה או לקובץ אבל, עם ה- -w אוֹפְּצִיָה,
אפשר לציין שההיסט צריך להיות ביחס לזרם
מיקום או סוף הקובץ.

syswrite [ -c countvar ] [ -o outfd ] נתונים
הנתונים (מחרוזת בתים בודדת) נכתבים אל מתאר הקובץ outfd, או 1
אם זה לא ניתן, באמצעות לכתוב שיחת מערכת. פעולות כתיבה מרובות עשויות
לשמש אם הראשון לא כותב את כל הנתונים.

If countvar נתון, מספר הבתים שנכתב מאוחסן בפרמטר ששמו
by countvar; זה אולי לא לכל אורכו של נתונים אם אירעה שגיאה.

הטעות EINTR (שיחת מערכת מופרעת) מטופלת באופן פנימי על ידי ניסיון חוזר;
אחרת שגיאה גורמת לפקודה לחזור. לדוגמה, אם הקובץ
מתאר מוגדר לפלט לא חוסם, שגיאה שוב (במערכות מסוימות,
EWOULDBLOCK) עלול לגרום לכך שהפקודה תחזור מוקדם.

מצב ההחזרה עשוי להיות 0 עבור הצלחה, 1 עבור שגיאה בפרמטרים של
פקודה, או 2 עבור שגיאה בכתיבה; לא מודפסת הודעת שגיאה באחרון
מקרה, אבל הפרמטר שגיאה ישקף את השגיאה שהתרחשה.

zsystem פלוק [ -t פסק זמן ] [ -f היה ] [-R] פילה
zsystem פלוק -u fd_expr
המובנה zsystemפקודה המשנה של פלוק מבצע נעילת קבצים מייעצים (דרך
fcntl(2) קריאת מערכת) על כל התוכן של הקובץ הנתון. צורה זו של
נעילה מחייבת את התהליכים הניגשים לקובץ לשתף פעולה; הכי ברור שלו
השימוש הוא בין שני מופעים של המעטפת עצמה.

בצורה הראשונה את השם פילה, שחייב כבר להתקיים, ננעל על ידי פתיחת א
מתאר קובץ לקובץ והחלת מנעול על מתאר הקובץ. המנעול
מסתיים כאשר תהליך המעטפת שיצר את המנעול יוצא; לכן
לעתים קרובות נוח ליצור נעילות קבצים בתוך קונכיות משנה, שכן המנעול הוא
משוחרר אוטומטית כאשר תת-המעטפת יוצאת. מצב 0 מוחזר אם הנעילה
מצליח, אחרת סטטוס 1.

בצורה השנייה מתאר הקובץ שניתן על ידי הביטוי האריתמטי fd_expr
סגור, משחרר מנעול. ניתן לשאול את מתאר הקובץ באמצעות ה- `-f
היה' נוצר במהלך הנעילה; על מנעול מוצלח, משתנה המעטפת היה מוגדר
מתאר הקובץ המשמש לנעילה. המנעול ישוחרר אם הקובץ
מתאר נסגר בכל אמצעי אחר, למשל באמצעות `Exec {היה}>&-';
עם זאת, הטופס המתואר כאן מבצע בדיקת בטיחות שמתאר הקובץ
נמצא בשימוש לנעילת קבצים.

כברירת מחדל, המעטפת ממתינה ללא הגבלת זמן עד שהנעילה תצליח. האפשרות -t
פסק זמן מציין פסק זמן לנעילה בשניות; כרגע זה חייב להיות an
מספר שלם. המעטפת תנסה לנעול את הקובץ פעם בשנייה במהלך תקופה זו.
אם הזמן הקצוב לניסיון, סטטוס 2 מוחזר.

אם האפשרות -e נתון, מתאר הקובץ עבור המנעול נשמר כאשר
שימושים במעטפת Exec להתחיל תהליך חדש; אחרת הוא סגור באותה נקודה ו
המנעול השתחרר.

אם האפשרות -r נתון, המנעול מיועד רק לקריאה, אחרת הוא מיועד
קריאה וכתיבה. מתאר הקובץ נפתח בהתאם.

zsystem תומך פקודה משנה
המובנה zsystemפקודה המשנה של תומך בודק אם תת-פקודה נתונה היא
נתמך. הוא מחזיר סטטוס 0 אם כן, אחרת סטטוס 1. הוא פועל בשקט אלא אם כן
הייתה שגיאת תחביר (כלומר מספר שגוי של ארגומנטים), ובמקרה זה מצב
255 מוחזר. סטטוס 1 יכול להצביע על אחד משני דברים: פקודה משנה ידוע אבל
לא נתמך על ידי מערכת ההפעלה הנוכחית, או פקודה משנה לא ידוע (ייתכן
מכיוון שזוהי גרסה ישנה יותר של המעטפת לפני שהוטמעה).

מתמטיקה פונקציות
סיסטל(fd)
הפונקציה systell Math מחזירה את מיקום הקובץ הנוכחי עבור מתאר הקובץ
עבר כטיעון.

פרמטרים
טעות מערך קריאה בלבד של שמות השגיאות המוגדרות במערכת. אלה הם בדרך כלל
פקודות מאקרו שהוגדרו ב-C על ידי הכללת קובץ הכותרת של המערכת errno.h. המדד של כל אחד
שם (בהנחה שהאפשרות KSH_ARRAYS לא מוגדר) מתאים למספר השגיאה.
מספרי שגיאה NUM לפני השגיאה הידועה האחרונה שאין לה שם ניתן השם
ENUM במערך.

שים לב שכינויים לשגיאות אינם מטופלים; רק השם הקנוני משמש.

סיספרמים
מערך אסוציאטיבי לקריאה בלבד. המפתחות הם:

PID מחזירה את מזהה התהליך של התהליך הנוכחי, אפילו במעטפות משנה. לְהַשְׁווֹת
$$, אשר מחזיר את מזהה התהליך של תהליך המעטפת הראשי.

ppd מחזירה את מזהה התהליך של האב של התהליך הנוכחי, אפילו ב
קונכיות משנה. לְהַשְׁווֹת $PPID, אשר מחזיר את מזהה התהליך של האב של ה-
תהליך המעטפת הראשי.

LA ZSH/NET/TCP מודול

השמיים zsh/net/tcp מודול זמין פקודה מובנית אחת:

ztcp [ -acflLtv ] [ -d fd ] [ טוען ]
ztcp מיושם כמובנה כדי לאפשר שימוש מלא בעריכת שורת הפקודה של מעטפת,
קלט/פלט קבצים ומנגנוני בקרת עבודה.

If ztcp מופעל ללא אפשרויות, הוא יוציא את התוכן של טבלת הפעלות שלו.

אם זה מופעל רק עם האפשרות -L, זה יוציא את תוכן ההפעלה
טבלה בפורמט המתאים לניתוח אוטומטי. מתעלמים מהאפשרות אם היא ניתנת
עם פקודה לפתוח או לסגור הפעלה. הפלט מורכב מקבוצה של קווים,
אחד לכל מפגש, כל אחד מכיל את האלמנטים הבאים מופרדים ברווחים:

מתאר קובץ
מתאר הקובץ שנמצא בשימוש עבור החיבור. לכניסה רגילה (I) ו
יוצא (O) קשרים זה עשוי להיקרא ולכתוב על ידי המעטפת הרגילה
מנגנונים. עם זאת, זה צריך להיות קרוב רק עם `ztcp -c'.

סוג חיבור
מכתב המציין כיצד נוצר הפגישה:

Z הפעלה שנוצרה עם zftp פקודה.

L נפתח חיבור להאזנה עם `ztcp -l'.

I חיבור נכנס מתקבל עם `ztcp -a'.

O חיבור יוצא שנוצר עם `ztcp המארח ...'.

המארח המקומי
זה בדרך כלל מוגדר ככתובת IP אפס ככתובת של
localhost לא רלוונטי.

הנמל המקומי
סביר להניח שזה יהיה אפס אלא אם החיבור נועד להאזנה.

המארח המרוחק
זהו שם הדומיין המלא של העמית, אם זמין, אחרת
כתובת ה - IP. זוהי כתובת IP אפסית עבור הפעלה שנפתחה עבורה
הַקשָׁבָה.

היציאה המרוחקת
זה אפס עבור חיבור שנפתח להאזנה.

יוצא חיבורי
ztcp [ -v ] [ -d fd ] המארח [ נמל ]
פתח חיבור TCP חדש ל המארח. אם נמל מושמט, הוא יהפוך כברירת מחדל ליציאה
23. החיבור יתווסף לטבלת הפגישה ולפרמטר המעטפת
תשובה יוגדר לתיאור הקובץ המשויך לחיבור זה.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

על מנת לעורר פלט רב יותר, השתמש -v.

נכנס חיבורי
ztcp -l [ -v ] [ -d fd ] נמל
ztcp -l יפתח שקע מאזין ב-TCP נמל. השקע יתווסף ל-
טבלת הפעלות ופרמטר המעטפת תשובה יוגדר לתיאור הקובץ
קשור לאותו מאזין.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

על מנת לעורר פלט רב יותר, השתמש -v.

ztcp -a [ -טֵלֶוִיזִיָה ] [ -d targetfd ] להאזיןfd
ztcp -a יקבל חיבור נכנס ליציאה המשויכת אליו להאזיןfd.
החיבור יתווסף לטבלת הפגישה ולפרמטר המעטפת תשובה
יוגדר לתיאור הקובץ המשויך לחיבור הנכנס.

If -d מצוין, הארגומנט שלו יילקח כמתאר קובץ היעד עבור
החיבור.

If -t מצוין, ztcp יחזור אם אין חיבור נכנס בהמתנה.
אחרת זה יחכה לאחד.

על מנת לעורר פלט רב יותר, השתמש -v.

סְגִירָה חיבורי
ztcp -סה [ -v ] [ fd ]
ztcp -c [ -v ] [ fd ]
ztcp -c יסגור את השקע המשויך אליו fd. השקע יוסר ממנו
שולחן הפגישה. אם fd לא מצוין, ztcp יסגור הכל ב
שולחן הפעלות.

בדרך כלל, שקעים רשומים על ידי zftp (ראה zshmodules(1) ) לא ניתן לסגור את זה
דֶרֶך. על מנת לסגור שקע כזה בכוח, השתמש -f.

על מנת לעורר פלט רב יותר, השתמש -v.

דוגמה
הנה איך ליצור חיבור TCP בין שני מופעים של zsh. אנחנו צריכים לבחור א
יציאה לא מוקצה; כאן אנו משתמשים ב-5123 שנבחר באקראי.

On host1,
zmodload zsh/net/tcp
ztcp -l 5123
listenfd=$REPLY
ztcp -a $האזנה
fd=$REPLY
הפקודה השנייה מהפקודה האחרונה חוסמת עד שיש חיבור נכנס.

כעת צור חיבור מ host2 (שיכולה להיות, כמובן, אותה מכונה):
zmodload zsh/net/tcp
ztcp host1 5123
fd=$REPLY

עכשיו בכל מארח, $fd מכיל מתאר קובץ לשיחה עם האחר. לדוגמה,
on host1:
הדפסה זֶה is a הודעה >&$fd
ועל host2:
לקרוא -r קו <&$fd; הדפסה -r - $line
הדפסים `זֶה is a הודעה'.

לסדר, הלאה host1:
ztcp -c $האזנה
ztcp -c $fd
ועל host2
ztcp -c $fd

LA ZSH/TERMCAP מודול

השמיים zsh/termcap מודול זמין פקודה מובנית אחת:

echotc כּוֹבַע [ גדול מ ... ]
פלט את ערך termcap המתאים ליכולת כּוֹבַע, עם אופציונלי
ארגומנטים.

השמיים zsh/termcap מודול זמין פרמטר אחד:

termcap
מערך אסוציאטיבי הממפה קודי יכולת termcap לערכים שלהם.

LA ZSH/TERMINFO מודול

השמיים zsh/termininfo מודול זמין פקודה מובנית אחת:

echoti כּוֹבַע [ גדול מ ]
פלט את ערך terminfo המתאים ליכולת כּוֹבַע, באינסטציה עם
גדול מ אם ניתן ליישום.

השמיים zsh/termininfo מודול זמין פרמטר אחד:

מונח מידע
מערך אסוציאטיבי שממפה שמות של יכולות terminfo לערכים שלהם.

LA ZSH/ZFTP מודול

השמיים zsh/zftp מודול זמין פקודה מובנית אחת:

zftp פקודה משנה [ טוען ]
השמיים zsh/zftp מודול הוא לקוח עבור FTP (פרוטוקול העברת קבצים). זה
מיושם כמובנה כדי לאפשר שימוש מלא בעריכת שורת הפקודה של מעטפת, קובץ I/O,
ומנגנוני שליטה בעבודה. לעתים קרובות, משתמשים ייגשו אליו באמצעות פונקציות מעטפת
מתן ממשק חזק יותר; סט מסופק עם ZSH הפצה
ומתואר ב zshzftpsys(1). אולם, ה zftp הפקודה ניתנת לחלוטין לשימוש ב
בזכות עצמו.

כל הפקודות מורכבות משם הפקודה zftp ואחריו שם של פקודה משנה.
אלה מפורטים להלן. סטטוס ההחזרה של כל פקודה משנה אמור להיות
משקף את ההצלחה או הכישלון של הפעולה מרחוק. ראה תיאור של
משתנה ZFTP_VERBOSE למידע נוסף על איך תגובות מהשרת עשויות להיות
מודפס.

פקודות משנה
לפתוח המארח[:נמל] [ המשתמש [ סיסמא [ חשבון ] ] ]
פתח הפעלת FTP חדשה כדי המארח, שעשוי להיות שמו של מארח TCP/IP המחובר או
מספר IP בסימון הנקודות הסטנדרטי. אם הטיעון הוא בצורה
המארח:נמל, פתח חיבור ליציאת TCP נמל במקום יציאת ה-FTP הרגילה 21.
זה עשוי להיות שם של שירות TCP או מספר: ראה את התיאור של
ZFTP_PORT להלן למידע נוסף.

אם נעשה שימוש בכתובות IPv6 בפורמט נקודתיים, ה- המארח צריך להיות מוקף בציטוט
סוגריים מרובעים כדי להבחין בינו לבין נמל, למשל
'[fe80::203:baff:fe02:8b56]'. למען עקביות זה מותר עם כל הצורות של
המארח.

שאר הטיעונים מועברים ל- התחבר פקודה משנה. שימו לב שאם אין טיעונים
מעבר המארח מסופקים, לפתוח יצטרך לֹא להתקשר אוטומטית התחבר. אם אין טיעונים
בכלל מסופקים, לפתוח ישתמש בפרמטרים שנקבעו על ידי params פקודה משנה.

לאחר פתיחה מוצלחת, המעטפת משתנים ZFTP_HOST, ZFTP_PORT, ZFTP_IP ו
ZFTP_SYSTEM פנויים; ראה 'משתנים' להלן.

התחבר [ שם [ סיסמא [ חשבון ] ] ]
המשתמש [ שם [ סיסמא [ חשבון ] ] ]
התחבר למשתמש שם עם פרמטרים סיסמא ו חשבון. כל אחד מהפרמטרים
ניתן להשמיט, ויקרא מקלט סטנדרטי במידת הצורך (שם תמיד
נָחוּץ). אם הקלט הסטנדרטי הוא מסוף, תודפס הנחיה עבור כל אחד מהם
שגיאת תקן ו סיסמא לא יקבל הד. אם אחד מהפרמטרים לא
בשימוש, מודפסת הודעת אזהרה.

לאחר כניסה מוצלחת, משתני המעטפת ZFTP_USER, ZFTP_ACCOUNT ו ZFTP_PWD
פנויים; ראה 'משתנים' להלן.

פקודה זו עשויה להיות מונפקת מחדש כאשר משתמש כבר מחובר, והשרת יעשה זאת
תחילה לאתחל מחדש עבור משתמש חדש.

params [ המארח [ המשתמש [ סיסמא [ חשבון ] ] ] ]
params -
אחסן את הפרמטרים הנתונים למועד מאוחר יותר לפתוח פקודה ללא טיעונים. רק אלו
נתון בשורת הפקודה ייזכר. אם לא ניתנו טיעונים, ה
הפרמטרים המוגדרים כעת מודפסים, אם כי הסיסמה תופיע כשורה
של כוכבים; מצב ההחזרה הוא אחד אם לא הוגדרו פרמטרים, אחרת אפס.

ניתן לציין כל אחד מהפרמטרים בתור `?', שאולי צריך לצטט
להגן עליו מפני התרחבות מעטפת. במקרה זה, הפרמטר המתאים יהיה
קרא מתוך stdin כמו עם ה התחבר פקודה משנה, כולל טיפול מיוחד ב
סיסמא. אם ה`?' ואחריו מחרוזת, המשמשת כהנחיה עבור
קריאת הפרמטר במקום הודעת ברירת המחדל (כל סימני פיסוק ו
יש לכלול רווח לבן בסוף ההנחיה). האות הראשונה של ה
ניתן לצטט פרמטר (בלבד) עם '\'; ומכאן טיעון "\\$word" ערבויות
שהמחרוזת מפרמטר המעטפת $word יטופלו מילולית, אם
או לא זה מתחיל ב-`?'.

אם במקום יחיד `-' נתון, הפרמטרים הקיימים, אם יש כאלה, נמחקים. ב
המקרה הזה, מתקשר לפתוח ללא ארגומנטים יגרום לשגיאה.

רשימת הפרמטרים לא נמחקת לאחר א close, אולם הוא יימחק אם
מה היא zsh/zftp מודול פרוק.

לדוגמה,

zftp params ftp.elsewhere.xx juser '?סיסמה ל juser: '

יאחסן את המארח ftp.elsewhere.xx והמשתמש juser ולאחר מכן בקש מהמשתמש
עבור הסיסמה המתאימה עם ההנחיה הנתונה.

מבחן בדוק את החיבור; אם השרת דיווח שהוא סגר את החיבור
(אולי בגלל פסק זמן), מצב החזרה 2; אם בכל מקרה לא היה חיבור פתוח, חזור
סטטוס 1; אחרת מצב החזרה 0. ה מבחן תת-פקודה שקטה, מלבד הודעות
נדפס על ידי $ZFTP_VERBOSE מנגנון, או הודעות שגיאה אם ​​החיבור נסגר.
אין תקורה ברשת לבדיקה זו.

הבדיקה נתמכת רק במערכות עם או בחר(2) or בו(2) מערכת
שיחות; אחרת ההודעה `לֹא נתמך on זֶה מערכת' מודפס במקום.

השמיים מבחן תת-פקודה תיקרא אוטומטית בתחילת כל פקודה אחרת
פקודה משנה עבור ההפעלה הנוכחית כאשר חיבור פתוח.

cd בספרייה
שנה את הספרייה המרוחקת ל בספרייה. משנה גם את משתנה המעטפת ZFTP_PWD.

cdup שנה את הספרייה המרוחקת לזו הגבוהה יותר בעץ הספריות. ציין זאת cd
.. יעבוד כמו שצריך גם במערכות שאינן UNIX.

dir [ גדול מ ... ]
תן רשימה (רבותית) של הספרייה המרוחקת. ה גדול מs מועברים ישירות ל
השרת. התנהגות הפקודה תלויה ביישום, אך שרת UNIX
יפרש בדרך כלל גדול מs כטיעונים ל ls פקודה וללא טיעונים
להחזיר את התוצאה של `ls -l'. הספרייה רשומה לפלט סטנדרטי.

ls [ גדול מ ... ]
תן רשימה (קצרה) של הספרייה המרוחקת. ללא גדול מ, מייצר רשימה גולמית
מהקבצים בספריה, אחד בכל שורה. אחרת, עד גחמות של
יישום שרת, מתנהג דומה ל dir.

סוג [ סוג ]
שנה את סוג ההעברה אל סוג, או הדפס את הסוג הנוכחי אם סוג is
נֶעדָר. הערכים המותרים הם `A' (ASCII), `I' (תמונה, כלומר בינארית), או 'B' (א
מילה נרדפת ל`I').

ברירת המחדל של ה-FTP עבור העברה היא ASCII. לעומת זאת, אם zftp מגלה שהשלט
host הוא מכונת UNIX עם בייס של 8 סיביות, הוא יעבור אוטומטית לשימוש
בינארי עבור העברות קבצים על לפתוח. ניתן לעקוף זאת לאחר מכן.

סוג ההעברה מועבר למארח המרוחק רק כאשר יש חיבור נתונים
מְבוּסָס; פקודה זו אינה כרוכה בתקורת רשת.

ASCII זהה ל סוג A.

בינרי זהה ל סוג I.

מצב [ S | B ]
הגדר את סוג המצב לסטרימינג (S) או לחסום (B). מצב זרם הוא ברירת המחדל; לַחסוֹם
מצב אינו נתמך באופן נרחב.

מרחוק פילה ...
מקומי [ פילה ... ]
הדפס את הגודל וזמן השינוי האחרון של הקבצים המרוחקים או המקומיים. אם יש
הוא יותר מפריט אחד ברשימה, שם הקובץ מודפס ראשון. ה
המספר הראשון הוא גודל הקובץ, השני הוא זמן השינוי האחרון של הקובץ
בפורמט CCYYMMDDhhmmSS המורכב משנה, חודש, תאריך, שעה, דקות ו
שניות ב-GMT. שימו לב שהפורמט הזה, כולל האורך, מובטח, אז
שניתן להשוות ישירות מחרוזות זמן דרך ה [[ מובנית < ו > מפעילים,
גם אם הם ארוכים מכדי להיות מיוצגים כמספרים שלמים.

לא כל השרתים תומכים בפקודות לאחזור מידע זה. בתוך זה
המקרה, ה מרחוק הפקודה לא תדפיס דבר ותחזיר מצב 2, לעומת
סטטוס 1 עבור קובץ שלא נמצא.

השמיים מקומי פקודה (אבל לא מרחוק) ניתן להשתמש ללא טיעונים, ובמקרה זה
המידע מגיע מבדיקת מתאר הקובץ אפס. זה אותו קובץ כמו
נראה על ידי א גם פקודה ללא הפנייה נוספת.

לקבל פילה ...
אחזר הכל פילהs מהשרת, משרשרת אותם ושולחת אותם לסטנדרט
פלט.

גם פילה ...
עבור כל פילה, קרא קובץ מקלט רגיל ושלח אותו למארח המרוחק
עם השם הפרטי.

לצרף פילה ...
As גם, אבל אם השלט פילה כבר קיים, נתונים מצורפים אליו במקום
מחליפים אותו.

getat פילה נקודה
putat פילה נקודה
תוספת פילה נקודה
גרסאות של לקבל, גם ו לצרף אשר יתחיל את ההעברה בנתון נקודה in
השלט פילה. זה שימושי לצירוף לקובץ מקומי לא שלם.
עם זאת, שים לב שיכולת זו אינה נתמכת באופן אוניברסאלי על ידי שרתים (ולא
ההתנהגות שצוינה בתקן).

להסיר פילה ...
מחק את רשימת הקבצים בשרת.

mkdir בספרייה
צור ספרייה חדשה בספרייה בשרת.

הוא rm בספרייה
מחק את הספרייה בספרייה בשרת.

שינוי השם שם ישן שם חדש
שנה את שם הקובץ שם ישן ל שם חדש בשרת.

אתר גדול מ ...
שלח פקודה ספציפית למארח לשרת. אתה כנראה תצטרך את זה רק אם
הוראה מהשרת להשתמש בו.

לצטט גדול מ ...
שלח את רצף פקודות ה-FTP הגולמי לשרת. כדאי להכיר את ה
ערכת פקודת FTP כפי שהוגדרה ב-RFC959 לפני ביצוע פעולה זו. פקודות שימושיות עשויות
לכלול STAT ו עזרה. שימו לב גם למנגנון להחזרת הודעות כמתואר
עבור המשתנה ZFTP_VERBOSE להלן, במיוחד שכל ההודעות מה-
חיבור הבקרה נשלחים לשגיאה רגילה.

close
להפסיק סגור את חיבור הנתונים הנוכחי. זה מבטל את הגדרות המעטפת ZFTP_HOST,
ZFTP_PORT, ZFTP_IP, ZFTP_SYSTEM, ZFTP_USER, ZFTP_ACCOUNT, ZFTP_PWD, ZFTP_TYPE ו
ZFTP_MODE.

מושב [ essname ]
מאפשר שימוש במספר הפעלות FTP בו-זמנית. שם הפגישה הוא an
מחרוזת תווים שרירותית; הפעלת ברירת המחדל נקראת `ברירת מחדל'. אם זה
הפקודה נקראת ללא ארגומנט, היא תפרט את כל ההפעלות הנוכחיות; עם
ארגומנט, הוא יעבור להפעלה הקיימת שנקראת essname, או
ליצור הפעלה חדשה בשם זה.

כל הפעלה זוכרת את מצב החיבור, קבוצת החיבור הספציפית
פרמטרי מעטפת (אותה קבוצה לא מוגדרת כאשר חיבור נסגר, כפי שמופיע ב
התיאור של close), וכל פרמטר משתמש שצוין עם ה- params
פקודה משנה. שינוי להפעלה קודמת משחזר את הערכים הללו; שינוי ל-a
הפעלה חדשה מאתחלת אותם באותו אופן כאילו zftp זה עתה נטען. ה
שם ההפעלה הנוכחית ניתן על ידי הפרמטר ZFTP_SESSION.

rmsession [ essname ]
מחק הפעלה; אם לא ניתן שם, ההפעלה הנוכחית נמחקת. אם ה
ההפעלה הנוכחית נמחקת, ההפעלה הקיימת המוקדמת ביותר הופכת להיות הנוכחית החדשה
הפעלה, אחרת ההפעלה הנוכחית לא תשתנה. אם הפגישה להיות
נמחק הוא היחיד, הפעלה חדשה בשם `ברירת מחדלנוצר והופך ל-
הפגישה הנוכחית; שים לב שזהו הפעלה חדשה גם אם ההפעלה נמחקת
נקרא גם `ברירת מחדל'. מומלץ לא למחוק הפעלות תוך כדי
פקודות רקע המשתמשות zftp עדיין פעילים.

פרמטרים
הפרמטרים הבאים של המעטפת נמצאים בשימוש על ידי zftp. כרגע אף אחד מהם לא מיוחד.

ZFTP_TMOUT
מספר שלם. הזמן בשניות להמתנה לסיום פעולת רשת לפני כן
מחזיר שגיאה. אם זה לא מוגדר כאשר המודול נטען, זה יינתן
ערך ברירת המחדל 60. ערך של אפס מכבה את פסקי הזמן. אם מתרחש פסק זמן ב-
חיבור הבקרה הוא ייסגר. השתמש בערך גדול יותר אם זה קורה גם
בתדירות גבוהה.

ZFTP_IP
לקריאה בלבד. כתובת ה-IP של החיבור הנוכחי בסימון נקודות.

ZFTP_HOST
לקריאה בלבד. שם המארח של השרת המרוחק הנוכחי. אם המארח נפתח כ-
מספר IP, ZFTP_HOST מכיל את זה במקום; זה חוסך את התקורה עבור שם
חיפוש, שכן מספרי IP משמשים לרוב כאשר שרת שמות אינו זמין.

ZFTP_PORT
לקריאה בלבד. המספר של יציאת ה-TCP המרוחקת שאליה החיבור פתוח (אפילו
אם היציאה צוינה במקור כשירות בעל שם). בדרך כלל זה ה
יציאת FTP רגילה, 21.

במקרה הלא סביר שלמערכת שלך אין את ההמרה המתאימה
פונקציות, זה מופיע בסדר בתים ברשת. אם המערכת שלך היא מעט אנדיאנית,
לאחר מכן, היציאה מורכבת משני בתים מוחלפים והיציאה הסטנדרטית תדווח
כמו 5376. במקרה זה, יציאות מספריות עברו אל zftp לפתוח יצטרך להיות גם בפנים
פורמט זה.

ZFTP_SYSTEM
לקריאה בלבד. מחרוזת סוג המערכת שהוחזרה על ידי השרת בתגובה ל-FTP SYST
בַּקָשָׁה. המקרה המעניין ביותר הוא תחילת מחרוזת "יוניקס סוּג: L8", אשר
מבטיח תאימות מרבית עם מארח UNIX מקומי.

ZFTP_TYPE
לקריאה בלבד. הסוג שישמש להעברת נתונים, או `A' או 'I'. להשתמש ב
סוג תת-פקודה לשנות זאת.

ZFTP_USER
לקריאה בלבד. שם המשתמש המחובר כעת, אם קיים.

ZFTP_ACCOUNT
לקריאה בלבד. שם החשבון של המשתמש הנוכחי, אם קיים. רוב השרתים לא
דורש שם חשבון.

ZFTP_PWD
לקריאה בלבד. הספרייה הנוכחית בשרת.

ZFTP_CODE
לקריאה בלבד. קוד שלוש הספרות של תשובת ה-FTP האחרונה מהשרת כמחרוזת.
זה עדיין ניתן לקרוא לאחר סגירת החיבור, ואינו משתנה כאשר
שינויים בהפעלה הנוכחית.

ZFTP_REPLY
לקריאה בלבד. השורה האחרונה של התשובה האחרונה שנשלחה על ידי השרת. זה עדיין יכול להיות
לקרוא לאחר סגירת החיבור, ואינו משתנה בעת ההפעלה הנוכחית
שינויים.

ZFTP_SESSION
לקריאה בלבד. שם הפעלת ה-FTP הנוכחית; ראה את התיאור של מושב
פקודה משנה.

ZFTP_PREFS
שורה של העדפות לשינוי היבטים של zftpההתנהגות של. כל העדפה
הוא דמות בודדת. ההגדרות הבאות מוגדרות:

P פסיבי: נסה לגרום לשרת המרוחק ליזום העברות נתונים. זֶה
הוא מעט יותר יעיל ממצב sendport. אם המכתב S מתרחש מאוחר יותר
במחרוזת, zftp ישתמש במצב sendport אם מצב פסיבי אינו זמין.

S Sendport: התחל העברות באמצעות ה-FTP נמל פקודה. אם זה קורה
לפני כל P במחרוזת, מצב פסיבי לעולם לא ינוסה.

D מטומטם: השתמש רק במינימום של פקודות FTP. זה מונע את
משתנים ZFTP_SYSTEM ו ZFTP_PWD מלהיות מוגדר, ויתכוון לכל
חיבורים כברירת מחדל לסוג ASCII. זה עשוי למנוע ZFTP_SIZE מלהיות מוגדר
במהלך העברה אם השרת לא שולח אותה בכל מקרה (שרתים רבים כן).

If ZFTP_PREFS לא מוגדר מתי zftp נטען, הוא יוגדר כברירת מחדל של `PS',
כלומר השתמש במצב פסיבי אם זמין, אחרת חזור למצב sendport.

ZFTP_VERBOSE
מחרוזת של ספרות בין 0 ל-5 כולל, המציינת אילו תגובות מה-
יש להדפיס את השרת. כל התגובות עוברות לשגיאת תקן. אם כל אחד מה
המספרים 1 עד 5 מופיעים במחרוזת, תגובות גולמיות מהשרת עם קודי תשובה
החל בספרה זו יודפס לשגיאת תקן. הספרה הראשונה של
קוד התשובה שלוש הספרות מוגדר על ידי RFC959 כך שיתאים ל:

1. תשובה מקדמית חיובית.

2. תשובת השלמה חיובית.

3. תשובת ביניים חיובית.

4. תשובת השלמה שלילית חולפת.

5. תשובת השלמה שלילית לצמיתות.

יש לציין כי מסיבות לא ידועות, התשובה `השירות אינו זמין',
אשר מאלץ סיום חיבור, מסווג כ-421, כלומר `חולף
שלילי', פרשנות מעניינת למילה 'חולף'.

הקוד 0 הוא מיוחד: הוא מציין שהכל מלבד השורה האחרונה של הרב-שורה
תשובות שנקראו מהשרת יודפסו לשגיאה סטנדרטית בעיבוד
פוּרמָט. לפי המוסכמה, שרתים משתמשים במנגנון זה לשליחת מידע עבור
משתמש לקרוא. קוד התשובה המתאים, אם הוא תואם את אותה תגובה, לוקח
עדיפות.

If ZFTP_VERBOSE לא מוגדר מתי zftp נטען, הוא יוגדר לערך ברירת המחדל
450, כלומר, הודעות המיועדות למשתמש וכל השגיאות יודפסו. אפס
המחרוזת חוקית ומציינת שאין להדפיס הודעות.

פונקציות
zftp_chpwd
אם פונקציה זו מוגדרת על ידי המשתמש, היא נקראת בכל פעם שהספרייה משתנה
בשרת, כולל כאשר משתמש מחובר, או כאשר חיבור נסגר.
במקרה האחרון, $ZFTP_PWD יבוטל; אחרת זה ישקף את החדש
במדריך.

zftp_progress
אם פונקציה זו מוגדרת על ידי המשתמש, היא תיקרא במהלך א לקבל, גם or לצרף
פעולה בכל פעם שהתקבלו מספיק נתונים מהמארח. במהלך א לקבל,
הנתונים נשלחים לפלט סטנדרטי, ולכן חיוני שהפונקציה הזו תכתוב
לשגיאה רגילה או ישירות למסוף, לֹא לתפוקה רגילה.

כאשר הוא נקרא עם העברה בתהליך, המעטפת הנוספת הבאה
פרמטרים מוגדרים:

ZFTP_FILE
שם הקובץ המרוחק שמועבר מ-או אליו.

ZFTP_TRANSFER
A G עבור לקבל מבצע וא P עבור גם פעולה.

ZFTP_SIZE
הגודל הכולל של הקובץ המלא המועבר: זהה לגודל הראשון
ערך שסופק על ידי מרחוק ו מקומי פקודות משנה עבור קובץ מסוים.
אם השרת אינו יכול לספק ערך זה עבור קובץ מרוחק שאחזור, הוא
לא יוגדר. אם הקלט הוא מצינור הערך עשוי להיות שגוי ו
מתאים פשוט למאגר צינור מלא.

ZFTP_COUNT
כמות הנתונים שהועברה עד כה; מספר בין אפס ל $ZFTP_SIZE,
אם זה מוגדר. מספר זה זמין תמיד.

הפונקציה נקראת בתחילה עם ZFTP_TRANSFER להגדיר כראוי ו
ZFTP_COUNT מוגדר לאפס. לאחר סיום ההעברה, הפונקציה תהיה
התקשר פעם נוספת עם ZFTP_TRANSFER מכוון ל GF or PF, למקרה שהוא רוצה לסדר
לְמַעלָה. אחרת הוא אף פעם לא נקרא פעמיים עם אותו ערך של ZFTP_COUNT.

לפעמים מד ההתקדמות עלול לגרום להפרעה. זה נתון למשתמש להחליט
האם יש להגדיר את הפונקציה ולהשתמש בה חוסר תפקוד כשצריך.

בעיות
אסור לפתוח חיבור בצד שמאל של צינור מכיוון שזה קורה ב
subshell ופרטי הקובץ אינם מעודכנים במעטפת הראשית. במקרה של סוג
או שינויי מצב או סגירת החיבור ב-subshell, המידע מוחזר אבל
משתנים לא מתעדכנים עד הקריאה הבאה אל zftp. שינויי סטטוס אחרים בתתי-קונכיות
לא יבוא לידי ביטוי בשינויים במשתנים (אבל צריך להיות לא מזיק אחרת).

מחיקת הפעלות בזמן א zftp הפקודה פעילה ברקע יכולה להיות בלתי צפויה
אפקטים, גם אם הוא לא משתמש בהפעלה הנמחקת. זה בגלל כל הקליפה
תהליכי משנה משתפים מידע על מצב כל החיבורים ומחיקת הפעלה
משנה את סדר המידע הזה.

במערכות הפעלה מסוימות, חיבור הבקרה אינו חוקי לאחר fork(), כך ש
פעולות בתת-קונכיות, בצד שמאל של צינור או ברקע אינן
אפשרי, כפי שהם צריכים להיות. ככל הנראה מדובר בבאג במערכת ההפעלה.

LA ZSH/ZLE מודול

השמיים zsh/zle מודול מכיל את עורך השורות Zsh. לִרְאוֹת zshzle(1).

LA ZSH/ZLEPARAMETER מודול

השמיים zsh/zleparameter מודול מגדיר שני פרמטרים מיוחדים שניתן להשתמש בהם כדי לגשת
מידע פנימי של עורך הקו Zsh (ראה zshzle(1)).

מפות מפתח
מערך זה מכיל את שמות מפות המפתח המוגדרות כעת.

יישומונים
מערך אסוציאטיבי זה מכיל ערך אחד לכל ווידג'ט שהוגדר. השם של
widget הוא המפתח והערך נותן מידע על הווידג'ט. זה גם כן
המחרוזת `בנוי' עבור ווידג'טים מובנים, מחרוזת של הטופס `מִשׁתַמֵשׁ:שם' ל
יישומונים המוגדרים על ידי המשתמש, היכן שם הוא השם של פונקציית המעטפת המיישמת את
widget, או שזו מחרוזת של הטופס `סִיוּם:סוג:שם', להשלמה
ווידג'טים. במקרה האחרון סוג הוא השם של הווידג'טים המובנים ההשלמה
יישומון מחקה בהתנהגותו ו שם הוא השם של פונקציית המעטפת
יישום יישומון ההשלמה.

LA ZSH/ZPROF מודול

כאשר הוא טעון, ה zsh/zprof גורם ליצירת פרופיל של פונקציות מעטפת. תוצאות הפרופיל
ניתן להשיג עם zprof פקודה מובנית שזמינה על ידי מודול זה. אין
דרך לכבות את הפרופיל מלבד פריקת המודול.

zprof [ -c ]
בלי ה -c אוֹפְּצִיָה, zprof מפרט את תוצאות הפרופילים לפלט סטנדרטי. ה
הפורמט דומה לזה של פקודות כמו gprof.

בחלק העליון יש סיכום המפרט את כל הפונקציות שנקראו לפחות פעם אחת.
סיכום זה ממוין בסדר יורד של כמות הזמן המושקעת בכל אחד.
השורות מכילות את מספר הפונקציה לפי הסדר, המשמשת בחלקים אחרים
של הרשימה בסיומות של הטופס `[NUM]', ואז מספר השיחות שבוצעו אל
פוּנקצִיָה. שלוש העמודות הבאות מציגות את הזמן במילי-שניות שהושקע ב-
פונקציה וצאצאיה, הזמן הממוצע באלפיות שניות שהושקע ב-
פונקציה וצאצאיה לכל שיחה ואחוז הזמן המושקע בכל המעטפת
פונקציות המשמשות בפונקציה זו וצאצאיה. שלושת העמודות הבאות
נותנים את אותו המידע, אך סופרים רק את הזמן המושקע בפונקציה עצמה.
העמודה האחרונה מציגה את שם הפונקציה.

לאחר הסיכום, מידע מפורט על כל פונקציה שהופעלה הוא
רשום, ממוין בסדר יורד של כמות הזמן המושקעת בכל פונקציה ו
צאצאיו. כל אחד מהערכים הללו מורכב מתיאורים עבור הפונקציות
זה קרא לפונקציה המתוארת, לפונקציה עצמה ולפונקציות ש
נקראו ממנו. לתיאור הפונקציה עצמה יש אותו פורמט
כמו בסיכום (ומראה את אותו מידע). השורות האחרות אינן מציגות את
מספר הפונקציה בהתחלה והפונקציה שלה נקראת בהזחה
להקל על ההבחנה בין הקו המציג את הפונקציה המתוארת ב
קטע מהקווים שמסביב.

המידע המוצג במקרה זה כמעט כמו בסיכום, אבל רק
מתייחס להיררכיית השיחות המוצגת. לדוגמה, עבור פונקציה מתקשרת
העמודה המציגה את זמן הריצה הכולל מפרטת את הזמן שהושקע בתיאור המתואר
פונקציה וצאצאיה רק ​​לזמנים שבהם נקרא מזה
פונקציית קריאה מסוימת. באופן דומה, עבור פונקציה שנקראה, עמודות זו מפרטות
הזמן הכולל שהושקע בפונקציה הנקראת וצאצאיה רק ​​עבור הזמנים
כאשר הוא נקרא מהפונקציה המתוארת.

גם במקרה זה, גם העמודה המציגה את מספר הקריאות לפונקציה מופיעה
לוכסן ולאחר מכן המספר הכולל של הפעלות לפונקציה שנקראה.

כל עוד zsh/zprof מודול נטען, יצירת פרופילים יתבצע ומרובה
קריאות של zprof הפקודה המובנית תציג את הזמנים והמספרים של השיחות
מאז שהמודול נטען. עם ה -c אפשרות, zprof פקודה מובנית
אפס את המונים הפנימיים שלו ולא יציג את הרישום.

LA ZSH/ZPTY מודול

השמיים zsh/zpty מודול מציע אחד מובנה:

zpty [ -e ] [ -b ] שם [ גדול מ ... ]
הטיעונים הבאים שם משורשרים עם רווחים ביניהם, ואז מבוצעים כ
פקודה, כאילו הועברה ל- הערכה מובנה. הפקודה פועלת תחת קובץ חדש
מוקצה פסאודו-טרמינל; זה שימושי להפעלת פקודות באופן לא אינטראקטיבי
אשר מצפים לסביבה אינטראקטיבית. ה שם אינו חלק מהפקודה, אבל
משמש להתייחסות לפקודה זו בקריאות מאוחרות יותר אל zpty.

עם -e אפשרות, הפסאודו-טרמינל מוגדר כך שתווי הקלט יהיו
הדהד.

עם -b אפשרות, קלט ופלט מהפסאודו-טרמינל נעשים
לא חוסם.

פרמטר המעטפת תשובה מוגדר לתיאור הקובץ שהוקצה לצד המאסטר
של הפסאודו-טרמינל. זה מאפשר לנטר את הטרמינל עם ZLE
מטפלים בתיאורים (ראה zshzle(1)) או עם מניפולציות sysread ו syswrite (ראה
מודול ה-ZSH/מערכת ב zshmodules(1)). אזהרה: שימוש ב sysread ו syswrite is
לֹא מומלץ, השתמש zpty -r ו zpty -w אלא אם כן אתה יודע בדיוק מה אתה
מַעֲשֶׂה.

zpty -d [ שם ... ]
הצורה השנייה, עם ה -d אפשרות, משמשת למחיקת פקודות שהוחלו בעבר,
על ידי אספקת רשימה שלהם שםס. אם לא שם נתון, כל הפקודות נמחקות.
מחיקת פקודה גורמת לאות HUP להישלח לתהליך המתאים.

zpty -w [ -n ] שם [ מחרוזת ... ]
השמיים -w ניתן להשתמש באפשרות כדי לשלוח את הפקודה to שם הנתון מחרוזתs כקלט
(מופרדים ברווחים). אם ה -n האפשרות היא לֹא נתון, נוספה שורה חדשה ב-
הסוף.

אם לא מחרוזת מסופק, הקלט הסטנדרטי מועתק לפסאודו-טרמינל; זֶה
עשוי להפסיק לפני העתקת הקלט המלא אם הפסאודו-טרמינל אינו חוסם.

שימו לב שהפקודה מתחת לפסאודו-טרמינל רואה את הקלט הזה כאילו היה
הקלדת, אז היזהר בעת שליחת תווי מנהל התקן tty מיוחדים כגון מחיקת מילה,
line-kill, ו-end-of-file.

zpty -r [ -מט ] שם [ להפסיק [ דפוס ]]
השמיים -r ניתן להשתמש באפשרות כדי לקרוא את הפלט של הפקודה שם. רק עם א שם
ארגומנט, הפלט הנקרא מועתק לפלט הסטנדרטי. אלא אם כן ה
פסאודו-טרמינל אינו חוסם, ההעתקה נמשכת עד לפקודה תחת
יציאות פסאודו-טרמינליות; כאשר לא חוסם, רק כמה פלט שיש מיד
זמין מועתק. מצב ההחזרה הוא אפס אם פלט כלשהו מועתק.

כאשר ניתן גם א להפסיק ארגומנט, לכל היותר שורה אחת נקראת ומאוחסנת ב-
פרמטר בשם להפסיק. ניתן לקרוא פחות משורה מלאה אם ​​הפסאודו-טרמינל כן
לא חוסם. מצב ההחזרה הוא אפס אם לפחות תו אחד מאוחסן ב
להפסיק.

אם דפוס נתון גם כן, הפלט נקרא עד שכל המחרוזת תואמת
מה היא דפוס, גם במקרה שאינו חוסם. מצב ההחזרה הוא אפס אם
string read תואם את התבנית, או אם הפקודה יצאה אך לפחות אחת
עדיין ניתן היה לקרוא את הדמות. אם האפשרות -m קיים, מצב ההחזרה הוא
אפס רק אם התבנית תואמת. נכון לכתיבת שורות אלה, מקסימום מגה בייט אחד של
ניתן לצרוך פלט בדרך זו; אם מגה-בייט מלא נקרא ללא התאמה ל-
דפוס, מצב ההחזרה אינו אפס.

בכל המקרים, מצב ההחזרה אינו אפס אם לא ניתן היה לקרוא דבר, והוא אכן כך 2 if
זה בגלל שהפקודה הסתיימה.

אם -r אפשרות משולבת עם -t אוֹפְּצִיָה, zpty בודק אם הפלט הוא
זמין לפני שמנסים לקרוא. אם אין פלט זמין, zpty מיד
מחזיר את הסטטוס 1. בשימוש עם א דפוס, ההתנהגות בסקר כושל היא
בדומה לזמן שבו הפקודה יצאה: ערך ההחזרה הוא אפס אם לפחות אחד
עדיין ניתן היה לקרוא את התו גם אם הדפוס לא הצליח להתאים.

zpty -t שם
השמיים -t אפשרות ללא ה -r ניתן להשתמש באפשרות כדי לבדוק אם הפקודה שם is
עדיין פועל. הוא מחזיר מצב אפס אם הפקודה פועלת ולא אפס
ערך אחרת.

zpty [ -L ]
הטופס האחרון, ללא ארגומנטים, משמש לרשימת הפקודות כרגע
מוּגדָר. אם ה -L ניתנת אפשרות, זה נעשה בצורה של שיחות אל zpty
מובנה.

LA ZSH/ZSELECT מודול

השמיים zsh/zselect מודול זמין פקודה מובנית אחת:

zselect [ -rwe ] [ -t פסק זמן ] [ -a מערך ] [ -A Assoc ] [ fd ... ]
השמיים zselect ה-buildin הוא חזית לקריאת המערכת 'בחר', אשר חוסמת עד
מתאר קובץ מוכן לקריאה או כתיבה, או שיש לו מצב שגיאה, עם
פסק זמן אופציונלי. אם זה לא זמין במערכת שלך, הפקודה תודפס
הודעת שגיאה ומחזירה סטטוס 2 (שגיאות רגילות מחזירות סטטוס 1). לעוד
מידע, עיין בתיעוד המערכות שלך עבור בחר(3). שימו לב שאין
חיבור עם המעטפת המובנית באותו שם.

טיעונים ואפשרויות עשויים להיות מעורבים בכל סדר. טיעונים שאינם אופציונליים הם
מתארי קבצים, שחייבים להיות מספרים שלמים עשרוניים. כברירת מחדל, מתארי קבצים הם
להיבדק לקריאה, כלומר. zselect יחזור כאשר הנתונים יהיו זמינים
לקרוא מתוך מתאר הקובץ, או ליתר דיוק, כאשר פעולת קריאה מה-
מתאר הקובץ לא יחסום. אחרי -r, -w ו -e, מתארי הקובץ הנתונים
יש לבדוק עבור תנאי קריאה, כתיבה או שגיאה. אפשרויות אלה ו-
רשימה שרירותית של מתארי קבצים יכולה להינתן בכל סדר.

(הנוכחות של 'מצב שגיאה' אינה מוגדרת היטב בתיעוד עבור
יישומים רבים של קריאת המערכת הנבחרת. על פי הגרסאות האחרונות של
מפרט POSIX, זה באמת יוצא מן הכלל מצב, שבו היחיד
דוגמה סטנדרטית היא נתונים מחוץ לפס המתקבלים על שקע. אז משתמשי zsh הם
לא סביר למצוא את -e אפשרות שימושית.)

האפשרות `-t פסק זמן' מציין פסק זמן במאות השנייה. זה יכול להיות
אפס, ובמקרה זה מתארי הקבצים פשוט ישולבו ו zselect יצטרך
לחזור מיד. אפשר לקרוא ל-zselect ללא מתארי קבצים ו-a
פסק זמן שאינו אפס לשימוש כתחליף דק יותר עבור `שינה'; שים לב, עם זאת,
מצב ההחזרה הוא תמיד 1 עבור פסק זמן.

האפשרות `-a מערך' מעיד על כך מערך צריך להיות מוגדר כדי לציין את הקובץ
מתאר(ים) מוכנים. אם האפשרות לא ניתנת, המערך תשובה יהיה
משמש למטרה זו. המערך יכיל מחרוזת הדומה לארגומנטים
ל zselect. לדוגמה,

zselect -t 0 -r 0 -w 1

עשוי לחזור מיד עם סטטוס 0 ו $תגובה המכיל `-r 0 -w 1' להציג
ששני מתארי הקבצים מוכנים לפעולות המבוקשות.

האפשרות `-A Assoc' מציין שהמערך האסוציאטיבי Assoc צריך להיות מוגדר
ציין את מתארי הקבצים המוכנים. אפשרות זו עוקפת את האפשרות
-a, וגם לא ירצה תשובה להיות שונה. המפתחות של Assoc הם מתארי הקבצים, ו
הערכים המתאימים הם כל אחד מהתווים `Rweכדי לציין את התנאי.

הפקודה מחזירה סטטוס 0 אם מתארי קבצים מסוימים מוכנים לקריאה. אם
תם הזמן הקצוב לפעולה, או שניתן פסק זמן של 0 ולא היו מתארי קבצים
מוכן, או שהייתה שגיאה, הוא מחזיר מצב 1 והמערך לא יוגדר
(ולא שונה בשום צורה). אם הייתה שגיאה בפעולת הבחירה
הודעת שגיאה מתאימה מודפסת.

LA ZSH/ZUTIL מודול

השמיים זש/זוטיל מודול מוסיף רק כמה מבנים:

zstyle [ -L [ דפוס [ סגנון ] ] ]
zstyle [ -e | - | -- ] דפוס סגנון מחרוזת ...
zstyle -d [ דפוס [ סגנון ... ] ]
zstyle -g שם [ דפוס [ סגנון ]]
zstyle -{a|b|s} הקשר סגנון שם [ ספטמבר ]
zstyle -{T|t} הקשר סגנון [ מחרוזת ... ]
zstyle -m הקשר סגנון דפוס
פקודה מובנית זו משמשת להגדרה ולחיפוש סגנונות. סגנונות הם זוגות של
שמות וערכים, כאשר הערכים מורכבים ממספר כלשהו של מחרוזות. הם
מאוחסן יחד עם דפוסים וחיפוש נעשה על ידי מתן מחרוזת, הנקראת
'הקשר', אשר מושווה לדפוסים. ההגדרה שנשמרה עבור הראשון
תבנית תואמת תוחזר.

לסדר השוואות, תבניות נבדקות מהספציפי ביותר למינימום
ספציפיים, ודפוסים ספציפיים באותה מידה שומרים על הסדר שבו היו
מוּגדָר. דפוס נחשב ספציפי יותר מאחר אם הוא מכיל
רכיבים נוספים (מחרוזות משנה מופרדות על ידי נקודתיים) או אם הדפוסים עבור
רכיבים ספציפיים יותר, כאשר מחרוזות פשוטות נחשבות ליותר
ספציפיים מדפוסים ודפוסים מורכבים נחשבים ספציפיים יותר מ
התבנית `*'.

הצורה הראשונה (ללא טיעונים) מפרטת את ההגדרות. סגנונות מוצגים ב
סדר אלפביתי ותבניות מוצגים לפי הסדר zstyle יבדוק אותם.

אם -L ניתנת אפשרות, הרישום נעשה בצורה של שיחות אל zstyle. ה
ארגומנט ראשון אופציונלי הוא דפוס שיותאם למחרוזת
מסופק כתבנית להקשר; שים לב שזה אומר, למשל, `zstyle
-L ":סִיוּם:*"' יתאים לכל דפוס שסופק מתחיל ':סִיוּם:', לא
רק ":סִיוּם:*": להשתמש ":סִיוּם:\*" להתאים לזה. השנייה האופציונלית
ארגומנט מגביל את הפלט לספציפי סגנון (לא דפוס). -L לא
תואם לכל אופציה אחרת.

שאר הטפסים הם אלה:

zstyle [ - | -- | -e ] דפוס סגנון מחרוזת ...
מגדיר את הנתון סגנון עבור דפוס עם מחרוזתs כערך. אם
מה היא -e ניתנת אפשרות, ה מחרוזתs יהיו משורשרים (מופרדים על ידי
רווחים) והמחרוזת המתקבלת תוערך (באותו אופן כפי שהיא
נעשה על ידי הערכה פקודה מובנית) כאשר הסגנון נבדק למעלה. במקרה הזה
הפרמטר `תשובהיש להקצות ' כדי להגדיר את המחרוזות המוחזרות לאחר ה
הַעֲרָכָה. לפני הערכת הערך, תשובה אינו מוגדר, ואם הוא עדיין
לא מוגדר לאחר ההערכה, הסגנון יטופל כאילו לא נקבע.

zstyle -d [ דפוס [ סגנון ... ] ]
מחק הגדרות סגנון. ללא טיעונים כל ההגדרות נמחקות,
עם דפוס כל ההגדרות של הדפוס הזה נמחקות ואם בכלל
סגנוןs ניתנים, אז רק הסגנונות האלה נמחקים עבור דפוס.

zstyle -g שם [ דפוס [ סגנון ]]
אחזר הגדרת סגנון. ה שם משמש כשם של מערך ב
אשר התוצאות נשמרות. בלי ויכוחים נוספים, כל הדפוסים
מוגדרים מוחזרים. עם דפוס הסגנונות שהוגדרו עבור דפוס זה הם
חזר ועם שניהם א דפוס וכן סגנון, מחרוזות הערך של זה
השילוב מוחזר.

ניתן להשתמש בטפסים האחרים כדי לחפש או לבדוק דפוסים.

zstyle -s הקשר סגנון שם [ ספטמבר ]
הפרמטר שם מוגדר לערך של הסגנון המתפרש כמחרוזת.
אם הערך מכיל מספר מחרוזות הם משורשרים עם רווחים (או
עם ספטמבר מחרוזת אם זה נתון) ביניהם.

zstyle -b הקשר סגנון שם
הערך מאוחסן ב שם בתור בוליאני, כלומר כמחרוזת `כן' אם ה
לערך יש רק מחרוזת אחת והמחרוזת הזו שווה לאחד של `כן', `נָכוֹן',
`on', או '1'. אם הערך הוא כל מחרוזת אחרת או שיש לו יותר ממחרוזת אחת,
הפרמטר מוגדר ל- `לא'.

zstyle -a הקשר סגנון שם
הערך מאוחסן ב שם כמערך. אם שם מוכרז כ-
מערך אסוציאטיבי, המחרוזות הראשונה, השלישית וכו' משמשות כמקשים ו
המחרוזות האחרות משמשות כערכים.

zstyle -t הקשר סגנון [ מחרוזת ... ]
zstyle -T הקשר סגנון [ מחרוזת ... ]
בדוק את הערך של סגנון, כלומר -t אפשרות מחזירה רק סטטוס (סט
$?). ללא מחרוזת מצב ההחזרה הוא אפס אם הסגנון מוגדר
עבור תבנית תואמת אחת לפחות, יש רק מחרוזת אחת בערך שלה, ו
זה שווה לאחד מ`נָכוֹן', `כן', `on' או '1'. אם בכלל מחרוזתs ניתנים
המצב הוא אפס אם ורק אם לפחות אחד מה- מחרוזתs שווה ל-at
לפחות אחת מהמחרוזות בערך. אם הסגנון מוגדר אבל לא
התאמה, סטטוס ההחזרה הוא 1. אם הסגנון לא מוגדר, המצב הוא 2.

השמיים -T option בודק את ערכי הסגנון כמו -t, אבל זה מחזיר סטטוס
אפס (ולא 2) אם הסגנון אינו מוגדר עבור תבנית תואמת כלשהי.

zstyle -m הקשר סגנון דפוס
התאם ערך. מחזיר מצב אפס אם דפוס תואם לפחות אחד מהם
המחרוזות בערך.

zformat -f להפסיק פוּרמָט מפרט ...
zformat -a מערך ספטמבר מפרט ...
מובנה זה מספק שתי צורות שונות של עיצוב. הטופס הראשון נבחר
עם -f אוֹפְּצִיָה. במקרה זה ה פוּרמָט מחרוזת תשתנה על ידי החלפה
רצפים שמתחילים בסימן אחוז בתוכו עם מחרוזות מה- מפרטש. כל אחד
מפרט צריך להיות בצורת `char:מחרוזתמה שיגרום לכל הופעה של ה
רצף `%charפנימה פוּרמָט להיות מוחלף על ידי מחרוזת. ה`%' רצף עשוי גם
מכילים מפרטי רוחב שדה מינימליים ומקסימליים אופציונליים בין ה- `%'ו
את `char'בטופס'%דקות.מקסימוםc', כלומר רוחב השדה המינימלי ניתן תחילה ו
אם נעשה שימוש ברוחב השדה המרבי, יש להקדים אותו בנקודה. ציון א
רוחב שדה מינימלי גורם לתוצאה להיות מרופדת ברווחים מימין אם
מחרוזת קצר מהרוחב המבוקש. ריפוד לשמאל ניתן להשיג על ידי
נותן רוחב שדה מינימלי שלילי. אם צוין רוחב שדה מרבי, ה-
מחרוזת יחתכו אחרי כל כך הרבה תווים. אחרי הכל `%' רצפים עבור
הנתון מפרטלאחר עיבוד, המחרוזת המתקבלת מאוחסנת ב-
פרמטר להפסיק.

השמיים %-escapes גם מבינים ביטויים משולשים בצורה המשמשת את ההנחיות. ה
% אחריו מופיע `(' ולאחר מכן תו מפרט פורמט רגיל כמתואר
מֵעַל. עשויה להיות קבוצה של ספרות לפני או אחרי ה'('; אלה מציינים
מספר בדיקה, שברירת המחדל הוא אפס. מותרים גם מספרים שליליים. א
תו מפריד שרירותי עוקב אחר מפרט הפורמט, ואחריו א
חתיכת טקסט 'אמיתי', שוב תו המפריד, חתיכת טקסט 'שקר', ו
סוגריים סוגרים. כך נראה הביטוי השלם (ללא הספרות).
`%(X.טקסט.טקסט)', אלא שה-'.הדמות היא שרירותית. הערך שניתן
עבור מפרט הפורמט ב- char:מחרוזת ביטויים מוערכים כ-a
ביטוי מתמטי, והשוו למספר המבחן. אם הם זהים,
טקסט הוא פלט, אחר טקסט הוא פלט. ניתן לברוח פנימה סוגריים טקסט as
%). אחד מ טקסט or טקסט עשוי להכיל מקונן %-בורחת.

לדוגמה:

zformat -f תשובה " לענות is '%3(c.yes.no)'." ג:3

פלט "התשובה היא 'כן'." ל תשובה מאז הערך עבור מפרט הפורמט c
הוא 3, מסכים עם ארגומנט הספרה לביטוי השלישוני.

הצורה השנייה, באמצעות ה -a אפשרות, ניתן להשתמש ליישור מחרוזות. הנה ה
מפרטs הם מהצורה `עזבו:תקין'איפה'עזבו'ו'תקין' הן מחרוזות שרירותיות.
מחרוזות אלו משתנות על ידי החלפת המעיים ב- ספטמבר חוט וריפוד
מה היא עזבו מחרוזות עם רווחים מימין כך שה ספטמבר מחרוזות בתוצאה
(ומכאן ה תקין מחרוזות שאחריהם) מיושרות כולן אם המחרוזות מודפסות
מתחת אחד לשני. כל המחרוזות ללא נקודתיים נשארות ללא שינוי וכל המיתרים
עם ריק תקין המחרוזת להסיר את המעי הגס הנגרר. בשני המקרים ה
אורכי המיתרים אינם משמשים כדי לקבוע כיצד יהיו המיתרים האחרים
מיושר. המחרוזות המתקבלות מאוחסנות ב- מערך.

zregexparse
זה מיישם כמה פנימיות של טיעונים _regex פונקציה.

zparseopts [ -DKME ] [ -a מערך ] [ -A Assoc ] מפרט ...
מובנה זה מפשט את הניתוח של אפשרויות בפרמטרים מיקוםיים, כלומר
סט טיעונים שניתנו על ידי $*. כל מפרט מתאר אפשרות אחת וחייב להיות מה-
טופס `לִבחוֹר[=מערך]'. אם אפשרות המתוארת על ידי לִבחוֹר נמצא בעמדה
פרמטרים זה מועתק לתוך מערך שצוין עם ה -a אוֹפְּצִיָה; אם ה
אופציונלי `=מערך' נתון, במקום זאת הוא מועתק למערך הזה.

שים לב שזו שגיאה לתת כל מפרט ללא `=מערךאלא אם כן אחד מה -a
or -A נעשה שימוש באפשרויות.

אלא אם כן ה -E האפשרות ניתנת, הניתוח נעצר במחרוזת הראשונה שאינה
מתואר על ידי אחד מה מפרטס. אפילו עם -E, הניתוח תמיד נעצר במיקום
פרמטר שווה ל-`-' או '--'.

השמיים לִבחוֹר התיאור חייב להיות אחד מהבאים. כל אחת מהדמויות המיוחדות
יכול להופיע בשם האפשרות בתנאי שקודם לו קו נטוי אחורי.

שם
שם+ השמיים שם הוא שם האופציה ללא ה-' המוביל-'. כדי לציין א
אפשרות ארוכה בסגנון GNU, אחת משתי הרגילות המובילות `-' חייב להיכלל ב
שם; לדוגמה, a `--קוֹבֶץהאפשרות מיוצגת על ידי א שם של `-file'.

אם `+' מופיע אחרי שם, האפשרות מצורפת ל מערך בכל פעם שכן
נמצא בפרמטרים המיקוםיים; בלי ה`+' רק ה אחרון הִתרַחֲשׁוּת
של האופציה נשמר.

אם נעשה שימוש באחת מהצורות הללו, האפשרות לא לוקחת ארגומנט, אז ניתוח
מפסיק אם הפרמטר המיקום הבא לא מתחיל גם ב-`-' (אלא אם כן
מה היא -E נעשה שימוש באופציה).

שם:
שם:-
שם:: אם ניתנים נקודתיים אחד או שניים, האפשרות לוקחת ארגומנט; עם אחד
נקודתיים, הארגומנט הוא חובה ועם שני נקודתיים הוא אופציונלי. ה
הטיעון מצורף ל- מערך אחרי האופציה עצמה.

ארגומנט אופציונלי מוכנס לאותו אלמנט מערך כמו שם האופציה
(שים לב שזה הופך מחרוזות ריקות כטיעונים לבלתי ניתנות להבחנה). א
ארגומנט חובה נוסף כרכיב נפרד אלא אם כן ה- `:-'צורה היא
בשימוש, ובמקרה זה הטיעון מוכנס לאותו אלמנט.

א `+' כפי שתואר לעיל עשוי להופיע בין ה שם והמעי הגס הראשון.

האפשרויות של zparseopts עצמם הם:

-a מערך
כפי שתואר לעיל, זה נותן שם למערך ברירת המחדל שבו לאחסן את
אפשרויות מוכרות.

-A Assoc
אם זה ניתן, האפשרויות והערכים שלהן מוכנסים גם ל-an
מערך אסוציאטיבי עם שמות האפשרויות כמפתחות והארגומנטים (אם יש)
בתור הערכים.

-D אם אפשרות זו ניתנת, כל האפשרויות שנמצאו יוסרו מהמיקום
פרמטרים של פונקציית המעטפת הקוראת או המעטפת, עד אך לא כולל
כל שלא מתואר על ידי מפרטס. זה דומה לשימוש ב- משמרת מובנה.

-K עם אפשרות זו, המערכים שצוינו עם ה- -a אפשרות ועם
`=מערך' טפסים נשמרים ללא שינוי כאשר אף אחד מה מפרטs עבורם משמש.
אחרת המערך כולו מוחלף כאשר כל אחד מה- מפרטs משמש.
אלמנטים בודדים של מערכים אסוציאטיביים שצוינו עם -A אפשרות הם
נשמר על ידי -K. זה מאפשר הקצאת ערכי ברירת מחדל למערכים לפני
קוראים zparseopts.

-M זה משנה את כללי ההקצאה כדי ליישם מפה בין אפשרויות מקבילות
שמות. אם בכלל מפרט משתמש ב-`=מערךטופס, המחרוזת מערך מתפרש
כשמו של אחר מפרט, המשמש לבחירת היכן לאחסן את
ערכים. אם אין אחר מפרט נמצא, הערכים מאוחסנים כרגיל. זֶה
משנה רק את האופן שבו הערכים נשמרים, לא את הדרך $* מנותח, אז
התוצאות עשויות להיות בלתי צפויות אם ה-`שם+נעשה שימוש במפרט '
באופן לא עקבי.

-E זה משנה את כללי הניתוח ל לֹא עצור במחרוזת הראשונה שאינה
מתואר על ידי אחד מה מפרטס. זה יכול לשמש כדי לבדוק עבור או (אם נעשה שימוש
יחד עם -D) לחלץ אפשרויות והטיעונים שלהן, תוך התעלמות מכל השאר
אפשרויות וארגומנטים שעשויים להיות בפרמטרים המיקוםיים.

לדוגמה,

סט -- -a -בקס -c y -צ באז -סנד
zparseopts a=foo b:=בר c+:=bar

תהיה השפעה של

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

הטיעונים מ`באז' on לא ישמש.

כדוגמה ל -E אפשרות, שקול:

סט -- -a x -b y -c z arg1 arg2
zparseopts -E -D b:=בר

תהיה השפעה של

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

כלומר, האפשרות -b והטיעונים שלו לקוחים מהפרמטרים המיקוםיים ו
להכניס למערך בָּר.

השמיים -M ניתן להשתמש באפשרות כך:

סט -- -a -בקס -c y -צ באז -סנד
zparseopts -A בָּר -M a=foo b+: c:=ב

להשפיע על

foo=(-a)
bar=(-a '' -b xyz)

השתמש ב-zshmodules באופן מקוון באמצעות שירותי onworks.net