mkfset(8)mkfset(8)NAMEmkfset - Creates a fileset in an existing AdvFS domain
SYNOPSIS
/sbin/mkfset [-o argument] domain fileset
OPTIONS
Specifies fileset options; valid arguments are:
frag -- Uses the frag file for files or file fragments less than
8 kilobytes (default).
nofrag -- Disables the frag file for files or file fragments
less than 8 kilobytes.
OPERANDS
Specifies the name of an existing AdvFS domain. Specifies the name of
the fileset to be created in the specified domain.
DESCRIPTION
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 indepen‐
dently of the other filesets in the domain. You can assign fileset quo‐
tas (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
normal 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 significant 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 efficiency for improved filesystem perfor‐
mance.
Use the following commands to manipulate filesets: Displays the file‐
sets 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.
RESTRICTIONS
You must be the root user to use this utility.
Each fileset within a domain must have a unique name of up to 31 char‐
acters. 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 informa‐
tion on DMAPI, see AdvFS Administration.
EXAMPLE
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
directory, enter: # 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 parameters, 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 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 fileset: # 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.
SEE ALSO
Commands: chfsets(8), mkfdmn(8), renamefset(8), rmfset(8), showfdmn(8),
showfsets(8)
File Formats: advfs(4)mkfset(8)