Open System Services System Calls Reference Manual (G06.25+, H06.03+)

socket_transport_name_set(2) OSS System Calls Reference Manual

Each user process has a current transport-provider name for each domain that is used when creat-

ing a socket in that domain.

The default AF_INET or AF_INET6 transport-provider name is $ZTC0, unless overridden by

an existing Guardian DEFINE =TCPIPˆPROCESSˆNAME. If =TCPIPˆPROCESSˆNAME exists,

it must be a MAP DEFINE with a FILE attribute string of the desired AF_INET or AF_INET6

transport-provider name.

The default AF_UNIX transport-provider name is $ZPLS. This is the only supported transport-

provider name.

Each user process can change its AF_INET or AF_INET6 transport-provider name with the

socket_transport_name_set()

function and can retrieve its current AF_INET, AF_INET6, and

AF_UNIX transport-provider names with the

socket_transport_name_get()

function.

Changing the AF_UNIX transport-provider name is not supported. Changing the

AF_INET or

AF_INET6 transport-provider name is meaningful when a node is con

ﬁgured with multiple

TCP/IP processes as part of the AF_INET or AF_INET6 socket environment.

RETURN VALUES

Upon successful completion, the socket_transport_name_set() function returns the value 0

(zero). Otherwise, the value -1 is returned and errno is set to indicate the error.

ERRORS

If any of the following conditions occurs, the socket_transport_name_set() function sets errno

to the corresponding value:

[EFAULT] The address speciﬁed for the buffer parameter is not valid.

[EINVAL] One of the following conditions occurred:

• The domain parameter does not specify a supported domain.

• The null-terminated process name pointed to by the buffer parameter has

zero length or is too large for a valid process name.

RELATED INFORMATION

Functions: socket_transport_name_get(2), socket(2), socketpair(2).

STANDARDS CONFORMANCE

This function is an extension to the XPG4 speciﬁcation.

7−82 Hewlett-Packard Company 527186-003