CONFSTR

Section: C Library Functions (3)
索引 jman

BSD mandoc

索引

名称

confstr - 文字列値の設定可能変数を得る

索引

ライブラリ

Lb libc

索引

書式

In unistd.h Ft size_t Fn confstr int name char *buf size_t len

索引

解説

Bf -symbolic このインタフェースは、 sysctl(3) によって旧式になっています。 Ef

Fn confstr 関数は、システム構成により定義されている文字列値を、アプリケーションが取得するための方式を提供します。

Fa name 引数は、照会されるシステム変数を指定します。各名前の値となるシンボリック定数は、インクルードファイル Aq Pa unistd.h の中にあります。 Fa len 引数は、引数 Fa buf が参照するバッファのサイズを指定します。 Fa len が 0 でない場合、 Fa buf は NULL ではないポインタで、 Fa name は値を持っており、その値のうち最高 Fa len - 1 バイトがバッファ Fa buf にコピーされます。コピーされた値の末尾は必ずヌル文字です。

利用可能な値は次のとおりです。

_CS_PATH: 全標準ユーティリティを検出する PATH 環境変数の値を返します。

索引

戻り値

Fn confstr の呼び出しが正常に完了しない場合、-1 が返され、該当する errno が設定されます。また変数に、システム構成により定義されている値がない場合 0 が返され、 errno は変更されません。それ以外の場合は、設定定義された値全体を入れるのに必要なバッファサイズが返されます。このサイズが引数 Fa len より大きい場合、 Fa buf 内の文字列は切り捨てられています。

索引