rmfdmn(8) [osf1 man page]

rmfdmn(8)						      System Manager's Manual							 rmfdmn(8)

NAME

       rmfdmn - 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 ALSO

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

																	 rmfdmn(8)

Check Out this Related Man Page

advfs_get_fdmn_list(3)					     Library Functions Manual					    advfs_get_fdmn_list(3)

NAME

       advfs_get_fdmn_list - Get an AdvFS file domain list

SYNOPSIS

       #include <sys/advfs_syscalls.h>

       int advfs_get_fdmn_list(
	       unsigned long arraySize,
	       unsigned long *offset,
	       unsigned long *numDomains,
	       domainInfoT domainInfo[] );

LIBRARY

       AdvFS Library (libadvfs)

PARAMETERS

       Contains  the  number of domainInfoT cells that have been malloced for the domainInfo array.  A pointer for the next iteration of the func-
       tion:  the starting location for the next set of file domains.  A pointer to the location that contains the number  of  file  domains  that
       currently exist on the system.  An array of domain information structures.

DESCRIPTION

       Use this function to obtain information about the AdvFS file domains on a system.  The function returns the information in the domainInfo[]
       array.

       The information is returned only for valid file domains.

       For an example of programming the advfs_get_fdmn_list function, see [reference to be determined].

NOTES

       If an AdvFS  file  domain  becomes  corrupt,  remove  its  directory  entry  in	/etc/fdmns  before  executing  a  program  that  uses  the
       advfs_get_fdmn_list function.  Corrupt file domains can crash the system.

       Compaq recommends that the application malloc an array large enough to gather all domain information in a single call to the function.

       By  default, only the root user has write access permission to the /etc/fdmns directory.  However, any user who gains this permission could
       rename a file domain or make other changes that could invalidate the return values of this function.

       The function can skip file domains or return them multiple times if the function is using the offset parameter while another  user  creates
       or removes file domains in between the calls that this user makes to the function.

RETURN VALUES

       The  function  returns  a  value  of 0 (zero) on successful completion. The function returns a value of -1 on failure and sets the value of
       errno to the specific error.

ERRORS

       The calling program is not running with root privileges.  An I/O error occurred on one of the disks in  the  file  domain.   There  is  not
       enough memory available for the operation

FILES

       Directory of valid AdvFS file domains.

SEE ALSO

       Commands: mkfdmn(8), rmfdmn(8)

       File Formats: advfs(4)

															    advfs_get_fdmn_list(3)

Linux and UNIX Man Pages

rmfdmn(8) [osf1 man page]

Check Out this Related Man Page