getconf

用途

将系统配置变量值写入标准输出。

语法

getconf [ -v specification ] [ SystemwideConfiguration | PathConfiguration PathName ] [DeviceVariable DeviceName ]

getconf -a

描述

SystemwideConfiguration 参数调用 getconf 命令,将 SystemwideConfiguration 参数所指定的变量值写到标准输出。

PathConfiguration PathName 参数调用 getconf 命令,写入 PathConfiguration 参数为PathName 参数指定路径指定的变量值,到标准输出。

getconf 命令,用 -a 标志调用,并写入全部系统配置变量值到标准输出。

getconf 命令,用 DeviceVariableDeviceName 参数调用,写磁盘设备名或位置的值到标准输出,设备路径由 DeviceName 参数指定。

如果在系统中定义指定的变量且其值描述为可从 confstr 子例程得到,则指定变量的值按下列格式写入:

“%s\n”,< 值 >

否则,如果在系统中定义指定变量,其值按下列格式写入:

“%d\n”, < 值 >

如果指定变量是有效的但在系统中未定义,则将下列内容写入标准输出:

“undefined\n”

如果变量名无效或出现错误,就会有一个诊断消息写入标准错误。

标记

-a 规格 显示了指定规格及版本,其配置变量等待确定。如果该标志未被指定,返回值将响应一个实现缺省值 XBS5 的相应的编辑环境。
-v 将全部系统配置变量值写入标准输出。

参数

PathName PathConfiguration 参数指定路径名。
SystemwideConfiguration 指定一个系统配置变量
PathConfiguration 指定一个系统路径配置变量
DeviceName 指定一个设备路径名。
DeviceVariable 指定一个设备变量。

当列入下列的表格中的第一列符号被用作 system_var 操作数时,getconf 将产生与用第二列的值调用 confstr 时相同的值:

注:
_CS_AIX_ARCHITECTURE_CS_AIX_BOOTDEV 变量,用做 confstr 参数时,只对 root 用户可用。

system_var confstr 名称值
BOOT_DEVICE _CS_AIX_BOOTDEV
MACHINE_ARCHITECHTURE _CS_AIX_ARCHITECTURE
MODEL_CODE _CS_AIX_MODEL_CODE
PATH _CS_PATH
XBS5_ILP32_OFF32_CFLAGS _CS_XBS5_ILP32_OFF32_CFLAGS
XBS5_ILP32_OFF32_LDFLAGS _CS_XBS5_ILP32_OFF32_LDFLAGS
XBS5_ILP32_OFF32_LIBS _CS_XBS5_ILP32_OFF32_LIBS
XBS5_ILP32_OFF32_LINTFLAGS _CS_XBS5_ILP32_OFF32_LINTFLAGS
XBS5_ILP32_OFFBIG_CFLAGS _CS_XBS5_ILP32_OFFBIG_CFLAGS
XBS5_ILP32_OFFBIG_LDFLAGS _CS_XBS5_ILP32_OFFBIG_LDFLAGS
XBS5_ILP32_OFFBIG_LIBS _CS_XBS5_ILP32_OFFBIG_LIBS
XBS5_ILP32_OFFBIG_LINTFLAGS _CS_XBS5_ILPBIG_OFF32_LINTFLAGS
XBS5_LP64_OFF64_CFLAGS _CS_XBS5_LP64_OFF64_CFLAGS
XBS5_LP64_OFF64_LDFLAGS _CS_XBS5_LP64_OFF64_LDFLAGS
XBS5_LP64_OFF64_LIBS _CS_XBS5_LP64_OFF64_LIBS
XBS5_LP64_OFF64_LINTFLAGS _CS_XBS5_LP64_OFF64_LINTFLAGS
XBS5_LPBIG_OFFBIG_CFLAGS _CS_XBS5_LPBIG_OFFBIG_CFLAGS
XBS5_LPBIG_OFFBIG_LDFLAGS _CS_XBS5_LPBIG_OFFBIG_LDFLAGS
XBS5_LPBIG_OFFBIG_LIBS _CS_XBS5_LPBIG_OFFBIG_LIBS
XBS5_LPBIG_OFFBIG_LINTFLAGS _CS_XBS5_LPBIG_OFFBIG_LINTFLAGS

