This is a translation of the original English documentation page. Help us make it better.

1 פורמט מפתח פריט

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

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

שם מפתח

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

 0-9a-zA-Z_-.

אשר אומר:

  • כל המספרים;
  • כל האותיות הקטנות;
  • כל האותיות הגדולות;
  • מדגיש;
  • לזנק;
  • נקודה.

פרמטרים מרכזיים

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

כל פרמטר מפתח יכול להיות מחרוזת במירכאות, מחרוזת ללא מרכאות או מערך.

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

פרמטר - מחרוזת במירכאות

אם פרמטר המפתח הוא מחרוזת במירכאות, כל תו Unicode הוא מוּתָר.

אם מחרוזת פרמטר המפתח מכילה פסיק, פרמטר זה חייב להיות מְצוּטָט.

אם מחרוזת פרמטר המפתח מכילה מרכאות, לפרמטר זה יש למירכאות וכל מרכאה שהיא חלק מהפרמטר המחרוזת חייבת להיות בורחת עם תו backsplash (\).

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

פרמטר - מחרוזת ללא מרכאות

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

פרמטר - מערך

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

::: שימו לב חשוב מערכי פרמטרים מרובי רמות, למשל. [a,[b,[c,d]],e], אינם מותרים. :::