hpux man page for cmpt_get_endpoint_cid

cmpt_get_peer_cid(3)					     Library Functions Manual					      cmpt_get_peer_cid(3)

NAME
       cmpt_get_peer_cid(), cmpt_get_endpoint_cid() - get the compartment IDs for INET domain communications.

SYNOPSIS

   Parameters
	      s      INET domain socket or stream.

DESCRIPTION
       The and functions return the compartments associated with an INET domain transport endpoint (a socket or a stream).

       The  function  returns  the  compartment  ID (cid) associated with the transport endpoint s.  The cid of a transport endpoint is set to the
       process's cid at the time of creation, and does not change even when it is transferred between processes or the	creating  process  changes
       its compartment.

       The  function returns the compartment ID of the peer that the transport endpoint s is communicating with.  For loopback communications, the
       cid is the one associated with the peer transport endpoint.  For communications over a network interface, the peer cid is the  one  associ-
       ated with the network interface where communications are being received.  For TCP communications, the peer cid is persistent once a connec-
       tion is established.  For other protocols, the peer cid may change for each packet that is received.

       The function returns an error if a connection is not established (for TCP) or no communication has been received (for all other protocols).

RETURN VALUE
       and return the following values:

	      Successful completion.
		      The function returns a valid compartment ID.

	      Function failed.
		      is set to indicate the error from the underlying system call.

ERRORS
       See ioctl(2) for errors indicated by

DEPENDENCIES
       These functions are a part of the library.

SEE ALSO
       compartments(4), compartments(5).

															      cmpt_get_peer_cid(3)