advfs_set_file_attributes(3)advfs_set_file_attributes(3)NAMEadvfs_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. However,
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 map‐
Type 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 fail‐
ure 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)