rmfdmn(8)rmfdmn(8)NAMErmfdmn - 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 ALSOmkfdmn(8), advfs(4), showfdmn(8), mount(8)rmfdmn(8)