svn commit: r305861 - in head/sbin: geom/class/multipath ggate/ggatec ggate/ggated ggate/ggatel hastctl hastd iscontrol mdmfs mount_nfs nandfs nvmecontrol

Fri Sep 16 04:28:34 UTC 2016

Author: allanjude
Date: Fri Sep 16 04:28:31 2016
New Revision: 305861
URL: https://svnweb.freebsd.org/changeset/base/305861

Log:
  Add missing history sections to a number of storage related man pages
  
  gmultipath.8: Add HISTORY
  	Adjust sentences with bad phrases picked up by igor
  
  ggatec.8: Add HISTORY
  
  ggated.8: Add HISTORY
  
  ggatel.8: Add HISTORY
  	Seperate out sentence as advised by igor.
  
  hastctl.8: Add HISTORY
  
  hastd.8: Add HISTORY
  	Fix sentence highlighted by igor.
  
  iscontrol.8: Add HISTORY
  
  mdmfs.8: Add HISTORY
  	Address issues raised by igor
  
  mount_nfs.8: Add HISTORY
  	Not sure where mount_nfs first showed up, but the verison used
  	in the BSD's originates from 4.4BSD according to CSRG archive.
  
  	Though commercial offerings from Sun and others covers older
  	systems, eg https://groups.google.com/forum/#!topic/net.unix-wizards/lMe7aQikqJI
  
  nandfs.8: Add HISTORY
  	Adjust sentence in description to address bad phrase highlighted
  	by igor.
  
  nvmecontrol.8: Add HISTORY
  
  PR:		212491
  PR:		212498
  PR:		212499
  PR:		212500
  PR:		212501
  PR:		212502
  PR:		212505
  PR:		212508
  PR:		212540
  PR:		212543
  PR:		212546
  Submitted by:	Sevan Janiyan <venture37 at geeklan.co.uk>

Modified:
  head/sbin/geom/class/multipath/gmultipath.8
  head/sbin/ggate/ggatec/ggatec.8
  head/sbin/ggate/ggated/ggated.8
  head/sbin/ggate/ggatel/ggatel.8
  head/sbin/hastctl/hastctl.8
  head/sbin/hastd/hastd.8
  head/sbin/iscontrol/iscontrol.8
  head/sbin/mdmfs/mdmfs.8
  head/sbin/mount_nfs/mount_nfs.8
  head/sbin/nandfs/nandfs.8
  head/sbin/nvmecontrol/nvmecontrol.8

Modified: head/sbin/geom/class/multipath/gmultipath.8
==============================================================================

--- head/sbin/geom/class/multipath/gmultipath.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/geom/class/multipath/gmultipath.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 18, 2015
+.Dd September 8, 2016
 .Dt GMULTIPATH 8
 .Os
 .Sh NAME
@@ -255,12 +255,11 @@ When this occurs, that path is marked FA
 in a list is selected as active and the failed I/O reissued.
 In Active/Active mode all paths not marked FAIL may handle I/O at the same time.
 Requests are distributed between paths to equalize load.
-For capable devices it allows to utilize the bandwidth of all paths.
+For capable devices it allows the utilisation of the bandwidth available on all paths.
 In Active/Read mode all paths not marked FAIL may handle reads at the same time,
 but unlike in Active/Active mode only one path handles write requests at any
