aboutsummaryrefslogtreecommitdiff
path: root/usr.sbin
diff options
context:
space:
mode:
authorGordon Bergling <gbe@FreeBSD.org>2020-10-22 19:25:01 +0000
committerGordon Bergling <gbe@FreeBSD.org>2020-10-22 19:25:01 +0000
commitad5e10ec0cecfd33c75be5690cff7bc47514467e (patch)
tree53d0c2fd51ca45347aeeb5a19bf40f2f2867bd5e /usr.sbin
parent54f09403a3cecef65e7b28dce37ad1885c4b26ab (diff)
downloadsrc-ad5e10ec0cecfd33c75be5690cff7bc47514467e.tar.gz
src-ad5e10ec0cecfd33c75be5690cff7bc47514467e.zip
stablerestart(5): Fix some issues reported by mandoc
- New sentence, new line
Notes
Notes: svn path=/head/; revision=366949
Diffstat (limited to 'usr.sbin')
-rw-r--r--usr.sbin/nfsd/stablerestart.529
1 files changed, 14 insertions, 15 deletions
diff --git a/usr.sbin/nfsd/stablerestart.5 b/usr.sbin/nfsd/stablerestart.5
index 7096053f7784..0f921a07ca49 100644
--- a/usr.sbin/nfsd/stablerestart.5
+++ b/usr.sbin/nfsd/stablerestart.5
@@ -52,18 +52,18 @@ first record.
The lease duration is used to set the grace period.
The boot times
are used to avoid the unlikely occurrence of a boot time being reused,
-due to a TOD clock going backwards. This record and the previous boot times with this boot time added is re-written at the
-end of the grace period.
+due to a TOD clock going backwards.
+This record and the previous boot times with this boot time
+added is re-written at the end of the grace period.
.Pp
The rest of the file are appended records, as defined by
-struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used
-represent one of two things. There are records which indicate that a
+struct nfst_rec in /usr/include/fs/nfs/nfsrvstate.h and are used represent one of two things.
+There are records which indicate that a
client successfully acquired state and records that indicate a client's state was revoked.
State revoke records indicate that state information
for a client was discarded, due to lease expiry and an otherwise
conflicting open or lock request being made by a different client.
-These records can be used
-to determine if clients might have done either of the
+These records can be used to determine if clients might have done either of the
edge conditions.
.Pp
If a client might have done either edge condition or this file is
@@ -71,8 +71,8 @@ empty or corrupted, the server returns NFSERR_NOGRACE for any reclaim
request from the client.
.Pp
For correct operation of the server, it must be ensured that the file
-is written to stable storage by the time a write op with IO_SYNC specified
-has returned. This might require hardware level caching to be disabled for
+is written to stable storage by the time a write op with IO_SYNC specified has returned.
+This might require hardware level caching to be disabled for
a local disk drive that holds the file, or similar.
.Sh FILES
.Bl -tag -width /var/db/nfs-stablerestart.bak -compact
@@ -86,12 +86,11 @@ backup copy of the file
.Xr nfsd 8
.Sh BUGS
If the file is empty, the NFSv4 server has no choice but to return
-NFSERR_NOGRACE for all reclaim requests. Although correct, this is
-a highly undesirable occurrence, so the file should not be lost if
-at all possible. The backup copy of the file is maintained
-and used by the
+NFSERR_NOGRACE for all reclaim requests.
+Although correct, this is a highly undesirable occurrence, so the file should not be lost if
+at all possible.
+The backup copy of the file is maintained and used by the
.Xr nfsd 8
to minimize the risk of this occurring.
-To move the file, you must edit
-the nfsd sources and recompile it. This was done to discourage
-accidental relocation of the file.
+To move the file, you must edit the nfsd sources and recompile it.
+This was done to discourage accidental relocation of the file.