unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



mkfset(8)							    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 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:

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

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 direc-
       tory, 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 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
       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)