README.rst | 3 ++
src/sanlock.8 | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 62 insertions(+)
New commits:
commit 467a97b475203e2f25423b49c6c357e73df61af8
Author: David Teigland <teigland(a)redhat.com>
Date: Tue Feb 28 15:50:52 2017 -0600
source moved to
https://pagure.io/sanlock
diff --git a/README.rst b/README.rst
index 982d36d..c197d46 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,3 @@
+| ``See
https://pagure.io/sanlock
| ``See sanlock(8) at sanlock.git/src/sanlock.8``
| ``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 8a564c25c691ec01de760abb1d802a8e2f13019d
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 12:58:25 2017 -0600
sanlock: add man page info about renewal history
diff --git a/src/sanlock.8 b/src/sanlock.8
index c62edaa..25b6b49 100644
--- a/src/sanlock.8
+++ b/src/sanlock.8
@@ -563,6 +563,7 @@ added or removed. Add -h 1 to also show hosts in each lockspace.
.BR "sanlock client renewal -s" " LOCKSPACE"
Print a history of renewals with timing details.
+See the Renewal history section below.
.B sanlock client log_dump
@@ -875,6 +876,64 @@ using the ORPHAN flag (-O 1), or release the orphan lease using the
ORPHAN
flag (-O 1). All orphan leases can be released by setting the lockspace
name (-s lockspace_name) with no resource name.
+.P
+
+.SS Renewal history
+
+sanlock saves a limited history of lease renewal information in each lockspace.
+See sanlock.conf renewal_history_size to set the amount of history or to
+disable (set to 0).
+
+IO times are measured in delta lease renewal (each delta lease renewal
+includes one read and one write).
+
+For each successful renewal, a record is saved that includes:
+.IP \[bu] 2
+the timestamp written in the delta lease by the renewal
+.IP \[bu] 2
+the time in milliseconds taken by the delta lease read
+.IP \[bu] 2
+the time in milliseconds taken by the delta lease write
+
+.P
+
+Also counted and recorded are the number io timeouts and
+other io errors that occur between successful renewals.
+
+Two consecutive successful renewals would be recorded as:
+.br
+.nf
+timestamp=5332 read_ms=482 write_ms=5525 next_timeouts=0 next_errors=0
+timestamp=5353 read_ms=99 write_ms=3161 next_timeouts=0 next_errors=0
+.fi
+
+Those fields are:
+
+.IP \[bu] 2
+timestamp is the value written into the delta lease during
+that renewal.
+
+.IP \[bu] 2
+read_ms/write_ms are the milliseconds taken for the renewal
+read/write ios.
+
+.IP \[bu] 2
+next_timeouts are the number of io timeouts that occured
+after the renewal recorded on that line, and before the next
+successful renewal on the following line.
+
+.IP \[bu] 2
+next_errors are the number of io errors (not timeouts) that
+occured after renewal recorded on that line, and before the
+next successful renewal on the following line.
+
+.P
+
+The command 'sanlock client renewal -s lockspace_name' reports
+the full history of renewals saved by sanlock, which by default
+is 180 records, about 1 hour of history when using a 20 second
+renewal interval for a 10 second io timeout.
+
.SH INTERNALS
.SS Disk Format
commit 9d2828a4e14baeb5cfee343ee2486982b538830d
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:31:51 2017 -0600
update test readme
diff --git a/README.rst b/README.rst
index 5e0b89b..982d36d 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,2 @@
-``See sanlock(8) at sanlock.git/src/sanlock.8``
-``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
+| ``See sanlock(8) at sanlock.git/src/sanlock.8``
+| ``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 05b15e19f215b1b34207cc7e5eb2fc2a36898ef3
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:29:54 2017 -0600
update test readme
diff --git a/README.rst b/README.rst
index 557c416..5e0b89b 100644
--- a/README.rst
+++ b/README.rst
@@ -1,4 +1,2 @@
-``
-See sanlock(8) at sanlock.git/src/sanlock.8
-See wdmd(8) at sanlock.git/wdmd/wdmd.8
-``
+``See sanlock(8) at sanlock.git/src/sanlock.8``
+``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 714d6854a46f1276b87389a2048e8e2ad9c76197
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:28:10 2017 -0600
add test readme
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..557c416
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,4 @@
+``
+See sanlock(8) at sanlock.git/src/sanlock.8
+See wdmd(8) at sanlock.git/wdmd/wdmd.8
+``