Linux 手册页条目 |不同种类

手册页（manual page）是 unix 或 unix 等操作系统中可用的不同命令的文档手册。

要检查任何命令使用的手动输入， man command_name
在本文中，我使用printf命令进行演示。

man printf

输出：

PRINTF(1)                                                      User Commands                                                      PRINTF(1)

NAME
       printf - format and print data

SYNOPSIS
       printf FORMAT [ARGUMENT]...
       printf OPTION

DESCRIPTION
       Print ARGUMENT(s) according to FORMAT, or execute according to OPTION:

       --help display this help and exit

       --version
              output version information and exit

       FORMAT controls the output as in C printf.  Interpreted sequences are:

       \"     double quote

       \\     backslash

       \a     alert (BEL)

...

如果仔细观察上面的输出，第一行包含PRINTF(1) ，大括号中的 1 是 man 条目的类型。该数字基本上对应于手册页的部分。

本手册分为 8 个部分，分别是（在 Research Unix、BSD、macOS 和 Linux 上）：

Section	Description
1	General Commands
2	System Calls
3	Library functions, covering in particular the C standard library
4	Special files (usually devices, those found in /dev) and drivers
5	File formats and conventions
6	Games and screensavers
7	Miscellanea
8	System administration commands and daemons

让我们继续PRINTF的示例，对于所有条目，请尝试以下命令：

man -a printf

输出：

PRINTF(1)                                                      User Commands                                                      PRINTF(1)

NAME
       printf - format and print data

SYNOPSIS
       printf FORMAT [ARGUMENT]...
       printf OPTION

DESCRIPTION
       Print ARGUMENT(s) according to FORMAT, or execute according to OPTION:

       --help display this help and exit

       --version
              output version information and exit

       FORMAT controls the output as in C printf.  Interpreted sequences are:

       \"     double quote

...

当你输入 q 退出时，终端上会出现下面的文字，按回车继续看到 printf 的另一个条目

--Man-- next: printf(3) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]

输出继续：

PRINTF(3)                                                Linux Programmer's Manual                                                PRINTF(3)

NAME
       printf, fprintf, dprintf, sprintf, snprintf, vprintf, vfprintf, vdprintf, vsprintf, vsnprintf - formatted output conversion

SYNOPSIS
       #include 

       int printf(const char *format, ...);
       int fprintf(FILE *stream, const char *format, ...);
       int dprintf(int fd, const char *format, ...);
       int sprintf(char *str, const char *format, ...);
       int snprintf(char *str, size_t size, const char *format, ...);

       #include 

       int vprintf(const char *format, va_list ap);
       int vfprintf(FILE *stream, const char *format, va_list ap);

...

要检查 printf 或任何其他命令的特定条目，您可以直接提供节号，例如：

man 3 printf

输出：它将显示与 printf 的第 3 部分相对应的 man 条目。

一些有用的 man 命令选项：
1) -f 选项

man -f printf

输出：
它将显示 printf 的简短描述，如果可用，类似于

printf - format and print data

2) -k 选项

man -k printf

输出：
它将在简短的手册页描述中搜索关键字并显示任何匹配项。

printf               (1)  - format and print data
printf               (1p)  - write formatted output
printf               (3)  - formatted output conversion
printf               (3p)  - print formatted output
printf [builtins]    (1)  - bash built-in commands, see bash(1)

3) -w 选项
它打印将显示的 cat 文件的位置，而不是文件的内容。

man -w printf

输出：

/usr/share/man/man1/printf.1.gz

4) -K 选项
它将在所有手册页中搜索文本。

man -K printf

输出：
它将显示所有包含 printf 关键字的 man 条目，在显示每个条目后，您可以按 Enter 键查看第二个条目。
例如：
下面提示查看 printf 的第二个条目，您可以跳过它或退出以终止命令。

--Man-- next: git-show(1) [ view (return) | skip (Ctrl-D) | quit (Ctrl-C) ]

参考 ：
1) 维基/手册页
2) man进入man