1
From: Christian Kastner <debian@kvr.at>
2
Date: Sun, 18 May 2014 16:44:32 +0200
3
Subject: man page syntax fixes
6
Last-Update: 2014-05-18
9
man/find_key_by_type_and_name.3 | 2 +-
10
man/key.dns_resolver.8 | 2 +-
11
man/keyctl.1 | 40 ++++++++++++++++++++--------------------
12
man/persistent-keyring.7 | 4 ++--
13
man/process-keyring.7 | 4 ++--
14
man/recursive_key_scan.3 | 2 +-
15
man/session-keyring.7 | 4 ++--
16
man/thread-keyring.7 | 4 ++--
17
man/user-keyring.7 | 4 ++--
18
man/user-session-keyring.7 | 4 ++--
19
10 files changed, 35 insertions(+), 35 deletions(-)
21
diff --git a/man/find_key_by_type_and_name.3 b/man/find_key_by_type_and_name.3
22
index c1db344..fc59a68 100644
23
--- a/man/find_key_by_type_and_name.3
24
+++ b/man/find_key_by_type_and_name.3
25
@@ -33,7 +33,7 @@ If a key is found, and
26
is not 0 and specifies a keyring, then the found key will be linked into it.
27
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
29
-The function returns the ID of the key if a key was found or -1 otherwise.
30
+The function returns the ID of the key if a key was found or \-1 otherwise.
31
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
34
diff --git a/man/key.dns_resolver.8 b/man/key.dns_resolver.8
35
index 8347a0d..78523be 100644
36
--- a/man/key.dns_resolver.8
37
+++ b/man/key.dns_resolver.8
38
@@ -13,7 +13,7 @@ key.dns_resolver - Upcall for request-key to handle dns_resolver keys
40
\fB/sbin/key.dns_resolver \fR<key>
42
-\fB/sbin/key.dns_resolver \fR-D [-v] [-v] <keydesc> <calloutinfo>
43
+\fB/sbin/key.dns_resolver \fR-D [\-v] [\-v] <keydesc> <calloutinfo>
45
This program is invoked by request-key on behalf of the kernel when kernel
46
services (such as NFS, CIFS and AFS) want to perform a hostname lookup and the
47
diff --git a/man/keyctl.1 b/man/keyctl.1
48
index 4d6cbe5..56b29ce 100644
53
keyctl - Key management facility control
55
-\fBkeyctl\fR --version
56
+\fBkeyctl\fR \-\-version
58
-\fBkeyctl\fR show [-x] [<keyring>]
59
+\fBkeyctl\fR show [\-x] [<keyring>]
61
\fBkeyctl\fR add <type> <desc> <data> <keyring>
63
@@ -81,13 +81,13 @@ keyctl - Key management facility control
65
\fBkeyctl\fR security <key>
67
-\fBkeyctl\fR reap [-v]
68
+\fBkeyctl\fR reap [\-v]
70
\fBkeyctl\fR purge <type>
72
-\fBkeyctl\fR purge [-i] [-p] <type> <desc>
73
+\fBkeyctl\fR purge [\-i] [\-p] <type> <desc>
75
-\fBkeyctl\fR purge -s <type> <desc>
76
+\fBkeyctl\fR purge \-s <type> <desc>
78
\fBkeyctl\fR get_persistent <keyring> [<uid>]
80
@@ -156,19 +156,19 @@ be added in future that then cause ambiguity.
82
(*) \fBDisplay the package version number\fR
84
-\fBkeyctl --version\fR
85
+\fBkeyctl \-\-version\fR
87
This command prints the package version number and build date and exits:
90
-testbox>keyctl --version
91
+testbox>keyctl \-\-version
93
keyctl from keyutils-1.5.3 (Built 2011-08-24)
96
(*) \fBShow process keyrings\fR
98
-\fBkeyctl show [-x] [<keyring>]\fR
99
+\fBkeyctl show [\-x] [<keyring>]\fR
101
By default this command recursively shows what keyrings a process is subscribed
102
to and what keys and keyrings they contain. If a keyring is specified then
103
@@ -195,7 +195,7 @@ The \fBpadd\fR variant of the command reads the data from stdin rather than
104
taking it from the command line:
107
-testbox>echo -n stuff | keyctl padd user mykey @u
108
+testbox>echo \-n stuff | keyctl padd user mykey @u
112
@@ -234,7 +234,7 @@ testbox>keyctl request2 user debug:hello wibble
116
-testbox>echo -n wibble | keyctl prequest2 user debug:hello
117
+testbox>echo \-n wibble | keyctl prequest2 user debug:hello
121
@@ -261,7 +261,7 @@ The \fBpupdate\fR variant of the command reads the data from stdin rather than
122
taking it from the command line:
125
-testbox>echo -n zebra | keyctl pupdate 23
126
+testbox>echo \-n zebra | keyctl pupdate 23
129
(*) \fBCreate a keyring\fR
130
@@ -409,7 +409,7 @@ testbox>keyctl list @us
134
- 22: vrwsl---------- 4043 -1 keyring: _uid.4043
135
+ 22: vrwsl---------- 4043 \-1 keyring: _uid.4043
137
23: vrwsl---------- 4043 4043 user: debug:hello
139
@@ -430,7 +430,7 @@ raw data returned from the kernel.
142
testbox>keyctl describe @us
143
- -5: vrwsl---------- 4043 -1 keyring: _uid_ses.4043
144
+ \-5: vrwsl---------- 4043 \-1 keyring: _uid_ses.4043
145
testbox>keyctl rdescribe @us
146
keyring;4043;-1;3f1f0000;_uid_ses.4043
148
@@ -618,7 +618,7 @@ The \fBpinstantiate\fR variant of the command reads the data from stdin rather
149
than taking it from the command line:
152
-testbox>echo -n "Debug $3" | keyctl pinstantiate $1 $4
153
+testbox>echo \-n "Debug $3" | keyctl pinstantiate $1 $4
156
(*) \fBSet the expiry time on a key\fR
157
@@ -662,7 +662,7 @@ testbox> keyctl show
161
- -3 --alswrv 0 0 keyring: foo
162
+ \-3 \-\-alswrv 0 0 keyring: foo
164
testbox> keyctl new_session
166
@@ -672,7 +672,7 @@ testbox> keyctl show
170
- -3 --alswrv 0 0 keyring: _ses
171
+ \-3 \-\-alswrv 0 0 keyring: _ses
174
Note that this affects the \fIparent\fP of the process that invokes the system
175
@@ -702,9 +702,9 @@ together with the success or failure of the unlink.
177
\fBkeyctl\fR purge <type>
179
-\fBkeyctl\fR purge [-i] [-p] <type> <desc>
180
+\fBkeyctl\fR purge [\-i] [\-p] <type> <desc>
182
-\fBkeyctl\fR purge -s <type> <desc>
183
+\fBkeyctl\fR purge \-s <type> <desc>
185
These commands perform a depth-first search to find matching keys in the
186
caller's session keyring tree and attempts to unlink them. The number of
187
@@ -717,8 +717,8 @@ removed from keyrings that grant Write permission.
188
The first variant purges all keys of the specified type.
190
The second variant purges all keys of the specified type that also match the
191
-given description literally. The -i flag allows a case-independent match and
192
-the -p flag allows a prefix match.
193
+given description literally. The \-i flag allows a case-independent match and
194
+the \-p flag allows a prefix match.
196
The third variant purges all keys of the specified type and matching
197
description using the key type's comparator in the kernel to match the
198
diff --git a/man/persistent-keyring.7 b/man/persistent-keyring.7
199
index 86dbb66..0facbeb 100644
200
--- a/man/persistent-keyring.7
201
+++ b/man/persistent-keyring.7
203
.\" as published by the Free Software Foundation; either version
204
.\" 2 of the Licence, or (at your option) any later version.
206
-.TH "PERSISTENT KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
207
+.TH "PERSISTENT-KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
208
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
210
-persistent keyring \- Per-user persistent keyring
211
+persistent-keyring \- Per-user persistent keyring
214
.B persistent keyring
215
diff --git a/man/process-keyring.7 b/man/process-keyring.7
216
index 0af7a1c..44b30d3 100644
217
--- a/man/process-keyring.7
218
+++ b/man/process-keyring.7
220
.\" as published by the Free Software Foundation; either version
221
.\" 2 of the Licence, or (at your option) any later version.
223
-.TH "PROCESS KEYRING" 7 "19 Feb 2014" Linux "Kernel key management"
224
+.TH "PROCESS-KEYRING" 7 "19 Feb 2014" Linux "Kernel key management"
225
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
227
-process keyring \- Per-process shared keyring
228
+process-keyring \- Per-process shared keyring
232
diff --git a/man/recursive_key_scan.3 b/man/recursive_key_scan.3
233
index c07be85..7d69d5d 100644
234
--- a/man/recursive_key_scan.3
235
+++ b/man/recursive_key_scan.3
236
@@ -63,7 +63,7 @@ The key to which the link points.
237
.BR desc " and " desc_len
238
A pointer to the raw description and its length as retrieved with
239
.IR keyctl_describe_alloc ().
240
-These will be NULL and -1 respectively if the description couldn't be
241
+These will be NULL and \-1 respectively if the description couldn't be
242
retrieved and errno will retain the error from
243
.IR keyctl_describe_alloc ().
245
diff --git a/man/session-keyring.7 b/man/session-keyring.7
246
index 6349ddb..59707e3 100644
247
--- a/man/session-keyring.7
248
+++ b/man/session-keyring.7
250
.\" as published by the Free Software Foundation; either version
251
.\" 2 of the Licence, or (at your option) any later version.
253
-.TH "SESSION KEYRING" 7 "19 Feb 2014" Linux "Kernel key management"
254
+.TH "SESSION-KEYRING" 7 "19 Feb 2014" Linux "Kernel key management"
255
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
257
-session keyring \- Session shared process keyring
258
+session-keyring \- Session shared process keyring
262
diff --git a/man/thread-keyring.7 b/man/thread-keyring.7
263
index 5f43788..e2b147a 100644
264
--- a/man/thread-keyring.7
265
+++ b/man/thread-keyring.7
267
.\" as published by the Free Software Foundation; either version
268
.\" 2 of the Licence, or (at your option) any later version.
270
-.TH "THREAD KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
271
+.TH "THREAD-KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
272
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
274
-thread keyring \- Per-thread keyring
275
+thread-keyring \- Per-thread keyring
279
diff --git a/man/user-keyring.7 b/man/user-keyring.7
280
index 23ea333..3c2abc3 100644
281
--- a/man/user-keyring.7
282
+++ b/man/user-keyring.7
284
.\" as published by the Free Software Foundation; either version
285
.\" 2 of the Licence, or (at your option) any later version.
287
-.TH "USER KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
288
+.TH "USER-KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
289
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
291
-user keyring \- Per-user keyring
292
+user-keyring \- Per-user keyring
296
diff --git a/man/user-session-keyring.7 b/man/user-session-keyring.7
297
index b8ecd21..d29eea9 100644
298
--- a/man/user-session-keyring.7
299
+++ b/man/user-session-keyring.7
301
.\" as published by the Free Software Foundation; either version
302
.\" 2 of the Licence, or (at your option) any later version.
304
-.TH "USER SESSION KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
305
+.TH "USER-SESSION-KEYRING" 7 "20 Feb 2014" Linux "Kernel key management"
306
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
308
-user session keyring \- Per-user default session keyring
309
+user-session-keyring \- Per-user default session keyring
312
.B user session keyring