标签 手册 下的文章

Linux 的帮助手册其实拥有很多有用的信息,而且比你想象中更容易使用

我们通常通过 google 来查询 Linux 中的命令说明,但是其实还有一个更好的办法:那就是通过 Linux 自带的 man 帮助页来查询命令详尽完整的使用说明。

man 页面的历史本身比 Linux 还长,可以追溯到 Unix 早期那个年代。 通过这个 Wikipedia 可以知道,Dennis Ritchie 和 Ken Thompson 在 1971 年写了第一个 man 帮助页,那个年代的计算器使用的还是像烤箱一样的计算机,个人电脑还未出世。man 帮助页也有它自己的一套设计精炼的语法,和 Unix 与 Linux 一样,man 帮助页也不是一成不变的,它就像 Linux 内核一样不停地发展更新。

Man 帮助页通过数字标识符来分成不同类型的内容:

  1. 一般用户命令
  2. 系统调用命令
  3. 库函数
  4. 特殊的文件和驱动程序
  5. 文件格式
  6. 游戏和屏保
  7. 杂项
  8. 系统管理命令和守护进程

尽管如此,用户一般也不需要知道他们想查询的命令是属于哪一个类型的。

这些文件格式化的方式在当今许多用户看来有点古怪。因为最开始他们是用 trooff 的方式,通过 PostScript 打印机来打印,所以包含了头部和布局方面的格式化信息。在 Linux 中,取而代之使用了一种叫做 groff) 的方法。

在我的 Fedora 系统中,man 帮助页相关的文件存储在 /usr/share/man 下的子目录中(比如 man1 存储第一部分的命令),还有进一步的子目录用于存储 man 帮助页的翻译。

如果你在 Shell 中查找 man 命令的 man 帮助页,你时间看到将是 gzip 工具压缩的 man.1.gz 文件。想要查询 man 帮助页,需要输入类似如下命令:

man man

这个例子会显示 man 命令的 man 帮助页,这将先解压 man 帮助页文件,然后解释格式化指令并用 less 显示结果,所以导航操作和在 less 中一样。

所有的 man 帮助页都应该显示这些子段落:NameSynopsisDescriptionExamplesSeeAlso。有些还会添加一些额外的子段落,比如 OptionsExitStatusEnvironmentBugsFilesAuthorReportingBugsHistoryCopyright

详细说明一个 man 帮助页

为了更详细地介绍一个典型的 man 帮助页,就用 ls 命令的帮助页来分析吧,在 Name 分段下,我们可以看到如下内容:

ls - list directory contents

它会简要地告诉我 ls 这条命令的作用.

Synopsis 分段下,我们可以看到如下的内容:

ls [OPTION]... [FILE]…

任何在中括号中的元素都是可选的。你可以只输入 ls 命令,后面不接任何参数。参数后面的省略号表示你可以添加任意多个彼此兼容的参数,以及许多文件名。对于 [FILE] 参数,你可以指定具体的目录名,或者可以使用通配符 *,比如这个例子,它会显示 Documents 文件夹下的 .txt 文件:

