fsckptadm man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

fsckptadm(1M)							 fsckptadm(1M)

NAME
       fsckptadm - VxFS Storage Checkpoint administration utility

AVAILABILITY
       VRTSvxfs

SYNOPSIS
       /opt/VRTS/bin/fsckptadm	  [-aCeh]    blockinfo	  pathname   ckpt_name
       mount_point

       /opt/VRTS/bin/fsckptadm [-v] clear  {  nomount  |  remove  }  ckpt_name
       mount_point

       /opt/VRTS/bin/fsckptadm	[-nruv]	 create	  ckpt_name [-S signature] [-D
       data_policy] [-M metadata_policy] mount_point

       /opt/VRTS/bin/fsckptadm [-nruv] createall  ckpt_name [-S signature] [-D
       data_policy] [-M metadata_policy] mount_point...

       /opt/VRTS/bin/fsckptadm	getquotalimit  mount_point

       /opt/VRTS/bin/fsckptadm [-cv] info  ckpt_name mount_point

       /opt/VRTS/bin/fsckptadm [-clv] list  mount_point...

       /opt/VRTS/bin/fsckptadm [-cv] pathinfo  pathname

       /opt/VRTS/bin/fsckptadm [-v] { quotaon | quotaoff } mount_point

       /opt/VRTS/bin/fsckptadm [-sv] remove  ckpt_name mount_point

       /opt/VRTS/bin/fsckptadm	 [-v]	rename	  old_ckpt_name	 new_ckpt_name
       mount_point

       /opt/VRTS/bin/fsckptadm [-sv]  set  {  nodata  |	 nomount  |  remove  }
       ckpt_name mount_point

       /opt/VRTS/bin/fsckptadm	[-fm]  setquotalimit   mount_point  hard_limit
       soft_limit

DESCRIPTION
       The fsckptadm utility performs administrative tasks, such as  creation,
       deletion,  and conversion, on a Storage Checkpoint of a specified Veri‐
       tas File System.	 ckpt_name specifies the name of a Storage Checkpoint.
       The  maximum  length  of	 a  Storage Checkpoint name is 127 characters.
       Storage Checkpoint names cannot contain a colon (:).  mount_point spec‐
       ifies  the  directory on which the file system or Storage Checkpoint is
       mounted.

       fsckptadm also sets and displays quota limits on	 Storage  Checkpoints.
       You must be a privileged user to set Storage Checkpoint quotas and turn
       quotas on and off.

Cluster File System Issues
       If any file system specified with the createall keyword	is  a  cluster
       file system, then all of the specified file systems must be disk layout
       Version 6 or later.

NOTES
       When you have fileset (checkpoint) quotas enabled on a  filesystem  and
       you  reorganize	the  filesystem	 with  fsadm_vxfs(1M),	it changes the
       filesystem and affects the ckeckpoint quota usage  on  the  filesystem.
       For example:

	# fsckptadm getquotalimit $DIR1
	    Filesystem	hardlimit  softlimit  usage    action_flag
	    /mnt1	 200000	     100000	 103952	 #  fsadm  -ed $DIR1 #
       fsckptadm getquotalimit $DIR1
	   Filesystem	hardlimit   softlimit  usage   action_flag
	   /mnt1	200000	    100000     118106

KEYWORDS
       blockinfo Displays information about the file pathname under the	 Stor‐
		 age  Checkpoint  ckpt_name  at	 the  specified	 mount	point.
		 Information includes the offset  and  size  of	 each  changed
		 block,	 extented  block,  or  data hole in the file.  Used in
		 conjunction with the -a, -C, -e, or -h options.  -a  displays
		 all the information.  Default is -a.

       clear	 Clears the attributes of a Storage Checkpoint.

       create	 Creates a Storage Checkpoint on a single file system.

       createall Creates a Storage Checkpoint on multiple file systems.

       getquotalimit
		 Displays  current  quota limits, current usage, and any flags
		 set with setquotalimit keyword.

       info	 Displays information about a Storage Checkpoint, such as  its
		 creation time, flags (nodata, nomount, or remove), signature,
		 and other attributes.

       list	 Lists all the Storage Checkpoints of a file system.

       pathinfo	 Displays the name of the Storage  Checkpoint  containing  the
		 file  at  pathname.  Displays "UNNAMED" if the Storage Check‐
		 point has no name.  Also displays the signature specified  by
		 the -S option.

       quotaoff	 Turns off Storage Checkpoint quotas.

       quotaon	 Turns on Storage Checkpoint quotas.

       remove	 Removes a Storage Checkpoint from a file system.

       rename	 Renames  a  Storage  Checkpoint  of  a	 file system.  You can
		 rename both the primary fileset and its Storage Checkpoints.

       set	 Sets the attributes of a Storage Checkpoint.

       setquotalimit
		 Sets the hard limit and soft  limit  for  Storage  Checkpoint
		 quotas.   Limits  are set in terms of file system blocks.  If
		 the specified value is zero, the maximum number of file  sys‐
		 tem blocks is the limit.

