Index for Section 3

Alphabetical listing for A

Bottom of page

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
  domain
      Specifies the name of an existing AdvFS file domain.

  fileset
      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:

  [EACCES]
      The calling program is not running with root privileges.

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

  [EBUSY]
      This fileset is still mounted; it must be unmounted before it can be
      removed.

  [EEXIST]
      This fileset has a clone fileset, which must be removed before this
      fileset can be removed.

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

  [EINVAL]
      One or both of the names for the fileset and the domain are NULL or set
      to .

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

  [ENOMEM]
      There is not enough memory available for the operation.

SEE ALSO
  Commands: rmfset(8)

  Functions: advfs_clonefset(3)

Index for Section 3

Alphabetical listing for A

Top of page