剛開始看 Linux 指令的時候,man 頁面常常又長又亂,不知道從哪裡看起。後來學到一個閱讀流程,發現不只一般指令,連 Driver 開發的文件也可以用同一套方法讀。
在看任何指令的 man page 時,SYNOPSIS 這欄會告訴你基本語法,裡面有幾個常見符號:
| 符號 | 意思 | 範例 |
|---|---|---|
[] | 選填(optional) | [-v] |
<> | 佔位符,要換成實際值 | <file>、<pid> |
| | 二選一 | |
... | 可以重複多次 | <file>... |
-- | 長選項開始或停止解析 | --help、-- |
每次打開 man,不用一口氣全部看完,照這個順序:
① NAME → 一句話知道這個指令是做什麼的 ② SYNOPSIS → 學會基本語法,哪些必填、哪些可選 ③ DESCRIPTION → 理解它的工作原理與行為 ④ OPTIONS → 需要什麼功能,再查對應選項
以 git blame 為例,它的 SYNOPSIS 長這樣:
git blame [options] <file>
[] 表示 options 是選填的<> 表示 file 要換成實際的檔案名稱所以完整的用法是:
git blame main.c # 看 main.c 每一行誰改的
git blame -L 10,20 main.c # 只看第 10~20 行
ioctl、epoll、pthread、systemd 等 man 頁面,