|
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)
|