NAME    [Toc]    [Back]

       advfs_rmfset - Removes a fileset or a clone fileset

SYNOPSIS    [Toc]    [Back]

       #include <sys/advfs_syscalls.h>

       int advfs_rmfset(
               char domain,
               char fileset );

LIBRARY    [Toc]    [Back]

       AdvFS Library (libadvfs)

PARAMETERS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The  function  sets  errno to the specified errors for the
       following failure conditions: The calling program  is  not
       running  with  root privileges.  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    [Toc]    [Back]

       Commands: rmfset(8)

       Functions: advfs_clonefset(3)



                                                  advfs_rmfset(3)