HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

confstr(3C) confstr(3C)

RETURN VALUE

If name is invalid, confstr() returns zero and sets

errno to [EINVAL].

If name does not have a conﬁguration-deﬁned value,

confstr() returns 0 (zero) and leaves errno

unchanged.

If name has a conﬁguration-deﬁned value,

confstr() returns the size of buffer that would be needed to

hold the entire conﬁguration-deﬁned value. If this return value is less than len, the string returned in buf

has been truncated.

EXAMPLES

The following code fragment calls

confstr() to determine the correct buffer size for

_CS_PATH, allo-

cates space for this buffer, then gets the conﬁguration value for

_CS_PATH.

#include <unistd.h>

#include <stddef.h>

size_t bufsize;

char *buffer;

bufsize=confstr(_CS_PATH,NULL,(size_t)0);

buffer=(char *)malloc(bufsize);

confstr(_CS_PATH,buffer,bufsize);

AUTHOR

confstr() was developed by HP.

FILES

/usr/include/unistd.h