pipe(2) DG/UX 4.30 pipe(2)
NAME
pipe - Create an interprocess channel.
SYNOPSIS
int pipe (fildes)
int fildes[2];
PARAMETERS
fildes Address of an array of two file descriptors.
DESCRIPTION
Pipe creates an I/O mechanism called a pipe that allows data
to be written and read in a first-in-first-out (FIFO)
manner.
<Fildes[]> is an array of two file descriptors. After the
pipe is created and opened, a read-only file descriptor is
returned in <fildes[0]> and a write-only descriptor is
returned in <fildes[1]>.
If the process exceeds its limit for open files, the call
will fail.
Pipes exist in the channel store, but not in the file name
store or the flat file store. Pipes have no file
attributes, except: time-last-accessed, time-last-changed,
time-last-modified, and size.
ACCESS CONTROL
None.
RETURN VALUE
0 The pipe was successfully created.
-1 An error occurred. Errno is set to indicate
the error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EFAULT The <fildes[]> buffer is an invalid area of
the process's address space.
EMFILE Pipe will fail if NOFILE-1 or more file
descriptors are currently open.
ENFILE The system file table is full.
Licensed material--property of copyright holder(s) Page 1
pipe(2) DG/UX 4.30 pipe(2)
SEE ALSO
The related manual sections: sh(1),
fork(2), read(2), readv(2), write(2), writev(2).
Licensed material--property of copyright holder(s) Page 2