Man page - open_by_handle_at(2)

Packages contains this manual

Available languages:

en fr ja ru

Manual

OPEN_BY_HANDLE_AT

名 前
書 式
説 明
name_to_handle_at()
open_by_handle_at()
返 り 値
エ ラ ー
バ ー ジ ョ ン
準 拠
注 意
永 続 的 な フ ァ イ ル シ ス テ ム ID の 取 得
例
プ ロ グ ラ ム の ソ ー ス : t_name_to_handle_at.c
プ ロ グ ラ ム の ソ ー ス : t_open_by_handle_at.c
関 連 項 目
こ の 文 書 に つ い て

名 前

name_to_handle_at, open_by_handle_at - パ ス 名 に 対 す る ハ ン ド ル の 取 得 と ハ ン ド ル に よ る フ ァ イ ル の オ ー プ ン

書 式

#define _GNU_SOURCE /* feature_test_macros(7) 参 照 */
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>

int name_to_handle_at(int dirfd , const char * pathname ,
struct file_handle * handle ,
int * mount_id , int flags );

int open_by_handle_at(int mount_fd , struct file_handle * handle ,
int flags );

説 明

シ ス テ ム コ ー ル name_to_handle_at () と open_by_handle_at () は openat (2) の 機 能 を 2 つ に 分 割 し た も の で あ る 。 name_to_handle_at () は 指 定 さ れ た フ ァ イ ル に 対 応 す る ハ ン ド ル を 返 す 。 open_by_handle_at () は name_to_handle_at () が 返 し た ハ ン ド ル に 対 応 す る フ ァ イ ル を オ ー プ ン し 、 オ ー プ ン さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー を 返 す 。

name_to_handle_at()

name_to_handle_at () シ ス テ ム コ ー ル は 、 引 数 dirfd と pathname で 指 定 さ れ る フ ァ イ ル に 対 応 す る フ ァ イ ル ハ ン ド ル と マ ウ ン ト ID を 返 す 。 フ ァ イ ル ハ ン ド ル は 引 数 handle で 返 さ れ る 。 handle は 以 下 の 形 式 の 構 造 体 へ の ポ イ ン タ ー で あ る 。

struct file_handle {
unsigned int handle_bytes; /* Size of f_handle [in, out] */
int handle_type; /* Handle type [out] */
unsigned char f_handle[0]; /* File identifier (sized by
caller) [out] */
};

It is the caller’s responsibility to allocate the structure with a size large enough to hold the handle returned in f_handle . Before the call, the handle_bytes field should be initialized to contain the allocated size for f_handle . (The constant MAX_HANDLE_SZ , defined in <fcntl.h> , specifies the maximum expected size for a file handle. It is not a guaranteed upper limit as future filesystems may require more space.) Upon successful return, the handle_bytes field is updated to contain the number of bytes actually written to f_handle .

The caller can discover the required size for the file_handle structure by making a call in which handle->handle_bytes is zero; in this case, the call fails with the error EOVERFLOW and handle->handle_bytes is set to indicate the required size; the caller can then use this information to allocate a structure of the correct size (see EXAMPLES below). Some care is needed here as EOVERFLOW can also indicate that no file handle is available for this particular name in a filesystem which does normally support file-handle lookup. This case can be detected when the EOVERFLOW error is returned without handle_bytes being increased.

handle_bytes フ ィ ー ル ド を 使 用 す る 以 外 は 、 呼 び 出 し 元 は file_handle 構 造 体 の 内 容 を 意 識 せ ず に 扱 う べ き で あ る 。 フ ィ ー ル ド handle_type と f_handle は 後 で open_by_handle_at () を 呼 び 出 す 場 合 に だ け 必 要 で あ る 。

flags 引 数 は 、 下 記 の AT_EMPTY_PATH と AT_SYMLINK_FOLLOW の う ち 0 個 以 上 の 論 理 和 を 取 っ て 構 成 さ れ る ビ ッ ト マ ス ク で あ る 。

