modem_write()

Write a string to a device

Synopsis:

#include <sys/modem.h>

int modem_write( int fd,
                 char* str );

The modem_write() function writes the string str to the device specified by the file descriptor fd. Just before writing each character, all buffered input from the same device is flushed. After writing each character an attempt to read an echo is made. The intent is to write a string without it appearing back in the input stream even if the device is echoing each character written.

If the \ character appears in str then the character following it is interpreted by modem_write() and instead of both being output they are treated as a special escape sequence which causes the following actions to be taken:

Escape	Description
`\r`	Output a carriage return.
`\n`	Output a newline.
`\x`hh	Output the single character whose hex representation follows as hh.
`\B`	Send a 500 msec break on the line using tcsendbreak().
`\D`	Drop the line for 1 second using tcdropline().
`\P`hh	Pause for hh 1/10 of a second where hh is two hex characters.

Returns:

Zero on success, -1 on failure (errno is set ).

Errors:

EAGAIN: The O_NONBLOCK flag is set for the file descriptor, and the process would be delayed in the write operation.
EBADF: The file descriptor, fildes, isn't a valid file descriptor open for writing.
EINTR: The write operation was interrupted by a signal, and either no data was transferred, or the resource manager responsible for that file doesn't report partial transfers.
EIO: A physical I/O error occurred. The precise meaning is device-dependent.
EPIPE: An attempt was made to write to a pipe (or FIFO) that isn't open for reading by any process. A SIGPIPE signal is also sent to the process.

Classification:

QNX 6

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes

modem_write()

Synopsis:

Library:

Description:

Returns:

Errors:

Classification:

See also: