release/man2/mkdir.2

   1 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;
   2 .\"             and Copyright (C) 1993 Michael Haardt
   3 .\"             and Copyright (C) 1993,1994 Ian Jackson.
   4 .\"
   5 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
   6 .\" You may distribute it under the terms of the GNU General
   7 .\" Public License. It comes with NO WARRANTY.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\"*******************************************************************
  11 .\"
  12 .\" This file was generated with po4a. Translate the source file.
  13 .\"
  14 .\"*******************************************************************
  15 .\"
  16 .\" Japanese Version Copyright (c) 1997 SUTO, Mitsuaki
  17 .\"         all rights reserved.
  18 .\" Translated Thu Jun 26 20:47:26 JST 1997
  19 .\"         by SUTO, Mitsuaki <suto@av.crl.sony.co.jp>
  20 .\" Updated & Modified Fri Jan 22 1999
  21 .\"         by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  22 .\" Updated Fri Sep 13 JST 2000 by Kentaro Shirakata <argrath@ub32.org>
  23 .\" Updated Sun May 23 JST 2004 by Kentaro Shirakata <argrath@ub32.org>
  24 .\" Updated Thu Mar 24 JST 2005 by Kentaro Shirakata <argrath@ub32.org>
  25 .\" Updated Wed Jul 30 JST 2008 by Kentaro Shirakata <argrath@ub32.org>
  26 .\" Updated 2012-05-08, Akihiro MOTOKI <amotoki@gmail.com>
  27 .\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
  28 .\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
  29 .\"
  30 .TH MKDIR 2 2013\-01\-27 Linux "Linux Programmer's Manual"
  31 .SH 名前
  32 mkdir \- ディレクトリを作成する
  33 .SH 書式
  34 .nf
  35 .\" .B #include <unistd.h>
  36 \fB#include <sys/stat.h>\fP
  37 \fB#include <sys/types.h>\fP
  38 .sp
  39 \fBint mkdir(const char *\fP\fIpathname\fP\fB, mode_t \fP\fImode\fP\fB);\fP
  40 .fi
  41 .SH 説明
  42 \fBmkdir\fP()  は \fIpathname\fP で示される名前のディレクトリを作成しようとする。
  43
  44 \fImode\fP 引き数は、作成されたディレクトリの許可属性を決定するのに使われる。 この値に、通常通りプロセスの \fIumask\fP
  45 による修正が加えられる。 したがって、作成されたディレクトリの許可属性は (\fImode\fP & ~\fIumask\fP & 0777)  となる。
  46 作成されたディレクトリのその他のモードビットはオペレーティングシステムに 依存する。Linux の場合は、以下の通りである。
  47
  48 新しく作成されたディレクトリの所有者はプロセスの実効ユーザ ID に設定される。 新たに作成されたディレクトリが含まれる親ディレクトリに set
  49 group ID ビットがセットされていたり、ファイルシステムが BSD の グループセマンティクス (\fImount \-o bsdgroups\fP
  50 あるいは、同じ意味の \fImount \-o grpid\fP)  に従ってマウントされている場合には、
  51 新たに作成されたディレクトリのグループ所有権は親ディレクトリの ものが継承される (親ディレクトリと同じになる)。
  52 それ以外の場合は、グループ所有権はプロセスの実効グループ ID となる。
  53
  54 もし親ディレクトリに set group ID ビットがセットされていれば新しく作成される ディレクトリにも set group ID
  55 ビットがセットされる。
  56 .SH 返り値
  57 \fBmkdir\fP()  は成功した場合 0 を、失敗した場合 \-1 を返す (また、 \fIerrno\fP がエラーの内容にしたがって適切に設定される)。
  58 .SH エラー
  59 .TP
  60 \fBEACCES\fP
  61 プロセスが親ディレクトリへの書き込み許可を持たない、もしくは \fIpathname\fP 中のディレクトリのどれかに検索許可属性が無い
  62 (\fBpath_resolution\fP(7)  も参照)。
  63 .TP
  64 \fBEDQUOT\fP
  65 ディスクブロックか inode がそのファイルシステムのユーザクォータに達していた。
  66 .TP
  67 \fBEEXIST\fP
  68 \fIpathname\fP が既に存在している(ただしそれがディレクトリであるとは限らない)。 \fIpathname\fP がシンボリックリンクの場合も
  69 (その指定先が存在するかどうかに関らず)エラーになる。
  70 .TP
  71 \fBEFAULT\fP
  72 \fIpathname\fP がアクセス可能なアドレス空間の外を指している。
  73 .TP
  74 \fBELOOP\fP
  75 \fIpathname\fP を解決するときに、解決すべきシンボリックリンクが多すぎた。
  76 .TP
  77 \fBEMLINK\fP
  78 親ディレクトリへのリンク数が \fBLINK_MAX\fP を超えてしまう。
  79 .TP
  80 \fBENAMETOOLONG\fP
  81 \fIpathname\fP が長すぎる。
  82 .TP
  83 \fBENOENT\fP
  84 \fIpathname\fP の構成要素のディレクトリのいずれかが存在しないか、 またはリンク先が存在しないシンボリックリンクである。
  85 .TP
  86 \fBENOMEM\fP
  87 カーネルに十分なメモリがない。
  88 .TP
  89 \fBENOSPC\fP
  90 \fIpathname\fP を含むデバイスに新たにディレクトリを作成する空きが無い。
  91 .TP
  92 \fBENOSPC\fP
  93 もしくはユーザーのディスク quota が使い切られているため、 新たにディレクトリを作成することができない。
  94 .TP
  95 \fBENOTDIR\fP
  96 \fIpathname\fP のディレクトリ部分が実際にはディレクトリでない。
  97 .TP
  98 \fBEPERM\fP
  99 \fIpathname\fP を含むファイルシステムがディレクトリの作成をサポートしていない。
 100 .TP
 101 \fBEROFS\fP
 102 \fIpathname\fP が読み出し専用ファイルシステム上のファイルを指している。
 103 .SH 準拠
 104 .\" SVr4 documents additional EIO, EMULTIHOP
 105 SVr4, BSD, POSIX.1\-2001.
 106 .SH 注意
 107 Linux では、許可ビット以外で意味を持つのは、 \fBS_ISVTX\fP モードビットだけである。 つまり、Linux
 108 では作成されたディレクトリは実際には (\fImode\fP & ~\fIumask\fP & 01777)  のモードを持つことになる。 \fBstat\fP(2)
 109 を参照のこと。
 110 .PP
 111 NFS を実現しているプロトコルには多くの不備が存在し、 それら中には \fBmkdir\fP()  に影響を与えるものもある。
 112 .SH 関連項目
 113 \fBmkdir\fP(1), \fBchmod\fP(2), \fBchown\fP(2), \fBmkdirat\fP(2), \fBmknod\fP(2),
 114 \fBmount\fP(2), \fBrmdir\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2),
 115 \fBpath_resolution\fP(7)
 116 .SH この文書について
 117 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
 118 である。プロジェクトの説明とバグ報告に関する情報は
 119 http://www.kernel.org/doc/man\-pages/ に書かれている。