引 数 pathname と dirfd は そ の 組 み 合 わ せ で ハ ン ド ル を 取 得 す る フ ァ イ ル を 指 定 す る 。 以 下 の 4 つ の パ タ ー ン が あ る 。

*

pathname が 空 で な い 文 字 列 で 絶 対 パ ス 名 を 含 む 場 合 、 こ の パ ス 名 が 参 照 す る フ ァ イ ル に 対 す る ハ ン ド ル が 返 さ れ る 。

*

pathname が 相 対 パ ス が 入 っ た 空 で な い 文 字 列 で 、 dirfd が 特 別 な 値 AT_FDCWD の 場 合 、 pathname は 呼 び 出 し 元 の カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ に 対 す る 相 対 パ ス と 解 釈 さ れ 、 そ の フ ァ イ ル に 対 す る ハ ン ド ル が 返 さ れ る 。

*

pathname が 相 対 パ ス が 入 っ た 空 で な い 文 字 列 で 、 dirfd が デ ィ レ ク ト リ を 参 照 す る フ ァ イ ル デ ィ ス ク リ プ タ ー の 場 合 、 pathname は dirfd が 参 照 す る デ ィ レ ク ト リ に 対 す る 相 対 パ ス と 解 釈 さ れ 、 そ の フ ァ イ ル を 参 照 す る ハ ン ド ル が 返 さ れ る 。 (な ぜ 「 デ ィ レ ク ト リ フ ァ イ ル デ ィ ス ク リ プ タ ー 」 が 役 に 立 つ の か に つ い て は openat (2) を 参 照 。 )

*

pathname が 空 の 文 字 列 で flags に AT_EMPTY_PATH が 指 定 さ れ て い る 場 合 、 dirfd に は 任 意 の 種 別 の フ ァ イ ル を 参 照 す る オ ー プ ン さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー か AT_FDCWD (カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ を 意 味 す る ) を 指 定 で き 、 dirfd が 参 照 す る フ ァ イ ル に 対 す る ハ ン ド ル が 返 さ れ る 。

The mount_id argument returns an identifier for the filesystem mount that corresponds to pathname . This corresponds to the first field in one of the records in /proc/self/mountinfo . Opening the pathname in the fifth field of that record yields a file descriptor for the mount point; that file descriptor can be used in a subsequent call to open_by_handle_at (). mount_id is returned both for a successful call and for a call that results in the error EOVERFLOW .

デ フ ォ ル ト で は 、 name_to_handle_at () は pathname が シ ン ボ リ ッ ク リ ン ク の 場 合 に そ の 展 開 (dereference) を 行 わ ず 、 リ ン ク 自 身 に 対 す る ハ ン ド ル を 返 す 。 AT_SYMLINK_FOLLOW が flags に 指 定 さ れ る と 、 pathname が シ ン ボ リ ッ ク リ ン ク の 場 合 に リ ン ク の 展 開 が 行 わ れ る (リ ン ク が 参 照 す る フ ァ イ ル に 対 す る ハ ン ド ル が 返 さ れ る )。

name_to_handle_at () does not trigger a mount when the final component of the pathname is an automount point. When a filesystem supports both file handles and automount points, a name_to_handle_at () call on an automount point will return with error EOVERFLOW without having increased handle_bytes . This can happen since Linux 4.13 with NFS when accessing a directory which is on a separate filesystem on the server. In this case, the automount can be triggered by adding a "/" to the end of the pathname.

open_by_handle_at()

open_by_handle_at () シ ス テ ム コ ー ル は handle が 参 照 す る フ ァ イ ル を オ ー プ ン す る 。 handle は 前 に 呼 び 出 し た name_to_handle_at () が 返 し た フ ァ イ ル ハ ン ド ル で あ る 。

mount_fd 引 数 は 、 handle が そ の フ ァ イ ル シ ス テ ム に 関 連 す る と 解 釈 さ れ る マ ウ ン ト さ れ た フ ァ イ ル シ ス テ ム 内 の 任 意 の オ ブ ジ ェ ク ト (フ ァ イ ル 、 デ ィ レ ク ト リ な ど ) の フ ァ イ ル デ ィ ス ク リ プ タ ー で あ る 。 特 別 な 値 AT_FDCWD も 指 定 で き る 。 こ の 値 は 呼 び 出 し 元 の カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ を 意 味 す る 。

