sam_set_fs_contig(3)

NAME
     sam_set_fs_contig - Sets the maximum  number  of  contiguous
     blocks for I/O

SYNOPSIS
     cc [ flag  ... ] file  ... -L/opt/SUNWsamfs/lib  -lsamapi  [library ... ]

     #include "/opt/SUNWsamfs/include/samapi.h"

     int sam_set_fs_contig(ushort_t  eq_number,  int  max_contig,
     int wait_response);

DESCRIPTION
     sam_set_fs_contig() sets the maximum  number  of  contiguous
     blocks  that can be read or written to a mass storage device
     in the family set at equipment number eq_number.  The  value
     for  max_contig  can be from 1 to 128.  The default value is
     8.  The block size is 16384 bytes.

     The call will return immediately after issuing  the  command
     if  zero is specified for wait_response value.  Other values
     for wait_response will give undefined results.

RETURN VALUES
     Upon succesful completion a value of 0 is returned.   Other-
     wise, a value of -1 is returned and errno is set to indicate
     the error.

ERRORS
     sam_set_fs_contig() fails if one or more  of  the  following
     are true:

     ER_DEVICE_NOT_CORRECT_TYPE
                         The specified eq_number device is not  a
                         family set device.

     ER_FIFO_PATH_LENGTH The path and filename for the FIFO  pipe
                         is too long.

     ER_NO_EQUIP_ORDINAL eq_number is  not  a  defined  equipment
                         number in this configuration.

     ER_NO_MASTER_SHM    No Sun  QFS  or  SAM-QFS  master  shared
                         memory  segment defined.  Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are
                         mounted.

     ER_NO_MASTER_SHM_ATT
                         No Sun  QFS  or  SAM-QFS  master  shared
                         memory  segment  found.   Check that the
                         Sun QFS  or  SAM-QFS  file  systems  are

                         mounted.

     ER_NO_RESPONSE_FIFO Unable to create the response FIFO pipe.

     ER_OPERATOR_NOT_PRIV
                         Operator does not have permission to set
                         maximum contiguous blocks.

FILES
     mcf                 The configuration file for  Sun  QFS  or
                         SAM-QFS file systems.

SEE ALSO
     samu(1M).