IPB
>  Man Pages > Unix > Solaris 10 11/06 > Section 2 > mknod man page

mknod man page

Section 2 - Solaris 10 11/06 Man Pages

Other operating system man pages available here


Advanced Search

Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!





System Calls                                             mknod(2)



NAME
     mknod - make a directory, a special file, or a regular file

SYNOPSIS
     #include <sys/stat.h>

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

DESCRIPTION
     The mknod() function creates a new file named  by  the  path
     name  pointed  to  by path. The file type and permissions of
     the new file are initialized from mode.

     The file type is specified in mode by the S_IFMT bits, which
     must be set to one of the following values:

     S_IFIFO         fifo special



     S_IFCHR         character special



     S_IFDIR         directory



     S_IFBLK         block special



     S_IFREG         ordinary file



     The file access permissions are specified  in  mode  by  the
     0007777  bits, and may be constructed by a bitwise OR opera-
     tion of the following values:

     S_ISUID       04000       Set user ID on execution.
     S_ISGID       020#0       Set group ID on execution if  #  is
                               7,  5,  3,  or  1. Enable mandatory
                               file/record locking if # is  6,  4,
                               2, or 0
     S_ISVTX       01000       On directories, restricted deletion
                               flag;  on  regular  files  on a UFS
                               file system, do not cache flag.
     S_IRWXU       00700       Read, write, execute by owner.
     S_IRUSR       00400       Read by owner.
     S_IWUSR       00200       Write by owner.




SunOS 5.10          Last change: 19 Feb 2004                    1






System Calls                                             mknod(2)



     S_IXUSR       00100       Execute (search if a directory)  by
                               owner.
     S_IRWXG       00070       Read, write, execute by group.
     S_IRGRP       00040       Read by group.
     S_IWGRP       00020       Write by group.
     S_IXGRP       00010       Execute by group.
     S_IRWXO       00007       Read, write,  execute  (search)  by
                               others.
     S_IROTH       00004       Read by others.
     S_IWOTH       00002       Write by others
     S_IXOTH       00001       Execute 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 effec-
     tive group ID of the process.  However, if the  S_ISGID  bit
     is  set  in  the  parent directory, then the group ID of the
     file is inherited from the parent.  If the group ID  of  the
     new file does not match the effective group ID or one of the
     supplementary group IDs, the S_ISGID bit is cleared.

     The access permission 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.
     See makedev(3C).

     If path is a symbolic link, it is not followed.

RETURN VALUES
     Upon successful completion, mknod() returns 0. Otherwise, it
     returns -1, the new file is not created, and errno is set to
     indicate the error.

ERRORS
     The mknod() function will fail if:

     EACCES                  A  component  of  the  path   prefix
                             denies  search  permission, or write
                             permission is denied on  the  parent
                             directory.



     EDQUOT                  The directory  where  the  new  file
                             entry  is  being  placed  cannot  be
                             extended because the user's quota of
                             disk  blocks on that file system has
                             been exhausted, or the user's  quota



SunOS 5.10          Last change: 19 Feb 2004                    2






System Calls                                             mknod(2)



                             of  inodes  on the file system where
                             the file is being created  has  been
                             exhausted.



     EEXIST                  The named file exists.



     EFAULT                  The path argument points to an ille-
                             gal address.



     EINTR                   A signal was caught during the  exe-
                             cution of the mknod() function.



     EINVAL                  An invalid argument exists.



     EIO                     An I/O error occurred while  access-
                             ing the file system.



     ELOOP                   Too many symbolic links were encoun-
                             tered in translating path.



     ENAMETOOLONG            The  length  of  the  path  argument
                             exceeds {PATH_MAX}, or the length of
                             a path component exceeds  {NAME_MAX}
                             while _POSIX_NO_TRUNC is in effect.



     ENOENT                  A  component  of  the  path   prefix
                             specified  by  path does not name an
                             existing directory  or  path  is  an
                             empty string.



     ENOLINK                 The path argument points to a remote
                             machine and the link to that machine
                             is no longer active.




SunOS 5.10          Last change: 19 Feb 2004                    3






System Calls                                             mknod(2)



     ENOSPC                  The directory that would contain the
                             new  file  cannot be extended or the
                             file system is out of  file  alloca-
                             tion resources.



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



     EPERM                   Not all privileges are  asserted  in
                             the  effective  set  of  the calling
                             process.



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



     The mknod() function may fail if:

     ENAMETOOLONG            Pathname resolution  of  a  symbolic
                             link produced an intermediate result
                             whose length exceeds {PATH_MAX}.



USAGE
     Applications should use the mkdir(2) function  to  create  a
     directory  because  appropriate permissions are not required
     and because mknod() might not  establish  directory  entries
     for  the directory itself (.) and the parent directory (..).
     The mknod() function can be invoked  only  by  a  privileged
     user  for file types other than FIFO special. The mkfifo(3C)
     function should be used to create FIFOs.

     Doors  are  created  using  door_create(3DOOR)  and  can  be
     attached  to  the  file  system  using fattach(3C). Symbolic
     links can be created using symlink(2). An endpoint for  com-
     munication can be created using socket(3SOCKET).

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:






SunOS 5.10          Last change: 19 Feb 2004                    4






System Calls                                             mknod(2)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     chmod(2), creat(2),  exec(2),  mkdir(2),  open(2),  stat(2),
     symlink(2),   umask(2),   door_create(3DOOR),   fattach(3C),
     makedev(3C),  mkfifo(3C),  socket(3SOCKET),   stat.h(3HEAD),
     attributes(5), privileges(5), standards(5)









































SunOS 5.10          Last change: 19 Feb 2004                    5





Man(1) output converted with man2html and wrapped by fishsponge

This page was generated on Wed Sep 12 11:27:02 GMT 2007

Your favourite pages:

No pages logged yet.
Trying to save cookie...

Top 10 most popular pages:

CPAN man page (4290 hits)
(Suse Linux 10.1)

ssh man page (4160 hits)
(Suse Linux 10.1)

adv_cap_autoneg man page (3469 hits)
(Solaris 10 11_06)

sqlite3 man page (3370 hits)
(openSUSE 10.2)

svn man page (3036 hits)
(FreeBSD 6.2)

startproc man page (1856 hits)
(Suse Linux 10.1)

pprosetup man page (1576 hits)
(Solaris 10 11_06)

signal man page (1541 hits)
(Suse Linux 10.1)

netcat man page (1508 hits)
(Suse Linux 10.1)

ssh-socks5-proxy-connect man page (1450 hits)
(Solaris 10 11_06)

Useful Links

Go Back

Visitor Statistics


Valid XHTML 1.0 Transitional     Valid CSS!

Partners: Cambridge Plus :: PYRENEES ACTIVITY HOLIDAYS :: PIC Boot Loader :: <Link Available>
Unix Man Pages / Linux Man Pages :: HiFi Forum :: SIP VoIP Phone & Provider Reviews :: UNIX/Linux Forum Archives

More info on advertising on Unix/Linux Forum