confstr.3c (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

confstr(3C) confstr(3C)

NAME

confstr( ) - get string-valued conﬁguration values

SYNOPSIS

#include <unistd.h>

size_t confstr(int name, char *buf, size_t len);

DESCRIPTION

confstr() provides a method for applications to get conﬁguration-deﬁned string values. Its use and

purpose are similar to sysconf() (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 deﬁned in

<unistd.h>.

_CS_PATH A default value for the PATH environment variable which can be used to locate com-

mands in Section 1 of the HP-UX Reference and utilities deﬁned in the POSIX.2

standard that are currently implemented in the HP-UX operating system.

_CS_HW_CPU_SUPP_BITS

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

"32/64" or "64".

_CS_KERNEL_BITS

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

_CS_MACHINE_MODEL

The hardware model string.

_CS_MACHINE_IDENT

Unique identiﬁer 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 _CS_PARTITION_IDENT

for a unique identiﬁer for partitions

in a machine. For hardware classes ﬁrst 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 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 sys-

tems improperly conﬁgured in manufacturing. Comparisons of this value must be

made using the string compare functions, see string (3C).

_CS_PARTITION_IDENT

Identiﬁer 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 _CS_MACHINE_IDENT

. Comparisons of this value must be

made using the string compare functions, see string (3C).

_CS_MACHINE_SERIAL

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 identiﬁer of the machine, since machines of different

classes can have the same serial number.

If a unique identiﬁer is needed, use

_CS_MACHINE_IDENT or

_CS_PARTITION_IDENT.

_CS_XBS5_ILP32_OFF32_CFLAGS

The set of initial options to be given to the cc and c89 utilities to build an applica-

tion using a programming model with 32-bit int, long, pointer, and off_t types.

_CS_XBS5_ILP32_OFF32_LDFLAGS

The set of ﬁnal options to be given to the cc and c89 utilities to build an applica-

tion using a programming model with 32-bit int, long, pointer, and off_t types.

_CS_XBS5_ILP32_OFF32_LIBS

The set of libraries to be given to the cc and c89 utilities to build an application

using a programming model with 32-bit int, long, pointer, and off_t types.

_CS_XBS5_ILP32_OFF32_LINTFLAGS

The set of options to be given to the lint utility to check application source using a

programming model with 32-bit int, long, pointer, and off_t types.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
confstr(3C) confstr(3C) NAME confstr( ) - get string-valued configuration values SYNOPSIS #include size_t confstr(int name, char *buf, size_t len); DESCRIPTION confstr() provides a method for applications to get configuration-defined string values. Its use and purpose are similar to sysconf() (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 .
PAGE 2
confstr(3C) confstr(3C) _CS_XBS5_ILP32_OFFBIG_CFLAGS The set of initial options to be given to the cc and c89 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. _CS_XBS5_ILP32_OFFBIG_LDFLAGS The set of final options to be given to the cc and c89 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.
PAGE 3
confstr(3C) confstr(3C) _CS_POSIX_V6_ILP32_OFFBIG_CFLAGS The set of initial options to be given to the c99 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. _CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS The set of final options to be given to the c99 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.
PAGE 4
confstr(3C) confstr(3C) EXAMPLES The following code fragment calls confstr() to determine the correct buffer size for _CS_PATH, allocates space for this buffer, then gets the configuration value for _CS_PATH. #include #include size_t bufsize; char *buffer; bufsize=confstr(_CS_PATH,NULL,(size_t)0); buffer=(char *)malloc(bufsize); confstr(_CS_PATH,buffer,bufsize); A cA AUTHOR confstr() was developed by HP. FILES /usr/include/unistd.