Man page - gfs_pio_create(3)

Packages contains this manual

Package:  libgfarm-dev
apt-get install libgfarm-dev

Manuals in package:
• gfs_acl_check(3)
• gfs_pio_datasync(3)
• gfs_acl_entries(3)
• gfs_acl_get_perm(3)
• gfs_acl_valid(3)
• gfs_stat(3)
• gfs_acl_create_entry(3)
• gfs_pio_open(3)
• gfs_acl_set_file(3)
• gfs_acl_to_any_text(3)
• gfs_mkdir(3)
• gfs_stat_free(3)
• gfs_acl_from_text_with_default(3)
• gfs_pio_read(3)
• gfs_acl_to_xattr_value(3)
• gfs_acl_set_permset(3)
• gfs_acl_clear_perms(3)
• gfs_acl_cmp(3)
• gfs_acl_get_file(3)
• gfs_acl_calc_mask(3)
• gfarm_initialize(3)
• gfs_pio_seek(3)
• gfs_acl_init(3)
• gfarm_terminate(3)
• gfs_acl_error(3)
• gfs_acl_set_tag_type(3)
• gfs_acl_set_qualifier(3)
• gfs_acl_to_text(3)
• gfs_acl_sort(3)
• gfs_acl_get_qualifier(3)
• gfs_acl_get_tag_type(3)
• gfs_acl_dup(3)
• gfs_pio_recvfile(3)
• gfs_acl_from_mode(3)
• gfs_acl_add_perm(3)
• gfs_acl_get_permset(3)
• gfs_acl_free(3)
• gfs_pio_sendfile(3)
• gfs_unlink(3)
• gfs_rmdir(3)
• gfs_pio_close(3)
• gfs_acl_get_entry(3)
• gfs_acl_delete_perm(3)
• gfs_acl_equiv_mode(3)
• gfs_pio_create(3)
• gfs_pio_write(3)
• gfarm(3)
• gfs_acl_delete_entry(3)
• gfs_acl_delete_def_file(3)
• gfs_acl_from_text(3)
• gfs_acl_from_xattr_value(3)
• gfs_pio_flush(3)
• gfs_pio_sync(3)
Documentations in package:
• libgfarm-dev

Available languages:

en ja

Manual

GFS_PIO_CREATE

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
SEE ALSO

---

NAME

gfs_pio_create - Gfarmフ ァ イ ル シ ス テ ム の フ ァ イ ル の 作 成

SYNOPSIS

#include <gfarm/gfarm.h>

gfarm_error_t gfs_pio_create(const char * gfarm_url , int flags , gfarm_mode_t mode , GFS_File * gfp );

DESCRIPTION

指 定 し た gfarm_url に 、 モ ー ド mode で フ ァ イ ル を 新 規 作 成 し 、 GFS_File 構 造 体 を gfp の 指 す 先 に 返 し ま す 。

引 数 flags は 、 gfs_pio_open() の 第 二 引 数 と 同 じ 意 味 を 持 ち ま す 。 GFARM_FILE_RDONLY 、 GFARM_FILE_WRONLY 、 GFARM_FILE_RDWR の い ず れ か 一 つ の フ ラ グ を 必 ず 指 定 し な け れ ば な ら な い 点 も 同 じ で す 。 た だ し 、 gfs_pio_create() に 特 有 の フ ラ グ と し て 、 GFARM_FILE_EXCLUSIVE を 指 定 す る こ と が で き ま す 。 こ の 指 定 を 行 な っ た 場 合 、 フ ァ イ ル が 既 に 存 在 す る 場 合 は 、 フ ァ イ ル の オ ー プ ン に 失 敗 し ま す 。

引 数 flags の 値 と し て GFARM_FILE_TRUNC が 必 要 な 場 合 は 、 明 示 的 に 指 定 す る 必 要 が あ り ま す の で 、 ご 注 意 く だ さ い 。

RETURN VALUES

GFARM_ERR_NO_ERROR

正 常 終 了 を 示 し ま す 。

GFARM_ERR_IS_A_DIRECTORY

指 定 さ れ た フ ァ イ ル は デ ィ レ ク ト リ で す 。

GFARM_ERR_IS_A_SYMBOLIC_LINK