引 数 flags は open (2) と 同 じ で あ る 。 handle が シ ン ボ リ ッ ク リ ン ク を 参 照 し て い る 場 合 、 呼 び 出 し 元 は O_PATH フ ラ グ を 指 定 し な け れ ば な ら ず 、 そ の シ ン ボ リ ッ ク リ ン ク は 展 開 さ れ な い 。 O_NOFOLLOW が 指 定 さ れ た 場 合 は 、 O_NOFOLLOW は 無 視 さ れ る 。

open_by_handle_at () を 呼 び 出 す に は 、 呼 び 出 し 元 が CAP_DAC_READ_SEARCH ケ ー パ ビ リ テ ィ ー を 持 っ て い な け れ ば な ら な い 。

返 り 値

成 功 す る と 、 name_to_handle_at () は 0 を 返 し 、 open_by_handle_at () は フ ァ イ ル デ ィ ス ク リ プ タ ー (非 負 の 整 数 ) を 返 す 。

エ ラ ー の 場 合 、 ど ち ら の シ ス テ ム コ ー ル も -1 を 返 し 、 errno に エ ラ ー の 原 因 を 示 す 値 を 設 定 す る 。

エ ラ ー

name_to_handle_at () と open_by_handle_at () は openat (2) と 同 じ エ ラ ー で 失 敗 す る 。 ま た 、 こ れ ら の シ ス テ ム コ ー ル は 以 下 の エ ラ ー で 失 敗 す る こ と も あ る 。

name_to_handle_at () は 以 下 の エ ラ ー で 失 敗 す る こ と が あ る 。

EFAULT

pathname , mount_id , handle の ど れ か が ア ク セ ス 可 能 な ア ド レ ス 空 間 の 外 を 指 し て い る 。

EINVAL

flags に 無 効 な ビ ッ ト 値 が 含 ま れ て い る 。

EINVAL

handle->handle_bytes が MAX_HANDLE_SZ よ り も 大 き い 。

ENOENT

pathname が 空 文 字 列 だ が 、 flags に AT_EMPTY_PATH が さ れ て い な か っ た 。

ENOTDIR

dirfd で 指 定 さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー が デ ィ レ ク ト リ を 参 照 し て お ら ず 、 両 方 の flags に AT_EMPTY_PATH が 指 定 さ れ 、 か つ pathname が 空 文 字 列 で あ る 場 合 で も な い 。

EOPNOTSUPP

フ ァ イ ル シ ス テ ム が パ ス 名 を フ ァ イ ル ハ ン ド ル へ の 変 換 を サ ポ ー ト し て い な い 。

EOVERFLOW

呼 び 出 し に 渡 さ れ た handle->handle_bytes の 値 が 小 さ す ぎ た 。 こ の エ ラ ー が 発 生 し た 際 、 handle->handle_bytes は ハ ン ド ル に 必 要 な サ イ ズ に 更 新 さ れ る 。

open_by_handle_at () は 以 下 の エ ラ ー で 失 敗 す る こ と が あ る 。

EBADF

mount_fd が オ ー プ ン さ れ た フ ァ イ ル デ ィ ス ク リ プ タ ー で な い 。

EFAULT

handle が ア ク セ ス 可 能 な ア ド レ ス 空 間 の 外 を 指 し て い る 。

EINVAL

handle->handle_bytes が MAX_HANDLE_SZ よ り 大 き い か 0 に 等 し い 。

ELOOP

handle が シ ン ボ リ ッ ク リ ン ク を 参 照 し て い る が 、 flags に O_PATH が さ れ て い な か っ た 。

EPERM

呼 び 出 し 元 が CAP_DAC_READ_SEARCH ケ ー パ ビ リ テ ィ を 持 っ て い な い 。

ESTALE

指 定 さ れ た handle が 有 効 で は な い 。 こ の エ ラ ー は 、 例 え ば フ ァ イ ル が 削 除 さ れ た 場 合 な ど に 発 生 す る 。

