From fdcd03918cfd901f61756d14ada4dd09532a22cc Mon Sep 17 00:00:00 2001 From: brueffer Date: Tue, 14 Jul 2015 14:01:33 +0000 Subject: [PATCH] Cleanup; mostly language with a little bit of mdoc style. MFC after: 1 week --- ggatec/ggatec.8 | 10 +++++----- ggated/ggated.8 | 12 ++++++------ ggatel/ggatel.8 | 13 +++++++------ 3 files changed, 18 insertions(+), 17 deletions(-) diff --git a/ggatec/ggatec.8 b/ggatec/ggatec.8 index 8545baf..705d42f 100644 --- a/ggatec/ggatec.8 +++ b/ggatec/ggatec.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 2, 2015 +.Dd July 14, 2015 .Dt GGATEC 8 .Os .Sh NAME @@ -71,8 +71,8 @@ utility is a network client for the GEOM Gate class. It is responsible for the creation of .Nm ggate devices and forwarding I/O requests between the -.Nm geom_gate.ko -kernel module and the +.Nm GEOM Gate +kernel subsystem and the .Xr ggated 8 network daemon. Available commands: @@ -111,7 +111,7 @@ Do not use .Dv TCP_NODELAY option on TCP sockets. .It Fl o Cm ro | wo | rw -Specify permission to use when opening the file or device: read-only +Specify permissions to use when opening the file or device: read-only .Pq Cm ro , write-only .Pq Cm wo , @@ -136,7 +136,7 @@ Default is 131072 (128kB). Sector size for .Nm ggate provider. -If not specified, it is taken from device, or set to 512 bytes for files. +If not specified, it is taken from the device, or set to 512 bytes for files. .It Fl t Ar timeout Number of seconds to wait before an I/O request will be canceled. Default is 0, which means no timeout. diff --git a/ggated/ggated.8 b/ggated/ggated.8 index 3560fe0..dd6109a 100644 --- a/ggated/ggated.8 +++ b/ggated/ggated.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 29, 2004 +.Dd July 14, 2015 .Dt GGATED 8 .Os .Sh NAME @@ -43,14 +43,14 @@ .Sh DESCRIPTION The .Nm -utility is a network server for GEOM Gate class. +utility is a network server for the GEOM Gate class. It runs on a server machine to service GEOM Gate requests from workers placed on a client machine. -Keep in mind, that connection between +Keep in mind, that connections between .Xr ggatec 8 and .Nm -is not encrypted. +are not encrypted. .Pp Available options: .Bl -tag -width ".Ar exports\ file" @@ -65,7 +65,7 @@ option on TCP sockets. .It Fl p Ar port Port on which .Nm -listens for connection. +listens for connections. Default is 3080. .It Fl R Ar rcvbuf Size of receive buffer to use. @@ -74,7 +74,7 @@ Default is 131072 (128kB). Size of send buffer to use. Default is 131072 (128kB). .It Fl v -Do not fork, run in foreground and print debug informations on standard +Do not fork, run in foreground and print debug information on standard output. .It Ar "exports file" An alternate location for the exports file. diff --git a/ggatel/ggatel.8 b/ggatel/ggatel.8 index 37e11cd..f2eea7c 100644 --- a/ggatel/ggatel.8 +++ b/ggatel/ggatel.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 9, 2015 +.Dd July 14, 2015 .Dt GGATEL 8 .Os .Sh NAME @@ -62,7 +62,7 @@ It can be used as a replacement for devices or as a .Dq GEOMificator for non GEOM-aware devices, but it was mainly created as an example -on how to use and how to communicate with the GEOM Gate kernel module. +on how to use and how to communicate with the GEOM Gate kernel subsystem. .Pp Available commands: .Bl -tag -width ".Cm destroy" @@ -82,7 +82,8 @@ providers. Take over a previously created provider and handle pending and future requests. This is useful if the initial .Nm -process died. To prevent data loss, the given path must lead to the +process died. +To prevent data loss, the given path must lead to the regular file or device that was used to create the provider. .El .Pp @@ -93,7 +94,7 @@ Forcibly destroy .Nm ggate provider (cancels all pending requests). .It Fl o Cm ro | wo | rw -Specify permission to use when opening the file or device: read-only +Specify permissions to use when opening the file or device: read-only .Pq Cm ro , write-only .Pq Cm wo , @@ -105,7 +106,7 @@ Default is Sector size for .Nm ggate provider. -If not specified, it is taken from device, or set to 512 bytes for files. +If not specified, it is taken from the device, or set to 512 bytes for files. .It Fl t Ar timeout Number of seconds to wait before an I/O request will be canceled. 0 means no timeout. @@ -131,7 +132,7 @@ the .Dq Li fd0 device and use .Xr gbde 8 -to encrypt data on a floppy. +to encrypt data on a floppy disk. .Bd -literal -offset indent ggatel create -u 5 /dev/fd0 gbde init /dev/ggate5