HP-UX Reference (11i v2 04/09) - 3 Library Functions N-Z (vol 7)

nis_subr(3N) nis_subr(3N)

into an array (using the dest parameter to

nis_clone_object()

) then the object cannot be freed with

this function. Instead, the function

xdr_free(xdr_nis_object,

dest) must be used.

nis_print_object()

prints out the contents of a NIS+ object structure on the standard output. Its

primary use is for debugging NIS+ programs.

MULTITHREAD USAGE

Thread Safe: Yes

Cancel Safe: Yes

Fork Safe: No

Async-cancel Safe: No

Async-signal Safe: No

These functions can be called safely in a multithreaded environment. These functions may be thread can-

cellation points because they invoke functions that are thread cancellation points.

In a multithreaded environment, these functions are not safe to be called by a child process after

fork()

and before exec(). These functions should not be called by a multithreaded application that support

asynchronous cancellation or asynchronous signals.

EXTERNAL INFLUENCES

Environment Variables

NIS_PATH This variable overrides the default NIS+ directory search path used by

nis_getnames(). It contains an ordered list of directories separated by ’:’ (colon)

characters. The ’$’ (dollar sign) character is treated specially. Directory names that end

in ’$’ have the default domain appended to them, and a ’$’ by itself is replaced by the list

of directories between the default domain and the global root that are at least two levels

deep. The default NIS+ directory search path is ’$’.

WARNINGS

HP-UX 11i Version 2 is the last HP-UX release on which NIS+ is supported.

LDAP is the recommended replacement for NIS+. HP fully supports the industry standard naming ser-

vices based on LDAP.

NOTES

nis_leaf_of(), nis_name_of()

and nis_clone_object() return their results as thread-

speciﬁc data in multithreaded applications.