NAME

mkfset − creates an AdvFS fileset in an existing file domain

SYNOPSIS

/sbin/mkfset [-f filesystem_id] domain setname

domainSpecifies the name of an existing file domain. 

setnameSpecifies the name of the fileset to be created in the specified file domain. 

FLAGS

-f filesystem_idCreates file system ID for POLYCENTER HSM Extended File System (EFS). 

DESCRIPTION

The mkfset command creates an AdvFS fileset or an EFS file system within an existing file domain.  You must create at least one fileset per file domain; however, you can create multiple filesets within a file domain. You can mount and unmount each fileset independently of the other filesets in the file domain. You can assign block and file usage limits (quotas) to filesets. 

Use the following commands to manipulate filesets:

showfsetsDisplays the filesets associated with a domain. 

rmfsetRemoves a fileset (and all of its files) from the file domain. 

renamefsetAssigns a new name to an existing fileset. 

chfsetsChanges fileset attributes; specifically fileset quotas. 

For more information, see the reference pages for each command. 

For HSM, choosing the -f flag sets unique identification for the extended file system.  This allows an AdvFS fileset to be recognized by HSM and enables the hierarchical storage management features known as file shelving.  Do not use this option unless you require a POLYCENTER HSM EFS file system. 

The file system ID passed for the -f option must be a unique, nonzero string.  The string can be a hexadecimal constant or a hexadecimal value.  No other fileset can have the same value.  You will need to know the file system ID when you assign platters to each file system.  This can be obtained by examining the user ID field shown in the output from the showfsets command.  The characteristics and restrictions of the EFS file system are different from those of AdvFS. 

RESTRICTIONS

You must have root-user privilege to access this command. 

Each fileset within a domain must have a unique name of up to 31 characters.  The space character and the / # : ∗ ? characters are invalid for fileset names. 

Digital UNIX supports an unlimited number of filesets per system; only 512 filesets can be mounted at one time. 

EXAMPLE

The following example creates two filesets, credit_fs and debit_fs, within an existing domain called accounts_dmn. 

# mkfset accounts_dmn credit_fs
# mkfset accounts_dmn debit_fs

To mount the newly created credit_fs fileset on the /mnt/credit directory, enter:

# mount -t advfs accounts_dmn#credit_fs /mnt/credit

You can add filesets to the /etc/fstab file in the same manner that you add any file system. Once added, filesets are mounted each time you reboot the system and fileset quotas are enabled.  For example, to automatically mount the credit_fs fileset, add the following line to your fstab file:

accounts_dmn#credit_fs /mnt/credit advfs rq, userquota, groupquota

The following example creates an EFS file system with an id of 123abc:

# mkfset -f 123abc domain hsm_set

or

# mkfset -f 0x123abc domain hsm_set

FILES

.tagsA permanent directory that is reserved for future use. 

RELATED INFORMATION

advfs(4), chfsets(8), mkfdmn(8), renamefset(8), rmfset(8), showfdmn(8), showfsets(8).