Index for Section 8

Alphabetical listing for M

Bottom of page

mkfset(8)
NAME
  mkfset - Creates a fileset in an existing AdvFS domain

SYNOPSIS
  /sbin/mkfset [-o argument] domain fileset

OPTIONS
  -o argument
      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
  domain
      Specifies the name of an existing AdvFS domain.

  fileset
      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 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
  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 performance.

  Use the following commands to manipulate filesets:

  showfsets
      Displays the filesets associated with a domain.

  rmfset
      Removes a fileset (and all of its files) from the domain.

  renamefset
      Assigns a new name to an existing fileset.

  chfsets
      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
  characters.  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.

EXAMPLE
   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
       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

   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)

Index for Section 8

Alphabetical listing for M

Top of page