[linuxjm/LDP_man-pages.git] / release / man2 / mknod.2

.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\"                               1993 Michael Haardt
.\"                               1993,1994 Ian Jackson.
.\" You may distribute it under the terms of the GNU General
.\" Public License. It comes with NO WARRANTY.
.\"
.\" Modified 1996-08-18 by urs
.\" Modified 2003-04-23 by Michael Kerrisk
.\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
.\"
.\"
.\" Japanese Version Copyright (c) 1997 SUTO, Mitsuaki
.\"         all rights reserved.
.\" Translated 1997-06-26, SUTO, Mitsuaki <suto@av.crl.sony.co.jp>
.\" Updated & Modified 1999-03-01, NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated & Modified 2001-06-04, Yuichi SATO <ysato@h4.dion.ne.jp>
.\" Updated & Modified 2003-07-26, Yuichi SATO <ysato444@yahoo.co.jp>
.\" Updated & Modified 2004-12-31, Yuichi SATO
.\" Updated 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.\"WORD:        node            ¥Î¡¼¥É
.\"WORD:        permission      µö²Ä°À­
.\"WORD:        resolve         (¥Ñ¥¹Ì¾¤ò) ²ò·è¤¹¤ë
.\"
.TH MKNOD 2 2010-09-20 "Linux" "Linux Programmer's Manual"
.SH ̾Á°
mknod \- Æüì¥Õ¥¡¥¤¥ë¤äÄ̾ï¤Î¥Õ¥¡¥¤¥ë¤òºîÀ®¤¹¤ë
.SH ½ñ¼°
.nf
.B #include <sys/types.h>
.B #include <sys/stat.h>
.B #include <fcntl.h>
.B #include <unistd.h>
.sp
.BI "int mknod(const char *" pathname ", mode_t " mode ", dev_t " dev );
.fi
.sp
.in -4n
glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
.RB ( feature_test_macros (7)
»²¾È):
.in
.sp
.BR mknod ():
.ad l
.RS 4
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
.RE
.ad
.SH ÀâÌÀ
¥·¥¹¥Æ¥à¥³¡¼¥ë
.BR mknod ()
¤Ï
.I pathname
¤È¤¤¤¦Ì¾Á°¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¡¦¥Î¡¼¥É
(¥Õ¥¡¥¤¥ë¡¢¥Ç¥Ð¥¤¥¹¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¡¢Ì¾Á°ÉÕ¤­¥Ñ¥¤¥×) ¤ò¡¢
°À­
.I mode
¤È
.I dev
¤Î»ØÄê¤Ë¤·¤¿¤¬¤Ã¤ÆºîÀ®¤¹¤ë¡£

.I mode
°ú¤­¿ô¤Ë¤Ï¡¢ºîÀ®¤¹¤ë¥Î¡¼¥É¤Îµö²Ä°À­ (permission) ¤È¥¿¥¤¥×¤ò»ØÄꤹ¤ë¡£
.I mode
¤Î»ØÄê¤Ï°Ê²¼¤Ë¤¢¤²¤ë¥Õ¥¡¥¤¥ë¥¿¥¤¥×¤Î¤¦¤Á¤Î 1 ¤Ä¤È¡¢
µö²Ä°À­¤ÎÁȹ礻 (¥Ó¥Ã¥È¤´¤È¤Î OR ¤ò»ÈÍÑ) ¤Ç¹Ô¤¦¡£

µö²Ä°À­¤ÏÄ̾ïÄ̤ꡢ¥×¥í¥»¥¹¤Î
.I umask
¤Ë¤è¤Ã¤Æ½¤Àµ¤µ¤ì¡¢ºîÀ®¤µ¤ì¤¿¥Î¡¼¥É¤Îµö²Ä°À­¤Ï
.I "(mode & ~umask)"
¤È¤Ê¤ë¡£

