日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
DLADDR(3) FreeBSD ライブラリ関数マニュアル DLADDR(3)
名称
dladdr -- 与えられたアドレスを含んでいる共有オブジェクトを見つける
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <dlfcn.h>
int
dladdr(const void *addr, Dl_info *info);
解説
dladdr() 関数は、アドレス addr を含んでいる共有オブジェクトに関する情報を
動的リンカに問い合わせます。情報は、info によって指定される構造体に返され
ます。構造体は、少なくとも次のメンバが含まれます:
const char *dli_fname アドレスを含んでいる共有オブジェクトのパス名。
void *dli_fbase 共有オブジェクトが呼び出しているプロセスのアド
レス空間にマップされるベースアドレス。
const char *dli_sname addr 以下の値がある最も近い実行時のシンボルの名
前。可能であるとき、シンボル名は、C ソースコー
ドに現れるように返されます。
適切な値があるシンボルが見つからないなら、この
フィールドと dli_saddr の両方は、NULL に設定さ
れます。
void *dli_saddr dli_sname に返されるシンボルの値。
dladdr() 関数は、動的にリンクされたプログラムでだけで利用可能です。
エラー
addr を含んでいるマップされた共有オブジェクトが見つからないなら、dladdr()
は、0 を返します。その場合に、失敗を詳述するメッセージは、dlerror() を呼
び出すことによって検索して取り出すことができます。
成功すれば、0 以外の値が返されます。
関連項目
rtld(1), dlopen(3)
歴史
dladdr() 関数は、Solaris オペレーティングシステムではじめて登場しました。
バグ
この実装は、Solaris の実装とバグに互換性があります。特に、次のバグが存在
します:
• addr が共有ライブラリではなくメインの実行形式にあるなら、dli_fname に
返されるパス名は、正しいくないかもしれません。パス名は、呼び出してい
るプロセスの argv[0] から直接取られます。フルパス名によって指定された
プログラムを実行するとき、ほとんどのシェルは、argv[0] をパス名に設定
します。しかし、これは、シェルの必須でも、オペレーティングシステムに
よっても保証されません。
• addr が形式 &func であるなら、ここで func は、グローバル関数、その値
は、不愉快な驚きであるかもしれません。動的にリンクされたプログラム
で、グローバル関数のアドレスは、関数その自体のエントリポイントではな
く、プログラムのリンクテーブルのエントリを指すと見なされます。これに
よって、ほとんどのグローバル関数は、実際のコードが存在する共有ライブ
ラリではなく、メインの実行形式内で定義されているように見えます。
• 失敗の表示として 0 を返すことは、長年の Unix の伝統に反します。
FreeBSD 11.2 February 5, 1998 FreeBSD 11.2