环境变量

下列的环境变量影响 getconf的执行:

LANG 为取消设置或空的国际化变量值提供一个缺省值。如果 LANG 被取消设置或空,则将使用来自依赖实现的 | 缺省语言环境的相应值。如果任何一个国际化变量包含一个无效设置,实用程序将象未定义变量义变量来运行。
LC_CALL 如果设置为一个非空字符串值,则所有其它国际化变量值会被覆盖。
LC_CTYPE 确定将文本数据字节序列解释为字符的语言环境(例如,在参数中,单字节字符与多字节字符相对)。
LC_MESSAGES 确定用以影响写入标准错误的诊断消息格式和内容的语言环境。
NLSPATH 决定处理 LC_MESSAGES 消息目录的位置。

系统范围配置变量

SystemwideConfiguration 参数指定系统配置变量,其值在整个系统中都可用。有两种系统配置变量:

系统范围配置变量

系统范围配置变量包含系统各部分中的最小值。下列的列表定义系统范围配置变量,这些变量与getconf 命令一起使用:

_CS_PATH PATH 环境变量值,用以查找命令。
ARG_MAX 用于一个 exec 子例程的参数的最大长度(以字节为单位),包含环境数据。
BC_BASE_MAX bc 命令使用的 obase 变量允许的最大值。
BC_DIM_MAX bc 命令所允许的一个数组中的最大元素数。
BC_SCALE_MAX bc 命令使用的 scale 变量允许的最大值。
BC_STRING_MAX bc 命令可接受的字符串常量的最大长度。
CHARCLASS_NAME_MAX 字符类名中的最大字节数。
CHAR_BIT 类型 character 的位数。
CHAR_MAX 类型 character 的最大值。
CHAR_MIN 类型 character 的最小值。
CHILD_MAX 每个真实用户标识同时打开进程的最大数量。
CLK_TCK time 子例程返回的每秒钟时钟计数。
COLL_WEIGHTS_MAX 配给在一个语言环境定义文件的 LC_COLLATE 语言环境节中条目的最大权重。
CS_PATH PATH 环境变量值,用以查找命令。
EXPR_NEST_MAX 圆括号内可嵌套的最大表达式数,用于 expr 命令。
INT_MAX 类型的最大值,类型为 int
INT_MIN 类型的最小值,类型为 int
LINE_MAX 当实用程序被描述成为处理文本文件时,命令输入行(标准输入或者是其它文件)的最大长度(以字节为单位)。长度包含换行字符的空间。
LONG_BIT 类型中的位数,类型为 long int
LONG_MAX 类型的最大值,类型为 long int
LONG_MIN 类型的最小值,类型为 long int
MB_LEN_MAX 在所有支持的语言环境中一个字符的最大字节数。
NGROUPS_MAX 每个进程中同时补充的最大组标识数。
NL_ARGMAX printfscanf 子例程调用中的数字最大值。
NL_LANGMAX 在一个 LANG 名中最大字节数。
NL_MSGMAX 最大消息数。
NL_NMAX 一个从 N 到 1 整序映射中最大字节数。
NL_SETMAX 最大设置数。
NL_TEXTMAX 一个消息字符串中最大字节数。
NZERO 缺省进程优先级。
OPEN_MAX 在进程中可同时打开的最大文件数。
PATH 用以查找命令的以冒号相隔的路径前缀的序列。
RE_DUP_MAX 当使用间隔符号参数时允许正则表达式重复出现次数的最大值,正如ed 命令使用的 mn 参数。
SCHAR_MAX 类型的最大值,类型为 signed char
SCHAR_MIN 类型的最小值,类型为 signed char
SHRT_MAX 类型的最大值,类型为 short
SHRT_MIN 类型的最小值,类型为 short
SSIZE_MAX 一个类型为 ssize_t 的对象的最大值。
STREAM_MAX 一个进程可同时打开的流数。
TMP_MAX tmpnam 子例程生成的唯一路径名的最小数量。一个应用程序可靠调用 tmpnam 子例程的最多次数。
TZNAME_MAX 一个时区名支持的最大字节数(非 TZ 环境变量的长度)。
UCHAR_MAX 类型的最大值,类型为 unsigned char
UINT_MAX 类型的最大值,类型为 unsigned int
ULONG_MAX 类型的最大值,类型为 unsigned long int
USHRT_MAX 类型的最大值,类型为 unsigned short int
WORD_BIT 字或类型 int 中的位数。
KERNEL_BITMODE 内核的位方式,32 位或 64 位.
REAL_MEMORY 真实内存大小。
HARDWARE_BITMODE 计算机硬件的位方式,32 位或 64 位。
MP_CAPABLE 计算机微处理器容量。

