advfs_set_file_attributes(3)				     Library Functions Manual				      advfs_set_file_attributes(3)

NAME

       advfs_set_file_attributes - Set AdvFS file attributes

SYNOPSIS

       #include <sys/advfs_syscalls.h>

       int advfs_set_file_attributes(
	       int fd,
	       fileAttributesT *fileAttributes );

LIBRARY

       AdvFS Library (libadvfs)

PARAMETERS

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

DESCRIPTION

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

RESTRICTIONS

       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

       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

       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

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

       Functions: open(2), advfs_get_file_attributes(3)

														      advfs_set_file_attributes(3)