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