Content-type: text/html Manpage of GFAL_CREAT

GFAL_CREAT

Section: Library Functions (3)
Updated: 2003/11/19 12:56:29
Index Return to Main Contents
 

NAME

gfal_creat - create a new file or truncate an existing one  

SYNOPSIS

#include "gfal_api.h"

int gfal_creat (const char *filename, mode_t mode);

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

int gfal_creat64 (const char *filename, mode_t mode);

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

int gfal_creat64 (const char *filename, mode_t mode);  

DESCRIPTION

gfal_creat creates a new file or truncates an existing one.
filename
specifies the file name: either a logical file name, a guid, an SURL or a TURL.
mode
is used only if the file is created.

gfal_creat (filename, mode) is equivalent to:

        open(filename, O_WRONLY | O_CREAT | O_TRUNC, mode)
 

RETURN VALUE

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

ERRORS

ENOENT
A component of the filename prefix does not exist.
EACCES
Search permission is denied on a component of the filename prefix or the file does not exist and write permission on the parent directory is denied or the file exists and write permission on the file itself is denied.
EFAULT
filename is a NULL pointer.
EBUSY
Device or resource busy. Happens if you try to open in write mode a CASTOR file that is in an active migration stream.
ENOTDIR
A component of filename prefix is not a directory.
EINVAL
filename has an invalid syntax.
ECOMM
Communication error.
EPROTONOSUPPORT
Access method not supported.
 

SEE ALSO

gfal(3)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:34:06 GMT, January 20, 2004