Man
手冊頁:何時在第 2 部分和何時在第 3 部分放置新的系統呼叫?
在大學的一個練習中,我們被要求使用一個系統呼叫來擴展 Minix (v2),該系統呼叫
utctime
可以正確計算閏秒(Minix 的實現time
沒有這樣做)。我們創建了一個新的系統呼叫,並創建了一個新的庫函式來包裝這個添加到
<time.h>
.現在,我們想為
utctime
. 但是,time
在第 2 節(系統呼叫)和第 3 節(庫呼叫)中都有手冊頁。
utctime
我們應該在這兩者中添加嗎?還是僅僅2
因為它不是標準化的 C 庫呼叫?
我建議第 2 節。例如,考慮
open
系統呼叫——實際上,系統呼叫上的 C 庫函式包裝器open
——僅在第 2 節中記錄。
如果函式存在於核心本身,而不是使用者空間 C 庫中,則將其放在第 2 節中。
第 3 節不僅針對 libc 函式,它們還可以是提供不屬於核心的低級作業系統子常式的其他庫。例如,PAM 功能手冊頁儲存在第 3 節中。
在這種情況下,如果您有核心系統呼叫和庫函式,請將系統呼叫的手冊頁放在第 2 節,將庫函式的手冊頁放在第 3 節。