getconf(1)
名前
getconf - 構成値の取得
形式
/usr/bin/getconf [-v specification] system_var
/usr/bin/getconf [-v specification] path_var pathname
/usr/bin/getconf -a
/usr/xpg4/bin/getconf [-v specification] system_var
/usr/xpg4/bin/getconf [-v specification] path_var pathname
/usr/xpg4/bin/getconf -a
/usr/xpg6/bin/getconf [-v specification] system_var
/usr/xpg6/bin/getconf [-v specification] path_var pathname
/usr/xpg6/bin/getconf -a
説明
第 1 形式では、getconf ユーティリティーは、–v オプションが使用されている場合は specification に従って、system_var によって指定された変数の値を標準出力に書き込みます。
第 2 形式では、getconf は、–v オプションが使用されている場合は specification に従って、pathname によって指定されたパスの path_var によって指定された変数の値を標準出力に書き込みます。
第 3 形式では、config は現在のシステム構成変数の名前を標準出力に書き込みます。
各構成変数の値は、取得可能と定義されている関数を呼び出して取得した場合のように判別されます。値には現在のオペレーティング環境の状態が反映されます。
オプション
サポートしているオプションは、次のとおりです。
- –a
現在のシステム構成変数の名前を標準出力に書き込みます。
- –v specification
構成変数の値の選択を制御する内容を指定します。
オペランド
次のオペランドがサポートされています。
- path_var
値を pathconf(2) 関数で取得できる構成変数の名前。次の表のすべての値がサポートされています。
LINK_MAX
|
NAME_MAX
|
_POSIX_CHOWN_RESTRICTED
|
MAX_CANON
|
PATH_MAX
|
_POSIX_NO_TRUNC
|
MAX_INPUT
|
PIPE_BUF
|
_POSIX_VDISABLE
|
|
- pathname
path_var によって指定された変数が判別されるパス名。
- system_var
値を confstr(3C) または sysconf(3C) で取得できる構成変数の名前。次の表のすべての値がサポートされています。
ARG_MAX
|
BC_BASE_MAX
|
BC_DIM_MAX
|
BC_SCALE_MAX
|
BC_STRING_MAX
|
CHAR_BIT
|
CHARCLASS_NAME_MAX
|
CHAR_MAX
|
CHAR_MIN
|
CHILD_MAX
|
CLK_TCK
|
COLL_WEIGHTS_MAX
|
CS_PATH
|
EXPR_NEST_MAX
|
HOST_NAME_MAX
|
INT_MAX
|
INT_MIN
|
LFS64_CFLAGS
|
LFS64_LDFLAGS
|
LFS64_LIBS
|
LFS64_LINTFLAGS
|
LFS_CFLAGS
|
LFS_LDFLAGS
|
LFS_LIBS
|
LFS_LINTFLAGS
|
LINE_MAX
|
LONG_BIT
|
LONG_MAX
|
LONG_MIN
|
MB_LEN_MAX
|
NGROUPS_MAX
|
NL_ARGMAX
|
NL_LANGMAX
|
NL_MSGMAX
|
NL_NMAX
|
NL_SETMAX
|
NL_TEXTMAX
|
NZERO
|
OPEN_MAX
|
POSIX2_BC_BASE_MAX
|
POSIX2_BC_DIM_MAX
|
POSIX2_BC_SCALE_MAX
|
POSIX2_BC_STRING_MAX
|
POSIX2_C_BIND
|
POSIX2_C_DEV
|
POSIX2_CHAR_TERM
|
POSIX2_COLL_WEIGHTS_MAX
|
POSIX2_C_VERSION
|
POSIX2_EXPR_NEST_MAX
|
POSIX2_FORT_DEV
|
POSIX2_FORT_RUN
|
POSIX2_LINE_MAX
|
POSIX2_LOCALEDEF
|
POSIX2_RE_DUP_MAX
|
POSIX2_SW_DEV
|
POSIX2_SYMLINKS
|
POSIX2_UPE
|
POSIX2_VERSION
|
POSIX_ALLOC_SIZE_MIN
|
POSIX_REC_INCR_XFER_SIZE
|
POSIX_REC_MAX_XFER_SIZE
|
POSIX_REC_MIN_XFER_SIZE
|
POSIX_REC_XFER_ALIGN
|
POSIX_V6_ILP32_OFF32
|
POSIX_V6_ILP32_OFF32_CFLAGS
|
POSIX_V6_ILP32_OFF32_LDFLAGS
|
POSIX_V6_ILP32_OFF32_LIBS
|
POSIX_V6_ILP32_OFFBIG
|
POSIX_V6_ILP32_OFFBIG_CFLAGS
|
POSIX_V6_ILP32_OFFBIG_LDFLAGS
|
POSIX_V6_ILP32_OFFBIG_LIBS
|
POSIX_V6_LP64_OFF64
|
POSIX_V6_LP64_OFF64_CFLAGS
|
POSIX_V6_LP64_OFF64_LDFLAGS
|
POSIX_V6_LP64_OFF64_LIBS
|
POSIX_V6_LPBIG_OFFBIG
|
POSIX_V6_LPBIG_OFFBIG_CFLAGS
|
POSIX_V6_LPBIG_OFFBIG_LDFLAGS
|
POSIX_V6_LPBIG_OFFBIG_LIBS
|
POSIX_V6_WIDTH_RESTRICTED_ENVS
|
SYMLINK_MAX
|
SYMLOOP_MAX
|
_POSIX2_BC_BASE_MAX
|
_POSIX2_BC_DIM_MAX
|
_POSIX2_BC_SCALE_MAX
|
_POSIX2_BC_STRING_MAX
|
_POSIX2_CHARCLASS_NAME_MAX
|
_POSIX2_CHAR_TERM
|
_POSIX2_COLL_WEIGHTS_MAX
|
_POSIX2_C_BIND
|
_POSIX2_C_DEV
|
_POSIX2_C_VERSION
|
_POSIX2_EXPR_NEST_MAX
|
_POSIX2_FORT_DEV
|
_POSIX2_FORT_RUN
|
_POSIX2_LINE_MAX
|
_POSIX2_LOCALEDEF
|
_POSIX2_PBS
|
_POSIX2_PBS_ACCOUNTING
|
_POSIX2_PBS_CHECKPOINT
|
_POSIX2_PBS_LOCATE
|
_POSIX2_PBS_MESSAGE
|
_POSIX2_PBS_TRACK
|
_POSIX2_RE_DUP_MAX
|
_POSIX2_SW_DEV
|
_POSIX2_UPE
|
_POSIX2_VERSION
|
_POSIX_ADVISORY_INFO
|
_POSIX_AIO_LISTIO_MAX
|
_POSIX_AIO_MAX
|
_POSIX_ARG_MAX
|
_POSIX_ASYNC_IO
|
_POSIX_BARRIERS
|
_POSIX_CHILD_MAX
|
_POSIX_CLOCKRES_MIN
|
_POSIX_CLOCK_SELECTION
|
_POSIX_CPUTIME
|
_POSIX_DELAYTIMER_MAX
|
_POSIX_HOST_NAME_MAX
|
_POSIX_IPV6
|
_POSIX_JOB_CONTROL
|
_POSIX_LINK_MAX
|
_POSIX_LOGIN_NAME_MAX
|
_POSIX_MAX_CANON
|
_POSIX_MAX_INPUT
|
_POSIX_MONOTONIC_CLOCK
|
_POSIX_MQ_OPEN_MAX
|
_POSIX_MQ_PRIO_MAX
|
_POSIX_NAME_MAX
|
_POSIX_NGROUPS_MAX
|
_POSIX_OPEN_MAX
|
_POSIX_PATH_MAX
|
_POSIX_PIPE_BUF
|
_POSIX_PRIO_IO
|
_POSIX_RAW_SOCKETS
|
_POSIX_READER_WRITER_LOCKS
|
_POSIX_REGEXP
|
_POSIX_RE_DUP_MAX
|
_POSIX_RTSIG_MAX
|
_POSIX_SAVED_IDS
|
_POSIX_SEM_NSEMS_MAX
|
_POSIX_SEM_VALUE_MAX
|
_POSIX_SHELL
|
_POSIX_SIGQUEUE_MAX
|
_POSIX_SPAWN
|
_POSIX_SPIN_LOCKS
|
_POSIX_SPORADIC_SERVER
|
_POSIX_SSIZE_MAX
|
_POSIX_SS_REPL_MAX
|
_POSIX_STREAM_MAX
|
_POSIX_SYMLINK_MAX
|
_POSIX_SYMLOOP_MAX
|
_POSIX_SYNC_IO
|
_POSIX_THREAD_ATTR_STACKADDR
|
_POSIX_THREAD_ATTR_STACKSIZE
|
_POSIX_THREAD_CPUTIME
|
_POSIX_THREAD_DESTRUCTOR_ITERATIONS
|
_POSIX_THREAD_KEYS_MAX
|
_POSIX_THREAD_PRIORITY_SCHEDULING
|
_POSIX_THREAD_PRIO_INHERIT
|
_POSIX_THREAD_PRIO_PROTECT
|
_POSIX_THREAD_PROCESS_SHARED
|
_POSIX_THREAD_SAFE_FUNCTIONS
|
_POSIX_THREAD_SPORADIC_SERVER
|
_POSIX_THREAD_THREADS_MAX
|
_POSIX_TIMEOUTS
|
_POSIX_TIMER_MAX
|
_POSIX_TRA_POSIX_TIMER_MAXCE
|
_POSIX_TIMESTAMP_RESOLUTION
|
|
_POSIX_TRACE_EVENT_FILTER
|
_POSIX_TRACE_EVENT_NAME_MAX
|
_POSIX_TRACE_INHERIT
|
_POSIX_TRACE_LOG
|
_POSIX_TRACE_NAME_MAX
|
_POSIX_TRACE_SYS_MAX
|
_POSIX_TRACE_USER_EVENT_MAX
|
_POSIX_TTY_NAME_MAX
|
_POSIX_TYPED_MEMORY_OBJECTS
|
_POSIX_TZNAME_MAX
|
_POSIX_VERSION
|
_POSIX_V6_ILP32_OFF32
|
_POSIX_V6_ILP32_OFFBIG
|
_POSIX_V6_LP64_OFF64
|
_POSIX_V6_LPBIG_OFFBIG
|
_V6_ILP32_OFF32
|
_V6_ILP32_OFFBIG
|
_V6_LP64_OFF64
|
_V6_LPBIG_OFFBIG
|
RE_DUP_MAX
|
SCHAR_MAX
|
SCHAR_MIN
|
SHRT_MAX
|
SHRT_MIN
|
SSIZE_MAX
|
STREAM_MAX
|
TMP_MAX
|
TZNAME_MAX
|
UCHAR_MAX
|
UINT_MAX
|
ULONG_MAX
|
USHRT_MAX
|
WORD_BIT
|
XBS5_ILP32_OFF32
|
XBS5_ILP32_OFF32_CFLAGS
|
XBS5_ILP32_OFF32_LDFLAGS
|
XBS5_ILP32_OFF32_LIBS
|
XBS5_ILP32_OFF32_LINTFLAGS
|
XBS5_ILP32_OFFBIG
|
XBS5_ILP32_OFFBIG_CFLAGS
|
XBS5_ILP32_OFFBIG_LDFLAGS
|
XBS5_ILP32_OFFBIG_LIBS
|
XBS5_ILP32_OFFBIG_LINTFLAGS
|
XBS5_LP64_OFF64
|
XBS5_LP64_OFF64_CFLAGS
|
XBS5_LP64_OFF64_LDFLAGS
|
XBS5_LP64_OFF64_LIBS
|
XBS5_LP64_OFF64_LINTFLAGS
|
XBS5_LPBIG_OFFBIG
|
XBS5_LPBIG_OFFBIG_CFLAGS
|
XBS5_LPBIG_OFFBIG_LDFLAGS
|
XBS5_LPBIG_OFFBIG_LIBS
|
XBS5_LPBIG_OFFBIG_LINTFLAGS
|
_XOPEN_CRYPT
|
_XOPEN_ENH_I18N
|
_XOPEN_IOV_MAX
|
_XOPEN_LEGACY
|
_XOPEN_NAME_MAX
|
_XOPEN_PATH_MAX
|
_XOPEN_SHM
|
_XOPEN_STREAMS
|
_XOPEN_VERSION
|
_XOPEN_XCU_VERSION
|
_XOPEN_XPG2
|
_XOPEN_XPG3
|
_XOPEN_XPG4
|
|
シンボル PATH も認識され、confstr() の名前値 CS_PATH と同じ値が得られます。
使用法
2G バイト (231 バイト) 以上のファイルを処理するときの /usr/bin/getconf の動作については、largefile(5) を参照してください。
例
使用例 1 変数の値の書き込み
この例では、{NGROUPS_MAX}: の値を表示しています。
example% getconf NGROUPS_MAX
使用例 2 特定のディレクトリの変数の値の書き込み
この例では、特定のディレクトリの NAME_MAX の値を表示しています。
example% getconf NAME_MAX /usr
使用例 3 不確定な結果への対応
この例は、不確定である可能性のある結果を慎重に処理する方法を示しています。
if value=$(getconf PATH_MAX /usr); then
if [ "$value" = "undefined" ]; then
echo PATH_MAX in /usr is infinite.
else
echo PATH_MAX in /usr is $value.
fi
else
echo Error in getconf.
fi
例:
sysconf(_SC_POSIX_C_BIND);
および
system("getconf POSIX2_C_BIND");
は、C プログラムでは異なる結果となる可能性があります。sysconf の呼び出しでは、実装によっては、プログラムがコンパイルまたは実行されたときの状態に対応する値が返されます。getconf への system の呼び出しでは、プログラムが実行されたときの状態に対応する値が常に返されます。
環境変数
getconf の実行に影響する環境変数 (LANG、LC_ALL、LC_CTYPE、LC_MESSAGES、および NLSPATH) については、environ(5) を参照してください。
終了ステータス
次の終了ステータスが返されます。
- 0
指定された変数は有効であり、現在の状態に関する情報が正常に書き込まれました。
- >0
エラーが発生した。
属性
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
|
使用条件
|
system/core-os
|
インタフェースの安定性
|
確実
|
標準
|
|
|
関連項目
sh(1)、pathconf(2)、sysinfo(2)、confstr(3C)、sysconf(3C)、attributes(5)、environ(5)、largefile(5)、standards(5)