OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man2 / mknod.2
index 597fdf7..9168755 100644 (file)
 .\" 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>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.\"WORD:       node            ノード
-.\"WORD:       permission      許可属性
-.\"WORD:       resolve         (パス名を) 解決する
-.\"
-.TH MKNOD 2 2010-09-20 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
+.\"*******************************************************************
+.TH MKNOD 2 2010\-09\-20 Linux "Linux Programmer's Manual"
 .SH 名前
-.\"O mknod \- create a special or ordinary file
 mknod \- 特殊ファイルや通常のファイルを作成する
-.\"O .SH SYNOPSIS
 .SH 書式
 .nf
-.B #include <sys/types.h>
-.B #include <sys/stat.h>
-.B #include <fcntl.h>
-.B #include <unistd.h>
+\fB#include <sys/types.h>\fP
+\fB#include <sys/stat.h>\fP
+\fB#include <fcntl.h>\fP
+\fB#include <unistd.h>\fP
 .sp
-.BI "int mknod(const char *" pathname ", mode_t " mode ", dev_t " dev );
+\fBint mknod(const char *\fP\fIpathname\fP\fB, mode_t \fP\fImode\fP\fB, dev_t \fP\fIdev\fP\fB);\fP
 .fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR mknod ():
+\fBmknod\fP():
 .ad l
 .RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .RE
 .ad
-.\"O .SH DESCRIPTION
 .SH 説明
-.\"O The system call
-.\"O .BR mknod ()
-.\"O creates a file system node (file, device special file or
-.\"O named pipe) named
-.\"O .IR pathname ,
-.\"O with attributes specified by
-.\"O .I mode
-.\"O and
-.\"O .IR dev .
-システムコール
-.BR mknod ()
-は
-.I pathname
-という名前のファイルシステム・ノード
-(ファイル、デバイススペシャルファイル、名前付きパイプ) を、
-属性
-.I mode
-と
-.I dev
-の指定にしたがって作成する。
+システムコール \fBmknod\fP()  は \fIpathname\fP という名前のファイルシステム・ノード
+(ファイル、デバイススペシャルファイル、名前付きパイプ) を、 属性 \fImode\fP と \fIdev\fP の指定にしたがって作成する。
 
-.\"O The
-.\"O .I mode
-.\"O argument specifies both the permissions to use and the type of node
-.\"O to be created.
-.I mode
-引き数には、作成するノードの許可属性 (permission) とタイプを指定する。
-.\"O It should be a combination (using bitwise OR) of one of the file types
-.\"O listed below and the permissions for the new node.
-.I mode
-の指定は以下にあげるファイルタイプのうちの 1 つと、
-許可属性の組合せ (ビットごとの OR を使用) で行う。
+\fImode\fP 引き数には、作成するノードの許可属性 (permission) とタイプを指定する。 \fImode\fP
+の指定は以下にあげるファイルタイプのうちの 1 つと、 許可属性の組合せ (ビットごとの OR を使用) で行う。
 
-.\"O The permissions are modified by the process's
-.\"O .I umask
-.\"O in the usual way: the permissions of the created node are
-.\"O .IR "(mode & ~umask)" .
-許可属性は通常通り、プロセスの
-.I umask
-によって修正され、作成されたノードの許可属性は
-.I "(mode & ~umask)"
-となる。
+許可属性は通常通り、プロセスの \fIumask\fP によって修正され、作成されたノードの許可属性は \fI(mode & ~umask)\fP となる。
 
-.\"O The file type must be one of
-.\"O .BR S_IFREG ,
-.\"O .BR S_IFCHR ,
-.\"O .BR S_IFBLK ,
-.\"O .B S_IFIFO
-.\"O or
-.\"O .B S_IFSOCK
-.\"O .\" (S_IFSOCK since Linux 1.2.4)
-.\"O to specify a regular file (which will be created empty), character
-.\"O special file, block special file, FIFO (named pipe), or UNIX domain socket,
-.\"O respectively.
-.\"O (Zero file type is equivalent to type
-.\"O .BR S_IFREG .)
-ファイルタイプには
-.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
-と同じである)。
+.\" (S_IFSOCK since Linux 1.2.4)
+ファイルタイプには \fBS_IFREG\fP, \fBS_IFCHR\fP, \fBS_IFBLK\fP, \fBS_IFIFO\fP, \fBS_IFSOCK\fP
+のいずれかを指定しなければならない。 それぞれ順に、通常のファイル (空のファイルとして作成される)・
+キャラクタスペシャルファイル・ブロックスペシャルファイル・ FIFO (名前付きパイプ)・UNIX ドメインソケットである (ファイルタイプ 0 は
+\fBS_IFREG\fP と同じである)。
 
