mkfifo(3P)                                             mkfifo(3P)



     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
          mkfifo creates a new FIFO special file named by the pathname
          pointed to by path.  The mode of the new FIFO is initialized
          from mode.  The file permission bits of mode are modified by
          the file creation mask of the process. If bits in mode other
          than file permissions are set, the permissions on the FIFO
          will be undefined.

          For the POSIX environment, the following constants for mode
          are defined in <sys/stat.h> :

          S_IRUSR        read permission, owner

          S_IWUSER       writer permission, owner

          S_IXUSR        execute/search permission, owner

          S_IRGRP        read permission, group

          S_IWGRP        writer permission, group

          S_IXGRP        execute/search permission, group

          S_IROTH        read permission, others

          S_IWOTH        writer permission, others

          S_IXOTH        execute/search permission, others

          The owner ID of the FIFO is set to the effective user ID of
          the process.  The group ID of the FIFO is set to the effec-
          tive group ID of the process.

          On successful completion, mkfifo marks for update the
          st_atime, st_ctime, and st_mtime fields for the file.  The
          st_ctime and st_mtime fields of the directory that contains
          the new entry are also marked for update.

     RETURN VALUE
          On successful completion, mkfifo returns a value of 0.  Oth-
          erwise, a value of -1 is returned, no FIFO is created, and



     April, 1990                                                     1

     mkfifo(3P)                                             mkfifo(3P)



          errno is set to indicate the error.

     ERRORS
          mkfifo will fail and the new FIFO will not be created if one
          or more of the following are true:

          [ENAMETOOLONG]
                       A component of a pathname exceeded NAME_MAX
                       characters, or an entire pathname exceeded
                       PATH_MAX.

          [ELOOP]      Too many symbolic links were encountered in
                       translating a pathname.

          [ENOTDIR]    A component of the path prefix is not a direc-
                       tory.

          [ENOENT]     A component of the path prefix does not exist.

          [EROFS]      The directory in which the FIFO is to be creat-
                       ed is located on a read-only file system.

          [EEXIST]     The named FIFO exists.

          [EFAULT]     path points outside the allocated address space
                       of the process.

     SEE ALSO
          mknod(2), umask(2).


























     2                                                     April, 1990