mkfset - Creates a fileset in an existing AdvFS domain
/sbin/mkfset [-o argument] domain fileset
Specifies fileset options; valid arguments are:
frag -- Uses the frag file for files or file fragments less than 8
nofrag -- Disables the frag file for files or file fragments less than
Specifies the name of an existing AdvFS domain.
Specifies the name of the fileset to be created in the specified
The mkfset command creates an AdvFS fileset within an existing domain. You
can have more than one fileset in a domain unless that fileset is enabled
for the data management API (DMAPI), then only one fileset is allowed in a
domain. You can mount and unmount each fileset independently of the other
filesets in the domain. You can assign fileset quotas (block and file usage
limits) to filesets.
A domain is not active until it has a mounted fileset.
The -o option with the frag argument causes files to be fragged in the nor-
mal manner. The nofrag argument causes files that normally would be fragged
not to be.
The page size in AdvFS is 8 kilobytes. For small files that are not an even
multiple of 8 kilobytes in length, the last partial page of data is stored
in the fileset's frag file. The use of the fragment file results in signi-
ficant disk space savings for filesets with many small files. The trade-off
for this efficient use of disk space is degraded filesystem performance for
these small files. Disabling the fragment file trades excellent space effi-
ciency for improved filesystem performance.
Use the following commands to manipulate filesets:
Displays the filesets associated with a domain.
Removes a fileset (and all of its files) from the domain.
Assigns a new name to an existing fileset.
Changes fileset attributes; specifically fileset quotas.
For more information, see the reference pages for each command.
You must be the root user to use this utility.
Each fileset within a domain must have a unique name of up to 31 charac-
ters. All whitespace characters (tab, new line, space and so on) and the /
# : * ? characters are invalid for fileset names.
If a file has a frag, persistent atomic-write data logging cannot be
activated for that file.
If a fileset is DMAPI-enabled it must be the only fileset in a domain. If
you try to create a fileset in a domain where the existing fileset is
DMAPI-enabled, you will receive an error message. For more information on
DMAPI, see AdvFS Administration.
1. The following example creates two filesets, credit_fs and debit_fs,
within an existing domain called accts_dmn and mounts one of them.
# mkfset accts_dmn credit_fs
# mkfset accts_dmn debit_fs
To create a mount point directory for credit_fs, enter:
# mkdir /mnt/credit
To mount the newly created credit_fs fileset on the /mnt/credit direc-
# mount -t advfs accts_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. If you add the userquota and groupquota parame-
ters, filesets quotas are enabled. You can set fileset quota limits
with the chfsets command. For example, to automatically mount the
credit_fs fileset, add the following line to the /etc/fstab file:
accts_dmn#credit_fs /mnt/credit advfs rq,userquota,groupquota 0 2
2. The following example shows the message you get if you try to create
more than one fileset in a domain with an existing DMAPI-enabled
# mkfset dmn fset2
// A DMAPI-enabled fileset already exists in dmn
mkfset: error, A DMAPI-enabled fileset exists in the domain
A domain containing a DMAPI-enabled fileset is limited to one fileset only.
Commands: chfsets(8), mkfdmn(8), renamefset(8), rmfset(8), showfdmn(8),
File Formats: advfs(4)