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)