NAME    [Toc]    [Back]

       rmfdmn - removes a file domain

SYNOPSIS    [Toc]    [Back]

       /sbin/rmfdmn  [-f] domain

OPTIONS    [Toc]    [Back]

       Turns off the message prompt.

OPERANDS    [Toc]    [Back]

       Specifies the name of an existing file domain.

DESCRIPTION    [Toc]    [Back]

       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 displays  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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Contains file domain names and devices.

SEE ALSO    [Toc]    [Back]

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



                                                        rmfdmn(8)