分类: LINUX
2010-05-17 17:26:33
(1)所有的手册页都属于一个特定的领域,用一个字符来表示。
Linux下最通用的领域及其名称及说明如下:
领域 名称 说明
1 用户命令, 可由任何人启动的。
2 系统调用, 即由内核提供的函数。
3 例程, 即库函数。
4 设备, 即/dev目录下的特殊文件。
5 文件格式描述, 例如/etc/passwd。
6 游戏, 不用解释啦!
7 杂项, 例如宏命令包、惯例等。
8 系统管理员工具, 只能由root启动。
9 其他(Linux特定的), 用来存放内核例行程序的文档。
n 新文档, 可能要移到更适合的领域。
o 老文档, 可能会在一段期限内保留。
l 本地文档, 与本特定系统有关的。
例如:man ls就会有LS(1)
(2)man的一些常用参数和用法
man -a cmd
打开所有领域内的同名帮助,例如 man fam ,你首先会进入一个fam(1M)的命令版fam帮助,你再按q键
就会进入FAM(3X),库函数版的帮助
man -aw cmd
显示所有cmd的所有手册文件的路径,如 man -aw fam 就是
/usr/share/man/man1/fam.1m.gz
/usr/share/man/man3/fam.3x.gz
man 领域代号 cmd
直接指定特定领域内搜索手册页,如 man 3 fam 直接进入库函数版的帮助
man -M cmd
指定手册文件的搜索路径,如 man -M /home/mysql/man mysql 显示的就是你安装的mysql的帮助,
而不是系统自带的旧版mysql的帮助
man cmd| col -b > cmd.txt
把man手册信息输出到文本文件
LANG=语言代号
man -w cmd
man 特定语言manpage文件的路径
查看特定语言版本的手册页
例如,要查看mplayer的中文man
shell> LANG=zh
shell> man -w mplayer
/usr/share/man/zh/man1/mplayer.1.gz
新开一个shell窗口(或在原窗口 shell> LANG=en_US.UTF-8)
shell> man /usr/share/man/zh/man1/mplayer.1.gz
(3)man的配置文件/etc/man.config
如果你不想每次man cmd都要用-M指定路径,那么可以通过修改配置文件,添加内容如
MANPATH /home/mysql/man
man在各领域的搜索次序可以通过修改
MANSECT 1:8:2:3:4:5:6:7:9:tcl:n:l:p:o
实现,一般不推荐修改。
linux中man命令用法详解:
显示所有man文档的编号
man -f man 显示man程序的所有文档
在man中查询
apropos keywords
man -k keywords
重建man库
makewhatis
查询man文档位置
whereis man 查询man的文档位置
查看当前man的文档目录
manpath
打印man文档
man -t finger | lpr 打印
lpstat -p -d 查看打印机状态
用浏览器打开
man -Hfirefox bash
将man的结果保存在文件内
man bash | col -b > bash.txt
col是用来对文本进行转换的命令,这里是去掉所有的退格符号
名称
man-显示线上求助手册(manualpage)manpath-决定线上手册的搜寻路径
摘要
man[-acdfhkKtwW][-msystem][-pstring][-Cconfig_file][-Mpath][-Ppager][-Ssection_list][section]name...
描述
man是用来排版并显示线上求助手册,此版本了解MANPATH与(MAN)PAGER这两个环境变数,所以你可以拥有个人的线上手册,并选择任何程式来显示已排版的手册。如果指定了section,则man只会显示该手册的特定章节。您也可以利用选项或是环境变数来指定搜寻的次序或是排版之前的处理工具。如果name包含了`/’则man会先搜寻所指定的档案,所以您可以man./foo.5或者是man/cd/foo/bar.1.gz。
选项
-Cconfig_file指定设定档man.conf;内定值是/etc/man.conf。(Seeman.conf(5).)
-M
path指定了线上手册的搜寻路径,如果没有指定则使用环境变数MANPATH的设定;如果没有使用MANPATH,则会使用/usr/lib/man.conf内的设定;如果MANPATH是空字串则表示使用内定值。
-P
pager指定使用何种pager.man会优先使用此选项设定,然后是依环境变数MANPAGER设定,然后是环境变数PAGER;man内定使用/usr/bin/less-is。
-S
section_listman所搜寻的章节列表(以冒号分隔),此选项会覆盖环境变数MANSECT的设定。
-a
man内定在显示第一个找到的手册之后就会停止搜寻,使用此选项会强迫man显示所有符合name的线上手册。
-c
即使有最新的catpage,还是对线上手册重新作排版,本选项在萤幕的行列数改变时或已排版的线上手册损坏时特别有意义。
-d
不要真的显示线上手册,只显示除错讯息。
-D
同时显示线上手册与除错讯息。
-f
功能同whatis。
-h
显示求助讯息然后结束程式。
-k
功能同apropos。
-K
对所有的线上手册搜寻所指定的字串。警告:本功能回应速度可能很慢!如果指定section会对速度有帮助。
-m
system依所指定的system名称而指定另一组的线上手册。
-p
string指定在nroff或troff之前所执行的处理程式不是所有的安装都会有完整的前处理器。各个前处理器所代表的字母分别为:eqn(e),grap(g),pic(p),tbl(t),vgrind(v),refer(r).本选项覆盖环境变数MANROFFSEQ的设定。
-t
使用/usr/bin/groff-Tps-mandoc来对线上手册排版,并将结果显示至stdout。/usr/bin/groff-Tps-mandoc的输出结果可能还需要特定的过滤器才能列印(如bg5ps)。
-w或--path
不要真的显示线上手册,但显示线上手册的位置.如果没有指定引数则显示man所搜寻的目录列表。如果manpath是man的□结,则玬anpath?功能同玬an--path?。
-W
功能类-w,但每行只印出一个档名,不印出额外的讯息.这在下面的状况特别有用:man-aWman|xargsls-l。
man会试着存下已排版的线上手册,以节省下回排版所需要的时间。传统上,位于DIR/X的手册在排版完成后会存于DIR/catX,但在这里是存于/var/ctaman/catX。如果系统没有所需要的目录,则不会有任何catpage存档。
Itispossibletomakemansuidtoauserman.Then,ifacatdirectoryhasownermanandmode0755(onlywritablebyman),andthecatfileshaveownermanandmode0644or0444(onlywritablebyman,ornotwritableatall),noordinaryusercanchangethecatpagesorputotherfilesinthecatdirectory.Ifmanisnotmadesuid,thenacatdirectoryshouldhavemode0777ifallusersshouldbeabletoleavecatpagesthere.
选项-c强迫对线上手册重新作排版。
环境变数
MANPATHMANPATH用来设定man的搜寻路径。
MANROFFSEQ
MANROFFSEQ用来设定在nroff或troff执行前所需要的前处理器。内定在nroff前会先执行tablepreprocessor。
MANSECT
MANSECT决定man搜寻的章节。
MANWIDTH
MANWIDTH用来设定显示的宽度。若无设定,则手册会填满您萤幕的宽度。
MANPAGER
MANPAGER决定了显示线上手册的工具。如果无MANPAGER则使用PAGER,如果两者皆未设定则使用/usr/bin/less-is。
LANGLANG决定了man先搜寻的的子目录的名称所以`LANG=dkman1foo’会使man先搜寻[path]/dk/man1/foo.1,如果找不到该档,man才去寻找[path]/man1/foo.1,[path]是指预设的搜寻路径。
NLSPATH,LC_MESSAGES,LANG
环境变数NLSPATH与LC_MESSAGES(如果LC_MESSAGE不存在则使用LANG)用来指定讯息的语言种类.(英文讯息是编译时即内定,故不需另外设定.)请注意,man所呼叫的程式,如col(1)也会使用这些环境变数。
PATHPATH是用来设定man的搜寻线上手册的路径。
SYSTEMSYSTEM用来设定替代的系统名(此为选项-m所使用)。
相关说明
apropos(1),whatis(1),less(1),groff(1)。
选项-t只会在有类似troff工具存在时才有功用。在gnome-help-browser还看不到中文。在kdehelp中可看到中文,但固定字型建建议选取courier或lucidatyperiter。