-point in time.
-It allows to closer follow the original write request order if the layer above
-needs it for data consistency (not waiting for requisite write completion
+point in time; closely following the original write request order if the layer
+above needs it for data consistency (not waiting for requisite write completion
 before sending dependent write).
 .Pp
 When new devices are added to the system the
@@ -368,6 +367,11 @@ geom_multipath_load="YES"
 .Xr mount 8 ,
 .Xr newfs 8 ,
 .Xr sysctl 8
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Fx 7.0
 .Sh AUTHORS
 .An Matthew Jacob Aq Mt mjacob at FreeBSD.org
 .An Alexander Motin Aq Mt mav at FreeBSD.org

Modified: head/sbin/ggate/ggatec/ggatec.8
==============================================================================
--- head/sbin/ggate/ggatec/ggatec.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/ggate/ggatec/ggatec.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 25, 2016
+.Dd September 8, 2016
 .Dt GGATEC 8
 .Os
 .Sh NAME
@@ -173,6 +173,11 @@ client# mount_cd9660 /dev/ggate0 /cdrom
 .Xr ggated 8 ,
 .Xr ggatel 8 ,
 .Xr mount_cd9660 8
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 5.3 .
 .Sh AUTHORS
 The
 .Nm

Modified: head/sbin/ggate/ggated/ggated.8
==============================================================================
--- head/sbin/ggate/ggated/ggated.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/ggate/ggated/ggated.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 25, 2016
+.Dd September 8, 2016
 .Dt GGATED 8
 .Os
 .Sh NAME
@@ -116,6 +116,11 @@ Export CD-ROM device and a file:
 .Xr geom 4 ,
 .Xr ggatec 8 ,
 .Xr ggatel 8
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 5.3 .
 .Sh AUTHORS
 The
 .Nm

Modified: head/sbin/ggate/ggatel/ggatel.8
==============================================================================
--- head/sbin/ggate/ggatel/ggatel.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/ggate/ggatel/ggatel.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd July 14, 2015
+.Dd September 8, 2016
 .Dt GGATEL 8
 .Os
 .Sh NAME
@@ -80,7 +80,8 @@ List
 providers.
 .It Cm rescue
 Take over a previously created provider and handle pending and future
-requests. This is useful if the initial
+requests.
+This is useful if the initial
 .Nm
 process died.
 To prevent data loss, the given path must lead to the
@@ -151,6 +152,11 @@ ggatel destroy -u 5
 .Xr ggated 8 ,
 .Xr mount 8 ,
 .Xr newfs 8
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 5.3 .
 .Sh AUTHORS
 The
 .Nm

Modified: head/sbin/hastctl/hastctl.8
==============================================================================
--- head/sbin/hastctl/hastctl.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/hastctl/hastctl.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 14, 2013
+.Dd September 8, 2016
 .Dt HASTCTL 8
 .Os
 .Sh NAME
@@ -220,6 +220,11 @@ nodeB# application_start
 .Xr hastd 8 ,
 .Xr mount 8 ,
 .Xr newfs 8
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 8.1 .
 .Sh AUTHORS
 The
 .Nm

Modified: head/sbin/hastd/hastd.8
==============================================================================
--- head/sbin/hastd/hastd.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/hastd/hastd.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 1, 2010
+.Dd September 8, 2016
 .Dt HASTD 8
 .Os
 .Sh NAME
@@ -44,8 +44,8 @@ The
 daemon is responsible for managing highly available GEOM providers.
 .Pp
 .Nm
-allows to transparently store data on two physically separated machines
-connected over the TCP/IP network.
+allows the transpaent storage of data on two physically separated machines
+connected over a TCP/IP network.
 Only one machine (cluster node) can actively use storage provided by
 .Nm .
 This machine is called primary.
@@ -224,6 +224,11 @@ nodeA# mount -o noatime /dev/hast/shared
 .Xr mount 8 ,
 .Xr newfs 8 ,
 .Xr g_bio 9
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 8.1 .
 .Sh AUTHORS
 The
 .Nm

Modified: head/sbin/iscontrol/iscontrol.8
==============================================================================
--- head/sbin/iscontrol/iscontrol.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/iscontrol/iscontrol.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 9, 2014
+.Dd September 9, 2016
 .Dt ISCONTROL 8
 .Os
 .Sh NAME
@@ -125,7 +125,11 @@ whatever options are specified, and star
 .Xr iscsictl 8
 .Sh STANDARDS
 RFC 3720
-.\"Sh HISTORY
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+Fx 7.0 .
 .Sh BUGS
 .Nm
 should probably load the iscsi_initiator module if needed.

Modified: head/sbin/mdmfs/mdmfs.8
==============================================================================
--- head/sbin/mdmfs/mdmfs.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/mdmfs/mdmfs.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 9, 2016
+.Dd September 9, 2016
 .Dt MDMFS 8
 .Os
 .Sh NAME
@@ -127,7 +127,8 @@ to try to detach the unit before attachi
 .It Fl d Ar max-extent-size
 The file system may choose to store large files using extents.
 This parameter specifies the largest extent size that may be
-used.  It is presently limited to its default value which is 16
+used.
+It is presently limited to its default value which is 16
 times the file system blocksize.
 .It Fl E Ar path-mdconfig
 Use
@@ -311,8 +312,8 @@ option is passed to
 .Xr mount 8
 as
 .Fl t .
-See the programs that the options are passed to for more information
-on their semantics.
+For information on semantics, refer to the documentation of the programs
+that the options are passed to.
 .Sh EXAMPLES
 Create and mount a 32 megabyte swap-backed file system on
 .Pa /tmp :
@@ -394,5 +395,10 @@ was given on the command line.
 .Xr mdconfig 8 ,
 .Xr mount 8 ,
 .Xr newfs 8
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 5.0 .
 .Sh AUTHORS
 .An Dima Dorfman

Modified: head/sbin/mount_nfs/mount_nfs.8
==============================================================================
--- head/sbin/mount_nfs/mount_nfs.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/mount_nfs/mount_nfs.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -28,7 +28,7 @@
 .\"	@(#)mount_nfs.8	8.3 (Berkeley) 3/29/95
 .\" $FreeBSD$
 .\"
-.Dd October 30, 2014
+.Dd September 10, 2016
 .Dt MOUNT_NFS 8
 .Os
 .Sh NAME
@@ -183,8 +183,8 @@ for positive name cache entries.
 If this is set to 0 it disables positive name caching for the mount point.
 .It Cm negnametimeo Ns = Ns Aq Ar value
 Override the default of NFS_DEFAULT_NEGNAMETIMEO for the timeout (in seconds)
-for negative name cache entries. If this is set to 0 it disables negative
-name caching for the mount point.
+for negative name cache entries.
+If this is set to 0 it disables negative name caching for the mount point.
 .It Cm nfsv2
 Use the NFS Version 2 protocol (the default is to try version 3 first
 then version 2).
@@ -262,7 +262,7 @@ such that the dirty byte range becomes a
 that are dirty.
 This reduces the number of writes significantly for software
 builds.
-The merging of byte ranges isn't done if the file has been file
+The merging of byte ranges is not done if the file has been file
 locked, since most applications modifying a file from multiple
 clients will use file locking.
 As such, this option could result in a corrupted file for the
@@ -271,8 +271,9 @@ clients concurrently without using file 
 .It Cm principal
 For the RPCSEC_GSS security flavors, such as krb5, krb5i and krb5p,
 this option sets the name of the host based principal name expected
-by the server. This option overrides the default, which will be
-``nfs@<server-fqdn>'' and should normally be sufficient.
+by the server.
+This option overrides the default, which will be ``nfs@<server-fqdn>''
+and should normally be sufficient.
 .It Cm noresvport
 Do
 .Em not
@@ -515,6 +516,11 @@ Same as
 .Xr nfsd 8 ,
 .Xr nfsiod 8 ,
 .Xr showmount 8
+.Sh HISTORY
+A version of the
+.Nm
+utility appeared in
+.Bx 4.4 .
 .Sh BUGS
 Since nfsv4 performs open/lock operations that have their ordering strictly
 enforced by the server, the options

Modified: head/sbin/nandfs/nandfs.8
==============================================================================
--- head/sbin/nandfs/nandfs.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/nandfs/nandfs.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd February 28, 2012
+.Dd September 10, 2016
 .Dt NANDFS 8
 .Os
 .Sh NAME
@@ -48,7 +48,7 @@
 .Sh DESCRIPTION
 The
 .Nm
-utility allows to manage snapshots of a mounted NAND FS.
+utility allows the management of snapshots on a mounted NAND FS.
 .Sh EXAMPLES
 Create a snapshot of filesystem mounted on
 .Em /nand .
@@ -69,6 +69,11 @@ Remove snapshot 1 of filesystem mounted 
 .Bd -literal -offset 2n
 .Li # Ic nandfs rmsnap 1 /nand
 .Ed
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 10.0 .
 .Sh AUTHORS
 This utility and manual page were written by
 .An Mateusz Guzik .

Modified: head/sbin/nvmecontrol/nvmecontrol.8
==============================================================================
--- head/sbin/nvmecontrol/nvmecontrol.8	Fri Sep 16 04:22:21 2016	(r305860)
+++ head/sbin/nvmecontrol/nvmecontrol.8	Fri Sep 16 04:28:31 2016	(r305861)
@@ -33,7 +33,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd March 26, 2013
+.Dd September 10, 2016
 .Dt NVMECONTROL 8
 .Os
 .Sh NAME
@@ -94,9 +94,9 @@ Display an hexadecimal dump of the nvme0
 .Pp
 .Dl nvmecontrol perftest -n 32 -o read -s 512 -t 30 nvme0ns1
 .Pp
-Run a performance test on nvme0ns1 using 32 kernel threads for 30 seconds.  Each
-thread will issue a single 512 byte read command.  Results are printed to
-stdout when 30 seconds expires.
+Run a performance test on nvme0ns1 using 32 kernel threads for 30 seconds.
+Each thread will issue a single 512 byte read command.
+Results are printed to stdout when 30 seconds expires.
 .Pp
 .Dl nvmecontrol reset nvme0
 .Pp
@@ -137,6 +137,11 @@ Set the current power mode.
 .Dl nvmecontrol power nvme0
 .Pp
 Get the current power mode.
+.Sh HISTORY
+The
+.Nm
+utility appeared in
+.Fx 9.2 .
 .Sh AUTHORS
 .An -nosplit
 .Nm
