【前言】
編寫驅動程序的時候,一般情況下使用的都不是 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的博客