Series 300 and 800 Only

NAME

ipcdest() − creates a destination descriptor

SYNOPSIS

#include <sys/ns_ipc.h>

void ipcdest (socketkind,nodename,nodelen,protocol,protoaddr,
              protolen,flags,opt,destdesc,result);
ns_int_t socketkind,nodelen,protocol,protolen;
ns_int_t *flags,*destdesc, *result;
char *nodename;
short int opt[];
short int *protoaddr;

DESCRIPTION

The ipcdest call creates a destination descriptor that the calling process can use to establish a connection to another process. 
 
This call is similar in function to ipclookup because it returns a destination descriptor.  However, because ipcdest allows you to specify a protocol address, it allows you to obtain a destination descriptor for a call socket with a particular protocol address.  A call socket can be created with a particular protocol address by using the ipccreate call with the NSO_PROTOCOL_ADDRESS option. 
 
The ipcdest call 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. 
 
This routine can be linked into a program by giving the -lnsipc option to cc(1) or ld(1). 

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 that uses protoaddr resides.  Default:  You may omit the organization, organization and domain, or all parts of the node name.  When organization or organization and domain are omitted, they will 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 may be 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) See below.  Refer to the NetIPC programmer’s manual for your system for a complete description of this parameter. 

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.  Describes the location of a destination call socket.  May be used in a subsequent ipcconnect call to establish a connection to another process. 

result (output parameter) The error code returned; zero or NSR_NO_ERROR if no error.  Refer to "Diagnostics" below for more information. 

FLAGS PARAMETER

None supported for this call.  All flag bits must be cleared (set to zero). 

RETURNS

None.  Errors are returned in the result parameter. 

AUTHOR

HP. 

SEE ALSO

ipclookup(2), ipccreate(2), ipcconnect(2). 

DIAGNOSTICS

[NSR_NO_ERROR] The call was successful. 

[NSR_xxxx] Refer to the errors listed in the NetIPC programmer’s manual for your system. 

Hewlett-Packard Company  —  May 11, 2021