mkdir(2)

mkdir − ディレクトリファイルを作成する

標準 C ライブラリ (libc, −lc)

#include <sys/types.h>
#include <sys/stat.h>

int

mkdir(const char *path, mode_t mode);

解説

ディレクトリ path が、 mode による指定に呼び出しプロセスの umask(2) で制 約を加えたアクセス許可で作成されます。

ディレクトリの所有者 ID は、プロセスの実効ユーザ ID に設定されます。ディ レクトリのグループ ID は、そのディレクトリが作成された親ディレクトリのグ ループ ID に設定されます。

関数 mkdir() は、処理が成功すると値 0 を返します。そうでない場合、値 -1 が返され、グローバル変数 errno が設定されてエラーを示します。

mkdir() システムコールは次の場合、処理に失敗してディレクトリは作成されま せん:

パスの構成要素中にディレクトリ以外のものが含まれていま す。

[ENAMETOOLONG]
パス名の構成要素が 255 文字を越えているか、またはパス 名全体が 1023 文字を越えています。

[ENOENT]
パスの構成要素が存在しません。

[EACCES]
指定されたパスには、検索が許可されていないディレクトリ が含まれています。または、作成するディレクトリの親ディ レクトリに対する書込み権限が拒否されました。

[ELOOP]
パス名を変換するときに検出されたシンボリックリンクが多 すぎます。

[EROFS]
指定されたファイルは読取り専用ファイルシステム上にあり ます。

[EEXIST]
指定のファイルがすでに存在します。

[ENOSPC]
新しいディレクトリが作成できません。そのディレクトリを 作る容量がファイルシステムに残っていません。

[ENOSPC]
ディレクトリを作成するファイルシステム上に未使用の inode がありません。

[EDQUOT]
新しいディレクトリが作成できません。ディレクトリを作る ファイルシステム上のディスクブロックのユーザのクォータ が枯渇しました。

[EDQUOT]
ディレクトリを作成中のファイルシステム上のユーザの inode のクォータが枯渇しました。

[EIO]
ディレクトリエントリの作成中、あるいは inode を割り当 て中に入出力エラーが発生しました。

[EIO]
ファイルシステムに読み書きしている間に入出力エラーが発 生しました。

[EFAULT]
path 引数が、プロセスに割り当てられたアドレス空間の範 囲外を指しています。

関連項目

chmod(2), stat(2), umask(2)

mkdir() システムコールは ISO/IEC 9945-1:1990 (‘‘POSIX.1’’) に適合していま す。

FreeBSD 10.0 December 11, 1993 FreeBSD 10.0