rfiosetopt man page

RFIOSETOPT(3)               Rfio Library Functions               RFIOSETOPT(3)

[1mNAME[0m
      rfiosetopt - set RFIO options

[1mSYNOPSIS[0m
      [1m#include <sys/types.h>[0m
      [1m#include "rfio_api.h"[0m

      [1mint rfiosetopt (int [4m[22mopt[24m[1m, int *[4m[22mpval[24m[1m, int [4m[22mlen[24m[1m)[0m

      [1mint rfio_setbufsize (int [4m[22ms[24m[1m, int [4m[22mbufsize[24m[1m)[0m

[1mDESCRIPTION[0m
      [1mrfiosetopt  [22msets  the RFIO option [4mopt[24m to the content of the memory cell
      pointed by [4mpval[24m.

      [1mrfio_setbufsize [22msets the size of the readahead buffer to be used  on  a
      particular socket connection.

      [4mopt[24m can have on of the following values:

             [1mRFIO_READOPT[0m
                    The  value  pointed  by  pval  can  be  0,  RFIO_READBUF,
                    RFIO_READAHEAD or RFIO_STREAM (V3).

                    If set to zero, a normal read will be used  (one  request
                    to the server per read).

                    If  set  to RFIO_READBUF, an internal buffer is allocated
                    in the client API, each call to  the  server  fills  this
                    buffer  and  the  user buffer is filled from the internal
                    buffer. There is one server call per buffer fill.

                    If set to RFIO_READAHEAD, an initial call is sent to  the
                    server  which  pushes data to the client buffer until end
                    of file is reached or an error occurs or  a  new  request
                    comes  from  the client.  There is no intermediate buffer
                    unless RFIO_READBUF|RFIO_READAHEAD is specified.

                    If RFIO_STREAM is set, the V3 protocol is enabled.   This
                    uses  2  socket  connections  between  the client and the
                    server and the server itself is  multi-threaded  allowing
                    overlap  of  disk  and  network  operations.  The data is
                    pushed on the data socket until end of file is reached or
                    an error occurs. The transfer can be interrupted by send-
                    ing a packet on the control socket.
                    Default is RFIO_READBUF.

                    The default internal buffer size is 128kB, but the buffer
                    size   can  be  set  with  an  entry  RFIO  IOBUFSIZE  in
                    [1mshift.conf [22mor thru the environment  variable  RFIO_IOBUF-
                    SIZE.

             [1mRFIO_NETOPT[0m
                    The  value pointed by pval can be RFIO_NONET or RFIO_NET.
                    If set to RFIO_NONET, the NET entries in  [1mshift.conf  [22mare
                    ignored.  Default is RFIO_NET.

             [1mRFIO_NETRETRYOPT[0m
                    The   value  pointed  by  pval  can  be  RFIO_RETRYIT  or
                    RFIO_NOTIME2RETRY.

                    If set to RFIO_RETRYIT, there will be retries on  failing
                    connect.   The number of retries is given by the environ-
                    ment variable RFIO_CONRETRY or the RFIO CONRETRY entry in
                    [1mshift.conf[22m.   The retry interval (in seconds) is given by
                    the environment variable  RFIO_CONRETRYINT  or  the  RFIO
                    CONRETRYINT entry.

                    If  set  to  RFIO_NOTIME2RETRY, there will be no retry on
                    failing connect.
                    Default is RFIO_RETRYIT.

             [1mRFIO_CONNECTOPT[0m
                    The  value  pointed  by  pval  can  be  RFIO_NOLOCAL   or
                    RFIO_FORCELOCAL.   If  set to RFIO_FORCELOCAL, no parsing
                    is done on pathname. The file is  assumed  to  be  local.
                    Default is RFIO_NOLOCAL.

      The [4mlen[24m argument is ignored.

      [4ms[24m is the file descriptor of the receiving socket.

      [4mbufsize[24m is the size of the readahead buffer to be used.

[1mRETURN VALUE[0m
      [1mrfiosetopt [22mreturns 0 if the operation was successful or -1 if the oper-
      ation failed.  In the latter case, [1mserrno [22mis set appropriately.

[1mERRORS[0m
      [1mENOMEM       [22mbuffer could not be allocated.

      [1mEINVAL       [4m[22mopt[24m is not a valid option, [4mbufsize[24m is negative or the user
                   tries  to  change the buffer size after the actual I/O has
                   started.

[1mSEE ALSO[0m
      [1mrfio_open(3)[22m, [1mrfioreadopt(3)[0m

[1mAUTHOR[0m
      [1mLCG Grid Deployment [22mTeam

LCG          $Date: 2010-02-15 10:01:40 +0100 (Mon, 15 Feb 2010) $RFIOSETOPT(3)

Referenced By

rfio_setbufsize(3) is an alias of rfiosetopt(3).