שימוש ב-man

לפקודה man מלשון manual של ה-unix לא מעט אופציות, נתייחס כאן לחשובות שבהם.

השימוש הנפוץ ביותר של man הוא להריץ את הפקודה

manפקודה

שתריץ את ה-man page של הפקודה הזו (באם קיימת). ה- man page הוא למעשה דף טקסט שמפרט מה עושה פקודה, האופציות שלה, לפעמים גם דוגמאות שימוש ולעיתים כמות משמעותית אינפורמציה נוספת הנחשבת בעלת משמעות למשתמש בה. קיימים man pages עבור פקודות שורה (shell) אבל גם פקודות פנימיות של C, C++, FORTRAN ולעיתים שפות תכנות נוספות, ובנוסף יש דפים נוספים על קובצי מערכת כמו /etc/fstab (לא נרחיב כאן את הדיבור על כך) ודפים של מרבית התוכנות שהתקנו במערכת. אלו נוספו ביוזמת התוכנות הללו כחלק מתהליך ההתקנה.

את הדף על הפקודה man עצמו ניתן להשיג ע"י הפקודה

man man

לדוגמא, הפקודה

man ls

תפרוש פלט נוסך

LS(1) User Commands LS(1)

NAME

ls - list directory contents

SYNOPSIS

ls [OPTION]... [FILE]...

DESCRIPTION

List information about the FILEs (the current directory by default).

Sort entries alphabetically if none of -cftuSUX nor --sort.

Mandatory arguments to long options are mandatory for short options

too.

-a, --all

do not ignore entries starting with .

-A, --almost-all

do not list implied . and ..

--author

with -l, print the author of each file

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

הפקודה man פורשת באופן אוטומטי את הדף תוך ביצוע העברת הפלט ל-more כלומר הפרישה תעשה כך שהפלט ייעצר עם מילוי המסך וימתין למשתמש להמשיך. לחיצת רווח בדרך כלל תעבור למסך הבא, יציאה בדרך כלל ע"י לחיצת המקש 'q'. בדרך כלל אפשר לחזור מסך אחד אחורה ע"י לחיצת 'b'.

המבנה של תוכן הדף הוא די סטנדרטי ודי מהר מתרגלים אליו.

ברוב הדפים מופיע לקראת הסוף סעיפים SEE ALSO המציינים דפי man נוספים המפרטות מידע הקשור למידע בדף הנוכחי וסעיף FILES המציין שמות של קבצים שהפקודה או תוכנה מושפעת מהם. בבעיות סבוכות לעיתים הפתרון למה שמחפשים מצוי דווקא שם.

לעיתים יש יותר מדף אחד עבור אותו שם פקודה. לדוגמא לפקודה printf יש דף עבור גרסת ה-shell שלה וגרסת ה-C שלה. ברירת המחדל של הפקודה man הוא להציג רק את הדף הראשון שהוא מוצא. אם זה לא מה שחיפשת אפשר להשתמש בפקודה

man –a פקודה

יציג ברצף את כל הדפים.

למשל הפקודה

man –a printf

יציג את כל הדפים לפקודו printf.

בכדי לאפשר דפים שונים לאותה שם פקודה דפי ה-man מחולקים מספרי מחלקות (sections). לדוגמא section מספר 1 מכיל בדרך כלל פקודות shell ו-seaction מספר 3 מכיל פקודות של שפת C. כאשר אתה רואה משהוא כמו printf(3) הכוונה לדף ה-man ב-section מספר 3. אם יש יותר מדף אחד עבור שם פקודה מסוימת ניתן לציין את שם ה-section הרצוי ע"י האופציה S-.

לדוגמא, הפקודה

man –S 3 printf

יחפש דף עבור הפקודה printf רק ב-section מספר 3 (היכן שמצויים הדפים של פקודות בשפת C).

במידה ואתה לא יודע את שם הפקודה אבל אתה יודע מושג שקשור לו ניתן לחפש את הפקודה ע"י האופציה k- (מלשון keyword). לדוגמא הפקודה

man –k java

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

apropos java

הפקודה man –f הממומשת גם בשם whatis נותנת הסבר קצר על פקודה.

לדוגמא

$ man -f printf

printf (1) - format and print data

printf (3) - formatted output conversion

printf [builtins] (1) - bash built-in commands, see bash(1)

$

למידע נוסף על man, הרץ את הפקודה

man man