バ ー ジ ョ ン

こ れ ら の シ ス テ ム コ ー ル は Linux 2.6.39 で 初 め て 登 場 し た 。 ラ イ ブ ラ リ に よ る サ ポ ー ト は バ ー ジ ョ ン 2.14 以 降 の glibc で 提 供 さ れ て い る 。

準 拠

こ れ ら の シ ス テ ム コ ー ル は 非 標 準 の Linux の 拡 張 で あ る 。

FreeBSD に は getfh () と openfh () と い う ほ と ん ど 同 じ 機 能 の シ ス テ ム コ ー ル の ペ ア が 存 在 す る 。

注 意

あ る プ ロ セ ス で name_to_handle_at () を 使 っ て フ ァ イ ル ハ ン ド ル を 生 成 し て 、 そ の ハ ン ド ル を 別 の プ ロ セ ス の open_by_handle_at () で 使 用 す る こ と が で き る 。

い く つ か の フ ァ イ ル シ ス テ ム で は 、 パ ス 名 か ら フ ァ イ ル ハ ン ド ル へ の 変 換 が サ ポ ー ト さ れ て い な い 。 例 え ば 、 /proc , /sys や 種 々 の ネ ッ ト ワ ー ク フ ァ イ ル シ ス テ ム な ど で あ る 。

フ ァ イ ル ハ ン ド ル は 、 フ ァ イ ル が 削 除 さ れ た り 、 そ の 他 の フ ァ イ ル シ ス テ ム 固 有 の 理 由 で 、 無 効 ("stale") に な る 場 合 が あ る 。 無 効 な ハ ン ド ル で あ る こ と は 、 open_by_handle_at () か ら エ ラ ー ESTALE が 返 る こ と で 通 知 さ れ る 。

こ れ ら の シ ス テ ム コ ー ル は 、 ユ ー ザ ー 空 間 の フ ァ イ ル サ ー バ ー で の 使 用 を 意 図 し て 設 計 さ れ て い る 。 例 え ば 、 ユ ー ザ ー 空 間 NFS サ ー バ ー が フ ァ イ ル ハ ン ド ル を 生 成 し て 、 そ の ハ ン ド ル を NFS ク ラ イ ア ン ト に 渡 す こ と が で き る 。 そ の 後 、 ク ラ イ ア ン ト が フ ァ イ ル を オ ー プ ン し よ う と し た 際 に 、 こ の ハ ン ド ル を サ ー バ ー に 送 り 返 す こ と が で き る 。 こ の よ う な 機 能 に よ り 、 ユ ー ザ ー 空 間 フ ァ イ ル サ ー バ ー は 、 そ の サ ー バ ー が 提 供 す る フ ァ イ ル に 関 し て ス テ ー ト レ ス で (状 態 を 保 持 せ ず に ) 動 作 す る こ と が で き る 。

pathname が シ ン ボ リ ッ ク リ ン ク を 参 照 し て い て 、 flags に AT_SYMLINK_FOLLOW が 指 定 さ れ て い な い 場 合 、 name_to_handle_at () は (シ ン ボ リ ッ ク が 参 照 す る フ ァ イ ル で は な く ) リ ン ク に 対 す る ハ ン ド ル を 返 す 。 ハ ン ド ル を 受 け 取 っ た プ ロ セ ス は 、 open_by_handle_at () の O_PATH フ ラ グ を 使 っ て ハ ン ド ル を フ ァ イ ル デ ィ ス ク リ プ タ ー に 変 換 し 、 そ の フ ァ イ ル デ ィ ス ク リ プ タ ー を readlinkat (2) や fchownat (2) な ど の シ ス テ ム コ ー ル の dirfd 引 数 と し て 渡 す こ と で 、 そ の シ ン ボ リ ッ ク リ ン ク に 対 し て 操 作 を 行 う こ と が で き る 。

永 続 的 な フ ァ イ ル シ ス テ ム ID の 取 得

