man手册，安装中文手册

Myth丶恋晨 2022-11-30 12:39 269阅读 0赞

一、man手册。  
1、什么是man手册？  
man手册就是linux提供给用户查看linux语法的一本书，当用户遇到一些不懂的命令/函数时，不用刻意去记住命令/函数的用法，只需要记住怎么在man手册去查询即可。

遇到不懂的命令 -> 查阅man手册 -> 得知：命令功能，命令参数，命令使用方法。  
遇到不懂的函数 -> 查阅man手册 -> 得知：函数功能，函数头文件，函数原型，函数参数，函数返回值。

2、man手册是如何管理内容？  
gec@ubuntu:~$ man man -> 使用man命令去查看man命令的本身是怎么用的。  
第一个man就是使用命令。  
第二个man就是查询的内容。

页数  
1 Executable programs or shell commands  
//可执行程序或者shell命令

2 System calls (functions provided by the kernel)  
//系统调用函数

3 Library calls (functions within program libraries)  
//库调用函数 -> 标准C库，线程库

3、遇到命令不会时，怎么办？ -> 例如：mkdir命令  
1）命令100%都是在第1手册，直接在第1手册查询就可以。  
gec@ubuntu:~$ man 1 mkdir

2）分析内容。  
NAME -> 对命令进行简单的描述。  
mkdir - make directories -> 可以创建多个目录。

SYNOPSIS -> 使用格式。  
mkdir \[OPTION\]... DIRECTORY...

mkdir -> 命令  
\[\]代表这个选项是可以省略  
\[OPTION\]... -> 代表这个参数可以写，也可以不写，这个参数可以写多个。  
DIRECTORY... -> 目录的路径，代表这个参数一定要写,可以写多个目录路径。

3）分析参数。  
DESCRIPTION -> 对参数进行详细描述。

\-p, --parents  
no error if existing, make parent directories as needed  
//如果目录存在也不会报错，可以根据用户的需要创建多级目录。

\-m, --mode=MODE  
set file mode (as in chmod), not a=rwx - umask  
//可以设置目录的起始权限，就好像chmod功能一样，不会受到系统的umask的干扰。

4、遇到函数不会，怎么办？ -> 例如open()。  
1）通过-f选项去查看man手册的页数。  
gec@ubuntu:~$ man -f open  
open (1) - start a program on a new virtual terminal (VT). -> open也是一个命令  
open (2) - open and possibly create a file -> 2/3手册都能查，就用2手册。  
open (3posix) - open file relative to directory file descriptor -> posix代表可移植。

2）直接去man手册查看第2手册即可。  
gec@ubuntu:~$ man 2 open

3）查看函数的功能。  
NAME -> 函数功能简单描述  
open and possibly create a file

SYNOPSIS -> 使用格式。

头文件：  
\#include <sys/types.h>  
\#include <sys/stat.h>  
\#include <fcntl.h>

函数原型：  
int open(const char \*pathname, int flags);  
  
根据函数原型中参数的下划线，在DESCRIPTION里面找到下划线的地方，然后阅读这个下划线的上下文。  
参数：  
pathname： -> 文件的路径。  
flags： -> 打开文件的权限。  
O\_RDONLY （只读）  
O\_WRONLY （只写）  
O\_RDWR （可读可写）

RETURN VALUE  
返回值：  
成功：the new file descriptor ->一个新的文件描述符(int)  
失败：-1

二、安装中文手册。  
1、中文手册资源。 -> manpages-zh-1.5.1.tar.gz 上网自己找。  
2、先把资源放置到共享目录下。  
/mnt/hgfs/GZ2057/02 linux基础/03

3、在linux下解压资源，一定要解压到linux独有的目录。（家目录）  
tar zxvf manpages-zh-1.5.1.tar.gz -C /home/gec

4、在家目录下会出现一个新的目录：  
manpages-zh-1.5.1/

5、为中文手册创建一个安装目录。  
sudo mkdir /usr/local/cman  
sudo chmod 777 /usr/local/cman

6、切换到解压后的路径，看看有什么文件。  
gec@ubuntu:~/manpages-zh-1.5.1$ ls  
aclocal.m4 ChangeLog configure.in DOCS install-sh Makefile.in NEWS src  
AUTHORS configure COPYING INSTALL Makefile.am missing README utils

7、了解安装时的参数。  
./configure -h  
  
//使用格式：./configure \[选项\]... \[变量=值\]...  
Usage: ./configure \[OPTION\]... \[VAR=VALUE\]...

//指定安装的路径（类似于windows中安装软件时出现的"浏览"）  
\--prefix=PREFIX install architecture-independent files in PREFIX  
\[/usr/local\]

\--disable-zhtw do not generate manpages for zh\_TW -> 禁用繁体字，最后结果是简体字。  
\--disable-zhcn do not generate manpage for zh\_CN -> 禁用简体字，最后结果是繁体字。

8、开始配置。  
./configure --prefix=/usr/local/cman --disable-zhtw -> 生成很多Makefile

9、执行Makefile。  
make

10、安装  
make install

11、安装结果。  
gec@ubuntu:/usr/local/cman/share/man/zh\_CN$ ls  
man1 man2 man3 man4 man5 man6 man7 man8

例如：查看ls的用法。  
英文： man ls

\[-M path\] -> 指定man手册的内容从哪里读取。

中文： man -M /usr/local/cman/share/man/zh\_CN ls -> cman ls

练习1： 安装中文手册到你的ubuntu。  
练习2： 永久设置cman这个命令为查看中文手册命令。