Index Click this button to go to the index for this section.


rmfdmn(8)

NAME

rmfdmn - removes a file domain

SYNOPSIS

/sbin/rmfdmn [-f] domain domain Specifies the name of an existing file domain.

FLAGS

-f Turns off the message prompt.

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 flag is useful for scripts when you do not want to be queried for each file domain. If you choose the -f flag, 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 flag 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.

RELATED INFORMATION

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