rmfdmn(8)						      System Manager's Manual							 rmfdmn(8)

NAME

       rmfdmn - removes a file domain

SYNOPSIS

       /sbin/rmfdmn  [-f] domain

OPTIONS

       Turns off the message prompt.

OPERANDS

       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 dis-
       plays 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

       Contains file domain names and devices.

SEE ALSO

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

																	 rmfdmn(8)