/proc/self/mountinfo の マ ウ ン ト ID は 、 フ ァ イ ル シ ス テ ム の ア ン マ ウ ン ト 、 マ ウ ン ト が 行 わ れ る に 連 れ て 再 利 用 さ れ る こ と が あ る 。 し た が っ て 、 name_to_handle_at () (の *mount_id ) で 返 さ れ た マ ウ ン ト ID は 対 応 す る マ ウ ン ト さ れ た フ ァ イ ル シ ス テ ム を 表 す 永 続 的 な ID と 考 え る べ き で は な い 。 た だ し 、 ア プ リ ケ ー シ ョ ン は 、 マ ウ ン ト ID に 対 応 す る mountinfo レ コ ー ド の 情 報 を 使 う こ と で 、 永 続 的 な ID を 得 る こ と が で き る 。

例 え ば 、 mountinfo レ コ ー ド の 5 番 目 の フ ィ ー ル ド の デ バ イ ス 名 を 使 っ て 、 /dev/disks/by-uuid の シ ン ボ リ ッ ク リ ン ク 経 由 で 対 応 す る デ バ イ ス UUID を 検 索 で き る 。 (UUID を 取 得 す る も っ と 便 利 な 方 法 は libblkid (3) ラ イ ブ ラ リ を 使 用 す る こ と で あ る 。 ) そ の プ ロ セ ス は 、 逆 に 、 こ の UUID を 使 っ て デ バ イ ス 名 を 検 索 し 、 対 応 す る マ ウ ン ト ポ イ ン ト を 取 得 す る こ と で 、 open_by_handle_at () で 使 用 す る mount_fd 引 数 を 生 成 す る こ と が で き る 。

例

以 下 の 2 つ の プ ロ グ ラ ム は name_to_handle_at () と open_by_handle_at () の 使 用 例 を 示 し た も の で あ る 。 最 初 の プ ロ グ ラ ム ( t_name_to_handle_at.c ) は name_to_handle_at () を 使 用 し て 、 コ マ ン ド ラ イ ン 引 数 で 指 定 さ れ た フ ァ イ ル に 対 応 す る フ ァ イ ル ハ ン ド ル と マ ウ ン ト ID を 取 得 す る 。 ハ ン ド ル と マ ウ ン ト ID は 標 準 出 力 に 出 力 さ れ る 。

2 つ 目 の プ ロ グ ラ ム ( t_open_by_handle_at.c ) は 、 標 準 入 力 か ら マ ウ ン ト ID と フ ァ イ ル ハ ン ド ル を 読 み 込 む 。 そ れ か ら 、 open_by_handle_at () を 利 用 し て 、 そ の ハ ン ド ル を 使 っ て フ ァ イ ル を オ ー プ ン す る 。 追 加 の コ マ ン ド ラ イ ン 引 数 が 指 定 さ れ た 場 合 は 、 open_by_handle_at () の mount_fd 引 数 は 、 こ の 引 数 で 渡 さ れ た 名 前 の デ ィ レ ク ト リ を オ ー プ ン し て 取 得 す る 。 そ れ 以 外 の 場 合 、 /proc/self/mountinfo か ら ス キ ャ ン し て 標 準 入 力 か ら 読 み 込 ん だ マ ウ ン ト ID に 一 致 す る マ ウ ン ト ID を 検 索 し 、 そ の レ コ ー ド で 指 定 さ れ て い る マ ウ ン ト デ ィ レ ク ト リ を オ ー プ ン し て 、 mount_fd を 入 手 す る 。 (こ れ ら の プ ロ グ ラ ム で は マ ウ ン ト ID が 永 続 的 で は な い 点 に つ い て の 対 処 は 行 わ な い 。 )

以 下 の シ ェ ル セ ッ シ ョ ン は 、 こ れ ら 2 つ の プ ロ グ ラ ム の 使 用 例 で あ る 。

$ echo 'Can you please think about it?' > cecilia.txt
$ ./t_name_to_handle_at cecilia.txt > fh
$ ./t_open_by_handle_at < fh
open_by_handle_at: Operation not permitted
$ sudo ./t_open_by_handle_at < fh # Need CAP_SYS_ADMIN
Read 31 bytes
$ rm cecilia.txt

