confstr(3C)															       confstr(3C)

NAME

       confstr() - get string-valued configuration values

SYNOPSIS

DESCRIPTION

       provides a method for applications to get configuration-defined string values.  Its use and purpose are similar to (see sysconf(2)), except
       that it is used where string values rather than numeric values are returned.

       The name parameter can take on the following name values, which are defined in

	      A default value for the
			     environment variable which can be used to locate commands in Section 1 of the and utilities defined  in  the  POSIX.2
			     standard that are currently implemented in the HP-UX operating system.

	      Which kernel is supported on the hardware.  Current values returned include
			     "32", "32/64" or "64".

	      Whether the kernel is 32-bit or 64-bit.  Current values returned include
			     "32" or "64".

	      The hardware model string.

	      Unique identifier for each machine. Returned as an opaque string of
			     printable ASCII characters.  This string has the same value for all partitions in a physical machine.  Refer to for a
			     unique identifier for partitions in a machine.  For hardware classes first released with HP-UX 11i or later, this	ID
			     is  unique  across all hardware classes.  For earlier hardware classes, the ID number is unique only within the hard-
			     ware class.  A null string is returned if no ID number is available; this is expected to be the case only for  proto-
			     type  machines or other systems improperly configured in manufacturing.  Comparisons of this value must be made using
			     the string compare functions, see string(3C).

	      Identifier for each partition existing on a machine.  Returned as an opaque
			     string of printable ASCII characters.  For any machine not supporting partitions this value will be the same as  Com-
			     parisons of this value must be made using the string compare functions, see string(3C).

	      Machine serial number.
			     The value will be a printable ASCII string.  This string is not available on all classes of machines; if unavailable,
			     the string will be empty.	This string is not a unique identifier of the machine, since machines of different classes
			     can have the same serial number.

			     If a unique identifier is needed, use or

	      The set of initial options to be given to the
			     and utilities to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of final options to be given to the
			     and utilities to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of libraries to be given to the
			     and utilities to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of options to be given to the
			     utility to check application source using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of initial options to be given to the
			     and  utilities  to  build	an  application using a programming model with 32-bit int, long, and pointer types, and an
			     off_t type using at least 64-bits.

	      The set of final options to be given to the
			     and utilities to build an application using a programming model with 32-bit int, long,  and  pointer  types,  and	an
			     off_t type using at least 64-bits.

	      The set of libraries to be given to the
			     and  utilities  to  build	an  application using a programming model with 32-bit int, long, and pointer types, and an
			     off_t type using at least 64-bits.

	      The set of options to be given to the
			     utility to check application source using a programming model with 32-bit int, long, and pointer types, and an  off_t
			     type using at least 64-bits.

	      The set of initial options to be given to the
			     and  utilities to build an application using a programming model with 32-bit int, and 64-bit long, pointer, and off_t
			     types.

	      The set of final options to be given to the
			     and utilities to build an application using a programming model with 32-bit int, and 64-bit long, pointer, and  off_t
			     types.

	      The set of libraries to be given to the
			     and  utilities to build an application using a programming model with 32-bit int, and 64-bit long, pointer, and off_t
			     types.

	      The set of options to be given to the
			     utility to check application source using a programming model with 32-bit int, and 64-bit long,  pointer,	and  off_t
			     types.

	      The set of initial options to be given to the
			     and utilities to build an application using a programming model with an int type using 32 bits and long, pointer, and
			     off_t types using at least 64-bits.

	      The set of libraries to be given to the
			     and utilities to build an application using a programming model with an int type using 32 bits and long, pointer, and
			     off_t types using at least 64-bits.

	      The set of libraries to be given to the
			     and utilities to build an application using a programming model with an int type using 32 bits and long, pointer, and
			     off_t types using at least 64-bits.

	      The set of options to be given to the
			     utility to check application source using a programming model with an int type using 32 bits and long,  pointer,  and
			     off_t types using at least 64-bits.

	      The set of initial options to be given to the
			     utility to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of final options to be given to the
			     utility to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of libraries to be given to the
			     utility to build an application using a programming model with 32-bit int, long, pointer, and off_t types.

	      The set of initial options to be given to the
			     utility to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type
			     using at least 64 bits.

	      The set of final options to be given to the
			     utility to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type
			     using at least 64 bits.

	      The set of libraries to be given to the
			     utility to build an application using a programming model with 32-bit int, long, and pointer types, and an off_t type
			     using at least 64 bits.

	      The set of initial options to be given to the
			     utility to build an application using a programming model with 32-bit int and 64-bit long, pointer, and off_t types.

	      The set of final options to be given to the
			     utility to build an application using a programming model with 32-bit int and 64-bit long, pointer, and off_t types.

	      The set of libraries to be given to the
			     utility to build an application using a programming model with 32-bit int and 64-bit long, pointer, and off_t types.

	      The set of initial options to be given to the
			     utility to build an application using a programming model with an int type using at least 32 bits and long,  pointer,
			     and off_t types using at least 64 bits.

	      The set of final options to be given to the
			     utility  to build an application using a programming model with an int type using at least 32 bits and long, pointer,
			     and off_t types using at least 64 bits.

	      The set of libraries to be given to the
			     utility to build an application using a programming model with an int type using at least 32 bits and long,  pointer,
			     and off_t types using at least 64 bits.

	      This value is a <newline>-separated list of names of programming environments supported by the implementation
			     in  which the widths of the blksize_t, cc_t, mode_t, nfds_t, pid_t, ptrdiff_t, size_t, speed_t, ssize_t, suseconds_t,
			     tcflag_t, useconds_t, wchar_t, and wint_t types are no greater than the width of type long.

       If len is not zero, and if name is known and has a configuration-defined value, copies that value into the len-byte buffer  pointed  to	by
       buf.   If the string to be returned is longer than len bytes, including the terminating null, truncates the string to len-1 bytes and null-
       terminates the result.  The application can detect that the string was truncated by comparing the value returned by with len.

       If len is zero and buf is NULL, returns the integer value as defined below, but does not return a string.  If len is zero but  buf  is  not
       NULL, the result is unspecified.

RETURN VALUE

       If name is invalid, returns zero and sets to

       If name does not have a configuration-defined value, returns 0 (zero) and leaves unchanged.

       If  name has a configuration-defined value, returns the size of buffer that would be needed to hold the entire configuration-defined value.
       If this return value is less than len, the string returned in buf has been truncated.

EXAMPLES

       The following code fragment calls to determine the correct buffer size for allocates space for this buffer,  then  gets	the  configuration
       value for

AUTHOR

       was developed by HP.

FILES

       symbolic constants and structures used for support
		      of the /usr/group standard

SEE ALSO

       getconf(1), errno(2), fpathconf(2), pathconf(2), sysconf(2), malloc(3C), thread_safety(5).

STANDARDS CONFORMANCE

																       confstr(3C)