名 前
link, linkat − フ ァ イ ル の 新 し い 名 前 を 作 成 す る
書 式
#include <unistd.h>
int link(const char *oldpath, const char *newpath);
#include
<fcntl.h> /* AT_* 定 数 の
定 義 */
#include <unistd.h>
int
linkat(int olddirfd, const char
*oldpath,
int newdirfd, const char
*newpath, int flags);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
linkat():
glibc 2.10 以 降 :
_XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
glibc 2.10 よ り 前 :
_ATFILE_SOURCE
説 明
link() は 存 在 す る フ ァ イ ル へ の 新 し い リ ン ク (link) (ハ ー ド リ ン ク (hard link) と も い う ) を 作 成 す る 。
newpath が 存 在 す る 場 合 に は 、 上 書 き は さ れ な い 。 こ の 新 し い 名 前 は 全 て の 操 作 に お い て 古 い 名 前 と 完 全 に 同 じ よ う に 使 用 さ れ る ; 両 方 の 名 前 は 同 じ フ ァ イ ル を 参 照 し て お り (そ れ で 同 じ 許 可 (permission) や 所 有 者 (ownership) と な る の で )、 ど ち ら の 名 前 が 本 来 の も の で あ る か 判 別 で き な い 。
linkat()
linkat() シ ス テ ム コ
ー ル は link() と 全
く 同 様 に 動 作
す る が 、 以 下
で 説 明 す る 点
が 異 な る 。
oldpath で 指 定 さ れ た パ ス 名 が 相 対 パ ス の 場 合 、 こ の パ ス 名 は フ ァ イ ル デ ィ ス ク リ プ タ ー olddirfd が 参 照 す る デ ィ レ ク ト リ に 対 す る 相 対 パ ス と 解 釈 さ れ る (link(2) に 相 対 パ ス 名 を 渡 し た 場 合 の よ う に 、 呼 び 出 し た プ ロ セ ス の カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ に 対 す る 相 対 パ ス で は な い )。
oldpath で 指 定 さ れ た パ ス 名 が 相 対 パ ス で 、 olddirfd が 特 別 な 値 AT_FDCWD の 場 合 、 (link(2) と 同 様 に ) oldpath は 呼 び 出 し た プ ロ セ ス の カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ に 対 す る 相 対 パ ス と 解 釈 さ れ る 。
oldpath で 指 定 さ れ た パ ス 名 が 絶 対 パ ス の 場 合 、 olddirfd は 無 視 さ れ る 。
newpath
の 解 釈 は oldpath と
同 じ で あ る 。
相 対 パ ス の パ
ス 名 が フ ァ イ
ル デ ィ ス ク リ
プ タ ー newdirfd が 参
照 す る デ ィ レ
ク ト リ と 解 釈
さ れ る 点 だ け
が 異 な る 。 以
下 の 値 の ビ ッ
ト 単 位 の 論 理
和 を flags に 指 定
で き る 。
AT_EMPTY_PATH (Linux 2.6.39 以 降 )
oldpath が 空 文 字 列 の 場 合 、 olddirfd が 参 照 す る フ ァ イ ル へ の リ ン ク を 作 成 す る (olddirfd は open(2) の O_PATH フ ラ グ を 使 っ て 取 得 す る )。 こ の 場 合 、 olddirfd は デ ィ レ ク ト リ 以 外 の 任 意 の 型 の フ ァ イ ル を 参 照 す る こ と が で き る 。 一 般 的 に は 、 フ ァ イ ル の リ ン ク カ ウ ン ト が 0 の 場 合 は 、 こ の 操 作 は 成 功 し な い (た だ し 、 O_TMPFILE が 指 定 さ れ O_EXCL を 指 定 せ ず に 作 成 さ れ た フ ァ イ ル は 例 外 で あ る )。 こ の フ ラ グ を 使 用 す る た め に は 、 呼 び 出 し 元 は CAP_DAC_READ_SEARCH ケ ー パ ビ リ テ ィ を 持 っ て い な け れ ば な ら な い 。 こ の フ ラ グ は Linux 固 有 で 、 こ の 定 義 を 得 る に は _GNU_SOURCE を 定 義 す る こ と 。
AT_SYMLINK_FOLLOW (Linux 2.6.18 以 降 )
linkat() は (link() 同 様 ) デ フ ォ ル ト で は oldpath が シ ン ボ リ ッ ク リ ン ク の 場 合 リ ン ク の 展 開 を 行 わ な い 。 フ ラ グ AT_SYMLINK_FOLLOW を flags に 指 定 す る こ と が で き 、 指 定 し た 場 合 oldpath が シ ン ボ リ ッ ク リ ン ク の 場 合 リ ン ク の 展 開 が 行 わ れ る 。 procfs が マ ウ ン ト さ れ て い る 場 合 、 こ れ は AT_EMPTY_PATH の 代 替 と し て 以 下 の よ う に 使 う こ と が で き る 。
linkat(AT_FDCWD,
"/proc/self/fd/<fd>", newdirfd,
newname, AT_SYMLINK_FOLLOW); カ ー ネ
ル2.6.18 よ り 前 で は
、 flags 引 き 数 は
未 使 用 で 、 0 を
指 定 し な け れ
ば な ら な か っ
た 。
linkat() の 必 要 性 に つ い て の 説 明 に つ い て は openat(2) を 参 照 。
返 り 値
成 功 し た 場 合 は 0 が 返 さ れ る 。 エ ラ ー の 場 合 は −1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。
エ ラ ー
|
EACCES |
newpath を 含 ん で い る デ ィ レ ク ト リ へ の 書 き 込 み が 許 さ れ て い な い か 、 oldpath ま た は newpath へ の デ ィ レ ク ト リ の ど れ か に 検 索 許 可 が な い (path_resolution(7) を 参 照 )。
デ ィ ス
ク ブ ロ ッ ク か inode
が そ の フ ァ イ
ル シ ス テ ム の
ユ ー ザ ー ク ォ
ー タ に 達 し て
い た 。 newpath が 既 に 存 在 す る 。 EFAULT oldpath や newpath が ア ク セ ス 可 能 な ア ド レ ス 空 間 の 外 を 指 し て い る 。 EIO I/O エ ラ ー が 発 生 し た 。 ELOOP oldpath ま た は newpath を 解 決 す る 際 に 遭 遇 し た シ ン ボ リ ッ ク リ ン ク が 多 過 ぎ る 。 EMLINK oldpath に よ っ て 参 照 さ れ る フ ァ イ ル は 既 に 最 大 数 ま で の リ ン ク を 持 っ て い る 。 ENAMETOOLONG oldpath ま た は newpath が 長 過 ぎ る 。
十 分 な カ ー ネ ル メ モ リ ー が な い 。
ENOTDIR oldpath ま た は newpath の デ ィ レ ク ト リ 部 分 が 、 実 際 に は 、 デ ィ レ ク ト リ で な い 。
EPERM (Linux 3.6 以 降 ) 呼 び 出 し 元 に こ の フ ァ イ ル へ の ハ ー ド リ ン ク を 作 成 す る 許 可 が な か っ た (proc(5) の /proc/sys/fs/protected_hardlinks の 説 明 を 参 照 )。
oldpath と newpath が 同 じ マ ウ ン ト さ れ た フ ァ イ ル シ ス テ ム に 存 在 し な い 。 (Linux は 1 つ の フ ァ イ ル シ ス テ ム を 複 数 の マ ウ ン ト 位 置 に マ ウ ン ト す る こ と を 許 可 し て い る 。 し か し link() は 、 た と え 同 じ フ ァ イ ル シ ス テ ム で あ っ て も 、 別 々 の マ ウ ン ト 位 置 を 跨 い で は 動 作 し な い 。 ) linkat() で は 以 下 の エ ラ ー も 発 生 す る 。
|