OPTIONS
       -a blockinfo
		 Displays  offset  and	size  of  each changed block, extented
		 block, or data hole in a file under the Storage Checkpoint at
		 the specified mount point.

       -c	 Resets	 statistic  counters  such as number of reads, writes,
		 and pushes.  Used with the info, list, and pathinfo keywords.

       -C blockinfo
		 Displays offset and size of each changed block	 in  the  file
		 under the Storage Checkpoint at the specified mount point.

       -D data_policy
		 Specifies  an	allocation  policy to be used for file data in
		 the newly created Storage Checkpoint.	Used with  the	create
		 and  createall keywords.  See the fsapadm(1M) manual page for
		 information on allocation policies.

       -e blockinfo
		 Displays offset and size of each changed extent  of  a	 grown
		 file  under  the  Storage  Checkpoint	at the specified mount
		 point.

       -f setquotalimit
		 If a hard limit is exceeded, all further allocations  on  any
		 of  the Storage Checkpoints fail, but existing Storage Check‐
		 points are preserved.	Without the -f	option,	 one  or  many
		 removable  Storage  Checkpoints are deleted to make space for
		 the operation to succeed.

       -h blockinfo
		 Displays offset and size of the data holes in the file	 under
		 the Storage Checkpoint at the specified mount point.

       -l	 Displays statistical information on the file system's primary
		 fileset as well as its Storage Checkpoints.  Used  only  with
		 the list keyword.

       -m setquotalimit
		 If  a	soft limit is exceeded, no new Storage Checkpoints can
		 be created.  Usage must return below the  soft	 limit	before
		 more Storage Checkpoints can be created.

       -M metadata_policy
		 Specifies an allocation policy to be used for metadata in the
		 newly created Storage Checkpoint.  Used with the  create  and
		 createall  keywords.	See  the  fsapadm(1M)  manual page for
		 information on allocation policies.

       -n	 Sets the nodata attribute, creating a Storage Checkpoint that
		 contains  no  file  data.  Used with the create and createall
		 keywords.

       -r	 Sets the remove attribute on a Storage Checkpoint at creation
		 time.	 This  allows  the system to remove the Storage Check‐
		 point under certain ENOSPC conditions.	 Used with the	create
		 and createall keywords.

       -s	 Performs  the	operation  synchronously, that is, the command
		 does not return until the operation completes.	 Used with the
		 remove and set keywords.

       -S signature
		 An  identifying signature of 128 or less alphanumeric charac‐
		 ters stored in the newly created  Storage  Checkpoint.	  Used
		 with  the  create  and	 createall keywords.  The signature is
		 displayed by the info and pathinfo keywords.

       -u	 Sets the nomount attribute of a Storage Checkpoint when it is
		 created  so  that it cannot be mounted.  Used with the create
		 and createall keywords.

       -v	 Verbose mode.	Displays extensive statistical information.

ARGUMENTS
       nodata	 A nodata Storage Checkpoint is	 one  that  does  not  contain
		 actual file data.  Instead, it contains a collection of mark‐
		 ers of all the changed blocks maintained for  each  file.   A
		 nodata	 Storage  Checkpoint  can only be created if its down‐
		 stream Storage Checkpoint (that is, the  next	older  Storage
		 Checkpoint) is also a nodata Storage Checkpoint.

       nomount	 Specifies  a  Storage	Checkpoint that cannot be mounted.  If
		 the Storage Checkpoint is already mounted, the	 attribute  is
		 still	set,  and the next attempt to mount the Storage Check‐
		 point will fail.

       remove	 Specifies a removable Storage Checkpoint.  Under some	condi‐
		 tions,	 when  the  file  system  runs out of space, removable
		 Storage Checkpoints are deleted.  This ensures that  applica‐
		 tions	can continue running without interruptions due to lack
		 of disk space.	 Non-removable	Storage	 Checkpoints  are  not
		 automatically removed under certain ENOSPC conditions.	 It is
		 a good policy to create only removable	 Storage  Checkpoints.
		 See  the  Veritas  File System Administrator's Guide for more
		 information.

