Rechercher une page de manuel

gfs_pio_open

Langue: ja

Version: 30 October 2004 (ubuntu - 25/10/10)

Section: 3 (Bibliothèques de fonctions)

gfs_pio_open - Gfarmファイルのオープン

#include <gfarm/gfarm.h>

char *gfs_pio_open (char * gfarm_url, int flags, GFS_File * gfp);

指定した gfarm_url ファイルをオープンし、GFS_File 構造体を gfp の指す先に返します。

flags は、以下のフラグの bitwise-or で指定します。はじめの三つのフラグはどれかが指定されている必要があります。

以下のフラグは効率的な実行のためのヒントとして指定することができます。

GFARM_FILE_SEQUENTIAL: ファイルが連続的にアクセスされることを示します。
GFARM_FILE_REPLICATION: ファイルの複製がローカル・ファイルシステムにない場合は、ファイルアクセスに先立ち、ローカル・ファイルシステムにファイルの複製を作成します。
GFARM_FILE_NOT_REPLICATION: ファイルの複製がローカル・ファイルシステムにない場合でも、ファイルの複製を作成せず、遠隔のファイルシステムノードに格納されているファイルコピーを直接参照します。
GFARM_FILE_NOT_RETRY: 選択されたファイル複製が何らかの理由で存在しない、あるいはアクセスできない場合でも、自動的には別のファイル複製の参照を試みず、オープンに失敗します。

GFARM_FILE_REPLICATIONと GFARM_FILE_NOT_REPLICATIONは同時に指定することはできません。

gfrun(3) や gfmpirun_p4(3) で起動された並列プロセスで gfs_pio_open() を呼ぶ場合、それぞれのプロセスの GFS_File 構造体は個別ファイルポインタを持ちます。

NULL: 正常終了を示します。
GFARM_ERR_NO_MEMORY: メモリ不足のため処理を中止しました。
GFARM_ERR_AUTHENTICATION: gfmd(8) あるいは gfsd(8) に対するユーザー認証が失敗しました。
GFARM_ERR_PERMISSION_DENIED: gfarm_urlへ、 flags で指定されたモードでアクセスする権限が、ありません。
GFARM_ERR_IS_A_DIRECTORY: 指定された gfarm_url は、ディレクトリです。
GFARM_ERR_NO_SUCH_OBJECT: 指定されたファイルが存在しません。
GFARM_ERR_NOT_A_DIRECTORY: 指定したパス名の親ディレクトリが、実際にはディレクトリでなかったことを示します。
その他: 上記以外のエラーが生じたことを示します。