善用 Linux man-pages

Linux man-pages 提供与 Linux kernel 以及 GNU C library 提供的 user-space API 有关的详细资讯，其主要分为 8 个章节，主题如下:

1. User commands (Programs)
2. System calls
3. Library calls
4. Special files (devices)
5. File formats and configuration files
6. Games
7. Overview, conventions, and miscellaneous
8. System management commands

实际案例

Unix-like 的作业系统几乎都内建了 Programmer's Manual，它可以帮助我们查找 C 语言函式的定义。
若我想知道 sem_init() 的定义，便可以直接在终端机输入以下命令:

man sem_init

上图 SEM_INIT(3) 之中的数字 3 表示 sem_init() 属於函式库呼叫，并且详述了它被实作於哪一个函式库以及使用方式 (呼叫函式时应传入的参数以及应用场景等)。

安装

如果你无法在 Linux 作业系统查阅 Man pages ，请使用以下命令安装:

$ sudo apt-get install manpages # 涵盖 GNU/Linux 的基本操作
$ sudo apt-get install manpages-dev # GNU/Linux 的相关 API
$ sudo apt-get install manpages-posix # POSIX 所定义公用程序的方法
$ sudo apt-get install manpages-posix-dev # POSIX 的标头档以及函式库呼叫的方法

小技巧

1. 开启符合关键字的 man page:

man -a keyword

2. 列出符合关键字的档案路径，并询问是否要开启该档案:

man -K keyword

3. 列出所在章节/查询指定章节
以 pritf 为例，在输入命令时加入 -aw 参数，man page 就会回传 pritf 所在的章节。

man -aw printf

/usr/share/man/man1/printf.1
/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/share/man/man1/printf.1
/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/share/man/man3/printf.3

查询结果显示它会出现在 man page 当中的第一章和第三章，若我们想要查询的是 Library call，则可以在查询目标之前加入指定章节：