-.\"O If the file type is
-.\"O .B S_IFCHR
-.\"O or
-.\"O .B S_IFBLK
-.\"O then
-.\"O .I dev
-.\"O specifies the major and minor numbers of the newly created device
-.\"O special file
-.\"O .RB ( makedev (3)
-.\"O may be useful to build the value for
-.\"O .IR dev );
-.\"O otherwise it is ignored.
-ファイルタイプが
-.B S_IFCHR
-または
-.B S_IFBLK
-のとき、
-.I dev
-には作成するデバイススペシャルファイルのメジャー番号と
-マイナー番号を指定する
-.RB ( makedev (3)
-は
-.I dev
-のこれらの番号を作成する際に役立つだろう)。
-それ以外の場合は
-.I dev
+ファイルタイプが \fBS_IFCHR\fP または \fBS_IFBLK\fP のとき、 \fIdev\fP には作成するデバイススペシャルファイルのメジャー番号と
+マイナー番号を指定する (\fBmakedev\fP(3)  は \fIdev\fP のこれらの番号を作成する際に役立つだろう)。 それ以外の場合は \fIdev\fP
 は無視される。
 
-.\"O If
-.\"O .I pathname
-.\"O already exists, or is a symbolic link, this call fails with an
-.\"O .B EEXIST
-.\"O error.
-.I pathname
-が既に存在する場合、またはシンボリックリンクの場合、
-この呼び出しは
-.B EEXIST
-エラーで失敗する。
+\fIpathname\fP が既に存在する場合、またはシンボリックリンクの場合、 この呼び出しは \fBEEXIST\fP エラーで失敗する。
 
-.\"O The newly created node will be owned by the effective user ID of the
-.\"O process.
-.\"O If the directory containing the node has the set-group-ID
-.\"O bit set, or if the file system is mounted with BSD group semantics, the
-.\"O new node will inherit the group ownership from its parent directory;
-.\"O otherwise it will be owned by the effective group ID of the process.
-新しく作成されたノードの所有者はプロセスの実効ユーザ ID にセットされる。
-新たに作られたノードを保持する
-親ディレクトリの set-group-ID ビットがセットされていたり、
-ファイルシステムが BSD のグループセマンティクスにしたがって
-マウントされている場合には、新しいノードのグループ所有権は親ディレクトリの
-グループ所有権を継承する (親ディレクトリと同じになる)。
+新しく作成されたノードの所有者はプロセスの実効ユーザ ID にセットされる。 新たに作られたノードを保持する 親ディレクトリの set\-group\-ID
+ビットがセットされていたり、 ファイルシステムが BSD のグループセマンティクスにしたがって
+マウントされている場合には、新しいノードのグループ所有権は親ディレクトリの グループ所有権を継承する (親ディレクトリと同じになる)。
 また、そうでなかった場合の所有グループはプロセスの実効グループ ID となる。
-.\"O .SH RETURN VALUE
 .SH 返り値
-.\"O .BR mknod ()
-.\"O returns zero on success, or \-1 if an error occurred (in which case,
-.\"O .I errno
-.\"O is set appropriately).
-.BR mknod ()
-は成功した場合 0 を、失敗した場合 \-1 を返す
-(失敗した場合
-.I errno
-がエラーの内容にしたがってセットされる)。
-.\"O .SH ERRORS
+\fBmknod\fP()  は成功した場合 0 を、失敗した場合 \-1 を返す (失敗した場合 \fIerrno\fP がエラーの内容にしたがってセットされる)。
 .SH エラー
