NAME    [Toc]    [Back]

       advfs_set_file_attributes - Set AdvFS file attributes

SYNOPSIS    [Toc]    [Back]

       #include <sys/advfs_syscalls.h>

       int advfs_set_file_attributes(
               int fd,
               fileAttributesT *fileAttributes );

LIBRARY    [Toc]    [Back]

       AdvFS Library (libadvfs)

PARAMETERS    [Toc]    [Back]

       An  open  file  descriptor  of the file for which you want
       attributes set.  A pointer to a  structure  that  contains
       the file attributes.

DESCRIPTION    [Toc]    [Back]

       This  function  sets a file's AdvFS-specific attributes to
       the attributes that are defined in the  specified  fileAttributes
  structure.   However,  the function does not set
       any attributes that are marked as reserved in the  fileAttributes
 structure.

RESTRICTIONS    [Toc]    [Back]

       If  the  stripe.segmentCnt field is set to a value greater
       than the total number of volumes in the AdvFS file domain,
       an error is returned.

       You  must have the AdvFS Advanced Utilities license to set
       a file's mapType to XMT_STRIPE.

RETURN VALUES    [Toc]    [Back]

       The  function returns a value of 0  (zero)  on  successful
       completion.  The function returns a value of -1 on failure
       and sets the value of errno to the specific error.

ERRORS    [Toc]    [Back]

       The function sets errno to the specified  errors  for  the
       following  failure  conditions:  The file descriptor fd is
       not pointing to a file that resides in an  AdvFS  fileset.
       An  I/O  error occurred on one of the disks containing the
       file.   The  fileAttributes.writeOrder  field  contains  a
       value  other than ADVFS_WO_ASYNC_WRITE, ADVFS_WO_DATA_LOGGING,
 or ADVFS_WO_SYNC_WRITE.

              The fileAttributes.mapType field contains  a  value
              other than XMT_SIMPLE or XMT_STRIPE.

              The   fileAttributes.mapType   field   is   set  to
              XMT_STRIPE and the fileAttributes.stripe.segmentCnt
              field  contains a value less than 2 or greater than
              the number of volumes in the domain.  There is  not
              enough memory available for the operation.

SEE ALSO    [Toc]    [Back]

       Commands: chfile(8), showfile(8), stripe(8)

       Functions: open(2), advfs_get_file_attributes(3)



                                     advfs_set_file_attributes(3)