EXAMPLES
       The following command creates a nodata Storage  Checkpoint  named  fri‐
       day_7pm, of the file system t0:

	      # fsckptadm -n create friday_7pm /mnt0

       To list the Storage Checkpoint of the file system t0, enter:

	      # fsckptadm list /mnt0
	      /mnt0
	      friday_7pm:
		      ctime	 =  Fri Jun  1 19:02:27 2001
		      mtime	 =  Fri Jun  1 19:02:27 2001
		      flags	 =  nodata

       The  following  command removes the Storage Checkpoint named monday_7pm
       asynchronously.

	      # fsckptadm remove monday_7pm /mnt0
	      fsckptadm list /mnt0
	      /mnt0

       The following command deletes the Storage Checkpoint named  tuesday_7pm
       synchronously.

	      # fsckptadm -s remove tuesday_7pm /mnt0
	      fsckptadm list /mnt0
	      /mnt0

       The  following  command	creates	 a Storage Checkpoint on multiple file
       systems.

	      # fsckptadm -r createall tuesday_7pm /mnt0 /mnt1 /mnt2

       The following example shows the use of the pathinfo keyword.

	      # fsckptadm pathinfo /test1
	      UNNAMED

	      # fsckptadm pathinfo /test1/file
	      UNNAMED

	      # fsckptadm create checkpoint1 /test1
	      # mount -F vxfs -o ckpt=checkpoint1 /dev/vx/dsk/test1:checkpoint1 /test2
	      # fsckptadm pathinfo /test2
	      checkpoint1

	      # fsckptadm pathinfo /test2/file
	      checkpoint1

	      # fsckptadm -v pathinfo /test2/file
	      /test2/file
	      checkpoint1:
		      ctime		   =  Tue Jun 12 16:11:48 2001
		      mtime		   =  Tue Jun 12 16:11:48 2001
		      flags		   =  mounted
		      .
		      .
		      .

	      # fsckptadm -v info checkpoint1 /test1
	      checkpoint1:
		      ctime		   =  Tue Jun 12 16:11:48 2001
		      mtime		   =  Tue Jun 12 16:11:48 2001
		      flags		   =  mounted
		      .
		      .
		      .
       Following examples show	various	 blockinfo  operations	for  the  file
       file1:

	      # fsckptadm -C blockinfo /mnt2/d1/d2/file1 cl1 /mnt2
	      /mnt2/d1/d2/file1:  <offset, len, flag>
				  <0k, 8k, CHANGED>
				  <8k, 8k, CHANGED>
				  <200k, 8k, CHANGED>

	      # fsckptadm -e blockinfo /mnt2/d1/d2/file1 cl1 /mnt2
	      /mnt2/d1/d2/file1:  <offset, len, flag>
				  <4096k, 1024k, EXTENDED>
				  <5120k, 1k, EXTENDED>

	      # fsckptadm -h blockinfo /mnt2/d1/d2/file1 cl1 /mnt2
	      /mnt2/d1/d2/file1:  <offset, len, flag>
				  <4096k, 1024k, HOLE>

	      /mnt2/d1/d2/file1:  <offset, len, flag>
				  <0k, 8k, CHANGED>
				  <8k, 8k, CHANGED>
				  <16k, 48k, >
				  <64k, 136k, >
				  <200k, 8k, CHANGED>
				  <208k, 3888k, >
				  <4096k, 1024k, HOLE | EXTENDED>
				  <5120k, 1k, EXTENDED>

       The following example sets a Storage Checkpoint quota with a 1024 block
       hard limit and 512 block soft limit:

	      # fsckptadm setquotalimit /mnt1 1024 512

       The following example obtains current Storage Checkpoint usage and lim‐
       its:

	      # fsckptadm getquotalimit /mnt1
	      Filesystem  hard limit  soft limit  usage	 action_flag
	      /mnt	   1024		512	   29

       The following example turns Storage Checkpoint quotas on:

	      # fsckptadm quotaon /mnt1

       The following example turns Storage Checkpoint quotas off:

	      # fsckptadm quotaoff /mnt1

SEE ALSO
       fsadm_vxfs(1M), fsapadm(1M), fsckpt_restore(1M), mount_vxfs(1M)

       Veritas File System Administrator's Guide

VxFS 5.0			  7 Jan 2008			 fsckptadm(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net