Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (s and S) socket_transport_name_set(2)
NAME
socket_transport_name_set - Sets the name of the transport-provider process
LIBRARY
G-series native OSS processes: system library
H-series OSS processes: implicit libraries
SYNOPSIS
#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/socket.h>
int socket_transport_name_set(
int domain,
char *buffer
);
PARAMETERS
domain Specifies the domain for which the transport-provider process name is being set.
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 that contains the null-terminated transport-provider process
name. The buffer should be at most 9 characters long, to contain an 8-character
process name and a null terminator. The name can be specified in lowercase
letters; the name is always stored in uppercase characters.
DESCRIPTION
The socket_transport_name_set() function sets the name of the transport-provider process for
the domain specified by the domain parameter. A subsequent call to the
socket_transport_name_get() function can obtain the value set by this function.
Standard socket behavior does not require use of this function. A default transport-provider pro-
cess always exists for each domain that provides sockets, 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 For systems running AF_UNIX Release 1 software, $ZPLS is the only supported
AF_UNIX transport-provider name. The default transport-provider name is
$ZPLS.
For systems running AF_UNIX Release 2 software:
Choose transport-provider name $ZAFN2 to create an AF_UNIX Release 2
socket in portability mode. To set $ZAFN2 as the default transport-provider
name, you can use the Guardian DEFINE =_AFUNIX_PROCESS_NAME and
specify $ZAFN2. This Guardian define must be a MAP DEFINE with a FILE
attribute string of the desired AF_UNIX transport provider name.
Choose transport-provider name $ZPLS to create an AF_UNIX Release 2 socket
in compatibility mode. The default transport-provider name is $ZPLS.
527186-023 Hewlett-Packard Company 7−127