tcdrain Subroutine

Purpose

Waits for output to complete.

Library

Standard C Library (libc.a)

Syntax

#include <termios.h>

int tcdrain( FileDescriptor)
int FileDescriptor;

Description

The tcdrain subroutine waits until all output written to the object referred to by the FileDescriptor parameter has been transmitted.

Parameter

Item Description
FileDescriptor Specifies an open file descriptor.

Return Values

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

Error Codes

The tcdrain subroutine is unsuccessful if one of the following is true:

Item Description
EBADF The FileDescriptor parameter does not specify a valid file descriptor.
EINTR A signal interrupted the tcdrain subroutine.
EIO The process group of the writing process is orphaned, and the writing process does not ignore or block the SIGTTOU signal.
ENOTTY The file associated with the FileDescriptor parameter is not a terminal.

Example

To wait until all output has been transmitted, enter:

rc = tcdrain(stdout);