MKNOD(2)                COMMAND REFERENCE                MKNOD(2)



NAME
     mknod - make a special file

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

DESCRIPTION
     Mknod creates a new special file whose name is path. The
     mode of the new file (including special file bits) is
     initialized from mode.  (The protection part of the mode is
     modified by the process's mode mask; see umask(2)).  The
     first block pointer of the i-node is initialized from dev
     and is used to specify which device the special file refers
     to.

     For a list of modes, see stat(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 super-user.

DIAGNOSTICS
     Mknod will fail and the file mode will be unchanged if:

     [EPERM]
         The process's effective user ID is not super-user.

     [ENOASCII]
         The pathname contains a character with the high-order
         bit set.

     [ENAMETOOLONG]
         The argument path is too long.

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

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

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

     [EEXIST]
         The named file already exists.

     [EFAULT]



Printed 10/17/86                                                1

MKNOD(2)                COMMAND REFERENCE                MKNOD(2)



         Path points outside the process's allocated address
         space.

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

     [EIO]
         An I/O error occurred while writing to the file system.

     [EACCES]
         Search permission is denied for any component of the
         path name.  If the target directory is located on a
         remote host, this error code will be returned if the
         local host name and local user name does not appear in
         /usr/lib/dfs/access on the remote machine.  See access
         (dfs)(5n).

     [ENFILE]
         The system inode table is full.

     [ENOSPC]
         The file system is out of inodes.

     [ENOSPC]
         The directory in which the entry for the new file is
         being placed cannot be extended because there is no
         space left on the file system containing the directory.

     [EDFSNOSUCHHOST]
         The pathname referenced a remote host, but when we
         broadcast a request for its address, no host responded.

RETURN VALUE
     Upon successful completion a value of 0 is returned.
     Otherwise, a value of -1 is returned and errno is set to
     indicate the error.

SEE ALSO
     chmod(2), stat(2), umask(2).















Printed 10/17/86                                                2

%%index%%
na:72,63;
sy:135,375;
de:510,920;
di:1430,701;2275,1130;
rv:3405,235;
se:3640,131;
%%index%%000000000116