こ こ で 、 フ ァ イ ル を 削 除 し (す ぐ に ) 再 作 成 す る 。 同 じ 内 容 で (運 が よ け れ ば ) 同 じ inode に な る 。 こ の 場 合 で も 、 open_by_handle_at () は こ の フ ァ イ ル ハ ン ド ル が 参 照 す る 元 の フ ァ イ ル が す で に 存 在 し な い こ と を 認 識 す る 。

$ stat --printf="%i\n" cecilia.txt # Display inode number
4072121
$ rm cecilia.txt
$ echo 'Can you please think about it?' > cecilia.txt
$ stat --printf="%i\n" cecilia.txt # Check inode number
4072121
$ sudo ./t_open_by_handle_at < fh
open_by_handle_at: Stale NFS file handle

プ ロ グ ラ ム の ソ ー ス : t_name_to_handle_at.c

#define _GNU_SOURCE
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <errno.h>
#include <string.h>

#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \
} while (0)

int
main(int argc, char *argv[])
{
struct file_handle *fhp;
int mount_id, fhsize, flags, dirfd;
char *pathname;

if (argc != 2) {
fprintf(stderr, "Usage: %s pathname\n", argv[0]);
exit(EXIT_FAILURE);
}

pathname = argv[1];

/* file_handle 構 造 体 を 確 保 す る */

fhsize = sizeof(*fhp);
fhp = malloc(fhsize);
if (fhp == NULL)
errExit("malloc");

/* name_to_handle_at() を 最 初 に 呼 び 出 し て
フ ァ イ ル ハ ン ド ル に 必 要 な サ イ ズ を 入 手 す る */

dirfd = AT_FDCWD; /* For name_to_handle_at() calls */
flags = 0; /* For name_to_handle_at() calls */
fhp->handle_bytes = 0;
if (name_to_handle_at(dirfd, pathname, fhp,
&mount_id, flags) != -1 || errno != EOVERFLOW) {
fprintf(stderr, "Unexpected result from name_to_handle_at()\n");
exit(EXIT_FAILURE);
}

/* file_handle 構 造 体 を 正 し い サ イ ズ に 確 保 し 直 す */

fhsize = sizeof(*fhp) + fhp->handle_bytes;
fhp = realloc(fhp, fhsize); /* Copies fhp->handle_bytes */
if (fhp == NULL)
errExit("realloc");

/* コ マ ン ド ラ イ ン で 指 定 さ れ た パ ス 名 か ら フ ァ イ ル ハ ン ド ル を 取 得 */

if (name_to_handle_at(dirfd, pathname, fhp, &mount_id, flags) == -1)
errExit("name_to_handle_at");

/* t_open_by_handle_at.c で 後 で 再 利 用 で き る よ う に 、 マ ウ ン ト ID、
フ ァ イ ル ハ ン ド ル の サ イ ズ 、 フ ァ イ ル ハ ン ド ル を 標 準 出 力 に 書 き 出 す */

printf("%d\n", mount_id);
printf("%u %d ", fhp->handle_bytes, fhp->handle_type);
for (int j = 0; j < fhp->handle_bytes; j++)
printf(" %02x", fhp->f_handle[j]);
printf("\n");

exit(EXIT_SUCCESS);
}

プ ロ グ ラ ム の ソ ー ス : t_open_by_handle_at.c

#define _GNU_SOURCE
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>

#define errExit(msg) do { perror(msg); exit(EXIT_FAILURE); \
} while (0)

/* /proc/self/mountinfo を ス キ ャ ン し て 、 マ ウ ン ト ID が 'mount_id' に
一 致 す る 行 を 探 す 。 (も っ と 簡 単 な 方 法 は 'util-linux' プ ロ ジ ェ ク ト
が 提 供 す る 'libmount' ラ イ ブ ラ リ を イ ン ス ト ー ル し て 使 う こ と で あ る )
対 応 す る マ ウ ン ト パ ス を オ ー プ ン し 、 得 ら れ た フ ァ イ ル デ ィ ス ク リ プ タ ー を 返 す 。 */

