Date: Fri, 16 Sep 2016 04:28:31 +0000 (UTC) From: Allan Jude <allanjude@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r305861 - in head/sbin: geom/class/multipath ggate/ggatec ggate/ggated ggate/ggatel hastctl hastd iscontrol mdmfs mount_nfs nandfs nvmecontrol Message-ID: <201609160428.u8G4SV2F031448@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
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@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@FreeBSD.org .An Alexander Motin Aq Mt mav@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201609160428.u8G4SV2F031448>