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

System Functions (s and S) socket_transport_name_get(2)
NAME
socket_transport_name_get
- Gets the name of the transport-provider process
LIBRARY
G-series native OSS processes: system library
H-series OSS processes: implicit libraries
SYNOPSIS
#include <sys/socket.h>
int socket_transport_name_get(
int domain,
char *buffer,
int maxlen
);
PARAMETERS
domain Specifies the domain for which the transport-provider process name should be
obtained. The following values are valid:
AF_INET Specifies the Internet domain using IPv4 addresses
AF_INET6 Specifies the Internet domain using IPv6 addresses
AF_UNIX Specifies the local sockets domain
buffer Points to the buffer to contain the null-terminated transport-provider process
name.
maxlen Specifies the length in bytes of the buffer pointed to by the buffer parameter.
This value should be at least 9 so that the buffer is large enough to contain the
null terminator and an 8-character process name.
DESCRIPTION
The socket_transport_name_get() function returns the name of the transport-provider process
for the indicated domain as set by the most recent call to the socket_transport_name_set()
function, or it returns the default value if no calls to the socket_transport_name_set() function
have been made. The default transport-provider processes for each domain are as follows:
AF_INET or AF_INET6
The default transport-provider process is $ZTC0, unless overridden by an exist-
ing Guardian DEFINE =TCPIPˆPROCESSˆNAME.
AF_UNIX The default transport-provider process is $ZPLS. This is the only supported
AF_UNIX transport-provider name.
The value returned in the buffer pointed to by the buffer parameter is always an uppercase name.
NOTES
Choosing the Transport-Provider Process
Each socket declared by a user process is supported by:
• An OSS transport agent process (one per processor)
• A domain-specific transport-provider process (one or more per node)
Each user process has a current transport-provider name for each domain that is used when creat-
ing a socket in that domain.
527186-003 Hewlett-Packard Company 7−79