歡迎來到Linux教程網
Linux教程網
Linux教程網
Linux教程網
Linux教程網 >> Linux綜合 >> Linux內核 >> 創建Linux內核函數的Man手冊

創建Linux內核函數的Man手冊

日期:2017/3/3 14:13:44   编辑:Linux內核

【前言】

編寫驅動程序的時候,一般情況下使用的都不是 C標准庫的函數,而是 Linux內核中的函數。所以即使用 man命令 也找不到很多函數的幫助信息,這很不利於 Linux內核的學習。

好在 Linux內核雖然沒有直接提供手冊,卻提供了創建手冊的工具。我們可以手動生成 Linux內核的 Man手冊。

【創建步驟】

1、下載一個穩定版本的內核,例如:linux-4.4.8。

一般情況下用 Linux系統自帶的源碼不行,建議到官方網站下載最新版本:http://kernel.org/

2、在頂層目錄下執行 make mandocs 創建 Man手冊。這一步很費時間。

3、再執行 sudo make installmandocs 進行安裝。

4、現在可以使用 man命令 查看內核函數了。

【注意事項】

1、如果 make mandocs 命令執行失敗,可能是沒有安裝 xmlto 導致的,可以使用命令 sudo apt-get install xmlto 進行安裝。

2、可以將創建好的 Man手冊文檔 復制到別的設備上進行安裝,從而避免了非常費時的創建過程。

創建好的 Man手冊 存放於 /linux-4.4.8/Documentation/Docbook/man/ 目錄下,將該目錄中各子目錄及其包含的 *.9.gz 文件復制到需要安裝手冊的設備的相同目錄下(如果沒有就創建一個)。

然後以 root權限運行以下命令進行手冊的安裝:

mkdir -p /usr/local/man/man9

install Docbook/man/*.9.gz /usr/local/man/man9

命令執行成功後就可以在目標設備上同樣使用 Man命令 查看內核函數的幫助文檔了。

【參考文獻】

[1] 博客

雪夜流星

[2] 博客

star_shining的博客

Copyright © Linux教程網 All Rights Reserved