החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי Cloud Translation API.

RunUtil

public class RunUtil
extends Object implements IRunUtil

java.lang.Object
↳	com.android.tradefed.util.RunUtil

אוסף של שיטות עזר לביצוע פעולות.

סיכום

שדות
`public static final String`	`INHERITIO_PREFIX`
`public static final String`	`RUNNABLE_NOTIFIER_NAME`

יוצרים ציבוריים
`RunUtil()` יוצרים אובייקט `RunUtil` חדש לשימוש.
`RunUtil(boolean inheritEnvVars)`

שיטות ציבוריות
`void`	`allowInterrupt(boolean allow)` מאפשרת או אוסרת הפסקות ריצה בשרשור הנוכחי.
`ProcessBuilder`	`createProcessBuilder(Redirect redirect, commandList, boolean enableCache)`
`static IRunUtil`	`getDefault()` אחזור הפניה לאובייקט `RunUtil` שמוגדר כברירת מחדל.
`void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` הפונקציה מפסיקה את פעולות הריצה המתמשכות או העתידיות בשרשור הנתון.
`void`	`interrupt(Thread thread, String message)` הפונקציה מפסיקה את פעולות הריצה המתמשכות או העתידיות בשרשור הנתון.
`boolean`	`isInterruptAllowed()` הצגת סטטוס ההפרעה של RunUtil.
`Process`	`runCmdInBackground(Redirect redirect, command)` שיטה חלופית של `runCmdInBackground(String)` שמקבלת את ארגומנטים הפקודה בפורמט `ERROR(/List)`.
`Process`	`runCmdInBackground( command)` שיטה חלופית של `runCmdInBackground(String)` שמקבלת את ארגומנטים הפקודה בפורמט `ERROR(/List)`.
`Process`	`runCmdInBackground( command, OutputStream output)` הפעלת פקודה עם הדגל `ERROR(/OutputStream)` מתעדת את הפלט של הפקודה.
`Process`	`runCmdInBackground(String... command)` שיטה לעזרה לביצוע פקודה מערכתית באופן אסינכרוני.
`Process`	`runCmdInBackground(Redirect redirect, String... command)` שיטה לעזרה לביצוע פקודה מערכתית באופן אסינכרוני.
`boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.
`boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.
`boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.
`CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` חסימה והפעלה של פעולה, עם ביטול אם היא נמשכת יותר מזמן מסוים.
`CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` שיטה מסייעת להפעלת פקודת מערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין, והפניה אוטומטית של הפלט לקובצים אם צוין.
`CommandResult`	`runTimedCmd(long timeout, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdSilently(long timeout, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` שיטה מסייעת להפעלת פקודת מערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין, והפניה אוטומטית של הפלט לקובצים אם צוין.
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, String... command)` שיטה מסייעת להרצת פקודת מערכת שדורשת קלט מ-stdin, וביטול הפעולה אם היא נמשכת יותר מפרק זמן מסוים.
`CommandResult`	`runTimedCmdWithInput(long timeout, String input, command)` שיטה מסייעת להרצת פקודת מערכת שדורשת קלט מ-stdin, וביטול הפעולה אם היא נמשכת יותר מפרק זמן מסוים.
`CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` שיטה מסייעת להרצת פקודת מערכת שדורשת הפניה אוטומטית של Stdin מקובץ, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` שיטה מסייעת להפעלת פקודת מערכת, ביטול אם הפעולה נמשכת יותר מהזמן שצוין, והפניה אוטומטית של הפלט לקובצים אם צוין.
`CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` שיטה מסייעת להרצת פקודת מערכת, וביטול הפקודה אם היא נמשכת יותר מהזמן שצוין.
`boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.
`boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.
`CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` חסימה והפעלה של פעולה, עם ביטול אם היא נמשכת יותר מזמן מסוים.
`void`	`setEnvVariable(String name, String value)` הגדרת משתנה סביבה לשימוש בזמן הרצת פקודות מערכת.
`void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` להחליט אם כשיוצרים תהליך, ביטול ההגדרה של משתנה הסביבה הוא בעדיפות גבוהה יותר מהגדרה שלו.
`void`	`setInterruptibleInFuture(Thread thread, long timeMs)` להגדיר את הפגישה כניתנת להפרעה אחרי זמן המתנה מסוים.
`void`	`setLinuxInterruptProcess(boolean interrupt)` מאפשר להשתמש בהפרעה של 'kill' ב-Linux בתהליך שפועל באמצעות שיטות #runTimed כשהוא מגיע לזמן קצוב לתפוגה.
`void`	`setRedirectStderrToStdout(boolean redirect)` הגדרת מקור השגיאות הרגיל להפניה אוטומטית למקור הפלט הרגיל כשמריצים פקודות מערכת.
`void`	`setWorkingDir(File dir)` הגדרת ספריית העבודה לפקודות המערכת.
`void`	`sleep(long time)` שיטה מסייעת לשינה למשך זמן נתון, תוך התעלמות מחריגים.
`void`	`unsetEnvVariable(String key)` ביטול ההגדרה של משתנה סביבה, כך שפקודות המערכת יפעלו בלי משתנה הסביבה הזה. משתני סביבה עשויים לרשת מהתהליך ההורה, לכן צריך למחוק את משתנה הסביבה מ-`ProcessBuilder.environment()`

שדות

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

יוצרים ציבוריים

RunUtil

public RunUtil ()

יוצרים אובייקט RunUtil חדש לשימוש.

RunUtil

public RunUtil (boolean inheritEnvVars)

פרמטרים
`inheritEnvVars`	`boolean`

שיטות ציבוריות

allowInterrupt

public void allowInterrupt (boolean allow)

מאפשרת או אוסרת הפסקות ריצה בשרשור הנוכחי. אם מותר, אפשר להפסיק פעולות ריצה של הליבה הנוכחית מליבות אחרות באמצעות השיטה interrupt(Thread, String).

פרמטרים
`allow`	`boolean`: האם לאפשר הפסקות ריצה בשרשור הנוכחי.

createProcessBuilder

public ProcessBuilder createProcessBuilder (Redirect redirect, 
                 commandList, 
                boolean enableCache)

פרמטרים
`redirect`	`Redirect`
`commandList`
`enableCache`	`boolean`

החזרות
`ProcessBuilder`

getDefault

public static IRunUtil getDefault ()

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

האפשרות הזו שימושית למבצעי קריאה שרוצים להשתמש ב-IRunUtil בלי התאמה אישית. מומלץ למבצע הקריאה שכן זקוק למכונה מותאמת אישית של IRunUtil (כלומר, צריך לקרוא ל-setEnvVariable(String, String) או ל-setWorkingDir(File)) ליצור עותק משלו.

החזרות
`IRunUtil`

interrupt

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

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

פרמטרים
`message`	`String`: ההודעה ל-`RunInterruptedException`.
`errorId`	`ErrorIdentifier`: מייצג את הסיבה להפרעה, אם היא ידועה.

interrupt

public void interrupt (Thread thread, 
                String message)

פרמטרים
`message`	`String`: ההודעה ל-`RunInterruptedException`.

isInterruptAllowed

public boolean isInterruptAllowed ()

הצגת סטטוס ההפרעה של RunUtil.

החזרות
`boolean`	true אם ניתן להפסיק את ההרצה, ו-false אחרת.

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

שיטה חלופית של runCmdInBackground(String) שמקבלת את ארגומנטים הפקודה בפורמט ERROR(/List).

פרמטרים
`redirect`	`Redirect`: ה-`ERROR(/Redirect)` שרוצים להחיל על ה-`ProcessBuilder`.
`command`	: ה-`ERROR(/List)` שמכיל את פקודת המערכת שצוינה ואת הארגומנטים ל-exec, אם יש כאלה

החזרות
`Process`	`Process` של הפקודה שהופעל

runCmdInBackground

public Process runCmdInBackground ( command)

שיטה חלופית של runCmdInBackground(String) שמקבלת את ארגומנטים הפקודה בפורמט ERROR(/List).

פרמטרים
`command`	: ה-`ERROR(/List)` שמכיל את פקודת המערכת שצוינה ואת הארגומנטים, אם יש כאלה, ל-exec

החזרות
`Process`	`Process` של הפקודה שהופעל

runCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

הפעלת פקודה עם הדגל ERROR(/OutputStream) מתעדת את הפלט של הפקודה. stdout ו-stderr מוזגו יחד.

פרמטרים
`command`	: הפקודה להרצה
`output`	`OutputStream`: OutputStream לשמירת הפלט

החזרות
`Process`	ה-`Process` שמריץ את הפקודה

runCmdInBackground

public Process runCmdInBackground (String... command)

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

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

פרמטרים
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`Process`	`Process` של הפקודה שהופעל

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

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

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

פרמטרים
`redirect`	`Redirect`: ה-`ERROR(/Redirect)` שרוצים להחיל על ה-`ProcessBuilder`.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`Process`	`Process` של הפקודה שהופעל

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.

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

פרמטרים
`opTimeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה לניסיון פעולה יחיד
`initialPollInterval`	`long`: זמן ההמתנה הראשוני בין ניסיונות הפעולה
`maxPollInterval`	`long`: משך הזמן המקסימלי להמתנה בין ניסיונות הפעולה
`maxTime`	`long`: משך הזמן המשוער הכולל להמשך הניסיון לבצע את הפעולה
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע

החזרות
`boolean`	`true` אם הפעולה הושלמה בהצלחה לפני שתוקף maxTime פג

runFixedTimedRetry

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.

פרמטרים
`opTimeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה לניסיון פעולה יחיד
`pollInterval`	`long`: זמן ההמתנה הראשוני בין ניסיונות הפעולה
`maxTime`	`long`: משך הזמן המשוער הכולל להמשך הניסיון לבצע את הפעולה
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע

החזרות
`boolean`	`true` אם הפעולה הושלמה בהצלחה לפני שתוקף maxTime פג

runFixedTimedRetryWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

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

פרמטרים
`opTimeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה לניסיון פעולה יחיד
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`pollInterval`	`long`: זמן ההמתנה הראשוני בין ניסיונות הפעולה
`maxTime`	`long`: משך הזמן המשוער הכולל להמשך הניסיון לבצע את הפעולה
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע

החזרות
`boolean`	`true` אם הפעולה הושלמה בהצלחה לפני שתוקף maxTime פג

runTimed

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע
`logErrors`	`boolean`: הרשאה לתיעוד שגיאות בחריגים או לא.

החזרות
`CommandStatus`	התוצאה `CommandStatus` של הפעולה.

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

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

פרמטרים
`timeout`	`long`: זמן קצוב לתפוגה – משך ההמתנה המקסימלי, במילישניות. הערך 0 מציין שאין זמן קצוב לתפוגה.
`stdout`	`OutputStream`: `ERROR(/OutputStream)` – המקום שאליו יועבר הפלט של std. הערך יכול להיות null.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` – המקום שאליו יועבר הפלט של השגיאה. הערך יכול להיות null.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, באלפיות שנייה. הערך 0 מציין שאין זמן קצוב לתפוגה.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdRetry

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה בכל ניסיון
`retryInterval`	`long`: משך הזמן להמתנה בין ניסיונות חוזרים של הפקודה
`attempts`	`int`: מספר הניסיונות המקסימלי
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdRetryWithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה בכל ניסיון
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`retryInterval`	`long`: משך הזמן להמתנה בין ניסיונות חוזרים של הפקודה
`attempts`	`int`: מספר הניסיונות המקסימלי
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdSilently

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdSilentlyRetry

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`retryInterval`	`long`: משך הזמן להמתנה בין ניסיונות חוזרים של הפקודה
`attempts`	`int`: מספר הניסיונות המקסימלי
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

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

פרמטרים
`timeout`	`long`: זמן קצוב לתפוגה – משך ההמתנה המקסימלי, במילישניות. הערך 0 מציין שאין זמן קצוב לתפוגה.
`input`	`String`: הקלט של stdin שרוצים להעביר לתהליך
`stdoutFile`	`File`: `ERROR(/File)` – המקום שאליו יועבר הפלט של std. הערך יכול להיות null.
`stderrFile`	`File`: `ERROR(/File)` – המקום שאליו יועבר הפלט של השגיאה. הערך יכול להיות null.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`input`	`String`: הקלט של stdin שרוצים להעביר לתהליך
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`input`	`String`: הקלט של stdin שרוצים להעביר לתהליך
`command`	: `ERROR(/List)` שמכיל את פקודת המערכת ואת הארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`inputRedirect`	`File`: ה-`ERROR(/File)` להפניה אוטומטית כקלט רגיל באמצעות `ProcessBuilder.redirectInput()`. אם הערך הוא null, לא תתבצע הפניה אוטומטית של stdin.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

פרמטרים
`timeout`	`long`: זמן קצוב לתפוגה – משך ההמתנה המקסימלי, במילישניות. הערך 0 מציין שאין זמן קצוב לתפוגה.
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`stdout`	`OutputStream`: `ERROR(/OutputStream)` – המקום שאליו יועבר הפלט של std. הערך יכול להיות null.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` – המקום שאליו יועבר הפלט של השגיאה. הערך יכול להיות null.
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, באלפיות שנייה. הערך 0 מציין שאין זמן קצוב לתפוגה.
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`command`	`String`: פקודת המערכת שצוינה וארגומנטים ל-exec (אופציונלי)

החזרות
`CommandResult`	`CommandResult` שמכיל תוצאה מהרצת הפקודה

runTimedRetry

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

חסימה והפעלה של פעולה מספר פעמים עד שהיא מצליחה.

פרמטרים
`opTimeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה לניסיון פעולה אחד
`pollInterval`	`long`: משך הזמן להמתנה בין ניסיונות חוזרים של הפקודה
`attempts`	`int`: מספר הניסיונות המקסימלי
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע

החזרות
`boolean`	`true` אם הפעולה הושלמה לפני שמספר הניסיונות הגיע למקסימום.

runTimedRetryWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

פרמטרים
`opTimeout`	`long`: משך ההמתנה המקסימלי באלפיות שנייה לניסיון פעולה אחד
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`pollInterval`	`long`: משך הזמן להמתנה בין ניסיונות חוזרים של הפקודה
`attempts`	`int`: מספר הניסיונות המקסימלי
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע

החזרות
`boolean`	`true` אם הפעולה הושלמה לפני שמספר הניסיונות הגיע למקסימום.

runTimedWithOutputMonitor

public CommandStatus runTimedWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

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

פרמטרים
`timeout`	`long`: משך ההמתנה המקסימלי, במילישניות
`idleOutputTimeout`	`long`: משך ההמתנה המקסימלי באלפיות השנייה להצגת פלט בזרמי הפלט
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` לביצוע
`logErrors`	`boolean`: הרשאה לתיעוד שגיאות בחריגים או לא.

החזרות
`CommandStatus`	התוצאה `CommandStatus` של הפעולה.

setEnvVariable

public void setEnvVariable (String name, 
                String value)

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

פרמטרים
`name`	`String`: שם המשתנה
`value`	`String`: ערך המשתנה

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

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

פרמטרים
`priority`	`IRunUtil.EnvPriority`

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

להגדיר את הפגישה כניתנת להפרעה אחרי זמן המתנה מסוים. ERROR(/CommandScheduler#shutdownHard()) כדי לאכוף את המדיניות, אנחנו מבטלים את החשבון בסופו של דבר.

פרמטרים
`thread`	`Thread`: השרשור שיהיה ניתן להפרעה.
`timeMs`	`long`: משך הזמן להמתנה לפני ההגדרה של האפשרות 'ניתן להפרעה'.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

מאפשר להשתמש בהפרעה של 'kill' ב-Linux בתהליך שפועל באמצעות שיטות #runTimed כשהוא מגיע לזמן קצוב לתפוגה. לא ניתן להשתמש בהם במכונה IRunUtil שמוגדרת כברירת מחדל.

פרמטרים
`interrupt`	`boolean`

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

הגדרת מקור השגיאות הרגיל להפניה אוטומטית למקור הפלט הרגיל כשמריצים פקודות מערכת. הערך הראשוני הוא false.

פרמטרים
`redirect`	`boolean`: ערך חדש לקביעת הצורך בהפניה אוטומטית

setWorkingDir

public void setWorkingDir (File dir)

הגדרת ספריית העבודה לפקודות המערכת.

פרמטרים
`dir`	`File`: ספריית העבודה

שינה

public void sleep (long time)

שיטה מסייעת לשינה למשך זמן נתון, תוך התעלמות מחריגים.

פרמטרים
`time`	`long`: אלפיות השנייה לשינה. ערכים שקטנים מ-0 או שווים לו יימחקו

unsetEnvVariable

public void unsetEnvVariable (String key)

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

פרמטרים
`key`	`String`: שם המשתנה

מידע נוסף:

ProcessBuilder.environment()