*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> mkfset (8)              



NAME    [Toc]    [Back]

       mkfset - Creates a fileset in an existing AdvFS domain

SYNOPSIS    [Toc]    [Back]

       /sbin/mkfset [-o argument] domain fileset

OPTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       Specifies the name of an existing AdvFS domain.  Specifies
       the name of the fileset to be  created  in  the  specified

DESCRIPTION    [Toc]    [Back]

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

RESTRICTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       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

              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    [Toc]    [Back]

       Commands: chfsets(8), mkfdmn(8), renamefset(8), rmfset(8),
       showfdmn(8), showfsets(8)

       File Formats: advfs(4)

[ Back ]
 Similar pages
Name OS Title
rmfset Tru64 Removes a fileset or a clone fileset from an AdvFS file domain
renamefset Tru64 Rename an existing AdvFS fileset
clonefset Tru64 Creates a read-only copy of an AdvFS fileset.
advfs_get_fset_quotas Tru64 Obtains fileset quotas for an AdvFS fileset
advfs_set_fset_quotas Tru64 Sets fileset quotas for an AdvFS fileset
mkfdmn Tru64 Creates a new AdvFS domain
advfs_clonefset Tru64 Creates a read-only copy of an active fileset
fs_restore_config Tru64 Restores an AdvFS domain configuration.
fs_save_config Tru64 Saves an AdvFS domain configuration.
nvlogpg Tru64 Displays the log file of an AdvFS domain
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service