t_sync(3) [hpux man page]
t_sync(3) Library Functions Manual t_sync(3) NAME
t_sync() - synchronize transport library SYNOPSIS
DESCRIPTION
For the transport endpoint specified by fd, the function synchronizes the data structures managed by the transport library with information from the underlying transport provider. In doing so, it can convert an uninitialized file descriptor (obtained via or as a result of a and to an initialized endpoint, assuming that the file descriptor referenced a transport endpoint, by updating and allocating the necessary library data structures. This function also allows two cooperating processes to synchronize their interaction with a transport provider. For example, if a process forks a new process and issues an the new process must issue a to build the private library data structure asso- ciated with a transport endpoint and to synchronize the data structure with the relevant provider information. It is important to remember that the transport provider treats all users of a transport endpoint as a single user. If multiple processes are using the same endpoint, they should coordinate their activities so as not to violate the state of the transport endpoint. The func- tion returns the current state of the transport endpoint to the user, thereby enabling the user to verify the state before taking further action. This coordination is only valid among cooperating processes; it is possible that a process or an incoming event could change the endpoint's state after a is issued. If the transport endpoint is undergoing a state transition when is called, the function will fail. Valid States All - apart from Fork Safety is not fork-safe. RETURN VALUE
returns the state of the transport connection endpoint on successful completion and -1 on failure, and is set to indicate the error. The state returned is one of the following: Unbound Idle Outgoing connection pending Incoming connection pending Data transfer Outgoing orderly release (waiting for an orderly release indication) Incoming orderly release (waiting for an orderly release request) ERRORS
On failure, is set to one of the following: [TBADF] The specified file descriptor does not refer to a transport endpoint. This error may be returned when the fd has been previously closed or an erroneous number may have been passed to the call. [TSTATECHNG] The transport endpoint is undergoing a state change. [TSYSERR] A system error has occurred during execution of this function. [TPROTO] (XTI only) This error indicates that a communication problem has been detected between XTI and the transport provider for which there is no other suitable XTI ( SEE ALSO
t_open(3), t_getstate(3), dup(2), exec(2), fork(2), open(2), thread_safety(5). STANDARDS CONFORMANCE
t_sync(3)
Check Out this Related Man Page
t_sync(3xti) t_sync(3xti) Name t_sync - synchronize transport library Syntax #include <xti.h> int t_sync(fd) int fd; Arguments fd Identifies the local transport endpoint. Description For the transport endpoint specified by fd, synchronizes the data structures managed by the transport library with information from the underlying transport provider. In doing so, can convert an uninitialized file descriptor to an initialized transport endpoint, by updating and allocating the necessary library data structures. The file descriptor, which is assumed to have referenced a transport endpoint, has to be obtained by means of an or be the result of a fork and The function also allows two cooperating processes to synchronize their interac- tion with a transport provider. For example, if a process forks a new process and issues an the new process must issue a to build the private library data structure asso- ciated with a transport endpoint and to synchronize the data structure with the relevant provider information. It is important to remember that the transport provider treats all users of a transport endpoint as a single user. If multiple processes are using the same endpoint, they should coordinate their activates so as not to violate the state of the transport endpoint. The function returns the current state of the transport endpoint to the user, thereby enabling the user to verify the state before taking further action. This coordination is valid only among cooperating processes; it is possible that a process or an incoming event could change the endpoint's state after a is issued. -------------------------------------- Parameters Before Call After Call -------------------------------------- fd x / -------------------------------------- Return Values Upon successful completion, returns the state of the transport endpoint. On failure, a value of -1 is returned, and t_errno is set to indi- cate the error. The state returned is one of the following: T_IDLE Idle T_OUTCON Outgoing connection pending T_INCON Incoming connection pending T_DATAXFER Data transfer T_OUTREL Outgoing orderly release (waiting for an orderly release indication). T_INREL Incoming orderly release (waiting for an orderly release request) Diagnostics On failure, t_errno is set to one of the following: [TBADF] The specified file descriptor does not refer to a transport endpoint. This error may be returned when the fd has been previously closed or an erroneous number may have been passed to the call. [TSTATECHNG] The transport endpoint is undergoing a state change. [TSYSERR] A system error has occurred during execution of this function. See Also dup(2), exec(2), fork(2), open(2) t_sync(3xti)