 |
Index for Section 8 |
|
 |
Alphabetical listing for R |
|
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
The rmfdmn utility enables you to remove an unused file domain. Before you
can remove a file domain, unmount all filesets and clone filesets from the
domain using the umount command. If you try to remove a file domain that
has mounted filesets, the system displays an error message indicating that
a fileset is mounted. AdvFS will not remove the file domain. For each file
domain you will be prompted:
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 -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 will
display. The rmfdmn command will operate 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.
You must update the /etc/fdmns directory to delete the file domain entry
for the deleted file domain.
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 credit_fs fileset is mounted on the /mnt3 directory and yes is
selected at the verification prompt:
# 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)