tcsendbreak(3) — AIX PS/2 1.2.1



TCSENDBREAK(3,L)            AIX Technical Reference            TCSENDBREAK(3,L)



-------------------------------------------------------------------------------
tcsendbreak, tcdrain, tcflush, tcflow



PURPOSE

Line control functions.

LIBRARY

Standard I/O Library (libc.a)

SYNTAX

#include <termios.h>

int tcsendbreak (fildes, duration)
int fildes;
int duration;

int tcdrain (fildes)
int fildes;

int tcflush (fildes, queue_selector)
int fildes;
int queue_selector;

int tcflow (fildes, action)
int fildes;
int actions;

DESCRIPTION

If the terminal is using asynchronous serial data transmission, the tcsendbreak
function causes transmission of a continuous stream of zero-valued bits for .25
seconds.  The duration parameter is ignored.

The tcdrain function waits until all output written to the object to which
fildes refers has been transmitted.

The tcflush function discards data written to the object to which fildes refers
but not transmitted, or data received but not read, depending on the value of
queue_selector as follows:

  o If queue_selector is TCIFLUSH, it flushes data received but not read.

  o If queue_selector is TCOFLUSH, it flushed data written but not transmitted.

  o If queue_selector is TCIOFLUSH, it flushes both data received but not read,
    and data written but not transmitted.




Processed November 7, 1990     TCSENDBREAK(3,L)                               1



TCSENDBREAK(3,L)            AIX Technical Reference            TCSENDBREAK(3,L)



The tcflow function suspends transmission or reception of data on the object to
which fildes refers, depending on the value of action as follows:

  o If action is TCOOFF, it suspends output.

  o If action is TCOON, it restarts suspended output.

  o If action is TCIOFF, the system transmits a STOP character, which causes
    the terminal device to stop transmitting data to the system.

  o If action is TCION, it restarts suspended output.

RETURN VALUE

Upon successful completion, a value of 0 is returned.  Otherwise, a value of -1
is returned and errno is set to indicated the error.

ERROR CONDITIONS

If any of the following conditions occur, the tcsendbreak function returns -1
and sets errno to the corresponding value:

EBADF     The fildes argument is not a valid descriptor.

EINVAL    The device does not support the tcsendbreak function.

ENOTTY    The file associated with fildes is not a terminal.

If any of the following conditions occur, the tcdrain function returns -1 and
sets errno to the corresponding value:

EBADF     The fildes argument is not a valid file descriptor.

EINTR     A signal interrupted the tcdrain function.

EINVAL    The device does not support the tcdrain function.

ENOTTY    The file associated with fildes is not a terminal.

If any of the following conditions occur, the tcflush function returns -1 and
sets errno to the corresponding value:

EBADF     The fildes argument is not a valid file descriptor.

EINVAL    The device does not support the tcflush function, or queue_selector
          argument is not a proper value.

ENOTTY    The file associated with fildes is not a terminal.

If any of the following conditions occur, the tcflow function returns -1 and
sets errno to the corresponding value:




Processed November 7, 1990     TCSENDBREAK(3,L)                               2



TCSENDBREAK(3,L)            AIX Technical Reference            TCSENDBREAK(3,L)



EBADF     The fildes argument is not a valid file descriptor.

EINVAL    The device does not support the tcflush function, or action argument
          is not a proper value.

ENOTTY    The file associated with fildes is not a terminal.

RELATED INFORMATION

In this book:  "cfgetospeed, cfsetospeed, cfgetispeed, cfsetispeed,"
"tcgetattr, tcsetattr," and "tcgetpgrp, tcsetpgrp."












































Processed November 7, 1990     TCSENDBREAK(3,L)                               3

Museum

Related Articles