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)