Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

showfsets(8)							 showfsets(8)


  showfsets - Displays information about filesets in an	AdvFS domain


  /sbin/showfsets [-b  | -q] [-k] domain [fileset...]


  -b  Lists the	names of the filesets in a domain without additional detail.

  -k  Displays the total number	of blocks and the number of free 1Kb blocks.

  -q  Displays the quota limits	for filesets in	a domain.


      Specifies	the full path name of the AdvFS	domain.

      Specifies	the name of one	or more	filesets in the	domain.


  The showfsets	command	displays the filesets (or clone	filesets) and their
  characteristics in a specified domain.  The characteristics of a fileset

    +  Fileset Identifier

       A fileset identifier is a combination of	the domain identifier and an
       additional set of numbers that identify the fileset within the domain.
       For example, the	fileset	identifier 2be95ef4.000a129.1.8001 consists
       of the following:

       Domain identifier

       Fileset-specific	numbers

    +  Clone status

       The status items	of a clone fileset vary, depending on the fileset.
       Status items can	include:

	 -- Clone is

	    Specifies the name of a clone fileset.

	 -- Clone of

	    Specifies the name of the parent fileset, if the displayed
	    fileset is a clone fileset.

	 -- Revision

	    Specifies the number of times you recreate a clone fileset.	For
	    example, if	you recreate a clone fileset of	the same parent
	    fileset three times, the revision value is 3.

    +  Files

       Specifies the number of files in	the fileset. Files counted include
       normal files, symlinks, and all directories. Files not included in the
       count are the two quota files, the frag file, any index files (DVN 4
       and above) and invisible	system files. Note that	a file may have	many
       directory entries pointing to it	(hard links); only one instance	is
       included	in the count.

       Also specifies the current file usage limits (quotas). SLim, the	soft
       limit, is a quota that can be exceeded for a fixed period of time and
       HLim, the hard limit, is	a quota	that cannot be exceeded.

    +  Blocks

       Specifies the number of blocks that are in use by a mounted fileset
       and the current block soft and hard usage limits	(quotas). For
       filesets	that are not mounted, zero blocks will display.	For an accu-
       rate display, the fileset must be mounted.

    +  Quota Status

       Specifies which quota types are enabled (enforced).

    +  Object Safety

       Specifies whether zero-filled pages in the buffer are synchronously
       written to disk before application can access them (set by chfsets

    +  Fragging

       Specifies whether fragging is on	or off (set by chfsets command).

    +  DMAPI

       Specifies whether data management API is	on or off (set by chfsets

  The showfsets	command	with the -q option set displays	block and file infor-
  mation for a specified domain	or for one or more named filesets in the
  domain. The characteristics of a named fileset are:

    +  BF (block flag)

       Specifies block (B) and file (F)	usage limits. A	+ in this field	means
       that the	soft limit is exceeded;	a * means that the hard	limit is

    +  Block (512) Limits

       Specifies the number of blocks used, the	soft limit (the	number of
       blocks that can be exceeded for a period	of time), the hard limit (the
       number of blocks	that cannot be exceeded), and the grace	period (the
       remaining time for which	the soft limit may be exceeded).

    +  File Limits

       Specifies the number of files used, the fileset quotas enabled, and
       the grace period	remaining.


	 On a TruCluster Server, the showfsets command can sometimes report
	 incorrect disk	usage. Data in the Cluster File	System (CFS) client
	 caches	is synchronized	to the server at least every 30	seconds. The
	 disk usage reported does not account for dirty	data in	client caches
	 that has not yet been synchronized to the server.


   1.  The following example shows the command line and	resulting display for
       the showfsets command:
	    # showfsets	usr_domain

			 Id	       :  2c2f557f.000b15f4.3.8004
			 Clone is      :  usr_clone
			 Files	       :  17644, SLim=0,      HLim=	 0
			 Blocks	(512)  :  90582, SLim=212000, HLim= 256000
			 Quota Status  :  user=on    group=on
			 Object	Safety :  on
			 Fragging      :  on
			 DMAPI	       :  off

			 Id	       :  2fldabd6.00059d50.3.8052
			 Clone of      :  usr
			 Revision      :  82

   2.  The following example shows the command line and	resulting display
       when the	fileset	quota option is	set:
	    # showfsets	-q test_domain

				Block (512) Limits	      File Limits
	       Fileset	BF  used soft hard grace  used soft hard grace
	       fileset1	+-  1750 1500 2000 11:32    35	300  400

   3.  The following example shows the command line and	resulting display
       when the	DMAPI option is	set on and fragging is disabled:
	    # ./showfsets dmn1 fset1

	    Id		  :  3a2be83f.0003a240.1.8001
			 Files	       :      0, SLim=0,      HLim=	 0
			 Blocks	(512)  :      0, SLim=	      HLim=	 0
			 Quota Status  :  user=off  group=off
			 Object	Safety :  off
			 Fragging      :  off
			 DMAPI	       :  on


  Commands: chfsets(8),	mkfset(8), rmfset(8)

  File Formats:	advfs(4)