advfs_get_fset_list(3) Library Functions Manual advfs_get_fset_list(3)NAME
advfs_get_fset_list - Obtain a list of all the filesets in an AdvFS file domain
SYNOPSIS
#include <sys/advfs_syscalls.h>
int advfs_get_fset_list(
char domain,
unsigned long arraySize,
unsigned long *offset,
unsigned long *numFilesets,
filesetInfoT filesetInfo[] );
LIBRARY
AdvFS Library (libadvfs)
PARAMETERS
The name of the AdvFS file domain to be searched for filesets. Contains the number of filesetInfoT cells that have been malloced for the
filesetInfo array. A pointer for the next iteration of the function: the starting location for the next set of filesets. The total num-
ber of filesets in the specified file domain. The array of fileset information structures that is filled in on successful return from this
function.
DESCRIPTION
Use this function to obtain information about the filesets in an AdvFS file domain. Information about both mounted and unmounted filesets
is returned. The function returns the information in the "filesetInfo[]" array.
For an example of programming the advfs_get_fset_list function, see [reference to be provided].
NOTES
Compaq recommends that the application malloc an array large enough to gather all fileset information in a single call to the function.
The function can skip filesets or return them multiple times if the function is using the offset parameter while another user creates or
removes filesets in between the calls that this user makes to the function.
This function can take a very long time to complete when it is called to execute on a file domain with a large number of unmounted file-
sets.
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. The file domain
specified by the domain parameter does not exist. There is not enough memory available for the operation
SEE ALSO
Commands: clonefset(8), mkfset(8), renamefset(8), rmfset(8)
Functions: advfs_clonefset(3), advfs_rmfset(3)advfs_get_fset_list(3)
Check Out this Related 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)