advfs_rmfset(3)advfs_rmfset(3)NAMEadvfs_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 privi‐
leges.
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 fail‐
ure 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 file‐
set, 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)