Manpages

名 前

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 が 適 切 に 設 定 さ れ る 。

エ ラ ー