NAME
rfio_fopen - opens a file
SYNOPSIS
#include <sys/types.h>
#include "rfio_api.h"
FILE *rfio_fopen (char *path, char *mode);
Under Linux, for large files:
#define _LARGEFILE64_SOURCE
#include <sys/types.h>
#include "rfio_api.h"
FILE *rfio_fopen64 (char *path, char *mode);
For large files, under other systems:
#include <sys/types.h>
#include "rfio_api.h"
FILE *rfio_fopen64 (char *path, char *mode);
DESCRIPTION
rfio_fopen opens the file whose name is the string pointed to by path ,
a character string containing the filename specification, and
associates a FILE stream with it.
mode is an access mode indicator. One of the characters "r" or "w".
rfio_fopen64 allows to open large files (see NOTES).
RETURN VALUE
This routine returns NULL if the operation failed or a non-NULL pointer
to a FILE structure if the operation was successful. If it fails,
serrno variable is set appropriately.
ERRORS
ENOENT The named file/directory does not exist or is a null
pathname.
EACCES Search permission is denied on a component of the path
prefix.
EFAULT path is NULL
ENOTDIR A component of path prefix is not a directory.
EINVAL The mode provided to local open is invalid (see fopen(3))
EMFILE Too many open files
ECONNRESET Connection reset by peer
ETIMEDOUT Connection timed out
ECONNREFUSED Connection refused
EHOSTUNREACH No route to host
SENOSHOST Host unknown.
SENOSSERV Service unknown.
SEBADVERSION Version ID mismatch
SECOMERR Communication error.
SERTYEXHAUST Retry count exhausted
SENORCODE Host did not return error number
SEHOSTREFUSED
Host is not on local network and no mapping found
NOTES
On Irix, Tru64 and IA64 the 64 bit mode is the default one, rfio_fopen
and rfio_fopen64 are identical.
SEE ALSO
fopen(3), rfio_serror(3), rfio_perror(3), serrno(3)
AUTHOR
LCG Grid Deployment Team