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

socket_transport_name_get(2) OSS System Calls Reference Manual
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
AF_UNIX
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
figured with multiple
TCP/IP processes as part of the AF_INET or AF_INET6 socket environment.
The transport-provider name is a convention and does not guarantee use of a speci
ficTCP/IP
stack. For example, on older systems, $ZTC0 provided only Internet Procol version 4 addressing
for an AF_INET stack and could be used to distinguish the stack to use for sockets that do not
use AF_INET6 features. On current systems, $ZTC0 might identify an AF_INET6 protocol
stack; check with your TCP/IP administrator to determine your site’s naming conventions before
using this function to distinguish between stacks.
RETURN VALUES
Upon successful completion, the socket_transport_name_get() 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_get() function sets errno
to the corresponding value:
[EDEFINEERR]
The Guardian DEFINE =TCPIPˆPROCESSˆNAME is invalid.
[EFAULT] The address specified for the buffer parameter is not valid.
[EINVAL] One of the following conditions occurred:
• The domain parameter does not specify a supported domain.
• The buffer specified by the buffer and maxlen parameters is too small to
hold the transport-provider process name.
RELATED INFORMATION
Functions: socket_transport_name_set(2), socket(2), socketpair(2).
STANDARDS CONFORMANCE
This function is an extension to the XPG4 specification.
7−80 Hewlett-Packard Company 527186-003