ipcdest(2)

Requires Optional LAN/X.25 Software

NAME

ipcdest − create a NetIPC destination descriptor

SYNOPSIS

#include <sys/ns_ipc.h>

void ipcdest(

ns_int_t socketkind,
const char ∗nodename,
ns_int_t nodelen,
ns_int_t protocol,
short ∗protoaddr,
ns_int_t protolen,
ns_int_t ∗flags,
short opt[],
ns_int_t ∗destdesc,
ns_int_t ∗result);

DESCRIPTION

ipcdest creates a destination descriptor which the calling process can use to establish a connection to another process.

ipcdest can be used to obtain a destination descriptor for a call socket with a particular protocol address. To create a call socket with a particular address, use ipccreate(3N) with the NSO_PROTOCOL_ADDRESS option.

ipcdest does not verify that the remote endpoint described by the input parameters exists. This evaluation is delayed until the destination descriptor is used in a subsequent ipcconnect call.

Parameters

socketkind (input parameter) Defines the type of socket. Must be NS_CALL or 3 to specify a call socket. Other values are reserved for future use.

nodename (input parameter) The ASCII-coded name that identifies the node where the call socket with protoaddr resides. Default: The organization, organization and domain, or all parts of the node name can be omitted. When organization or organization and domain are omitted, they default to the local organization and/or domain. If the nodelen parameter is set to zero, this parameter is ignored and the node name defaults to the local node.

nodelen (input parameter) The length in bytes of the nodename parameter. Zero indicates that the nodename parameter is ignored, and the node name defaults to the local node. A fully-qualified node can be up to 50 bytes long.

protocol (input parameter) Defines the Transport Layer protocol to be used. Must be NSP_TCP or 4 to indicate the Transmission Control Protocol (TCP). Other values are reserved for future use.

protoaddr (input parameter) A data buffer that contains a TCP protocol address.

protolen (input parameter) The length in bytes of the protocol address. TCP protocol addresses are two bytes long.

flags (input parameter) This parameter is reserved for future use. All bits must be clear (not set).

opt (input parameter) No options are defined for this call. You must set this parameter to zero (0) or pass the constant (C programs only) NSO_NULL.

destdesc (output parameter) Destination descriptor. Can be used in a subsequent ipcconnect call to establish a connection to the call socket with protoaddr.

result (output parameter) See "Diagnostics" below.

RETURN VALUE

None. Errors are returned in the result parameter.

DIAGNOSTICS

[NSR_NO_ERROR] The call was successful.

[NSR_BOUNDS_VIO] A parameter address is invalid.

[NSR_NOT_CALL_SOCKET] The socketkind parameter is not NS_CALL.

[NSR_FLAGS] The value in the flags parameter is invalid.

[NSR_OPT_OPTION] An option specified in the opt parameter is unknown or unsupported.

[NSR_PROTOCOL] The protocol of the specified socket is not supported by the local system.

[NSR_KIND_AND_PROTOCOL] The socketkind and protocol parameters are not compatible.

[NSR_ADDR_OPT] The value in the protolen parameter is invalid.

[NSR_NLEN] The value in the nodelen parameter is invalid.

[NSR_NODE_NAME_SYNTAX] The node specified in the nodename parameter is invalid.

[NSR_NO_NODE] The specified node is unknown to the local host.

[NSR_NO_MEMORY] Sufficient system memory is not available to execute this call at this time.

[NSR_PATH_REPORT] The path report could not be interpreted.

[NSR_DEST_UNREACHABLE] The path report contained no usable paths.

[NSR_NO_FILE_AVAIL] No file table entries are available at this time.

[NSR_NO_DESC_AVAIL] The process exceeded the system-defined number of file and socket descriptors that can be open at a time (see getrlimit(2)).

AUTHOR

ipcdest was developed by HP.

Museum

Related Articles