osf1 man page for advfs_rmfset

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)