Parameter Values Returned to the Application

NAME

An IPv4 socket address structure to contain the peer name. The structure that is returned is the socket address structure for the remote socket connected to the local socket specified in field S.

FAMILY: A halfword binary field containing the connection peer’s IPv4 addressing family. The call always returns the value decimal 2, indicating AF_INET.
PORT: A halfword binary field set to the connection peer’s port number.
IP-ADDRESS: A fullword binary field set to the 32-bit IPv4 IP address of the connection peer’s host machine.
RESERVED: Specifies an 8-byte reserved field. This field is required, but not used.

An IPv6 socket address structure to contain the peer name. The structure that is returned is the socket address structure for the remote socket that is connected to the local socket specified in field S.

FAMILY: A halfword binary field containing the connection peer’s IPv6 addressing family. The call always returns the value decimal 19, indicating AF_INET6.
PORT: A halfword binary field set to the connection peer’s port number.
FLOWINFO: A fullword binary field specifying the traffic class and flow label. This value of this field is undefined.
IP-ADDRESS: A 16-byte binary field set to the 128-bit IPv6 IP address of the connection peer's host machine.
SCOPE-ID: A fullword binary field which identifies a set of interfaces as appropriate for the scope of the address carried in the IPv6-ADDRESS field. For a link scope IPv6-ADDRESS, SCOPE-ID contains the link index for the IPv6-ADDRESS. For all other address scopes, SCOPE-ID is undefined.

ERRNO

A fullword binary field. If RETCODE is negative, the field contains an error number. See Socket call error return codes for information about ERRNO return codes.

RETCODE

A fullword binary field that returns one of the following values:

Value: Description
0: Successful call.
-1: Check ERRNO for an error code.