advfs_set_file_attributes(3) [osf1 man page]

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)

advfs_rmfset(3) 					     Library Functions Manual						   advfs_rmfset(3)

NAME

       advfs_rmfset - Removes a fileset or a clone fileset

SYNOPSIS

       #include <sys/advfs_syscalls.h>

       int advfs_rmfset(
	       char domain,
	       char fileset );

LIBRARY

       AdvFS Library (libadvfs)

PARAMETERS

       Specifies the name of an existing AdvFS file domain.  Specifies the name of the fileset to be removed from the specified file domain.

DESCRIPTION

       This function removes an AdvFS fileset from the named file domain.

       Once  you  have	removed a fileset using this function, the fileset and its files are not recoverable.  The only way to restore the fileset
       and its files is by using a backed up version of the fileset.

RESTRICTIONS

       This function only removes AdvFS filesets; it does not remove UFS file systems.

       The program that calls this function must be running with root privileges.

       A fileset or clone fileset cannot be removed with this function if it is mounted.

       A fileset that has a clone fileset cannot be removed with this function until the clone fileset has been removed.

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 calling program is not running with root privi-
       leges.  The AdvFS lock for domain could not be acquired because one of the following operations was already running on the domain: balance,
       defragment,  rmfset,  or  rmvol.   This	fileset is still mounted; it must be unmounted before it can be removed.  This fileset has a clone
       fileset, which must be removed before this fileset can be removed.  An I/O error occurred on one of the disks in the file domain.   One	or
       both of the names for the fileset and the domain are NULL or set to .  The file domain specified by the domain parameter does not exist.

	      The  fileset  specified  by the fileset parameter does not exist in the file domain specified by the domain parameter.  There is not
	      enough memory available for the operation.

SEE ALSO

       Commands: rmfset(8)

       Functions: advfs_clonefset(3)

																   advfs_rmfset(3)