指 定 さ れ た フ ァ イ ル は シ ン ボ リ ッ ク リ ン ク で す 。

GFARM_ERR_OPERATION_NOT_PERMITTED

指 定 さ れ た フ ァ イ ル は フ ァ イ ル で は あ り ま せ ん 。

GFARM_ERR_NOT_A_DIRECTORY

指 定 し た パ ス 名 の 親 デ ィ レ ク ト リ が 、 デ ィ レ ク ト リ で は あ り ま せ ん 。

GFARM_ERR_PERMISSION_DENIED

指 定 さ れ た フ ァ イ ル に 対 し 、 flags で 指 定 さ れ た モ ー ド で ア ク セ ス す る 権 限 が な い か 、 そ の 親 デ ィ レ ク ト リ へ の 書 き 込 み 権 限 が あ り ま せ ん 。 あ る い は 、 メ タ デ ー タ サ ー バ へ の 認 証 に 失 敗 し ま し た 。

GFARM_ERR_NO_MEMORY

メ モ リ 不 足 の た め 処 理 を 中 止 し ま し た 。

GFARM_ERR_INVALID_ARGUMENT

flags の 指 定 が 不 正 で す 。

GFARM_ERR_GFARM_URL_HOST_IS_MISSING

gfarm_url で 指 定 さ れ た Gfarm URLに お い て 、 メ タ デ ー タ サ ー バ が 指 定 さ れ て い ま せ ん 。

GFARM_ERR_GFARM_URL_PORT_IS_MISSING

gfarm_url で 指 定 さ れ た Gfarm URLに お い て 、 メ タ デ ー タ サ ー バ の ポ ー ト 番 号 が 指 定 さ れ て い ま せ ん 。

GFARM_ERR_UNKNOWN_HOST

指 定 さ れ た メ タ デ ー タ サ ー バ の ア ド レ ス 解 決 が で き ま せ ん 。

GFARM_ERR_TOO_MANY_OPEN_FILES

プ ロ セ ス に お け る オ ー プ ン 可 能 な フ ァ イ ル 数 の 限 界 に 達 し ま し た 。

GFARM_ERR_TOO_MANY_OPEN_FILES_IN_SYSTEM

シ ス テ ム に お け る オ ー プ ン で き る フ ァ イ ル 数 の 限 界 に 達 し ま し た 。

GFARM_ERR_NETWORK_IS_UNREACHABLE

メ タ デ ー タ サ ー バ に 到 達 で き ま せ ん 。

GFARM_ERR_OPERATION_TIMED_OUT

メ タ デ ー タ サ ー バ へ の 接 続 が タ イ ム ア ウ ト を お こ し ま し た 。

GFARM_ERR_PROTOCOL

メ タ デ ー タ サ ー バ と の 通 信 に プ ロ ト コ ル エ ラ ー が 発 生 し ま し た 。

GFARM_ERR_BROKEN_PIPE

メ タ デ ー タ サ ー バ と の 通 信 が 切 断 し ま し た 。

GFARM_ERR_PROTOCOL_NOT_SUPPORTED

指 定 さ れ た 認 証 プ ロ ト コ ル は サ ポ ー ト し て い ま せ ん 。

GFARM_ERR_AUTHENTICATION

メ タ デ ー タ サ ー バ に 対 す る 認 証 に 失 敗 し ま し た 。

GFARM_ERR_ALREADY_EXISTS

flags 引 数 に GFARM_FILE_EXCLUSIVE フ ラ グ が 指 定 さ れ た が 、 フ ァ イ ル が 既 に 存 在 し ま し た 。

そ の 他

上 記 以 外 の エ ラ ー が 生 じ た こ と を 示 し ま す 。 gfarm_error_string (3) に よ り エ ラ ー の 原 因 を 文 字 列 に 変 換 す る こ と が で き ま す 。

SEE ALSO

gfs_pio_close (3), gfs_pio_create (3), gfs_pio_eof (3), gfs_pio_error (3), gfs_pio_flush (3), gfs_pio_getc (3), gfs_pio_getline (3), gfs_pio_open (3), gfs_pio_putc (3), gfs_pio_putline (3), gfs_pio_puts (3), gfs_pio_read (3), gfs_pio_seek (3), gfs_pio_ungetc (3), gfs_pio_write (3)

---