GFS_PIO_CREATE(3)
NAME
gfs_pio_create - create a file in the Gfarm file system
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
gfs_pio_create() creates a new file in the Gfarm file system whose name
is the string pointed to by gfarm_url with the access mode mode, and
returns a GFS_File structure to the address pointed to by gfp. Mode
specifies the file permissions to be created, and is modified by the
process's umask.
The flags argument has the same meaning as the second argument of
gfs_pio_open(), including the point such that exactly one of
GFARM_FILE_RDONLY, GFARM_FILE_WRONLY, and GFARM_FILE_RDWR should be
specified.
Note that GFARM_FILE_TRUNC must be explicitly specified by the flags
argument if needed.
RETURN VALUES
- GFARM_ERR_NO_ERROR
- The function terminated successfully.
- GFARM_ERR_IS_A_DIRECTORY
- gfarm_url refers to a directory.
- GFARM_ERR_IS_A_SYMBOLIC_LINK
- gfarm_url refers to a symbolic link.
- GFARM_ERR_OPERATION_NOT_PERMITTED
- gfarm_url refers to not a regular file.
- GFARM_ERR_NOT_A_DIRECTORY
- A component used as a directory in gfarm_url is not, in fact, a directory.
- GFARM_ERR_PERMISSION_DENIED
- The requested access to the file is not allowed, or one of the directories in gfarm_url did not allow search (execute) permission, or the file did not exist yet and write access to the parent directory is not allowed. Or, the authentication to the metadata server fails.
- GFARM_ERR_NO_MEMORY
- Insufficient memory was available.
- GFARM_ERR_INVALID_ARGUMENT
- flags is not valid.
- GFARM_ERR_GFARM_URL_HOST_IS_MISSING
- gfarm_url does not include a metadata server.
- GFARM_ERR_GFARM_URL_PORT_IS_MISSING
- gfarm_url does not include a port number of the metadata server.
- GFARM_ERR_UNKNOWN_HOST
- The metadata server cannot be resolved.
- GFARM_ERR_TOO_MANY_OPEN_FILES
- The process opens too many files.
- GFARM_ERR_TOO_MANY_OPEN_FILES_IN_SYSTEM
- The system limit on the total number of open files has been reached.
- GFARM_ERR_NETWORK_IS_UNREACHABLE
- Network is unrechable.
- GFARM_ERR_OPERATION_TIMED_OUT
- Connetion timeout occurs.
- GFARM_ERR_PROTOCOL
- Protocol error occurs.
- GFARM_ERR_BROKEN_PIPE
- Connection to the metadata server is broken.
- GFARM_ERR_PROTOCOL_NOT_SUPPORTED
- Specified authentication protocol is not supported.
- GFARM_ERR_AUTHENTICATION
- User authentication failed when connecting to the metadata server.
- Others An error except the above occurred. The reason is shown by
- gfarm_error_string(3).