manページ  — INTRO

intro – システムカーネルインタフェースの紹介

解説 ANSI-C 等のプロトタイプ インデントとスタイル 命名規則 シンボルのスコープ 関連項目 歴史

このセクションはカーネル内のインタフェースとサブルーチンについての 情報を含んでいます。

お願いします。

我々は全てのコードが完全にプロトタイプされていることを望みます。

あなたのコードが cc -Wall とした時にきれいにコンパイルできれば、我々は嬉しく思います。 これは cc を黙らせることが問題ではなく、 苦情の原因事象を避けることが問題であるということを理解することが重要です。 遠慮なしに言うと、キャストや他の不明瞭化する手法で問題を隠すのではなく、 問題を解決してください。

幾つかの一般的な規則があります。

1. ある関数が DDB でのデバッグ支援を意図したものであるならば、 それは下記のように囲まれるべきです。

   #ifdef DDB
   
   #endif /* DDB */
   

   加えて、関数の名前は、それがデバッガルーチンであることが明確にわかるように、 DDB_ を接頭辞として始めるべきです。

カーネル内のシンボルのスコープは注意深く考慮することが重要です。 何らかの理由でそう出来ない場合以外は、デフォルトでは全てを static にします。

この方針には幾つかの理由があります。 主な理由は、カーネルは単一の名前空間であることと、 ここでは名前空間の汚染もあまり名案ではないということです。

デバイスドライバと カーネルに新しい内部のインタフェースを追加しないモジュールでは、 可能であるならば全てのソースコードが一つのファイルであるべきです。 それは全てのシンボルを static にできる方法であるからです。

何らかの理由によりモジュールが複数のファイルに分割される場合には、 大きな境界線に沿ってそのモジュールを分割するよう努力して、 グローバルなシンボルの数を手引にして熟考してください。 少ない方が好ましいです。

intro セクションのマニュアルページは FreeBSD 2.2 で登場しました。