confstr(3C)confstr(3C)NAMEconfstr() - get string-valued configuration values
SYNOPSISDESCRIPTION
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 cur‐
rently 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 ear‐
lier hardware classes, the ID number is unique
only within the hardware class. A null string is
returned if no ID number is available; this is
expected to be the case only for prototype
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 Comparisons 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 pro‐
gramming 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 pro‐
gramming 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 pro‐
gramming 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 pro‐
gramming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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 program‐
ming 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, usec‐
onds_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-ter‐
minates 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 ALSOgetconf(1), errno(2), fpathconf(2), pathconf(2), sysconf(2), mal‐
loc(3C), thread_safety(5).
STANDARDS CONFORMANCEconfstr(3C)