ls Documents/*.txt

Description 分段下, 我们可以看到关于这条命令更加详细的信息,还有关于这条命令各个参数作用的详细介绍的列表,比如说 ls 命令第一个选项 -a 参数,它的作用是显示包括隐藏文件/目录在内的所有文件:

-a, --all 

如果我们想用这些参数,要么用它们的别名,比如 -a,要么用它们的全名,比如 --all(两条中划线)。然而并不是所有参数都有全名和别名(比如 --author 只有一种),而且两者的名字并不总是相互关联的(-F--classify)。当你想用多个参数时,要么以空格隔开,要么共用一个连字符 -,在连字符后连续输入你需要的参数(不要添加空格)。比如下面两个等价的例子:

ls -a -d -l
ls -adl

但是 tar 这个命令有些例外,由于一些历史遗留原因,当参数使用别名时可以不用添加连字符 -,因此以下两种命令都是合法的:

tar -cvf filearchive.tar thisdirectory/

tar cvf filearchive.tar thisdirectory/

lsDescription 分段后是 AuthorReporting BugsCopyrightSee Also 等分段。

See Also 分段会提供一些相关的 man 帮助页,没事的话可以看看。毕竟除了命令外还有许多其他类型的 man 帮助页。

有一些命令不是系统命令,而是 Bash 特有的,比如 aliascd。这些 Bash 特有的命令可以在 BASH\_BUILTINS man 帮助页中查看,和上面的比起来它们的描述更加精炼,不过内容都是类似的。

其实通过 man 帮助页让你可以获得大量有用的信息,特别是当你想用一个已经很久没用过的命令,需要复习下这条命令的作用时。这个时候 man 帮助页饱受非议的简洁性反而对你来说是更好的。


作者简介:

Greg Pittman - Greg 是住在肯塔基州路易斯维尔的一位退休神经学家,但是却对计算机和编程保持着长久的兴趣,从二十世纪六十年代就开始捣腾 Fortran IV 了。随着 Linux 和开源软件的到来,更加激起了他去学习的兴趣并投身于这项事业中,并成为 Scribus 组织的一员。


via: https://opensource.com/article/17/7/using-man-pages

作者:Greg Pittman 译者:吴霄/toyijiu 校对:wxy

本文由 LCTT 原创编译,Linux中国 荣誉推出

几个月以前,Debian开发者发布了《The Debian Administrator's Handbook》,这本便于阅读、组织良好的书深入展现了Debian的内部。

本书最初发布的版本现在已经更新至Debian 7 Wheezy,改名为《The Debian Administrator's Handbook, Debian Wheezy from Discovery to Mastery》,新书根据目前现状重新整理了Debian的知识点,并明显增加了手册知识点数量。

《The Debian Administrator’s Handbook, Debian Wheezy from Discovery to Mastery》是该手册的第一次重大更新,这次更新距第一次发布已经超过了一年时间,因此,推荐给已经熟悉Debian,并希望提升Debian知识的用户们。

“我们高兴的宣布《The Debian Administrator’s Handbook, Debian Wheezy from Discovery to Mastery》发布了。这是自第一版书(2012年5月)发布后的第一次重大更新。我们更新了所有的章节来介绍Debian 7的改变。我们还删除了一些已经不再适用的过时内容。当然我们也增加了新的东西(如关于 multi-arch的部分),并修正了读者反馈的16个错误。”

什么是Debian?安装方法、二进制包的结构、软件包的结构、稳定软件库、性能和apt-get命令、配置和编程、通过ADSL连接、数据库、编译内核、RAID和LVM、图形化桌面、创建Debian包等,全部涵盖在了《The Debian Administrator’s Handbook, Debian Wheezy from Discovery to Mastery》的498页内容中。

《The Debian Administrator’s Handbook, Debian Wheezy from Discovery to Mastery》可以免费下载(498页,PDFEPUBMOBI)。

对于喜欢印刷版书籍的朋友,《The Debian Administrator’s Handbook, Debian Wheezy from Discovery to Mastery》可以通过以下方式购买http://debian-handbook.info/get/


via: http://iloveubuntu.net/debian-administrator%E2%80%99s-handbook-updated-debian-7-wheezy-published-and-freely-available-download

译者:乌龙茶 校对:wxy

本文由 LCTT 原创翻译,Linux中国 荣誉推出

最近在做中文MAN手册的翻译,发现MAC系统中的MAN命令不能像多数Linux发行版那样很好的显示中文MAN手册。

根据查找的资料,找到了解决方法:

1、首先要更新你的系统中的 groff 包,MAC中(10.8和10.9)的groff是1.18,是几年的版本了,需要升级,可以下载最新的groff 1.22 编译或者通过 port 来安装。

2、需要修改MAN的配置文件:

sudo vi /private/etc/man.conf

修改NROFF配置为:

NROFF preconv -e utf8 | /opt/local/bin/groff -Wall -mtty-char -Tutf8 -mandoc -c

这样就可以将UTF8编码的MAN页面通过转码而被groff识别。

修改PAGER配置为:

PAGER /usr/bin/less -isR

这样可以避免MAN手册页面中的ANSI Escape字符序列干扰(用于控制显示粗体等格式)

保存即可。

顺便,也说下如何彩色显示MAN的方法。

在环境变量中增加如下:

export GROFF_NO_SGR=1
export LESS_TERMCAP_mb=$'\E[01;36m'
export LESS_TERMCAP_md=$'\E[01;36m'
export LESS_TERMCAP_me=$'\E[0m'
export LESS_TERMCAP_se=$'\E[0m'
export LESS_TERMCAP_so=$'\E[01;44;33m'
export LESS_TERMCAP_ue=$'\E[0m'
export LESS_TERMCAP_us=$'\E[01;33m'

这样MAN就是彩色了,如果希望调整颜色,可以相应修改上述的Escape代码。

不过这种方法有个副作用就是,会扰乱env这样的命令输出的显示。

所以,更好的解决方式是,使用env命令来重新定义man命令的环境:

man() {
  env GROFF_NO_SGR=1 \
    LESS_TERMCAP_mb=$'\E[1;36m' \
    LESS_TERMCAP_md=$'\E[1;36m' \
    LESS_TERMCAP_me=$'\E[0m' \
    LESS_TERMCAP_se=$'\E[0m' \
    LESS_TERMCAP_so=$'\E[1;44;33m' \
    LESS_TERMCAP_ue=$'\E[0m' \
    LESS_TERMCAP_us=$'\E[1;33m' \
    man "$@"
}

以上可以放到你的/etc/bashrc 里面。