-.TP
-.B EACCES
-.\"O The parent directory does not allow write permission to the process,
-.\"O or one of the directories in the path prefix of
-.\"O .I pathname
-.\"O did not allow search permission.
-.\"O (See also
-.\"O .BR path_resolution (7).)
-プロセスが親ディレクトリへの書き込み許可を持たない。
-もしくはパス名
-.I pathname
-中のディレクトリ部分のどれかに検索許可属性が無い
-.RB ( path_resolution (7)
-も参照すること)。
-.TP
-.B EEXIST
-.\"O .I pathname
-.\"O already exists.
-.\"O This includes the case where
-.\"O .I pathname
-.\"O is a symbolic link, dangling or not.
-.I pathname
-が既に存在する。
-これには
-.I pathname
-がシンボリック・リンクである場合も含まれる
-(シンボリック・リンクが壊れているか (dangling) どうかは関係ない)。
-.TP
-.B EFAULT
-.\"O .IR pathname " points outside your accessible address space."
-.I pathname
-がそのプロセスのアクセス可能なアドレス空間の外を指している。
-.TP
-.B EINVAL
-.\"O .I mode
-.\"O requested creation of something other than a regular file, device
-.\"O special file, FIFO or socket.
-.I mode
-が通常のファイル・デバイススペシャルファイル・FIFO・ソケット以外を
-作成するようにセットされている。
-.TP
-.B ELOOP
-.\"O Too many symbolic links were encountered in resolving
-.\"O .IR pathname .
-パス名
-.I pathname
-を解決するときに、含まれているシンボリックリンクが多すぎた。
-.TP
-.B ENAMETOOLONG
-.\"O .IR pathname " was too long."
-.I pathname
-が長過ぎる。
-.TP
-.B ENOENT
-.\"O A directory component in
-.\"O .I pathname
-.\"O does not exist or is a dangling symbolic link.
-.I pathname
-中で指定されているディレクトリが存在しないか、
-またはリンク先の無いシンボリックリンクである。
-.TP
-.B ENOMEM
-.\"O Insufficient kernel memory was available.
+.TP 
+\fBEACCES\fP
+プロセスが親ディレクトリへの書き込み許可を持たない。 もしくはパス名 \fIpathname\fP 中のディレクトリ部分のどれかに検索許可属性が無い
+(\fBpath_resolution\fP(7)  も参照すること)。
+.TP 
+\fBEEXIST\fP
+\fIpathname\fP がすでに存在する。 これには \fIpathname\fP がシンボリックリンクである場合も含まれる
+(シンボリックリンクがリンク切れか (dangling) どうかは関係ない)。
+.TP 
+\fBEFAULT\fP
+\fIpathname\fP がそのプロセスのアクセス可能なアドレス空間の外を指している。
+.TP 
+\fBEINVAL\fP
+\fImode\fP が通常のファイル・デバイススペシャルファイル・FIFO・ソケット以外を 作成するようにセットされている。
+.TP 
+\fBELOOP\fP
+パス名 \fIpathname\fP を解決するときに、含まれているシンボリックリンクが多すぎた。
+.TP 
+\fBENAMETOOLONG\fP
+\fIpathname\fP が長過ぎる。
+.TP 
+\fBENOENT\fP
+\fIpathname\fP 中のディレクトリ部分が存在しない、 もしくはリンク先の無いシンボリックリンクである。
+.TP 
+\fBENOMEM\fP
 十分なカーネルメモリが無い。
-.TP
-.B ENOSPC
-.\"O The device containing
-.\"O .I pathname
-.\"O has no room for the new node.
-.I pathname
-のあるデバイスに新たにノードを作成する空きが無い。
-.TP
-.B ENOTDIR
-.\"O A component used as a directory in
-.\"O .I pathname
-.\"O is not, in fact, a directory.
-.I pathname
-中のディレクトリ要素が、実際にはディレクトリでない。
-.TP
-.B EPERM
-.\"O .I mode
-.\"O requested creation of something other than a regular file,
-.\"O FIFO (named pipe), or UNIX domain socket, and the caller
-.\"O is not privileged (Linux: does not have the
-.\"O .B CAP_MKNOD
-.\"O capability);
-.\"O .\" For UNIX domain sockets and regular files, EPERM is only returned in
-.\"O .\" Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
-.\"O .\" use mknod() to make these files.
-.\"O also returned if the file system containing
-.\"O .I pathname
-.\"O does not support the type of node requested.
-.I mode
-は通常のファイル・FIFO (名前付きパイプ)・UNIX ドメインソケット以外を
-作成するようにセットされているが、実行者が特権
-(Linux では
-.B CAP_MKNOD
-ケーパビリティ (capability)) を持っていない。
-.\" UNIX ドメインソケットと通常ファイルに対して mknod() を行うと、
-.\" Linux 2.2 以前では EPERM を返すだけである。
-.\" Linux 2.4 以降では特権を持っていなくてもこれらのファイルを
-.\" 作成するのに mknod() を使用することができる。
-または
-.I pathname
+.TP 
+\fBENOSPC\fP
+\fIpathname\fP のあるデバイスに新たにノードを作成する空きが無い。
+.TP 
+\fBENOTDIR\fP
+\fIpathname\fP 中のディレクトリ要素が、実際にはディレクトリでない。
+.TP 
+\fBEPERM\fP
+.\" For UNIX domain sockets and regular files, EPERM is only returned in
+.\" Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
+.\" use mknod() to make these files.
+\fImode\fP は通常のファイル・FIFO (名前付きパイプ)・UNIX ドメインソケット以外を 作成するようにセットされているが、実行者が特権
+(Linux では \fBCAP_MKNOD\fP ケーパビリティ (capability)) を持っていない。 または \fIpathname\fP
 を保持するファイルシステムが、指定されたノード形式をサポートしていない。
