*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> mknod (2)              



NAME    [Toc]    [Back]

       mknod - Create a FIFO or special file

SYNOPSIS    [Toc]    [Back]

       #include <sys/stat.h>

       int mknod(
               const char *path,
               mode_t mode,
               dev_t device );

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       mknod(): POSIX.1, XSH4.2, XSH5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

       Standards: standards(5)

PARAMETERS    [Toc]    [Back]

       Names  the  new  file.  If the final component of the path
       parameter names a symbolic link, the  link  will  be  traversed
  and  pathname resolution will continue.  Specifies
       the file type, attributes, and  access  permissions.  This
       parameter  is  constructed  with a logical OR operation on
       values described in the <sys/mode.h> header file.  Depends
       upon the configuration and is used only if the mode parameter
 specifies a block or character special file.  If  the
       file you specify is a remote file, the value of the device
       parameter must be meaningful on the node  where  the  file

DESCRIPTION    [Toc]    [Back]

       The  mknod()  function  creates  a  special  file or FIFO.
       Using the mknod() function to create file types other than
       FIFO special requires superuser privilege.

       For  the mknod() function to complete successfully, a process
 must have search permission and write  permission  in
       the parent directory of the path parameter.

       The  new file has the following characteristics: File type
       as specified by the mode parameter Owner  ID  set  to  the
       process  effective user ID Group ID set to the group ID of
       the file's parent directory Permission and attribute  bits
       set according to the value of the mode parameter

              All bits set in the process file mode creation mask
              are cleared. See the umask(2) function.

RETURN VALUES    [Toc]    [Back]

       Upon successful completion of the mknod() function a value
       of  0  (zero)  is  returned.  Otherwise,  a value of -1 is
       returned and errno is set to indicate the error.

ERRORS    [Toc]    [Back]

       If the mknod() function fails, the new file is not created
       and  errno  may  be  set to one of the following values: A
       component of the path prefix denies search permission,  or
       write  permission is denied on the parent directory of the
       FIFO to be created.  The directory in which the entry  for
       the  new  link  is being placed cannot be extended because
       the user's quota of disk blocks or inodes on the file system
 is exhausted.  The named file exists.  While accessing
       the file system, an I/O error occurred.  An invalid  argument
 has been specified.  The length of the path parameter
       exceeds PATH_MAX or a pathname component  is  longer  than
       NAME_MAX.   A  component of the path prefix does not exist
       or the path parameter points  to  an  empty  string.   The
       directory  that  would  contain  the  new  file  cannot be
       extended or the file system  is  out  of  file  allocation
       resources.  A component of the path prefix is not a directory.
  The mode parameter specifies a file type other than
       FIFO  and the calling process does not have the sufficient
       privilege.  The directory in which the file is to be  created
 is located on a read-only file system.

SEE ALSO    [Toc]    [Back]

       Functions: chmod(2), mkdir(2), open(2), umask(2), stat(2)

       Commands: chmod(1), mkdir(1)

       Others: standards(5)

[ Back ]
 Similar pages
Name OS Title
mkfifo IRIX make FIFO special file
mkfifo IRIX make a FIFO special file
pxfisfifo IRIX Tests for pipe or a FIFO special file
mkfifo Linux make a FIFO special file (a named pipe)
mknod IRIX build special file or named pipe (FIFO)
VOP_CREATE FreeBSD create a file, socket, fifo, device, directory or symlink
VOP_MKNOD FreeBSD create a file, socket, fifo, device, directory or symlink
VOP_SYMLINK FreeBSD create a file, socket, fifo, device, directory or symlink
VOP_MKDIR FreeBSD create a file, socket, fifo, device, directory or symlink
mkfifo Tru64 Makes FIFO special files
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service