如何看懂man手册2

最新推荐文章于 2023-11-24 17:12:04 发布

xiaohuoma7620

最新推荐文章于 2023-11-24 17:12:04 发布

阅读量1.7k

点赞数

分类专栏： Linux 文章标签： postscript documentation 文档正则表达式 bugs security

Linux 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

1 什么是man手册

首先，man是manual的简称，中文说法可以是手册。

在Linux世界中，许多新手请教某条命令的用法时，好多不耐心的老手通常会用一条命令来回答这位无助的新手，而这条命令通常
就是man开头。无助的新手敲上这条命令一看究竟，在终端上顿时显示出来了一屏幕的英文，
老手的意思是，自己看看手册吗，可是看手册也是有学问的，无助的新手甚
至不知道怎么退出这条命令呢。下面我们就来讲解一下看man手册的学问。

2 从man手册中获取有用的信息

我们先以mkdir命令来解释读man手册的一些入门知识。

MKDIR(1)     User Commands              MKDIR(1)



NAME

       mkdir - make directories



SYNOPSIS

       mkdir [OPTION] DIRECTORY...



DESCRIPTION

       Create the DIRECTORY(ies), if they do not already exist.



       Mandatory arguments to long options are mandatory for short options too.



       -m, --mode=MODE

              set file mode (as in chmod), not a=rwx - umask



       -p, --parents

              no error if existing, make parent directories as needed



       -v, --verbose

              print a message for each created directory



       -Z, --context=CTX

              set the SELinux security context of each created directory to CTX



       --help display this help and exit



       --version

              output version information and exit



AUTHOR

       Written by David MacKenzie.



REPORTING BUGS

       Report bugs to <bug-coreutils@gnu.org>.



COPYRIGHT

       Copyright (C) 2008 Free Software Foundation, Inc.  License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>



       This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.



SEE ALSO



       mkdir(2)



       The  full documentation for mkdir is maintained as a Texinfo manual.  If the info and mkdir programs are properly installed at your site, the com-



       mand



              info coreutils 'mkdir invocation'



       should give you access to the complete manual.

首先第一行 MKDIR(1)，显然，MKDIR是命令的大写，那么为什么有个(1)呢，那是因为man手册页有如下的规定：

Section 名称说明

l	本地文档	与本特定系统有关的
1	用户命令	可由任何人启动的
2	系统调用	即由内核提供的函数
3	例程	即库函数
4	设备	即/dev目录下的特殊文件
5	文件格式描述	例如/etc/passwd
6	游戏	不用解释啦
7	杂项	例如宏命令包、惯例等
8	系统管理员工具	只能由root启动
9	其他（Linux特定的）	用来存放内核例行程序的文档
n	新文档	可能要移到更适合的领域
o	老文档	可能会在一段期限内保留

MKDIR(1)表示该命令属于Section 1，为用户命令，类似的man
apt-get会看到APT-GET(8)，表示apt-get命令为系统管理工具。

“NAME”部分是该命令的名字和简单的解释，显然，在命令行中要执行该命令要使用到它的名称。

“SNOPSIS”是摘要部分，简要解释该命令如何使用，比如mkdir的摘要：
mkdir [OPTION] DIRECTORY…，读到这里便需要讲解一下了：

“OPTIONS”左右有”[“和”]”，表示这些参数并不必须，但是可以使用。对应的DIRECTORY两边没有”[]”，就是必须要加的参数了。
另外，它们后面都有”…” ，表示这些参数可以重复使用多次。至于OPTIONS具体怎么用，就要看DESCRIPTION部分了。下面举几个简单的例子，并配合例子解释：

用法解释

mkdir tmp	创建 tmp 目录
mkdir –mode=a+w tmp	创建一个模式为“a+w”的tmp目录，–mode是长参数，用法是–mode=MODE，在DESCRIPTION里说明
mkdir -m a+w tmp	创建一个模式为“a+w”的tmp目录，-m 是短参数，不用加 = 号，效果等同 –mode=MODE
mkdir -mv a+w tmp	创建一个模式为“a+w”的tmp目录，同时显示信息，verbose模式，-mv可以一起用
mkdir -v -m a+w tmp	创建一个模式为“a+w”的tmp目录，同时显示信息，verbose模式，-v后面接一个空格再用-m