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