名 前
getdirentries − デ ィ レ ク ト リ の エ ン ト リ ー を フ ァ イ ル シ ス テ ム に 依 存 し な い 形 式 で 取 得 す る
書 式
#include <dirent.h>
ssize_t getdirentries(int fd, char *buf, size_t nbytes , off_t *basep);
glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):
getdirentries(): _BSD_SOURCE || _SVID_SOURCE
説 明
fd で 指 定 さ れ た デ ィ レ ク ト リ か ら エ ン ト リ ー を 読 み 、 buf に 格 納 す る 。 最 大 で nbytes が 読 み 込 ま れ る 。 読 み 込 み は オ フ セ ッ ト *basep か ら 開 始 さ れ 、 読 み 込 み 終 了 時 に は *basep は 新 し い 位 置 に 更 新 さ れ る 。
返 り 値
getdirentries() は 読 み 込 ん だ バ イ ト 数 を 返 す か 、 デ ィ レ ク ト リ の 最 後 に き た 場 合 は 0 を 返 す 。 エ ラ ー が 起 こ っ た ら −1 を 返 し 、 errno を エ ラ ー に 対 応 す る 値 に セ ッ ト す る 。
エ ラ ー
詳 細 は Linux の ラ イ ブ ラ リ ソ ー ス コ ー ド を 読 ん で ほ し い 。
属 性
マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 )
getdirentries() 関 数 は ス レ ッ ド セ ー フ で あ る 。
準 拠
POSIX.1−2001 に は な い 。 BSD に 存 在 し 、 他 に も い く つ か の シ ス テ ム に も あ る 。 代 わ り に opendir(3) と readdir(3) を 使 用 す る こ と 。
関 連 項 目
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。