nm(1)
名前 | 形式 | 機能説明 | オプション | オペランド | 出力 | 環境 | 終了ステータス | 属性 | /usr/ccs/bin/nm | /usr/xpg4/bin/nm | 関連項目 | 注意事項
名前
- nm– オブジェクトファイルのネームリストを表示
形式
-
/usr/ccs/bin/nm [-ACDhlnPprRsTuVv] [-efox] [-g| -u] [-t format] file…
/usr/xpg4/bin/nm [-ACDhlnPprRsTuVv] [-efox] [-g| -u] [-t format] file…
機能説明
nm ユーティリティは、 file オペランドで指定された ELF オブジェクトファイルの各々に対して、 シンボルテーブルを表示します。
正しいファイルが指定されたにもかかわらず、そのファイルの シンボリック情報が存在しないとき、 nm はそのことを報告します。これはエラーとは見なされません。
オプション
- -A
-
各行に、オブジェクトの完全パス名とライブラリ名を出力します。
- -C
-
C++ シンボル名を、表示する前に複合化します。
- -D
-
SHT_DYNSYM シンボル情報を表示します。 これは ld.so.1 によって使用されるシンボルテーブルで、 ストリップされた動的実行可能ファイルにも 存在します。 デフォルトでは SHT_SYMTAB シンボルテーブルが表示されます。
- -e
-
後述の「注意事項」を参照してください。
- -f
-
後述の「注意事項」を参照してください。
- -g
-
外部 ( グローバル ) シンボル情報だけを出力します。
- -h
-
見出しのデータを表示しません。
- -l
-
WEAK と GLOBAL のシンボルを、 WEAK シンボルのキー文字の後に * を付加することにより区別します。
- -n
-
外部シンボルを、名前順にソートして出力します。
- -o
-
シンボルの値とサイズを、10 進数ではなく 8 進数で出力します (-t o と同じ )。
- -p
-
簡単に解析できる、簡易形式の出力を生成します。 各シンボル名の前には、シンボルの値 ( 未定義なら空白 ) と、シンボルの状態を示す文字が表示されます。 その文字とは以下のいずれかです。
- A
-
絶対シンボル
- B
-
bss ( 初期化されていないデータスペース ) シンボル
- C
-
COMMON シンボル
- D
-
データオブジェクトシンボル
- F
-
ファイルシンボル
- N
-
タイプのないシンボル
- L
-
スレッドローカル記憶領域シンボル
- S
-
セクションシンボル
- T
-
テキストシンボル
- U
-
未定義
シンボルのバインディング属性の意味は次のとおりです。
- LOCAL
-
このキー文字は小文字
- WEAK
-
このキー文字は大文字。また -l 修飾子が指定されていると、大文字のキー文字の後に * が付加される
- GLOBAL
-
このキー文字は大文字
- -P
-
後述の「標準出力」の項で述べるような、 移植性のある出力形式で情報を出力します。
- -r
-
各出力行に、オブジェクトファイルまたは アーカイブ名を付加します。
- -R
-
オブジェクトファイルとシンボル名の前に、 アーカイブ名 (もし存在していれば) を出力します。 -r オプションが同時に指定されている場合には、この -R オプションは無視されます。
- -s
-
セクションインデックスの代わりに セクション名を出力します。
- -tformat
-
個々の数値を指定された形式で出力します。 出力形式は、オプション引数の format により 1 文字で指定します。
- d
-
オフセットを 10 進数で出力 ( デフォルト )
- o
-
オフセットを 8 進数で出力
- x
-
オフセットを 16 進数で出力
- -T
-
後述の「注意事項」を参照してください。
- -u
-
未定義の各シンボルについての一覧を出力します。 後述の「出力」を参照してください。
- -v
-
外部シンボルを、値の順にソートして出力します。
- -V
-
実行した nm コマンドのバージョンを標準エラー出力に書き出します。
- -x
-
シンボルの値とサイズを、10 進数ではなく 16 進数で出力します (-t x と同じ )。
以下のオプションを使って、 nm の出力内容を制御できます。
/usr/ccs/bin/nm
/usr/xpg4/bin/nm
オプションはいくつでも指定できます。 複数個指定する場合その順序は問いません。 また、 コマンド行上のどこに記述しても構いません。 矛盾する組み合せでオプションを指定すると (たとえば -v と -n または、 -o と -x )、最初のオプションが有効となり、 2 番目は無視されて警告メッセージが出力されます (例外は -R オプションを参照)。
オペランド
出力
- Index
-
シンボルのインデックスです (インデックスは大括弧[ ] で囲んで表示されます)。
- Value
-
-
再配置可能ファイル中で定義されている シンボルのセクションオフセット
-
セクションインデックスが SHN_COMMON であるシンボルの境界合わせ上の制約
-
実行可能および動的ライブラリファイル中の仮想アドレス
-
- Size
-
対応するオブジェクトのサイズで、単位はバイトです。
- Type
-
- NOTYPE
-
タイプは指定されていない
- OBJECT
-
配列や変数のようなデータオブジェクト
- FUNC
-
関数あるいは他の実行可能コード
- REGI
-
レジスタシンボル (SPARC の場合のみ)
- SECTION
-
セクションシンボル
- FILE
-
ソースファイル名
- COMMON
-
初期化されていない共通ブロック
- TLS
-
スレッドローカル記憶領域に関連する変数
- Bind
-
シンボルのバインディング属性で、以下のいずれかです。
- LOCAL
-
このシンボルの有効範囲は、 その定義を含んでいるオブジェクトファイルに限定されている
- GLOBAL
-
このシンボルは、結合されている すべてのオブジェクトファイルから見ることができる
- WEAK
-
このシンボルは、実質的にはグローバルシンボルだが、 GLOBAL よりも優先順位は低い
- Other
-
将来の拡張用に予約されているフィールドで、 現在は 0 を含んでいます。
- Shndx
-
シンボル定義のもととなる、 セクションヘッダテーブルインデックスです。 ただし例外として、次の 3 つの値のいずれかが 表示されることがあります。
- ABS
-
シンボルの値は再配置しても変わらないことを表す
- COMMON
-
未割付ブロックを表し、値は境界合わせ用の制約を表す
- UNDEF
-
未定義のシンボルを表す
- Name
-
シンボル名です。
- Object Name
-
-A オプションが指定されているとき、オブジェクトまたはライブラリの 名前を表します。
-
-A が指定されていなければ <library/object name> は空の文字列です。
-
-A が指定され、対応する file オペランドがライブラリ名を示していない場合は、次のようになります。
"%s: ", file
-
-A が指定され、対応する file オペランドがライブラリ名を示している場合には、次のようになります。 なお <object file> は、当該シンボルを含んでいるライブラリのオブジェクトファイル名です。
"%s[%s]: ", file, <object file>
-
対応する file オペランドがライブラリ名を示しているとき ( なお <object file> は、後続のシンボルを含むライブラリ中のファイル名 )
"%s[%s]:\n", file, <object file>
標準出力
各シンボルに関して次の情報を出力します。
-P オプションが指定された場合には、上記の情報が以下に説明する 移植性のある形式で出力されます。この形式には 3 種類あり、 -t d 、 -t o 、 -t x のどれが指定されたかによって使い分けられます。
"%s%s %s %d %d\n", <library/object name>, name, type, value, size "%s%s %s %o %o\n", <library/object name>, name, type, value, size "%s%s %s %x %x\n", <library/object name>, name, type, value, size
このうち <library/object name> は次のような形式です。
-A が省略されたとき、 file オペランドが複数指定されているか、あるいは 1 つだけ指定された file がライブラリを表していれば、 nm は、後続のシンボルを含むオブジェクトを識別する行を、 そのシンボルを含む行の前に出力します。出力形式は次のとおりです。
-P が指定され、 -t が省略された場合には、出力形式は -t x が指定された場合と同一になります。
環境
nm の実行に影響を与える環境変数 LC_COLLATE 、 LC_CTYPE 、 LC_MESSAGES 、 NLSPATH についての詳細は、 environ(5) を参照してください。
終了ステータス
属性
次の属性については attributes(5) のマニュアルページを参照してください。
/usr/ccs/bin/nm
/usr/xpg4/bin/nm
関連項目
注意事項
- -e
-
外部シンボルと静的シンボルだけを出力します。 現在、シンボルテーブルには、この 2 つしか含まれていません。 自動シンボルは、シンボルテーブル内には存在しなくなり、 cc -g で生成されるデバッグ情報に出力されます。 この情報は、 dump(1) を使って検査することができます。
- -f
-
完全な出力を生成します。なお .text や .data などの冗長シンボルは、現在はもう存在していません。 したがってこの完全出力の生成は、 デフォルト出力の生成と同じ意味になります。
- -T
-
デフォルトでは、 nm はシンボルの名前全体を出力します。 シンボル名の出力カラムの位置が最終カラムに移動したので、 オーバフローの心配はなく、 シンボル名を途中で切り捨てる必要はなくなりました。
以下のオプションは、オブジェクトファイルの形式が 変わってしまったため現在ではあまり使用されていません。 将来のリリースで削除されることになります。
名前 | 形式 | 機能説明 | オプション | オペランド | 出力 | 環境 | 終了ステータス | 属性 | /usr/ccs/bin/nm | /usr/xpg4/bin/nm | 関連項目 | 注意事項
- © 2010, Oracle Corporation and/or its affiliates