RFIO_FOPEN
Section: Rfio Library Functions (3)
Updated: $Date: 2005/03/31 13:13:02 $
Index
Return to Main Contents
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