Index for Section 8

Alphabetical listing for R

Bottom of page

rmfdmn(8)
NAME
  rmfdmn - removes a file domain

SYNOPSIS
  /sbin/rmfdmn	[-f] domain

OPTIONS
  -f  Turns off the message prompt.

OPERANDS
  domain
      Specifies the name of an existing file domain.

DESCRIPTION
  Use the rmfdmn utility to remove an existing, but unused, file domain and
  all its filesets from the system.

  When you remove a file domain:

    ·  The file domain and its filesets are destroyed

    ·  The directory entry for the file domain in the /etc/fdmns file is
       deleted

    ·  AdvFS volumes which were assigned to the file domain are relabeled as
       unused

  Before attempting to remove a file domain, unmount all filesets and clone
  filesets from the domain using the umount command.  If you attempt to
  remove a file domain that has mounted filesets or clone filesets, the
  system does not remove the file domain.  Instead, it displays an error
  message indicating that a fileset is mounted.

  For each file domain you attempt to remove, a prompt similar to the
  following is displayed:

       rmfdmn accounts_dmn
       rmfdmn: remove domain accounts_dmn? [yes/no]

  If you answer n, the file domain remains. If you answer y, it is removed.
  The default is n, the file domain remains.

  The -f option is useful for scripts when you do not want to be queried for
  each file domain. If you choose the -f option, no message prompt is
  displayed. The rmfdmn command operates as if you responded yes to the
  prompt.

RESTRICTIONS
  You must be the root user to use this command.

  To remove a domain, all filesets and clone filesets must be unmounted.

  The rmfdmn command can leave a partially-removed domain in the /etc/fdmns
  directory, for example, should there be a system failure during the remove
  operation.  If this happens, the remnants of the removed domain are put in
  the /etc/fdmns directory as a file with a name in this format:
  rmfdmn.domain_name.processid.	 If you interrupt the rmfdmn command or there
  is a system failure during its operation, check the /etc/fdmns directory
  for domain names in this format and use the rmfdmn command to delete them.

  However, if a partially-removed domain has been in the /etc/fdmns directory
  for some time, it can be risky to remove it with the rmfdmn command:	the
  partitions might have been put back into use and deleting them would make
  them unusable.  [The rmfdmn command puts an unused option in the fstype
  field of the disk label when it removes disks.]

  In this case, use the rm -r command to remove the partially-recovered
  domain.  Unlike the rmfdmn command, the rm command does not alter the
  fstype field of the disk label.

EXAMPLES
  The following example removes the accounts_dmn file domain. In this
  example, the accounts_dmn#credit_fs fileset is mounted on the /mnt3
  directory and must be unmounted.  When the verification prompt for removing
  the accounts_dmn is displayed, yes is selected.

       # umount /mnt3
       # rmfdmn accounts_dmn
       # rmfdmn: remove domain accounts_dmn? [yes/no]
       # rmfdmn: domain accounts_dmn removed

FILES
  /etc/fdmns
      Contains file domain names and devices.

SEE ALSO
  mkfdmn(8), advfs(4), showfdmn(8), mount(8)

Index for Section 8

Alphabetical listing for R

Top of page