setsockopt(wdd)
NAME
setsockopt − Set the WDD socket options
SYNTAX
#include <sys/types.h>
#include <sys/socket.h>
#include <wdd/wda_var.h>
setsockopt (s, level, optname, optval, optlen)
int s, level, optname;
char ∗optval;
int optlen;
DESCRIPTION
This system call allows you to:
∗ Abort all data transmissions over the line and to release any buffers used.
∗ Start a data transmission opportunity (half-duplex mode only)
∗ End a data transmission opportunity (half-duplex mode only)
∗ ABORTING DATA TRANSMISSION
This function allows you to abort all data transmissions over a line and to release any buffers used.
ARGUMENTS
Input Arguments
s Value returned by the socket() system call
level 0
optname WDA_TXABORT
optval (char∗) 0
optlen 0
RETURN VALUE
The return value is 0 if the call is successful. Otherwise, a -1 is returned and the global variable errno is set to indicate the error.
DIANOSTICS
[ENODEV] A successful bind() has not been made by this socket.
[EACCES] The caller is not the owner of the line
[ENOPROTOOPT] The Protocol option is not available.
[ENOTCONN] The Modem Connect Line entity is Disabled or the device line is not active.
∗ STARTING A DATA TRANSMISSION OPPORTUNITY
This function allows you to start a data transmission opportunity when a line is set up to operate in half-duplex mode.
ARGUMENTS
Input Arguments
s Value returned by the socket() system call
level 0
optname WDA_STARTTX
optval (char∗) 0
optlen 0
RETURN VALUE
The return value is 0 if the call is successful. Otherwise, a -1 is returned and the global variable errno is set to indicate the error.
DIANOSTICS
[ENODEV] A successful bind() has not been made by this socket.
[EACCES] The caller is not the owner of the line
[ENOPROTOOPT] The Protocol option is not available.
[ENOTCONN] The Modem Connect Line entity is Disabled or the device line is not active.
∗ ENDING A DATA TRANSMISSION OPPORTUNITY
This function allows you to end a data transmission opportunity when a line is set up to operate in half-duplex mode.
ARGUMENTS
Input Arguments
s Value returned by the socket() system call
level 0
optname WDA_ENDTX
optval (char∗) 0
optlen 0
RETURN VALUE
The return value is 0 if the call is successful. Otherwise, a -1 is returned and the global variable errno is set to indicate the error.
DIANOSTICS
[ENODEV] A successful bind() has not been made by this socket.
[EACCES] The caller is not the owner of the line
[ENOPROTOOPT] The Protocol option is not available.
[ENOTCONN] The Modem Connect Line entity is Disabled or the device line is not active.