-.TP
-.B EROFS
-.\"O .I pathname
-.\"O refers to a file on a read-only file system.
-.I pathname
-が読み出し専用ファイルシステム上のファイルを指している。
-.\"O .SH CONFORMING TO
+.TP 
+\fBEROFS\fP
+\fIpathname\fP が読み出し専用ファイルシステム上のファイルを指している。
 .SH 準拠
-.\"O SVr4, 4.4BSD, POSIX.1-2001 (but see below).
-.\"O .\" The Linux version differs from the SVr4 version in that it
-.\"O .\" does not require root permission to create pipes, also in that no
-.\"O .\" EMULTIHOP, ENOLINK, or EINTR error is documented.
-SVr4, 4.4BSD, POSIX.1-2001 (下記も参照).
-.\" Linux の実装は SVr4 の実装と異なり、パイプの作成には root 権限が不要である。
-.\" また EMULTIHOP と ENOLINK と EINTR のエラーについては記述されていない。
-.\"O .SH NOTES
+.\" The Linux version differs from the SVr4 version in that it
+.\" does not require root permission to create pipes, also in that no
+.\" EMULTIHOP, ENOLINK, or EINTR error is documented.
+SVr4, 4.4BSD, POSIX.1\-2001 (下記も参照).
 .SH 注意
-.\"O POSIX.1-2001 says: "The only portable use of
-.\"O .BR mknod ()
-.\"O is to create a FIFO-special file.
-.\"O If
-.\"O .I mode
-.\"O is not
-.\"O .B S_IFIFO
-.\"O or
-.\"O .I dev
-.\"O is not 0, the behavior of
-.\"O .BR mknod ()
-.\"O is unspecified."
-POSIX.1-2001 では次のように書いている:
-.RB 「 mknod ()
-の唯一の移植性のある使用法は、FIFO スペシャルファイルを作成することである。
-.I mode
-が
-.B S_IFIFO
-ではない場合、または
-.I dev
-が 0 ではない場合、
-.BR mknod ()
-の挙動は規定されていない。」
-.\"O However, nowadays one should never use
-.\"O .BR mknod ()
-.\"O for this purpose; one should use
-.\"O .BR mkfifo (3),
-.\"O a function especially defined for this purpose.
-しかしながら、現在ではこの目的のために
-.BR mknod ()
-を使用すべきではない。この目的のために特別に定義された関数である
-.BR mkfifo ()
-を使用すべきである。
+POSIX.1\-2001 では次のように書いている: 「\fBmknod\fP()  の唯一の移植性のある使用法は、FIFO
+スペシャルファイルを作成することである。 \fImode\fP が \fBS_IFIFO\fP ではない場合、または \fIdev\fP が 0 ではない場合、
+\fBmknod\fP()  の挙動は規定されていない。」 しかしながら、現在ではこの目的のために \fBmknod\fP()
+を使用すべきではない。この目的のために特別に定義された関数である \fBmkfifo\fP()  を使用すべきである。
 
-.\"O Under Linux, this call cannot be used to create directories.
-Linux では、ディレクトリを作成するために
-この呼び出しを使用することはできない。
-.\"O One should make directories with
-.\"O .BR mkdir (2).
-ディレクトリは
-.BR mkdir (2)
-で作成すべきである。
-.\"O .\" and one should make UNIX domain sockets with socket(2) and bind(2).
-.\" UNIX ドメインソケットは socket(2) と bind(2) で作成すべきである。
+.\" and one should make UNIX domain sockets with socket(2) and bind(2).
+Linux では、ディレクトリを作成するために この呼び出しを使用することはできない。 ディレクトリは \fBmkdir\fP(2)  で作成すべきである。
 
-.\"O There are many infelicities in the protocol underlying NFS.
-.\"O Some of these affect
-.\"O .BR mknod ().
-NFS を実現しているプロトコルには多くの不備が存在し、
-それらのいくつかは
-.BR mknod ()
-に影響を与える。
-.\"O .SH SEE ALSO
+NFS を実現しているプロトコルには多くの不備が存在し、 それらのいくつかは \fBmknod\fP()  に影響を与える。
 .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)
+\fBchmod\fP(2), \fBchown\fP(2), \fBfcntl\fP(2), \fBmkdir\fP(2), \fBmknodat\fP(2),
+\fBmount\fP(2), \fBsocket\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2),
+\fBmakedev\fP(3), \fBmkfifo\fP(3), \fBpath_resolution\fP(7)