MKNOD(2)                                                              MKNOD(2)



NAME
       mknod - make a special file

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

DESCRIPTION
       _M_k_n_o_d  creates a new file whose name is _p_a_t_h_.  The mode of the new file
       (including special file bits) is initialized from _m_o_d_e.   (The  protec‐
       tion  part  of  the  mode  is  modified by the process’s mode mask (see
       _u_m_a_s_k(2))).  The first block pointer of the i-node is initialized  from
       _d_e_v and is used to specify which device the special file refers to.

       If  mode indicates a block or character special file, _d_e_v is a configu‐
       ration dependent specification of a character or block I/O device.   If
       _m_o_d_e does not indicate a block special or character special device, _d_e_v
       is ignored.

       _M_k_n_o_d may be invoked only by the super-user.

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

ERRORS
       _M_k_n_o_d will fail and the file mode will be unchanged if:

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

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

       [ENAMETOOLONG] A component of a pathname exceeded 255 characters, or an
                      entire path name exceeded 1023 characters.

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

       [EACCES]       Search  permission is denied for a component of the path
                      prefix.

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

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

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

       [EIO]          An I/O error occurred while making the  directory  entry
                      or allocating the inode.

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

       [ENOSPC]       There are no free inodes on the file system on which the
                      node is being created.

       [EDQUOT]       The  directory  in  which  the entry for the new node is
                      being placed cannot be extended because the user’s quota
                      of  disk blocks on the file system containing the direc‐
                      tory has been exhausted.

       [EDQUOT]       The user’s quota of inodes on the file system  on  which
                      the node is being created has been exhausted.

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

       [EEXIST]       The named file exists.

       [EFAULT]       _P_a_t_h  points  outside  the  process’s  allocated address
                      space.

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



4th Berkeley Distribution        May 23, 1986                         MKNOD(2)