_SET_THLIIPADDR() — Set the client's IP address

Standards

Standards / Extensions	C or C++	Dependencies
z/OS® UNIX	both

Format

#include <sys/__ussos.h>

int _SET_THLIIPADDR(ln, ipaddr);

General description

The _SET_THLIIPADDR() macro provides a way for daemons to set a client's IP address.

_SET_THLIIPADDR() takes the following arguments:

ln: The length of the IP address as specified by ipaddr. The IP address length can be between 1 and 16 inclusive. The argument is specified as an unsigned int.
ipaddr: Pointer to the IP address.

Usage notes

The intent of the _SET_THLIIPADDR() macro is to provide a way for daemons to set the IP address of a client for Security Authorization Facility (SAF) exits when performing security related functions.

Restrictions

Results are unpredictable if _SET_THLIIPADDR() is issued outside of the z/OS UNIX environment.

Returned value

If the client's IP address is set, _SET_THLIIPADDR() returns nonzero.

_SET_THLIIPADDR() returns 0 and does not set the IP address of the client when:

The base level of z/OS UNIX is not OS/390 R5.
The setting of the IP address is not supported.
The length of the IP address is less then 1 or greater than 16.

Related information

sys/__ussos.h