bionic (3) rfio_fopen.3.gz

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