tcsendbreak(3)                      CLIX                      tcsendbreak(3)



  NAME

    tcsendbreak - Sends a break on an asynchronous serial data line

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <termios.h>

    int tcsendbreak(
      int filedescriptor ,
      int duration );

  DESCRIPTION

    The tcsendbreak() function causes transmission of a continuous stream of
    zero-valued bits for a specific duration.

  PARAMETERS

    filedescriptor   Specifies an open file descriptor.

    duration         Specifies the number of milliseconds that zero-valued
                     bits are transmitted.  If the value of the duration
                     parameter is 0, it causes transmission of zero-valued
                     bits for 25 milliseconds.  If duration is not 0, it sends
                     zero-valued bits for duration milliseconds.

  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

    1.  To send a break condition for 500 milliseconds, use the following
        line:

        rc = tcsendbreak(stdout, 500);


    2.  To send a break condition for 25 milliseconds, use either of the
        following lines:

        rc = tcsendbreak(1, 25);





  2/94 - Intergraph Corporation                                              1

  tcsendbreak(3)                      CLIX                      tcsendbreak(3)



        rc = tcsendbreak(1, 0);


  ERRORS

    The tcsendbreak() function fails if one of the following are true:

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

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

    [EINTR]     A signal was caught during the tcsendbreak() function.

    [EIO]       Some physical I/O error occurred.

    [ENOLINK]   The filedescriptor parameter is on a remote machine and the
                link to that machine is no longer active.

  RELATED INFORMATION

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

    Files: termios(7)





























  2                                              Intergraph Corporation - 2/94