static int
open_mount_path_by_id(int mount_id)
{
char *linep;
size_t lsize;
char mount_path[PATH_MAX];
int mi_mount_id, found;
ssize_t nread;
FILE *fp;

fp = fopen("/proc/self/mountinfo", "r");
if (fp == NULL)
errExit("fopen");

found = 0;
linep = NULL;
while (!found) {
nread = getline(&linep, &lsize, fp);
if (nread == -1)
break;

nread = sscanf(linep, "%d %*d %*s %*s %s",
&mi_mount_id, mount_path);
if (nread != 2) {
fprintf(stderr, "Bad sscanf()\n");
exit(EXIT_FAILURE);
}

if (mi_mount_id == mount_id)
found = 1;
}
free(linep);

fclose(fp);

if (!found) {
fprintf(stderr, "Could not find mount point\n");
exit(EXIT_FAILURE);
}

return open(mount_path, O_RDONLY);
}

int
main(int argc, char *argv[])
{
struct file_handle *fhp;
int mount_id, fd, mount_fd, handle_bytes;
ssize_t nread;
char buf[1000];
#define LINE_SIZE 100
char line1[LINE_SIZE], line2[LINE_SIZE];
char *nextp;

if ((argc > 1 && strcmp(argv[1], "--help") == 0) || argc > 2) {
fprintf(stderr, "Usage: %s [mount-path]\n", argv[0]);
exit(EXIT_FAILURE);
}

/* マ ウ ン ト ID と フ ァ イ ル ハ ン ド ル 情 報 が 入 っ た 標 準 入 力 :

Line 1: <mount_id>
Line 2: <handle_bytes> <handle_type> <bytes of handle in hex>
*/

if ((fgets(line1, sizeof(line1), stdin) == NULL) ||
(fgets(line2, sizeof(line2), stdin) == NULL)) {
fprintf(stderr, "Missing mount_id / file handle\n");
exit(EXIT_FAILURE);
}

mount_id = atoi(line1);

handle_bytes = strtoul(line2, &nextp, 0);

/* handle_bytes が あ れ ば 、
file_handle 構 造 体 を こ こ で 割 り 当 て で き る */

fhp = malloc(sizeof(*fhp) + handle_bytes);
if (fhp == NULL)
errExit("malloc");

fhp->handle_bytes = handle_bytes;

fhp->handle_type = strtoul(nextp, &nextp, 0);

for (int j = 0; j < fhp->handle_bytes; j++)
fhp->f_handle[j] = strtoul(nextp, &nextp, 16);

/* マ ウ ン ト ポ イ ン ト の フ ァ イ ル デ ィ ス ク リ プ タ ー を 取 得 す る 。
取 得 は 、 コ マ ン ド ラ イ ン で 指 定 さ れ た パ ス 名 を オ ー プ ン す る か 、
/proc/self/mounts を ス キ ャ ン し て 標 準 入 力 か ら 受 け 取 っ た
'mount_id' に 一 致 す る マ ウ ン ト を 探 す こ と で 行 う 。 */

if (argc > 1)
mount_fd = open(argv[1], O_RDONLY);
else
mount_fd = open_mount_path_by_id(mount_id);

if (mount_fd == -1)
errExit("opening mount fd");

/* ハ ン ド ル と マ ウ ン ト ポ イ ン ト を 使 っ て フ ァ イ ル を オ ー プ ン す る */

fd = open_by_handle_at(mount_fd, fhp, O_RDONLY);
if (fd == -1)
errExit("open_by_handle_at");

/* そ の フ ァ イ ル か ら バ イ ト を 読 み 出 す */

nread = read(fd, buf, sizeof(buf));
if (nread == -1)
errExit("read");

printf("Read %zd bytes\n", nread);

exit(EXIT_SUCCESS);
}

関 連 項 目

open (2), libblkid (3), blkid (8), findfs (8), mount (8)
https://www.kernel.org/pub/linux/utils/util-linux/ で 入 手 で き る 最 新 の util-linux リ リ ー ス の libblkid と libmount の ド キ ュ メ ン ト 。

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。