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

fdAn open file descriptor of the file for which you want attributes set. 

∗fileAttributes
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 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:

[EBADF]
The file descriptor fd is not pointing to a file that resides in an AdvFS fileset. 

[EIO]
An I/O error occurred on one of the disks containing the file.

[EINVAL]
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. 

[ENOMEM]
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)