Linux：man命令用法

Linux提供了丰富的帮助手册，当你需要查看某个命令的参数时，可以使用 man 命令。同时也可以使用man man 查看man的使用方法。

一、命令格式

man [-adfhktwW] [section] [-M path] [-P pager] [-S list] [-m system] [-p string] title…

1.常用选项(OPTION)

-a, --all         寻找所有匹配的手册页
-d, --debug        输出调试信息
-D, --default       将所有选项都重置为默认值
--warnings[=警告]  开启 groff 的警告 
-f, --whatis        等同于 whatis
-h   显示man的语法和参数说明，执行完成后退出程序。
-k, --apropos       等同于 apropos将搜索whatis数据库，模糊查找关键字 
-S, -s, --sections=列表 使用以半角冒号分隔的章节列表
-t, --troff        使用 groff 对手册页排版
-w, --where, --path, --location 输出手册页的物理位置
-W, --where-cat, --location-cat 输出 cat 文件的物理位置 
-c, --catman        由 catman 使用，用来对过时的 cat 页重新排版  
-C, --config-file=文件  使用该用户设置文件
-K, --global-apropos    search for text in all pages
-M, --manpath=路径    设置搜索手册页的路径为“路径”
-?, --help         give this help list
--usage        give a short usage message
-V, --version       print program version
-R, --recode=编码    output source page encoded in ENCODING
 
寻找手册页：

-L, --locale=区域定义本次手册页搜索所采用的区域设置
-m, --systems=系统    use manual pages from other systems
-e, --extension=扩展将搜索限制在扩展类型为“扩展”的手册页之内
-i, --ignore-case     查找手册页时不区分大小写字母(默认)
-I, --match-case      查找手册页时区分大小写字母。
--regex        show all pages matching regex
--wildcard       show all pages matching wildcard
--names-only      make --regex and --wildcard match page names only,not descriptions

2.man命令对应的章节(section)

Linux的man手册共有以下几个章节(section)：
1、Standard commands （标准命令）用户在shell环境中可以操作的命令或可执行文件
2、System calls （系统调用）系统内核可调用的函数与工具等
3、Library functions （库函数）一些常用的函数与函数库，大部分为C的函数库(libc)
4、Special devices （设备说明）设备文件的说明，通常在/dev下的文件
5、File formats （文件格式）配置文件或者是某些文件的格式
6、Games and toys （游戏和娱乐）
7、Miscellaneous （杂项）惯例与协议等。如Linux文件系统、网络协议、ASCII码等说明
8、Administrative Commands （管理员命令）系统管理员可用的管理命令
9 其他（Linux特定的）， 用来存放内核例行程序的文档（与内核有关的文件）。

n 新文档， 可能要移到更适合的领域。
o 老文档， 可能会在一段期限内保留。
l 本地文档， 与本特定系统有关的。

如：

>>> man ls
它会在最左上角显示“LS（1）”，在这里，“LS”表示手册名称，而“（1）”表示该手册位于第一节章，
同样，我们输入“man ifconfig”它会在最左上角显示“IFCONFIG（8）”。

man是按照手册的章节号的顺序进行搜索的，所以也可以这样输入命令：man 3 sleep。
man sleep 只会显示sleep命令的手册,如果想查看库函数sleep，就要输入:man 3 sleep

二、man命令中常用按键以及用途

按键    用处
空格键 向下翻一页 
Page down 向下翻一页 
Page up 向上翻一页 
home 直接前往首页 
end 直接前往尾页 
/ 从上至下搜索某个关键词，如“/linux” 
? 从下至上搜索某个关键词，如“?linux” 
n 定位到下一个搜索到的关键词 
N 定位到上一个搜索到的关键词 
q 退出帮助文档 

三、 man命令帮助信息的结构以及意义

结构名称    代表意义
NAME 命令的名称及功能简要说明 
SYNOPSIS 参数的大致使用方法（语法简介）
DESCRIPTION 命令功能详细介绍，包括每一个选项的意义 
EXAMPLES 使用示例（附带简单说明） 
OPTIONS 具体的可用选项（针对SYNOPSIS部分）
COMMANDS 当这个程序在执行的时候，可以在此程序中执行的命令
FILES 用到的文件 
SEE ALSO 相关的资料 
BUGS 是否有相关的错误
OVERVIEW 概述 
DEFAULTS 默认的功能 
ENVIRONMENT 环境变量 
HISTORY 维护历史与联系方式  

四、man page数据文件的位置

不同的Linux发行版本可能不一样，通常是放在 /usr/share/man 目录下。我们可以修改 /etc/man.config 文件来修改 man page 的查询路径。

五、参考示例

1.用户命令whatis和apropos

命令whatis和apropos是man的简略写法
whatis命令是用于查询一个命令执行什么功能，并将查询结果打印到终端上。
>>> whatis man 
相当于 man -f man

>>> apropos man
相当于 man -k man

注意：这两个命令要能使用，必须要创建 whatis 数据库才行。需要用root身份执行下面的命令：
>>> makewhatis

2.系统调用 
>>> man 2 read

3.程序库调用 
>>> man 3 sleep

4.特殊文件（设备文件） 
>>> man 4 tty

5.文件格式(配置文件的语法)
>>> man 5 passwd
6.管理命令
>>> man 8 fdisk 

7.查看man命令相关的说明文件
>>> man -f man

8.在系统说明文件中查找含有man这个关键词的说明
>>> man  -k man