¥Õ¥¡¥¤¥ë¥¿¥¤¥×¤Ë¤Ï
.BR S_IFREG ,
.BR S_IFCHR ,
.BR S_IFBLK ,
.BR S_IFIFO ,
.B S_IFSOCK
.\" (S_IFSOCK ¤Ï Linux 1.2.4 ¤«¤é¸ºß¤¹¤ë)
¤Î¤¤¤º¤ì¤«¤ò»ØÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
¤½¤ì¤¾¤ì½ç¤Ë¡¢Ä̾ï¤Î¥Õ¥¡¥¤¥ë (¶õ¤Î¥Õ¥¡¥¤¥ë¤È¤·¤ÆºîÀ®¤µ¤ì¤ë)¡¦
¥­¥ã¥é¥¯¥¿¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¡¦¥Ö¥í¥Ã¥¯¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¡¦
FIFO (̾Á°ÉÕ¤­¥Ñ¥¤¥×)¡¦UNIX ¥É¥á¥¤¥ó¥½¥±¥Ã¥È¤Ç¤¢¤ë
(¥Õ¥¡¥¤¥ë¥¿¥¤¥× 0 ¤Ï
.B S_IFREG
¤ÈƱ¤¸¤Ç¤¢¤ë)¡£

¥Õ¥¡¥¤¥ë¥¿¥¤¥×¤¬
.B S_IFCHR
¤Þ¤¿¤Ï
.B S_IFBLK
¤Î¤È¤­¡¢
.I dev
¤Ë¤ÏºîÀ®¤¹¤ë¥Ç¥Ð¥¤¥¹¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¤Î¥á¥¸¥ã¡¼ÈÖ¹æ¤È
¥Þ¥¤¥Ê¡¼ÈÖ¹æ¤ò»ØÄꤹ¤ë
.RB ( makedev (3)
¤Ï
.I dev
¤Î¤³¤ì¤é¤ÎÈÖ¹æ¤òºîÀ®¤¹¤ëºÝ¤ËÌòΩ¤Ä¤À¤í¤¦)¡£
¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï
.I dev
¤Ï̵»ë¤µ¤ì¤ë¡£

.I pathname
¤¬´û¤Ë¸ºß¤¹¤ë¾ì¹ç¡¢¤Þ¤¿¤Ï¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¡¢
¤³¤Î¸Æ¤Ó½Ð¤·¤Ï
.B EEXIST
¥¨¥é¡¼¤Ç¼ºÇÔ¤¹¤ë¡£

