Digital

NAME

X25SetIOMode − Sets an X.25 port to blocking or non-blocking mode

LIBRARY

X.25 Library (libx25.a)

SYNOPSIS

#include <netx25/x25.h>
int X25SetIOMode(

int pd ,
int ioMode );

PARAMETERS

pdIdentifies the port for which the I/O mode is to be set. 

ioModeSpecifies the I/O mode in which the port is to operate.  If X25IO_BLOCK is specified, the port is set to blocking mode.  If X25IO_NONBLOCK is specified, the port is set to non-blocking mode. 
 

DESCRIPTION

The X25SetIOMode routine sets the specified port to the I/O mode specified by ioMode. 

If X25IO_NONBLOCK is passed as ioMode, the port is set to non-blocking mode.  Any subsequent X.25 operations on this port will return the error code X25RC_WOULDBLOCK, if the operation would block.  The exception to this is the X25WaitForEvent routine.  It can block on one or more non-blocking ports. 

If X25IO_BLOCK is passed as ioMode, the port is set to blocking mode.  This is the mode the port is set to on creation.  Any process which performs an operation which would block on this port will be suspended. 
 

RETURN VALUES

Upon successful completion, the X25SetIOMode routine returns the I/O mode the port was in when the routine was called.  Otherwise, a (negative) error code is returned. 
 

ERRORS

If the X25SetIOMode routine fails, one of the following error codes is returned. 

[X25RC_BADPD]
Invalid port descriptor specified.

[X25RC_INVALIOMODE]
The I/O mode specified is not valid.

[X25RC_SYSERR]
An operating system error occurred.  The external variable errno is set to indicate the error. 
 

RELATED INFORMATION

Functions: X25Listen(3X25), X25OpenPort(3X25), X25ReadData(3X25), X25ReadOOB(3X25), X25SendData(3X25), X25WaitForEvent(3X25). 

X.25 for Digital UNIX − Programmer’s Reference Manual.