mkfifo(3)                  DG/UX 4.30                   mkfifo(3)



     NAME
          mkfifo - Make a FIFO special file.

     SYNOPSIS
          #include <sys/types.h>
          #include <sys/stat.h>

          int mkfifo (path, mode)
          char *path;
          mode_t mode;

     DESCRIPTION
          The mkfifo routine creates a new FIFO special file named by
          the pathname pointed to by path.  The file permission bits
          of the new FIFO are initialized from mode.  The file
          permission bits of the mode argument are modified by the
          process's file creation mask (see umask(2)).  When bits in
          mode other than the file permission bits are set, the effect
          is implementation-defined.

          The FIFO's owner ID shall be set to the process's effective
          user ID.  The FIFO's group ID shall be set to the group ID
          of the directory in which the FIFO is being created or to
          the process's effective group ID.

          Upon successful completion, the mkfifo() function shall mark
          for update the st_atime, st_ctime, and st_mtime fields of
          the file.  Also, the st_ctime and st_mtime fields of the
          directory that contains the new entry are marked for update.

     RETURNS
          Upon successful completion a value of zero is returned.
          Otherwise, a value of -1 is returned, no FIFO is created,
          and errno is set to indicate the error.

     ERRORS
          If any of the following conditions occur, the mkfifo()
          function shall return -1 and set errno to the corresponding
          value:

          [EACCES]
               A component of the path prefix denies search
               permission.

          [EEXIST]
               The named file already exists.









     Licensed material--property of copyright holder(s)         Page 1

     mkfifo(3)                  DG/UX 4.30                   mkfifo(3)



          [ENAMETOOLONG]
               The length of the path string exceeds {PATH_MAX}, or a
               pathname component is longer than {NAME_MAX} while
               {_POSIX_NO_TRUNC} is in effect.

          [ENOENT]
               A component of the path prefix does not exist or the
               path argument points to an empty string.

          [ENOSPC]
               The directory that would contain the new file cannot be
               extended or the file system is out of file allocation
               resources.

          [ENOTDIR]
               A component of the path prefix is not a directory.

          [EROFS]
               The named file resides on a read-only file system.

     SEE ALSO
          chmod(2), exec(2), pipe(2), stat(2), <sys/stat.h>, umask(2)

     COPYRIGHTS
          Portions of this text are reprinted from IEEE Std 1003.1-
          1988, Portable Operating System Interface for Computer
          Environment, copyright © 1988 by the Institute of Electrical
          and Electronics Engineers, Inc., with the permission of the
          IEEE Standards Department.  To purchase IEEE Standards, call
          800/678-IEEE.

          In the event of a discrepancy between the electronic and the
          original printed version, the original version takes
          precedence.

     STANDARDS
          Any bits in the mode argument other than the file permission
          bits are ignored, regardless of whether they are set.

















     Licensed material--property of copyright holder(s)         Page 2