unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 getconf(1)                                                       getconf(1)




 NAME
      getconf - get system configuration values

 SYNOPSIS
      getconf [-v specification] system_var

      getconf [-v specification] system_var pathname

 DESCRIPTION
      The getconf command provides an interface to the confstr(3C),
      pathconf(2), and sysconf(2) library routines and system calls.

      The system_var argument specifies the configuration value desired in
      confstr(), pathconf(), or sysconf().  Use the first synopsis form, for
      inquiries involving confstr(), or sysconf() (in the first table
      below).  Use the second synopsis form, for inquiries involving
      pathconf() (in the second table below).  For inquiries involving
      pathconf() the pathname operand should be specified.

    Options
      getconf recognizes the following option:

           -v specification  Return configuration variables corresponding to
                             a particular compilation environment supported
                             by HP-UX.  If the -v option is not specified,
                             specification defaults to XBS5_ILP32_OFF32. See
                             table below for possible specifications and
                             meanings.
                               Specification     int    long   pointer   off_t
                             _________________________________________________
                             XBS5_ILP32_OFF32      32     32        32      32
                             XBS5_ILP32_OFFBIG     32     32        32    >=64
                             XBS5_LP64_OFF64       32     64        64      64
                             XBS5_LPBIG_OFFBIG   >=32   >=64      >=64    >=64

 EXTERNAL INFLUENCES
    Environment Variables
      LC_MESSAGES determines the language in which messages are displayed.

      If LC_MESSAGES is not specified in the environment or is set to the
      empty string, the value of LANG is used as a default for each
      unspecified or empty variable.  If LANG is not specified or is set to
      the empty string, a default of "C" (see lang(5)) is used instead of
      LANG.

      If any internationalization variable contains an invalid setting,
      getconf behaves as if all internationalization variables are set to
      "C".  See environ(5).

    International Code Set Support
      Single-byte and multi-byte character code sets are supported.



 Hewlett-Packard Company            - 1 -   HP-UX Release 11i: November 2000






 getconf(1)                                                       getconf(1)




 RETURN VALUE
      The error codes returned by getconf are:

           0    Success.  A value corresponding to the operand was returned.
           1    One or more missing operands.
           2    Operand was not recognized.
           3    pathname either invalid or inaccessible.

 EXAMPLES
      Request the number of intervals per second:

           getconf CLK_TCK

      Request the maximum value of a file's link count:

           getconf LINK_MAX /etc/passwd

      Other supported inquiries include the following:


           ARG_MAX                _BC_BASE_MAX              BC_DIM_MAX
           BS_SCALE_MAX          BC_STRING_MAX             CHARCLASS_NAME_MAX
           CHAR_BIT              CHAR_MAX                  CHAR_MIN
           CHILD_MAX             CLK_TCK                   COLL_WEIGHTS_MAX
           CPU_CHIP_TYPE         CS_MACHINE_IDENT          CS_PARTITION_IDENT
           CS_PATH               CS_MACHINE_SERIAL         EXPR_NEST_MAX
           HW_CPU_SUPP_BITS      HW_32_64_CAPABLE          INT_MAX
           INT_MIN               KERNEL_BITS               LINE_MAX
           LONG_BIT              LONG_MAX                  LONG_MIN
           MACHINE_IDENT         MACHINE_MODEL             MACHINE_SERIAL
           MB_LEN_MAX            NGROUPS_MAX               NL_ARGMAX
           NL_LANGMAX            NL_MSGMAX                 NL_NMAX
           NL_SETMAX             NL_TEXTMAX                NZERO
           OPEN_MAX              PARTITION_IDENT           PATH
           _POSIX_ARG_MAX        _POSIX_JOB_CONTROL        _POSIX_NGROUPS_MAX
           _POSIX_OPEN_MAX       _POSIX_SAVED_IDS          _POSIX_SSIZE_MAX
           _POSIX_STREAM_MAX     _POSIX_TZNAME_MAX         _POSIX_VERSION
           POSIX_ARG_MAX         POSIX_CHILD_MAX           POSIX_JOB_CONTROL
           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
           POSIX_SSIZE_MAX       POSIX_STREAM_MAX          POSIX_TZNAME_MAX
           POSIX_VERSION         POSIX2_BC_BASE_MAX        POSIX2_BC_DIM_MAX
           POSIX2_BC_SCALE_MAX   POSIX2_BC_STRING_MAX      POSIX2_C_BIND
           POSIX2_C_DEV          POSIX2_C_VERSION          POSIX2_CHAR_TERM
           POSIX_CHILD_MAX       POSIX2_COLL_WEIGHTS_MAX   POSIX2_EXPR_NEST_MAX
           POSIX2_FORT_DEV       POSIX2_FORT_RUN           POSIX2_LINE_MAX
           POSIX2_LOCALEDEF      POSIX2_RE_DUP_MAX         POSIX2_SW_DEV
           POSIX2_UPE            POSIX2_VERSION            SC_PASS_MAX
           SC_XOPEN_VERSION      SCHAR_MAX                 SCHAR_MIN
           SHRT_MAX              SHRT_MIN                  SSIZE_MAX



 Hewlett-Packard Company            - 2 -   HP-UX Release 11i: November 2000






 getconf(1)                                                       getconf(1)




           STREAM_MAX            RE_DUP_MAX                TMP_MAX
           TZNAME_MAX            UCHAR_MAX                 UINT_MAX
           ULONG_MAX             USHRT_MAX                 WORD_BIT
           XOPEN_VERSION         XOPEN_XCU_VERSION         XOPEN_XPG2
           XOPEN_XPG3            XOPEN_XPG4
           XBS5_ILP32_OFF32_CFLAGS    XBS5_ILP32_OFF32_LDFLAGS
           XBS5_ILP32_OFF32_LIBS      XBS5_ILP32_OFF32_LINTFLAGS
           XBS5_ILP32_OFFBIG_CFLAGS   XBS5_ILP32_OFFBIG_LDFLAGS
           XBS5_ILP32_OFFBIG_LIBS     XBS5_ILP32_OFFBIG_LINTFLAGS
           XBS5_LP64_OFF64_CFLAGS     XBS5_LP64_OFF64_LDFLAGS
           XBS5_LP64_OFF64_LIBS       XBS5_LP64_OFF64_LINTFLAGS

      Supported inquiries requiring the second parameter include:


           LINK_MAX                  MAX_CANON         MAX_INPUT
           NAME_MAX                  PATH_MAX          PIPE_BUF
           _POSIX_CHOWN_RESTRICTED   _POSIX_LINK_MAX   _POSIX_MAX_CANON
           _POSIX_MAX_INPUT          _POSIX_NO_TRUNC   _POSIX_NAME_MAX
           _POSIX_PATH_MAX           _POSIX_PIPE_BUF   _POSIX_VDISABLE
           POSIX_CHOWN_RESTRICTED    POSIX_NO_TRUNC    POSIX_VDISABLE

 AUTHOR
      getconf was developed by HP and POSIX.

 SEE ALSO
      pathconf(2), sysconf(2), confstr(3C).

 STANDARDS CONFORMANCE
      getconf: POSIX.2, XPG4
























 Hewlett-Packard Company            - 3 -   HP-UX Release 11i: November 2000