אפשרויות CLI

pperl מקבל קבוצה קטנה של דגלי שורת פקודה. רובם תואמי perl; מקצתם ייחודיים ל־pperl (JIT, הקבלה, בחירת סביבת ריצה, מטמון bytecode). הרשימה הקובעת היא מה ש־pperl --help מדפיס; הטבלאות שלהלן מציגות את הדגלים האלה, החולצו ממקור המפרש ומוצגים כאן בכל בנייה של התיעוד.

הערה

The actual pperl --help output on the terminal is always in English - the binary does not localise help strings. Translated documentation shows the same flags with descriptions in the page’s language so readers can study what each flag does; flag tokens (-T, --threads=N, …) are always verbatim.

PetaPerl - סביבת ריצה של Perl 5 מהדור הבא

שימוש

pperl [OPTIONS] [--] [SCRIPT [ARGS...]]
pperl -e 'code'

אפשרויות תואמות Perl

דגל	תיאור
-e 'code'	מבצע one-liner (תכונות מודרניות מופעלות תמיד)
-Idirectory	מוסיף תיקייה לתחילת @INC
-c	בדיקת תחביר בלבד, לא מריץ
-w	הפעלת אזהרות
-n	Loop over input lines (no auto-print), like while(<>)
-p	Loop over input lines and auto-print, like a sed filter
-a	Autosplit each line into @F (with -n or -p)
-F pattern	Set the -a split pattern (implies -a)
-l[octal]	Auto-chomp input, set output record separator
-0[octal]	Set input record separator (-0 = NUL, -00 = paragraph)
-i[ext]	Edit files in place (optional backup extension)
-T	Taint mode (forced)
-t	Taint warnings
-v	הצגת מידע על הגרסה
-V	הצגת תצורה מפורטת
--interactive	Launch interactive REPL (requires »shell« feature)
-h, -?, --help	הצגת הודעת עזרה זו

אפשרויות ייחודיות ל־pperl

דגל	תיאור
--from-json, -j	קריאת op tree מ־stdin (פורמט JSON של B::PetaPerl)
--optree, -o	קריאת op tree מ־stdin (פורמט B::Concise)
--stats, -s	הצגת סטטיסטיקת ביצועים (זמן, זיכרון, ops)
--trace	הפעלת מעקב ביצוע (לתשומת לב: ‎-t‎ הקצר הוא taint-warn של perl5)
--timeout=SECS	קביעת timeout לביצוע בשניות (ברירת מחדל: ללא)
--dump-optree	הדפסת op tree קנונית (לא מריץ)
--compare-bytecode	השוואת op trees: backend של perl5 מול המנתח המקורי
--cache	הפעלת מטמון bytecode (~/.pperl/cache/)
--flush	ניקוי כל מטמוני ה־bytecode ויציאה

אפשרויות סביבת ריצה

דגל	תיאור
--no-jit	השבתת קומפילציית JIT (פעיל כברירת מחדל)
--no-parallel	השבתת הקבלה אוטומטית (פעיל כברירת מחדל)
--threads=N	מספר ה־threads (ברירת מחדל: כל ה־CPU)
--parallel-threshold=N	מינימום איטרציות להקבלה (ברירת מחדל: 100)
--jit-stats	Print JIT summary to stderr at exit (see also PPERL_JIT_LOG)

דוגמאות

pperl script.pl

הרצת סקריפט Perl

pperl -e 'say "Hello!"'

הרצת one-liner (say, state וכו« זמינים תמיד)

pperl -c script.pl

בדיקת תחביר הסקריפט ללא הרצה

pperl script.pl arg1 arg2

העברת ארגומנטים לסקריפט (@ARGV)

למידע נוסף, ראו: https://gl.petatech.eu/petatech/peta-perl

משתני סביבה

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

משתנה	משמעות
PPERL	מחרוזת גרסה (זהה ל־pperl -v)
PPERL_FEATURES	רשימת תכונות Cargo משולבות, מופרדות בפסיקים
PPERL_MODS	זוגות Name/version מופרדים בפסיקים, לכל מודול מקורי
PPERL_SHELL	טעם של אינטגרציית shell (ריק אם תכונת shell כבויה)
PPERL_STATIC	yes אם הקובץ הבינארי קושר באופן סטטי עם musl, אחרת no

יש להריץ pperl -V כדי לראות את כל הערכים עבור הקובץ הבינארי הנוכחי.