mknod(2)                                                 mknod(2)



NAME
     mknod - makes a directory, or a special or ordinary file

SYNOPSIS
     int mknod(path, mode, dev)
     char *path;
     int mode, dev;

DESCRIPTION
     mknod creates a new file named by the pathname pointed to by
     path.  The mode of the new file is initialized from mode,
     where the value of mode is interpreted as follows:

          0170000 file type mask; one of the following:

               0010000 FIFO special
               0020000 character special
               0040000 directory
               0060000 block special
               0100000 or 0000000 ordinary file
               0120000 symbolic link
               0140000 socket
               0004000 set user ID on execution
               0002000 set group ID on execution
               0001000 save text image after execution

          0000777 access permissions; constructed from the
          following:

               0000400 read by owner
               0000200 write by owner
               0000100 execute (search on directory) by owner
               0000070 read, write, execute (search) by group
               0000007 read, write, execute (search) by others

     The owner ID of the file is set to the effective user ID of
     the process.  The group ID of the file is set to the
     effective group ID of the process.

     Values of mode other than those above are undefined and
     should not be used.  The low-order 9 bits of mode are
     modified by the process's file mode creation mask:  all bits
     set in the process's file mode creation mask are cleared
     (see umask(2)).  If mode indicates a block or character
     special file, dev is a configuration-dependent specification
     of a character or block I/O device.  If mode does not
     indicate a block special or character special device, dev is
     ignored.

     mknod may be invoked only by the superuser for file types
     other than FIFO special.




January 1992                                                    1

mknod(2)                                                 mknod(2)



STATUS MESSAGES AND VALUES
     Upon successful completion a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

     The mknod command will fail and the new file will not be
     created if one or more of the following is true:

     EPERM
          The effective user ID of the process is not superuser.

     EPERM
          A pathname contains a character with the high-order bit
          set.

     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 directory.

     ENOENT
          A component of the path prefix does not exist.

     EROFS
          The directory in which the file is to be created is
          located on a read-only file system.

     EEXIST
          The named file exists.

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

SEE ALSO
     chmod(2), exec(2), stat(2), umask(2), fs(4), stat(5)

     mkdir(1), mknod(1) in A/UX Command Reference











2                                                    January 1992