unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



rmfdmn(8)							    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

  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	sys-
  tem 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 follow-
  ing 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 exam-
  ple, 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

  /etc/fdmns
      Contains file domain names and devices.

SEE ALSO

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