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

ManualsBrandsHP ManualsServerHP NonStop G-Series

431

432

433

434

435

436

437

438

439

440

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

#include <sys/socket.h>

int socket_transport_name_set(

int domain,

char *buffer

);

PARAMETERS

domain Speciﬁes the domain for which the transport-provider process name is being set.

The following values are valid:

AF_INET Speciﬁes the Internet domain using IPv4 addresses

AF_INET6 Speciﬁes the Internet domain using IPv6 addresses

AF_UNIX Speciﬁes 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 speciﬁed 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 speciﬁed 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 The default transport-provider process is $ZPLS. This is the only supported

AF_UNIX transport-provider name.

NOTES

This function is equivalent to the socket_set_inet_name() function in the Guardian sockets

library.

The process name speciﬁed in the socket_transport_name_set() function call is validated dur-

ing each call to the socket(), socketpair(),orsocket_transport_name_get() function. Process

names are not validated during calls to the socket_transport_name_set() function.

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-speciﬁc transport-provider process (one or more per node)

527186-003 Hewlett-Packard Company 7−81