Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sh(1)

fork(2)

read(2)

readv(2)

write(2)

writev(2)



     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



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026