¿·¤·¤¯ºîÀ®¤µ¤ì¤¿¥Î¡¼¥É¤Î½êÍ­¼Ô¤Ï¥×¥í¥»¥¹¤Î¼Â¸ú¥æ¡¼¥¶ ID ¤Ë¥»¥Ã¥È¤µ¤ì¤ë¡£
¿·¤¿¤Ëºî¤é¤ì¤¿¥Î¡¼¥É¤òÊÝ»ý¤¹¤ë
¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤Î set-group-ID ¥Ó¥Ã¥È¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤¿¤ê¡¢
¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬ BSD ¤Î¥°¥ë¡¼¥×¥»¥Þ¥ó¥Æ¥£¥¯¥¹¤Ë¤·¤¿¤¬¤Ã¤Æ
¥Þ¥¦¥ó¥È¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢¿·¤·¤¤¥Î¡¼¥É¤Î¥°¥ë¡¼¥×½êÍ­¸¢¤Ï¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤Î
¥°¥ë¡¼¥×½êÍ­¸¢¤ò·Ñ¾µ¤¹¤ë (¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤ÈƱ¤¸¤Ë¤Ê¤ë)¡£
¤Þ¤¿¡¢¤½¤¦¤Ç¤Ê¤«¤Ã¤¿¾ì¹ç¤Î½êÍ­¥°¥ë¡¼¥×¤Ï¥×¥í¥»¥¹¤Î¼Â¸ú¥°¥ë¡¼¥× ID ¤È¤Ê¤ë¡£
.SH ÊÖ¤êÃÍ
.BR mknod ()
¤ÏÀ®¸ù¤·¤¿¾ì¹ç 0 ¤ò¡¢¼ºÇÔ¤·¤¿¾ì¹ç \-1 ¤òÊÖ¤¹
(¼ºÇÔ¤·¤¿¾ì¹ç
.I errno
¤¬¥¨¥é¡¼¤ÎÆâÍƤˤ·¤¿¤¬¤Ã¤Æ¥»¥Ã¥È¤µ¤ì¤ë)¡£
.SH ¥¨¥é¡¼
.TP
.B EACCES
¥×¥í¥»¥¹¤¬¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤Ø¤Î½ñ¤­¹þ¤ßµö²Ä¤ò»ý¤¿¤Ê¤¤¡£
¤â¤·¤¯¤Ï¥Ñ¥¹Ì¾
.I pathname
Ãæ¤Î¥Ç¥£¥ì¥¯¥È¥êÉôʬ¤Î¤É¤ì¤«¤Ë¸¡º÷µö²Ä°À­¤¬Ìµ¤¤
.RB ( path_resolution (7)
¤â»²¾È¤¹¤ë¤³¤È)¡£
.TP
.B EEXIST
.I pathname
¤¬´û¤Ë¸ºß¤¹¤ë¡£
¤³¤ì¤Ë¤Ï
.I pathname
¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Ç¤¢¤ë¾ì¹ç¤â´Þ¤Þ¤ì¤ë
(¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤¬²õ¤ì¤Æ¤¤¤ë¤« (dangling) ¤É¤¦¤«¤Ï´Ø·¸¤Ê¤¤)¡£
.TP
.B EFAULT
.I pathname
¤¬¤½¤Î¥×¥í¥»¥¹¤Î¥¢¥¯¥»¥¹²Äǽ¤Ê¥¢¥É¥ì¥¹¶õ´Ö¤Î³°¤ò»Ø¤·¤Æ¤¤¤ë¡£
.TP
.B EINVAL
.I mode
¤¬Ä̾ï¤Î¥Õ¥¡¥¤¥ë¡¦¥Ç¥Ð¥¤¥¹¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¡¦FIFO¡¦¥½¥±¥Ã¥È°Ê³°¤ò
ºîÀ®¤¹¤ë¤è¤¦¤Ë¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¡£
.TP
.B ELOOP
¥Ñ¥¹Ì¾
.I pathname
¤ò²ò·è¤¹¤ë¤È¤­¤Ë¡¢´Þ¤Þ¤ì¤Æ¤¤¤ë¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤¬Â¿¤¹¤®¤¿¡£
.TP
.B ENAMETOOLONG
.I pathname
¤¬Ä¹²á¤®¤ë¡£
.TP
.B ENOENT
.I pathname
Ãæ¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤¬Â¸ºß¤·¤Ê¤¤¤«¡¢
¤Þ¤¿¤Ï¥ê¥ó¥¯Àè¤Î̵¤¤¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Ç¤¢¤ë¡£
.TP
.B ENOMEM
½½Ê¬¤Ê¥«¡¼¥Í¥ë¥á¥â¥ê¤¬Ìµ¤¤¡£
.TP
.B ENOSPC
.I pathname
¤Î¤¢¤ë¥Ç¥Ð¥¤¥¹¤Ë¿·¤¿¤Ë¥Î¡¼¥É¤òºîÀ®¤¹¤ë¶õ¤­¤¬Ìµ¤¤¡£
.TP
.B ENOTDIR
.I pathname
Ãæ¤Î¥Ç¥£¥ì¥¯¥È¥êÍ×ÁǤ¬¡¢¼ÂºÝ¤Ë¤Ï¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤¤¡£
.TP
.B EPERM
.I mode
¤ÏÄ̾ï¤Î¥Õ¥¡¥¤¥ë¡¦FIFO (̾Á°ÉÕ¤­¥Ñ¥¤¥×)¡¦UNIX ¥É¥á¥¤¥ó¥½¥±¥Ã¥È°Ê³°¤ò
ºîÀ®¤¹¤ë¤è¤¦¤Ë¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤ë¤¬¡¢¼Â¹Ô¼Ô¤¬Æø¢
(Linux ¤Ç¤Ï
.B CAP_MKNOD
¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability)) ¤ò»ý¤Ã¤Æ¤¤¤Ê¤¤¡£
.\" UNIX ¥É¥á¥¤¥ó¥½¥±¥Ã¥È¤ÈÄ̾ï¥Õ¥¡¥¤¥ë¤ËÂФ·¤Æ mknod() ¤ò¹Ô¤¦¤È¡¢
.\" Linux 2.2 °ÊÁ°¤Ç¤Ï EPERM ¤òÊÖ¤¹¤À¤±¤Ç¤¢¤ë¡£
.\" Linux 2.4 °Ê¹ß¤Ç¤ÏÆø¢¤ò»ý¤Ã¤Æ¤¤¤Ê¤¯¤Æ¤â¤³¤ì¤é¤Î¥Õ¥¡¥¤¥ë¤ò
.\" ºîÀ®¤¹¤ë¤Î¤Ë mknod() ¤ò»ÈÍѤ¹¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
¤Þ¤¿¤Ï
.I pathname
¤òÊÝ»ý¤¹¤ë¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤¬¡¢»ØÄꤵ¤ì¤¿¥Î¡¼¥É·Á¼°¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£
.TP
.B EROFS
.I pathname
¤¬Æɤ߽Ф·ÀìÍÑ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¾å¤Î¥Õ¥¡¥¤¥ë¤ò»Ø¤·¤Æ¤¤¤ë¡£
.SH ½àµò
SVr4, 4.4BSD, POSIX.1-2001 (²¼µ­¤â»²¾È).
.\" Linux ¤Î¼ÂÁõ¤Ï SVr4 ¤Î¼ÂÁõ¤È°Û¤Ê¤ê¡¢¥Ñ¥¤¥×¤ÎºîÀ®¤Ë¤Ï root ¸¢¸Â¤¬ÉÔÍפǤ¢¤ë¡£
.\" ¤Þ¤¿ EMULTIHOP ¤È ENOLINK ¤È EINTR ¤Î¥¨¥é¡¼¤Ë¤Ä¤¤¤Æ¤Ïµ­½Ò¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
.SH Ãí°Õ
POSIX.1-2001 ¤Ç¤Ï¼¡¤Î¤è¤¦¤Ë½ñ¤¤¤Æ¤¤¤ë¡§
.RB ¡Ö mknod ()
¤ÎÍ£°ì¤Î°Ü¿¢À­¤Î¤¢¤ë»ÈÍÑË¡¤Ï¡¢FIFO ¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¤òºîÀ®¤¹¤ë¤³¤È¤Ç¤¢¤ë¡£
.I mode
¤¬
.B S_IFIFO
¤Ç¤Ï¤Ê¤¤¾ì¹ç¡¢¤Þ¤¿¤Ï
.I dev
¤¬ 0 ¤Ç¤Ï¤Ê¤¤¾ì¹ç¡¢
.BR mknod ()
¤ÎµóÆ°¤Ïµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¡£¡×
¤·¤«¤·¤Ê¤¬¤é¡¢¸½ºß¤Ç¤Ï¤³¤ÎÌÜŪ¤Î¤¿¤á¤Ë
.BR mknod ()
¤ò»ÈÍѤ¹¤Ù¤­¤Ç¤Ï¤Ê¤¤¡£¤³¤ÎÌÜŪ¤Î¤¿¤á¤ËÆÃÊ̤ËÄêµÁ¤µ¤ì¤¿´Ø¿ô¤Ç¤¢¤ë
.BR mkfifo ()
¤ò»ÈÍѤ¹¤Ù¤­¤Ç¤¢¤ë¡£

