netread(3) [debian man page]

NETREAD(3)						     Common Library Functions							NETREAD(3)

NAME

       netread - receive a message from a socket

SYNOPSIS

       #include "net.h"

       int netread (int s, char *buf, int nbytes);

       ssize_t netread_timeout (int s, void *buf, size_t nbytes, int timeout);

DESCRIPTION

       netread	receives  a  message  from  a  socket.	It overcomes the message fragmentation problem and always waits for all requested bytes to
       arrive or a timeout/error occurs.

RETURN VALUE

       This routine returns the number of bytes if the operation was successful, 0 if the connection was closed by the remote end  or  -1  if  the
       operation failed. In the latter case, serrno is set appropriately.

ERRORS

       EINTR	   The function was interrupted by a signal.

       EBADF	   s is not a valid descriptor.

       EAGAIN	   The socket is non-blocking and there is no message available.

       EFAULT	   buf is not a valid pointer.

       EINVAL	   nbytes is negative or zero.

       ENOTSOCK    s is not a socket.

       SECONNDROP  Connection closed by remote end.

       SETIMEDOUT  Timed out.

SEE ALSO

       recv(2), neterror(3)

AUTHOR

       LCG Grid Deployment Team

LCG
							   $Date: 2005/03/29 09:27:19 $ 						NETREAD(3)

RFIO_LOCKF(3)						      Rfio Library Functions						     RFIO_LOCKF(3)

NAME

       rfio_lockf - provide record locking on files

SYNOPSIS

       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_lockf (int sd, int op, long siz);

       Under Linux, for large files:
       #define _LARGEFILE64_SOURCE
       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_lockf64 (int sd, int op, off64_t siz);

       For large files, under other systems:
       #include <sys/types.h>
       #include "rfio_api.h"

       int rfio_lockf64 (int sd, int op, off64_t siz);

DESCRIPTION

       rfio_lockf restricts access to regions of files to the calling process.

       sd is the file descriptor returned by a previous rfio_open.

       op specifies the action to be taken:

	      F_ULOCK	   unlock a region.

	      F_LOCK	   lock a region.

	      F_TLOCK	   test and lock a region.

	      F_TEST	   test a region for other locks.

       siz gives the size of the region to be locked, starting at the current file offset.

       rfio_lockf64 must be used for large files and uses an off64_t instead of a long to specify the size of the region to be locked.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation failed. In the latter case, serrno is set appropriately.

ERRORS

       EBADF	    sd is not a valid descriptor.

       EACCES	    The file region is locked and F_TEST or F_TLOCK was specified.

       EINVAL	    incorrect value for op or siz.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SETIMEDOUT   Timed out.

       SECONNDROP   Connection closed by remote end.

       SECOMERR     Communication error.

SEE ALSO

       rfio_open(3)

AUTHOR

       LCG Grid Deployment Team

LCG
							   $Date: 2005/03/31 13:13:03 $ 					     RFIO_LOCKF(3)