_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.