HPUX ipcdest[2]
ipcdest(2) ipcdest(2)
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() with the
NSO_PROTOCOL_ADDRESS option (see ipccreate(3N)).
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
Hewlett-Packard Company - 1 - HP-UX Release 9.0: August 1992
ipcdest(2) ipcdest(2)
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 ERRORS below.
RETURN VALUE
None. Errors are returned in the result parameter.
ERRORS
[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.
Hewlett-Packard Company - 2 - HP-UX Release 9.0: August 1992
ipcdest(2) ipcdest(2)
[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.
SEE ALSO
getrlimit(2), ipcconnect(2), ipccontrol(2), ipccreate(2),
ipcgetnodename(2), ipclookup(2), ipcname(2), ipcnamerase(2),
ipcrecv(2), ipcrecvcn(2), ipcselect(2), ipcsend(2), ipcsetnodename(2),
ipcshutdown(2), addopt(3N), initopt(3N), ipcerrmsg(3N),
optoverhead(3N), readopt(3N).
Hewlett-Packard Company - 3 - HP-UX Release 9.0: August 1992