系统标准配置变量

系统标准配置变量包含由一个特殊系统标准所要求的最小值。_POSIX_POSIX2__XOPEN_ 前缀显示变量包含分别由 POSIX 1003.1、POSIX 1003.2 和 X/Open 系统标准要求的系统特性最小值。系统标准是系统满足的用来支持特定系统标准的全系统最小值。实际配置值可能超出这些标准。用于getconf 命令的这些系统标准配置变量的定义如下:

_POSIX_ARG_MAX 用于 exec 子例程的参数的最大长度(以字节为长度),包含环境数据。
_POSIX_CHILD_MAX 每个真实用户标识同时打开进程的最大数量。
_POSIX_JOB_CONTROL 如果系统支持作业控制,则值为 1。
_POSIX_LINK_MAX 到单个文件的最大链接数。
_POSIX_MAX_CANON 在终端规范输入队列中的最大字节数。
_POSIX_MAX_INPUT 在终端输入队列中允许的最大字节数。
_POSIX_NAME_MAX 文件名中的最大字节数(不包含终止空字符)。
_POSIX_NGROUPS_MAX 每个进程中同时补充的最大组标识数。
_POSIX_OPEN_MAX 在进程中可同时打开的最大文件数。
_POSIX_PATH_MAX 路径名中的最大字节数。
_POSIX_PIPE_BUF 写入管道时保证成为原子的最大字节数。
_POSIX_SAVED_IDS 值为1。每个进程具有保存的 set-user-ID 和保存的 set-group-ID。
_POSIX_SSIZE_MAX 可存进一个类型为 ssize_t 对象的最大值。
_POSIX_STREAM_MAX 一个进程可同时打开的流数。
_POSIX_TZNAME_MAX 一个时区名支持的最大字节数(非 TZ 环境变量的长度)。
_POSIX_VERSION 操作系统遵守的 POSIX 1 标准(C 语言绑定)的版本。
_XOPEN_CRYPT 如果系统支持 X/Open 加密功能组则值为 1。
_XOPEN_ENH_I18N 如果系统支持 X/Open 增强国际化功能组则值为 1。
_XOPEN_SHM 如果系统支持 X/Open 共享内存功能组则值为 1。
_XOPEN_VERSION 操作系统所遵守的 X/Open 可移植性指南的版本。
_XOPEN_XCU_VERSION 操作系统所遵守的 X/Open 命令和实用程序规范的版本。
_XOPEN_XPG2 如果系统支持 1987 年 1 月卷 2 的 X/Open 可移植性指南,XVS 系统调用和库,则值为 1,否则为未定义。
_XOPEN_XPG3 如果系统支持 1992 年 2 月 的 X/Open 规范,系统接口和头第三版,则缺省值为 1,否则为未定义。
_XOPEN_XPG4 如果系统支持 1992 年 7 月 的 X/Open CAE 规范,系统接口和头第 4 版,则值为 1,否则为未定义。
POSIX2_BC_BASE_MAX 允许的最大值,用于 obase 变量并使用 bc 命令。
POSIX2_BC_DIM_MAX bc 命令允许数组中的最大元素数。
POSIX2_BC_SCALE_MAX 允许的最大值,用于 scale 变量,执行 bc 命令。
POSIX2_BC_STRING_MAX 可被 bc 命令接受的字符串常量的最大长度。
POSIX2_CHAR_TERM 系统支持至少一个终端类型则值为 1;否则值为 -1。
POSIX2_COLL_WEIGHTS_MAX 配给一个条目的最大权重数目,条目在一个语言环境定义文件中的 LC_COLLATE 语言环境变量中。
POSIX2_C_BIND 如果系统支持 POSIX 2 中的 C 语言绑定选项,则值为 1;否则,值为-1。
POSIX2_C_DEV 如果系统支持 POSIX 2 中的 C 语言开发实用程序则值为 1;否则,值为 -1。
POSIX2_C_VERSION 操作系统所遵守的 POSIX 2 标准(C 语言绑定)的版本。
POSIX2_EXPR_NEST_MAX 圆括号内可嵌套的最大表达式数,用于 expr 命令。
POSIX2_FORT_DEV 如果系统支持 POSIX 2 中的 FORTRAN 开发实用程序选项则值为 1;否则,值为 -1。
POSIX2_FORT_RUN 如果系统支持 POSIX 2 中的 FORTRAN 运行时实用程序选项则值为 1;否则,值为 -1。
POSIX2_LINE_MAX 当命令被描述成处理文本文件时,一个命令输入行(标准输入或其他文件)的最大字节长度。长度包含换行字符空间。
POSIX2_LOCALEDEF 如果系统支持由 localedef 命令创建语言环境,则值为 1;否则值未定义。
POSIX2_RE_DUP_MAX 当使用间隔计数参数时正则表达式所允许重复出现的最大值,例如带 mn 参数使用 ed 命令。
POSIX2_SW_DEV 系统支持软件开发实用程序选项则值为 1;否则,值为 -1。
POSIX2_UPE 如果系统支持 POSIX 2 中用户可移植实用程序选项,则值为 1;否则,值为 -1。
POSIX2_VERSION 系统支持的 POSIX 2 标准的最新版本的批准日期。这个日期是一个六位数字,前四位数字表示年份后两位数字表示月份。POSIX 2 标准的不同版本由 IEEE 标准委员会定期批准,批准日期用于区分不同版本。

