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