tcflow(3)                           CLIX                           tcflow(3)



  NAME

    tcflow - Performs flow control functions

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <termios.h>

    int tcflow(
      int filedescriptor ,
      int action );

  PARAMETERS

    filedescriptor   Specifies an open file descriptor.

    action           Specifies one of the following:

                     [TCOOFF]   Suspends output.

                     [TCOON]    Restarts suspended output.

                     [TCIOFF]   Transmits a STOP character, which is intended
                                to cause the terminal device to stop
                                transmitting data to the system.  (See the
                                description of IXOFF in the input modes
                                section of the <termios.h> header file.)

                     [TCION]    Transmits a START character, which is intended
                                to cause the terminal device to start
                                transmitting data to the system.  (See the
                                description of IXOFF in the input modes
                                section of the <termios.h> header file.)

  DESCRIPTION

    The tcflow() function suspends transmission or reception of data on the
    object referred to by the filedescriptor parameter, depending on the value
    of the action parameter.

  RETURN VALUES

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

  EXAMPLES



  2/94 - Intergraph Corporation                                              1

  tcflow(3)                           CLIX                           tcflow(3)



    To restart output from a terminal device, enter the following:

    rc = tcflow(stdout, TCION);


  ERRORS

    The tcflow() function fails if one or more of the following are true:

    [EBADF]  The filedescriptor parameter is not a valid file descriptor.

    [EINVAL] The action parameter is not a proper value.

    [ENOTTY] The file associated with filedescriptor is not a terminal.

  RELATED INFORMATION

    Functions: tcdrain(3), tcflush(3), tcsendbreak(3)

    Files: termios(7)


































  2                                              Intergraph Corporation - 2/94