系统路径配置变量

PathConfiguration 参数指定了系统路径配置变量,该变量值包含在系统中的路径和路径结构信息。下列的列表定义了这些变量:

_POSIX_CHOWN_RESTRICTED chown() 子例程以适当的特权限制在进程,并且将文件的组标识只更改为进程的有效组标识或辅助组标识之一。如果PathName 参数引用目录,其返回值应用于除在目录中已存在的或可被创建的目录外的所有文件。
_POSIX_NO_TRUNC 路径名长于变量 NAME_MAX 指定的限定值就会产生错误。如果PathName 参数引用目录,其返回值应用于目录中的文件名。
_POSIX_VDISABLE 终端特殊字符,定义在 termios.h 文件中,可使用这一字符值禁用。
LINK_MAX 链接一个文件的最大链接数。如果 PathName 参数引用目录,则返回值应用于该目录。
MAX_CANON 在终端规范输入行中的最大字节数。
MAX_INPUT 在终端输入队列有可用空间的最大字节数。
NAME_MAX 文件名中的最大字节数(不包含终止空字符)。如果PathName 参数引用目录,返回值应用于目录内的文件名。
PATH_MAX 路径名中的最大字节数,包含终止空字符。如果 PathName 参数引用目录,返回值为当指定目录是工作目录时的相对路径名的最大长度。
PIPE_BUF 当写入管道时保证成为原子的最大字节数。如果这个PathName 参数指向先进先出或是管道,其返回值应用于引用对象。如果 PathName 参数引用目录,返回值应用于任何已存在的或可在目录内创建的先进先出。
DISK_PARTITION 磁盘的物理分区大小。

注:
对于 DISK_PARTITION 路径配置变量,这个 PathName 参数必须指定为之查询信息的磁盘的完整路径。
DISK_SIZE 磁盘大小以兆字节为单位。

