linux-2.6.25/__CRC_SYMBOL()

参照元†

• linux-2.6.25/__EXPORT_SYMBOL()

説明†

• パス: linux-2.6.25/include/linux/module.h

• モジュールのバージョン管理をサポートするため、 関数や変数の CRC 値（バージョンとして使う）を入れるシンボルを宣言する。
  • CRC はコンパイル時に計算されるようだが、詳細は不明です。
  • バージョン情報テーブルの先頭要素は __start___kcrctab というシンボルである。

引数†

• sym
  • CRC を計算する対象となるシンボルを指定する。
• sec
  • セクションに追記する文字列を指定する。

返り値†

• なし

参考†

#ifndef __GENKSYMS__

• __GENKSYMS__ が宣言されていないときに有効である。
  • linux-2.6.25/__GENKSYMS__

実装†

#ifdef CONFIG_MODVERSIONS
/* Mark the CRC weak since genksyms apparently decides not to
 * generate a checksums for some symbols */
#define __CRC_SYMBOL(sym, sec)                                  \
        extern void *__crc_##sym __attribute__((weak));         \

• CRC を格納するシンボルを宣言する。
  • weak シンボルとして宣言する。
  • ## はトークン連結演算子で、トークン同士を繋いで一つのトークンにする。 （例: __CRC_SYMBOL(hoge, "") なら __crc_hoge となる）

        static const unsigned long __kcrctab_##sym              \

• CRC 格納用の変数を宣言する。

        __used                                                  \

• 最適化で消されないようにする。「未使用の変数/関数です」警告を抑制する。
  • 古い gcc 用に使う。

        __attribute__((section("__kcrctab" sec), unused))       \

• セクション __kcrctab に入れる。
  • __attribute__( (unused) ) なのは __attribute__( (used) ) が変数に使えない 古い gcc のため（gcc < 3.4）らしい。

        = (unsigned long) &__crc_##sym;

• __crc_##sym へのポインタを __kcrctab_##sym と言う 名前で__kcrctab セクション（CRC 用のシンボルテーブル）に入れる。
• このセクションを見れば CRC 値を入れた変数へのポインタが得られる。
  • セクションを探してくる関数、セクションからバージョンを取り出すマクロもある。
  • linux-2.6.25/find_sec()
  • linux-2.6.25/symversion()

#else
#define __CRC_SYMBOL(sym, sec)

• CONFIG_MODVERSIONS が宣言されていない場合は何もしない。
  • このマクロはカーネルのコンフィグで module versioning を ON にすると 宣言される。

#endif

コメント†

中の人

• katsuhiro

最新の30件

管理用

メニュー編集

• edit

新規作成用

• 0-func
• 0-struct
• 0-menu
• 0-concept