SYSCONF
Section: C Library Functions (3)
索引
jman
BSD mandoc
索引
名称
sysconf
- コンフィギュレーション可能なシステム変数を取得
索引
ライブラリ
Lb libc
索引
書式
In unistd.h
Ft long
Fn sysconf int name
索引
解説
このインタフェースは、
St -p1003.1-88
により定義されたものです。
sysctl(3)
を使えば、さらに一層完全なインタフェースを使用することができます。
Fn sysconf
関数は、
コンフィギュレーション可能なシステムの制限 (system limit)
またはオプション変数の現在の値を、
アプリケーションが調べるための方法を提供します。
引数
Fa name
は、照会するシステム変数を指定します。
それぞれの名前の値に対応するシンボリック定数は、
インクルードファイル
Aq Pa unistd.h
の中にあります。
使用できる値は次の通りです:
- _SC_ARG_MAX
-
execve(2)
の引数の最大バイト数。
- _SC_CHILD_MAX
-
1 ユーザ ID あたりの同時プロセスの最大数。
- _SC_CLK_TCK
-
1 秒あたりの tick 数で表した統計クロック (statistics clock) の頻度。
- _SC_NGROUPS_Max
-
追加可能なグループの最大数。
- _SC_OPEN_MAX
-
1 ユーザ ID 当たりのオープン可能なファイルの最大数。
- _SC_STREAM_MAX
-
1 つのプロセスが一度にオープンできるストリームの最大数の最小値。
- _SC_TZNAME_MAX
-
時間帯 (timezone) の名前としてサポートされるタイプの最大数の最小値。
- _SC_JOB_CONTROL
-
このシステムでジョブ制御が利用できるなら 1 を返し、
利用できない場合は -1 を返します。
- _SC_SAVED_IDS
-
保存された set-group および保存された set-user ID が
利用できる場合は 1 を返し、そうでない場合は -1 を返します。
- _SC_VERSION
-
システムが準拠しようと試みる
St -p1003.1
のバージョン。
- _SC_BC_BASE_MAX
-
bc(1)
ユーティリティにおける ibase/obase の最大値。
- _SC_BC_DIM_MAX
-
bc(1)
ユーティリティにおける最大配列サイズ。
- _SC_BC_SCALE_MAX
-
bc(1)
ユーティリティにおける最大スケール値。
- _SC_BC_STRING_MAX
-
bc(1)
ユーティリティにおける最大ストリング長。
- _SC_COLL_WEIGHTS_MAX
-
ロケール定義ファイルにおける LC_COLLATE 順序キーボードのエントリに
割り当てることができる重みの最大数。
- _SC_EXPR_NEST_MAX
-
expr(1)
ユーティリティでの括弧でネストできる式の最大数。
- _SC_LINE_MAX
-
テキスト処理ユーティリティの入力ラインのバイトで表した最大長さ。
- _SC_RE_DUP_MAX
-
インターバル表記を使うときに許される正規表現の繰り返し発生回数の最大数。
- _SC_2_VERSION
-
システムが準拠することを試みる
St -p1003.2
のバージョン。
- _SC_2_C_BIND
-
システムの C 言語開発ファシリティで
C 言語構築オプション (C-Language Bindings Option) が
サポートされていれば 1 を返し、
サポートされていなければ -1 を返します。
- _SC_2_C_DEV
-
C 言語開発ユーティリティオプション
(C-Language Development Utilities Option) が
サポートされていれば 1 を返し、
サポートされていなければ-1 を返します。
- _SC_2_CHAR_TERM
-
St -p1003.2
に記述されている全操作が可能な端末タイプが、
最低 1 つサポートされていれば 1 を返し、
そうでなければ -1 を返します。
- _SC_2_FORT_DEV
-
FORTRAN 開発ユーティリティオプション
(FORTRAN Development Utilities Option) が
サポートされていれば 1 を返し、
サポートされていなければ -1 を返します。
- _SC_2_FORT_RUN
-
FORTRAN ランタイムユーティリティオプション
(FORTRAN Runtime Utilities Option) が
サポートされていれば 1 を返し、
サポートされていなければ -1 を返します。
- _SC_2_LOCALEDEF
-
ロケールの作成がサポートしていれば 1 を返し、
サポートされていなければ -1 を返します。
- _SC_2_SW_DEV
-
ソフトウェア開発ユーティリティオプション
(Software Development Utilities Option) が
サポートされていれば 1 を返し、
サポートされていなければ -1 を返します。
- _SC_2_UPE
-
ユーザポータビリティユーティリティオプション
(User Portability Utilities Option) が
サポートされていれば 1 を返し、
サポートされていなければ -1 を返します。
索引
戻り値
Fn sysconf
の呼び出しが成功しなかったときは -1 が返され、
errno
が適切な値に設定されます。
そうでないときは、
変数がサポートされていない機能に関連づけられていると -1 が返され、
errno
は修正されません。
それ以外の場合は、現在の変数値が返されます。
索引
エラー
Fn sysconf
関数が失敗して、ライブラリ関数
sysctl(3)
について記されているエラーのいずれかに対応した
errno
が設定されることがあります。
さらに、次のようなエラーが報告されることがあります。
- Bq Er EINVAL
-
Fa name
引数の値が無効です。
索引
関連項目
sysctl(3)
索引
バグ
_SC_STREAM_MAX の値は最大値の最小値であり、
ANSI C の FOPEN_MAX と同じであることが要求されているので、
戻り値は極めて小さい誤解を招くような値になります。
索引
規格
Fn sysconf
の返す値が、呼び出したプロセスが生存している間に変化する
可能性があることを除いては、この関数は
St -p1003.1-88
に準拠しています。
索引
歴史
Fn sysconf
関数は、最初
BSD 4.4
に現れました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- バグ
-
- 規格
-
- 歴史
-
Time: 07:07:13 GMT, January 12, 2009