gfal_open(3) - Linux man page

Name

gfal_open - open a file

Synopsis

#include "gfal_api.h"

int gfal_open (const char *filename, int flags, mode_t mode);

Under Linux, for large files:
#define _LARGEFILE64_SOURCE
#include "gfal_api.h"

int gfal_open64 (const char *filename, int flags, mode_t mode);

For large files, under other systems:
#include "gfal_api.h"

int gfal_open64 (const char *filename, int flags, mode_t mode);

Description

gfal_open opens a file according to the value of flags.

filename: specifies the file name: either a logical file name, a guid, an SURL or a TURL.
flags: value is built by OR'ing the bits defined in <fcntl.h> but one and only one of the first three flags below must be used:
O_RDONLY: open for reading only
O_WRONLY: open for writing only
O_RDWR: open for reading and writing
O_CREAT: If the file exists already and O_EXCL is also set, gfal_open will fail.
O_LARGEFILE: allows files whose sizes cannot be represented in 31 bits to be opened.
mode: is used only if the file is created.

Return Value

This routine returns the file descriptor if the operation was successful or -1 if the operation failed. In the latter case, errno is set appropriately.

Errors