注:
对于 DISK_SIZE 路径配置变量,这个 PathName 参数必须指定为之查询信息的磁盘的完整路径。

设备变量

DeviceVariable 参数显示了这个 DeviceName 参数是一个设备路径,例如 /dev/hdisk0。给定一个磁盘的路径,则这个 getconf 命令显示这个磁盘的设备名或位置。

DISK_DEVNAME 设备名或设备位置。

退出状态

此命令返回下列出口值:

0 这个指定变量是有效的并且其当前状态的信息已被成功写入。
>0 发生错误。
  1. 显示变量 ARG_MAX 的值,请输入:
    getconf ARG_MAX
  2. 显示所有系统配值变量值,输入:
     getconf -a
  3. 显示变量 NAME_MAX 的值,用于 /usr 目录,请输入:
     
    getconf NAME_MAX /usr
  4. 下列 shell 命令显示怎样处理未指定结果:
    if value=$(getconf PATH_MAX /usr)
         then     if [ "$value" = "undefined" ]
         then
                    echo 
                         The value of PATH_MAX in /usr is undefined.
         else
    
                         The value of PATH_MAX in /usr is $value.
         fi
    else
                    echo 
                         Error in the getconf command.
    fi

示例

  1. 显示变量 ARG_MAX 的值,请输入:
    getconf ARG_MAX
  2. 显示变量 NAME_MAX 的值,用于 /usr 目录,请输入:
    getconf NAME_MAX /usr
  3. 下列 shell 命令显示怎样处理未指定结果:
    if value=$(getconf PATH_MAX /usr)
    then     if [ "$value" = "undefined" ]
         then
                 echo 
                       The value of PATH_MAX in /usr is undefined.
         else
                 echo 
                       The value of PATH_MAX in /usr is $value.
         fi
    else
         echo Error in the getconf command.
    fi
  4. 如果命令:
    getconf _XBS5_ILP32_OFF32

    没有写入 -1\nundefined\n 到标准输出,那么表单命令:

    getconf -v XBS5_ILP32_OFF32 ...

    将确定相应于 XBS5_ILP32_OFF32 编译环境的配置变量值。编译环境指定于 c89,扩展描述。

  5. 如果命令:
    getconf _XBS5_ILP32_OFFBIG

    没有写入 -1\nundefined\n 到标准输出,那么表单命令:

    getconf -v XBS5_ILP32_OFFBIG ...

    将确定相应于 XBS5_ILP32_OFFBIG 编译环境的配置变量值,编译环境值指定于 c89,扩展描述。

  6. 如果命令:
    getconf _XBS5_LP64_OFF64

    没有写入 -1\nundefined\n 到标准输出,那么表单命令:

    getconf -v XBS5_LP64_OFF64 ...

    将确定相应于 XBS5_LP64_OFF64 编译环境的配置变量值,编译环境值指定于 c89,扩展描述。

  7. 如果命令:
    getconf _XBS5_LPBIG_OFFBIG

    没有写入 -1\nundefined\n 到标准输出,那么如下形式的命令:

    getconf -v _XBS5_LPBIG_OFFBIG

    将确定相应于在 c89,扩展描述中指定的 XBS5_LPBIG_OFFBIG 编译环境的配值变量值。

  8. 确定磁盘 hdisk0 大小,若是 root 用户,则输入下列:
    getconf DISK_SIZE /dev/hdisk0
  9. 确定实际内存大小,输入下列:
    getconf REAL_MEMORY
  10. 确定是否机器硬件是 32 位或 64 位,则输入下列:
    getconf HARDWARE_BITMODE
  11. 确定是否内核是 32 位或 64 位,则输入下列:
    getconf KERNEL_BITMODE
  12. 确定磁盘 hdisk0 的设备名或位置,则输入下列:
    getconf DEVICE_NAME /dev/hdisk0

文件

/usr/bin/getconf 包含一个 getconf 命令。
/usr/include/limits.h 定义系统配置变量。
/usr/include/unistd.h 定义系统配置变量。

请支持IPCMEN!

微信捐赠 支付宝捐赠
微信捐赠 支付宝捐赠