Create a pipe
#include <unistd.h> int pipe( int fildes[2] );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The pipe() function creates a pipe (an unnamed FIFO) and places a file descriptor for the read end of the pipe in fildes[0], and a file descriptor for the write end of the pipe in fildes[1]. Their integer values are the two lowest available at the time of the pipe() function call. The O_NONBLOCK flag is cleared for both file descriptors. (You can use fcntl() to set the O_NONBLOCK flag.)
You can write data to file descriptor fildes[1] and read it from file descriptor fildes[0]. If you read from file descriptor fildes[0], it returns the data written to fildes[1] on a first-in-first-out (FIFO) basis.
The pipe buffer is allocated by the pipe resource manager.
You typically use this function to connect standard utilities acting as filters, passing the write end of the pipe to the data-producing process as its STDOUT_FILENO, and the read end of the pipe to the data-consuming process as its STDIN_FILENO (either via the traditional fork(), dup2(), or exec*, or the more efficient spawn* calls).
If successful, pipe() marks the st_ftime, st_ctime, st_atime and st_mtime fields of the pipe for updating.
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |