Linux源码下生成并安装内核文档

1、最近想使用man命令查看Linux内核函数的帮助信息，无奈有如下提示：

2、xinu@slam:~$ man printkNo manual entry for printk

3、而在Linux内核源码下，我们执行make help命令后，输出的提示内容有关于内核文档的如下信息：

4、Documentation targets:Linux kernel internal documentation i荏鱿胫协n different formats:htmldocs - HTMLpdfdocs - PDFpsdocs - Postscriptxmldocs - XML DocBookmandocs - man pagesinstallmandocs - install man pages generated by mandocscleandocs - clean all generated DocBook files

5、总共可以生成HTML、PDF、Postscript、XML和man文档这5种格式，其中man文档可以安装到系统里，然后使用man命令来查看相关Linux内核函数（Linux内核API函数）的帮助信息。

6、由于我们终究要生成man文档，故而进行如下操作：

7、cd ~/linux-3.13.6make mandocs

8、此时会有如下错误提示：

9、xinu@slam:~/linux-3.13.6$ make mandocsHOSTCC scripts/docproc DOCPROC Documentatio荏鱿胫协n/DocBook/z8530book.xml** You need to install xmlto **make[1]:** [Documentation/DocBook/z8530book.9] Error 1make: **[mandocs] Error 2

10、于是使用如下命令安装xmlto：

11、sudo apt-get install xmlto

12、安装好后再执行上面的make mandocs命令继续生成Linux内核API帮助文档，生成的文档会放在Kernel源码的Documentation/DocBook目录下。

13、生成好后，再使用如下命令安装：

14、sudo make installmandocs

15、执行该命令时会有如下输出：

16、xinu@slam:~/linux-3.13.6$ sudo make installmandocs[sudo] password for xinu:GEN /home/xinu/linux-3.13.6/Documentation/DocBook//v4l2.xmlmkdir -p /usr/local/man/man9/install Documentation/DocBook/man/.9.gz /usr/local/man/man9/

17、从提示可以看出其实际上是将所有.9.gz文件安装到/usr/local/man/man9目录里，那我们可以只编译一遍，然后将这些*.9.gz文件复制到其他机器再执行上面最后一行命令进行安装即可，这样可以省下编译生成文档的1个来小时时间（视机器配置而言）。

18、至此，我们就可以使用类似man printk语句来查看内核函数的帮助信息了。