Linux ¤Ç¤Ï¡¢¥Ç¥£¥ì¥¯¥È¥ê¤òºîÀ®¤¹¤ë¤¿¤á¤Ë
¤³¤Î¸Æ¤Ó½Ð¤·¤ò»ÈÍѤ¹¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤¡£
¥Ç¥£¥ì¥¯¥È¥ê¤Ï
.BR mkdir (2)
¤ÇºîÀ®¤¹¤Ù¤­¤Ç¤¢¤ë¡£
.\" UNIX ¥É¥á¥¤¥ó¥½¥±¥Ã¥È¤Ï socket(2) ¤È bind(2) ¤ÇºîÀ®¤¹¤Ù¤­¤Ç¤¢¤ë¡£

NFS ¤ò¼Â¸½¤·¤Æ¤¤¤ë¥×¥í¥È¥³¥ë¤Ë¤Ï¿¤¯¤ÎÉÔÈ÷¤¬Â¸ºß¤·¡¢
¤½¤ì¤é¤Î¤¤¤¯¤Ä¤«¤Ï
.BR mknod ()
¤Ë±Æ¶Á¤òÍ¿¤¨¤ë¡£
.SH ´ØÏ¢¹àÌÜ
.BR chmod (2),
.BR chown (2),
.BR fcntl (2),
.BR mkdir (2),
.BR mknodat (2),
.BR mount (2),
.BR socket (2),
.BR stat (2),
.BR umask (2),
.BR unlink (2),
.BR makedev (3),
.BR mkfifo (3),
.BR path_resolution (7)