Several fixes and improvements to the manual pages
Subsystems (2)
cover Several fixes and improvements to the manual pages
Hi David,
Here's a set of fixes and improvements to the manual pages. I'm preparing a lot more, but I'll send these already to taste the waters.
Have a lovely day!
Alex
*** BLURB HERE ***
Alejandro Colomar (10):
man/asymmetric-key.7: Use HISTORY instead of VERSIONS
man: Use the LIBRARY section
man: Fix TH arguments 4 and 5
man: Update date in TH
man: Use lowercase in TH 1st argument
man: Escape dashes in TH
man: Add SYNOPSYS section
man: Improve formatting of SYNOPSIS of commands man/keyctl.1: Improve formatting
man: Organize manual pages in subdirectories
Makefile | 10 +-
man/{ => man1}/keyctl.1 | 432 ++++++++++++++-----
man/{ => man3}/find_key_by_type_and_name.3 | 11 +-
man/{ => man3}/keyctl.3 | 25 +-
man/{ => man3}/keyctl_capabilities.3 | 13 +-
man/{ => man3}/keyctl_chown.3 | 13 +-
man/{ => man3}/keyctl_clear.3 | 13 +-
man/{ => man3}/keyctl_describe.3 | 13 +-
man/{ => man3}/keyctl_dh_compute.3 | 13 +-
man/{ => man3}/keyctl_get_keyring_ID.3 | 13 +-
man/{ => man3}/keyctl_get_persistent.3 | 13 +-
man/{ => man3}/keyctl_get_security.3 | 13 +-
man/{ => man3}/keyctl_instantiate.3 | 13 +-
man/{ => man3}/keyctl_invalidate.3 | 13 +-
man/{ => man3}/keyctl_join_session_keyring.3 | 13 +-
man/{ => man3}/keyctl_link.3 | 13 +-
man/{ => man3}/keyctl_move.3 | 13 +-
man/{ => man3}/keyctl_pkey_decrypt.3 | 0
man/{ => man3}/keyctl_pkey_encrypt.3 | 13 +-
man/{ => man3}/keyctl_pkey_query.3 | 13 +-
man/{ => man3}/keyctl_pkey_sign.3 | 13 +-
man/{ => man3}/keyctl_pkey_verify.3 | 0
man/{ => man3}/keyctl_read.3 | 13 +-
man/{ => man3}/keyctl_restrict_keyring.3 | 13 +-
man/{ => man3}/keyctl_revoke.3 | 13 +-
man/{ => man3}/keyctl_search.3 | 15 +-
man/{ => man3}/keyctl_session_to_parent.3 | 13 +-
man/{ => man3}/keyctl_set_reqkey_keyring.3 | 13 +-
man/{ => man3}/keyctl_set_timeout.3 | 13 +-
man/{ => man3}/keyctl_setperm.3 | 13 +-
man/{ => man3}/keyctl_update.3 | 13 +-
man/{ => man3}/keyctl_watch_key.3 | 13 +-
man/{ => man3}/recursive_key_scan.3 | 11 +-
man/{ => man5}/key.dns_resolver.conf.5 | 2 +-
man/{ => man5}/request-key.conf.5 | 2 +-
man/{ => man7}/asymmetric-key.7 | 4 +-
man/{ => man7}/keyutils.7 | 26 +-
man/{ => man8}/key.dns_resolver.8 | 2 +-
man/{ => man8}/request-key.8 | 14 +-
39 files changed, 498 insertions(+), 381 deletions(-)
rename man/{ => man1}/keyctl.1 (89%)
rename man/{ => man3}/find_key_by_type_and_name.3 (92%)
rename man/{ => man3}/keyctl.3 (89%)
rename man/{ => man3}/keyctl_capabilities.3 (94%)
rename man/{ => man3}/keyctl_chown.3 (91%)
rename man/{ => man3}/keyctl_clear.3 (89%)
rename man/{ => man3}/keyctl_describe.3 (93%)
rename man/{ => man3}/keyctl_dh_compute.3 (95%)
rename man/{ => man3}/keyctl_get_keyring_ID.3 (92%)
rename man/{ => man3}/keyctl_get_persistent.3 (93%)
rename man/{ => man3}/keyctl_get_security.3 (93%)
rename man/{ => man3}/keyctl_instantiate.3 (96%)
rename man/{ => man3}/keyctl_invalidate.3 (90%)
rename man/{ => man3}/keyctl_join_session_keyring.3 (91%)
rename man/{ => man3}/keyctl_link.3 (92%)
rename man/{ => man3}/keyctl_move.3 (92%)
rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%)
rename man/{ => man3}/keyctl_pkey_encrypt.3 (94%)
rename man/{ => man3}/keyctl_pkey_query.3 (94%)
rename man/{ => man3}/keyctl_pkey_sign.3 (95%)
rename man/{ => man3}/keyctl_pkey_verify.3 (100%)
rename man/{ => man3}/keyctl_read.3 (94%)
rename man/{ => man3}/keyctl_restrict_keyring.3 (91%)
rename man/{ => man3}/keyctl_revoke.3 (89%)
rename man/{ => man3}/keyctl_search.3 (93%)
rename man/{ => man3}/keyctl_session_to_parent.3 (91%)
rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (93%)
rename man/{ => man3}/keyctl_set_timeout.3 (90%)
rename man/{ => man3}/keyctl_setperm.3 (94%)
rename man/{ => man3}/keyctl_update.3 (91%)
rename man/{ => man3}/keyctl_watch_key.3 (95%)
rename man/{ => man3}/recursive_key_scan.3 (95%)
rename man/{ => man5}/key.dns_resolver.conf.5 (95%)
rename man/{ => man5}/request-key.conf.5 (98%)
rename man/{ => man7}/asymmetric-key.7 (99%)
rename man/{ => man7}/keyutils.7 (89%)
rename man/{ => man8}/key.dns_resolver.8 (95%)
rename man/{ => man8}/request-key.8 (92%)Range-diff against v0:
-: ------- > 1: ec0c2fa man/asymmetric-key.7: Use HISTORY instead of VERSIONS -: ------- > 2: 8f02c27 man: Use the LIBRARY section -: ------- > 3: e3e616f man: Fix TH arguments 4 and 5 -: ------- > 4: 7762f59 man: Update date in TH -: ------- > 5: 7294951 man: Use lowercase in TH 1st argument -: ------- > 6: 3d6ef97 man: Escape dashes in TH -: ------- > 7: 5794916 man: Add SYNOPSYS section -: ------- > 8: 30c25a7 man: Improve formatting of SYNOPSIS of commands -: ------- > 9: ae1e052 man/keyctl.1: Improve formatting -: ------- > 10: 93e44ce man: Organize manual pages in subdirectories
Signature · 1 line
2.45.2
PATCH 1/10 man/asymmetric-key.7: Use HISTORY instead of VERSIONS
The VERSIONS section is usually used to describe differences in different systems, focusing on portability to other current systems.
The HISTORY section is used to describe the history of an API, such as when it appeared, or when it was standardized, focusing on portability to older versions of the same system.
--- man/asymmetric-key.7 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man/asymmetric-key.7 +1 -1
@@ -211,7 +211,7 @@ .SH BLACKLISTING that blacklisting is not retroactive, so an asymmetric key that is already on the system cannot be blacklisted by adding a matching blacklist entry later. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH VERSIONS +.SH HISTORY The .B asymmetric key type first appeared in v3.7 of the Linux kernel, the
Signature · 1 line
2.45.2
PATCH 2/10 man: Use the LIBRARY section
In reply to Alejandro ColomarThis is the de-facto standard way of documenting the library that provides a function, and the linker option to link to it.
This LIBRARY section is used (at least) by FreeBSD and the Linux man-pages project.
--- man/find_key_by_type_and_name.3 | 9 ++++----- man/keyctl.3 | 11 ++++------- man/keyctl_capabilities.3 | 11 ++++------- man/keyctl_chown.3 | 11 ++++------- man/keyctl_clear.3 | 11 ++++------- man/keyctl_describe.3 | 11 ++++------- man/keyctl_dh_compute.3 | 11 ++++------- man/keyctl_get_keyring_ID.3 | 11 ++++------- man/keyctl_get_persistent.3 | 11 ++++------- man/keyctl_get_security.3 | 11 ++++------- man/keyctl_instantiate.3 | 11 ++++------- man/keyctl_invalidate.3 | 11 ++++------- man/keyctl_join_session_keyring.3 | 11 ++++------- man/keyctl_link.3 | 11 ++++------- man/keyctl_move.3 | 11 ++++------- man/keyctl_pkey_encrypt.3 | 11 ++++------- man/keyctl_pkey_query.3 | 11 ++++------- man/keyctl_pkey_sign.3 | 11 ++++------- man/keyctl_read.3 | 11 ++++------- man/keyctl_restrict_keyring.3 | 11 ++++------- man/keyctl_revoke.3 | 11 ++++------- man/keyctl_search.3 | 13 ++++--------- man/keyctl_session_to_parent.3 | 11 ++++------- man/keyctl_set_reqkey_keyring.3 | 11 ++++------- man/keyctl_set_timeout.3 | 11 ++++------- man/keyctl_setperm.3 | 11 ++++------- man/keyctl_update.3 | 11 ++++------- man/keyctl_watch_key.3 | 11 ++++------- man/keyutils.7 | 12 ++++-------- man/recursive_key_scan.3 | 9 ++++----- 30 files changed, 120 insertions(+), 209 deletions(-)
man/find_key_by_type_and_name.3 +4 -5
@@ -12,6 +12,10 @@ .SH NAME find_key_by_type_and_name \- find a key by type and name .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -52,11 +56,6 @@ .SH ERRORS .B writable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_*() \- key management function wrappers .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH DESCRIPTION The .BR keyctl ()
@@ -24,13 +28,6 @@ .SH DESCRIPTION .nf .B #include <keyutils.h> .RE -.P -and then telling the linker it should link in the library: -.sp -.RS -.nf -.B \-lkeyutils -.RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH KEYCTL FUNCTIONS .BR keyctl_assume_authority (3)
man/keyctl_capabilities.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_capabilities \- Query subsystem capabilities .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -104,13 +108,6 @@ .SH ERRORS .B EFAULT The buffer cannot be written to. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_chown.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_chown \- change the ownership of a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -69,13 +73,6 @@ .SH ERRORS .B setattr permission to the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_clear.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_clear \- clear a keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -54,13 +58,6 @@ .SH ERRORS .B writable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_describe.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_describe \- describe a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS .B viewable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_dh_compute.3 +4 -7
@@ -14,6 +14,10 @@ .SH NAME .br keyctl_dh_compute_kdf \- Derive key from a Diffie-Hellman shared secret .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -151,13 +155,6 @@ .SH ERRORS .I buflen is too big. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .BR keyctl (1), .br
man/keyctl_get_keyring_ID.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_get_keyring_ID \- get the ID of a special keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -77,13 +81,6 @@ .SH ERRORS The key quota for this user would be exceeded by creating this key or linking it to the keyring. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_get_persistent.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_get_persistent \- get the persistent keyring for a user .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS .B write permission to the calling process. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l
man/keyctl_get_security.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_get_security \- retrieve a key's security context .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -83,13 +87,6 @@ .SH ERRORS .B viewable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_instantiate.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -171,13 +175,6 @@ .SH ERRORS .B writable by the requester. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_invalidate.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_invalidate \- invalidate a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -57,13 +61,6 @@ .SH ERRORS .B searchable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_join_session_keyring.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_join_session_keyring \- join a different session keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -63,13 +67,6 @@ .SH ERRORS .B searchable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_link.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -88,13 +92,6 @@ .SH ERRORS .B linkable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_move.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_move \- Move a key between keyrings .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -89,13 +93,6 @@ .SH ERRORS .B EDQUOT Expanding to_keyring would exceed the keyring owner's quota. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_pkey_encrypt.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -93,13 +97,6 @@ .SH ERRORS .B EFAULT Bad address. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_pkey_query.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_pkey_query \- Query public key parameters .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -116,13 +120,6 @@ .SH ERRORS .B EFAULT Bad address. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_pkey_sign.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -114,13 +118,6 @@ .SH ERRORS .B EFAULT Bad address. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_read.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_read \- read a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -92,13 +96,6 @@ .SH ERRORS .B EOPNOTSUPP The key type does not support reading of the payload data. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_restrict_keyring.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_restrict_keyring \- restrict keys that may be linked to a keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -66,13 +70,6 @@ .SH ERRORS .B ENOENT The key type exists but does not support restrictions. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_revoke.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_revoke \- revoke a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -54,13 +58,6 @@ .SH ERRORS .B writable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_search.3 +4 -9
@@ -12,6 +12,10 @@ .SH NAME keyctl_search \- search a keyring for a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -117,15 +121,6 @@ .SH ERRORS .B link permission to the caller. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -Although this is a Linux system call, it is not present in -.I libc -but can be found rather in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_session_to_parent.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_session_to_parent \- set the parent process's session keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -56,13 +60,6 @@ .SH ERRORS .B linkable by the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_set_reqkey_keyring.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_set_reqkey_keyring \- set the implicit destination keyring .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -81,13 +85,6 @@ .SH ERRORS .I reqkey_defl is invalid. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_set_timeout.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_set_timeout \- set the expiration timer on a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -62,13 +66,6 @@ .SH ERRORS .B setattr permission to the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_setperm.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_setperm \- change the permissions mask on a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -111,13 +115,6 @@ .SH ERRORS .B setattr permission to the calling process. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_update.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_update \- update a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -77,13 +81,6 @@ .SH ERRORS .B EOPNOTSUPP The key type does not support the update operation on its keys. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyctl_watch_key.3 +4 -7
@@ -12,6 +12,10 @@ .SH NAME keyctl_watch_key \- Watch for changes to a key .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -187,13 +191,6 @@ .SH ERRORS .B EBADSLT The specified key doesn't have a watch on it (removal only). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -This is a library function that can be found in -.IR libkeyutils . -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
man/keyutils.7 +4 -8
@@ -12,6 +12,10 @@ .SH NAME keyutils \- in-kernel key management utilities .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH DESCRIPTION The .B keyutils
@@ -25,14 +29,6 @@ .SH DESCRIPTION .B #include <keyutils.h> .RE .P -To link with the library, the following: -.P -.RS -.B \-lkeyutils -.RE -.P -should be specified to the linker. -.P Three system calls are provided: .TP .BR add_key (2)
man/recursive_key_scan.3 +4 -5
@@ -12,6 +12,10 @@ .SH NAME recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH LIBRARY +Key management utilities library +.RI ( libkeyutils ,\~ \-lkeyutils ) +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SYNOPSIS .nf .B #include <keyutils.h>
@@ -77,11 +81,6 @@ .SH RETURN VALUE .SH ERRORS Ignored. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" -.SH LINKING -When linking, -.B \-lkeyutils -should be specified to the linker. -.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH SEE ALSO .ad l .nh
Signature · 1 line
2.45.2
PATCH 3/10 man: Fix TH arguments 4 and 5
In reply to Alejandro Colomarmandoc_man(7) says:
TH Set the name of the manual page for use in the page header
and footer with the following syntax:
.TH name section date [source [volume]]
[...]. The recommended date format is YYYY‐MM‐DD as specified in the ISO‐8601 standard; if the argument does not conform, it is printed verbatim. If the date is empty or not specified, the current date is used. The optional source string specifies the organisation providing the utility. When unspecified, mandoc(1) uses its -Ios argument. The volume string replaces the default volume title of the section.
groff_man_style(7) says:
.TH identifier section [footer‐middle [footer‐inside [header‐middle]]]
[...]
By convention, footer‐middle is the date of the most recent modification to the man page source document, and footer‐ inside is the name and version or release of the project providing it.
The 5th argument is usually to be omitted, and it will default to the description of the chapter of the manual, that is, for man3 it will be "Library Functions Manual".
The 4th argument should be the name of the project providing the manual page, possibly including the version of it. For example, in the Linux man-pages project, we use the following in the git repository:
.TH keyctl 2 (date) "Linux man-pages (unreleased)"
and the following on a release:
.TH keyctl 2 2024-06-15 "Linux man-pages 6.9.1"
Here, I'd use keyutils, or possibly keyutils-X.Y. For now, I've made it just contain the project name.
--- man/asymmetric-key.7 | 2 +- man/find_key_by_type_and_name.3 | 2 +- man/key.dns_resolver.8 | 2 +- man/key.dns_resolver.conf.5 | 2 +- man/keyctl.1 | 2 +- man/keyctl.3 | 2 +- man/keyctl_capabilities.3 | 2 +- man/keyctl_chown.3 | 2 +- man/keyctl_clear.3 | 2 +- man/keyctl_describe.3 | 2 +- man/keyctl_dh_compute.3 | 2 +- man/keyctl_get_keyring_ID.3 | 2 +- man/keyctl_get_persistent.3 | 2 +- man/keyctl_get_security.3 | 2 +- man/keyctl_instantiate.3 | 2 +- man/keyctl_invalidate.3 | 2 +- man/keyctl_join_session_keyring.3 | 2 +- man/keyctl_link.3 | 2 +- man/keyctl_move.3 | 2 +- man/keyctl_pkey_encrypt.3 | 2 +- man/keyctl_pkey_query.3 | 2 +- man/keyctl_pkey_sign.3 | 2 +- man/keyctl_read.3 | 2 +- man/keyctl_restrict_keyring.3 | 2 +- man/keyctl_revoke.3 | 2 +- man/keyctl_search.3 | 2 +- man/keyctl_session_to_parent.3 | 2 +- man/keyctl_set_reqkey_keyring.3 | 2 +- man/keyctl_set_timeout.3 | 2 +- man/keyctl_setperm.3 | 2 +- man/keyctl_update.3 | 2 +- man/keyctl_watch_key.3 | 2 +- man/keyutils.7 | 2 +- man/recursive_key_scan.3 | 2 +- man/request-key.8 | 2 +- man/request-key.conf.5 | 2 +- 36 files changed, 36 insertions(+), 36 deletions(-)
man/asymmetric-key.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH ASYMMETRIC-KEY 7 "8 Nov 2018" Linux "Asymmetric Kernel Key Type" +.TH ASYMMETRIC-KEY 7 "8 Nov 2018" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" Linux "Linux Key Utility Calls" +.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER 8 "18 May 2020" Linux "Linux Key Management Utilities" +.TH KEY.DNS_RESOLVER 8 "18 May 2020" keyutils .SH NAME key.dns_resolver \- upcall for request\-key to handle dns_resolver keys .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" Linux "Linux Key Management Utilities" +.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" keyutils .SH NAME key.dns_resolver.conf \- Kernel DNS resolver config .SH DESCRIPTION
man/keyctl.1 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL 1 "20 Feb 2014" Linux "Linux Key Management Utilities" +.TH KEYCTL 1 "20 Feb 2014" keyutils .SH NAME keyctl \- key management facility control .SH SYNOPSIS
man/keyctl.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL 3 "21 Feb 2014" Linux "Linux Key Management Calls" +.TH KEYCTL 3 "21 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CAPABILITIES 3 "30 May 2019" Linux "Linux Key Management Calls" +.TH KEYCTL_CAPABILITIES 3 "30 May 2019" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CHOWN 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_CHOWN 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CLEAR 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_CLEAR 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DESCRIBE 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_DESCRIBE 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" Linux "Linux Key Management Calls" +.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_persistent.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" Linux "Linux Key Management Calls" +.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_persistent \- get the persistent keyring for a user
man/keyctl_get_security.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" Linux "Linux Key Management Calls" +.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INSTANTIATE 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_INSTANTIATE 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" Linux "Linux Key Management Calls" +.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" Linux "Linux Key Management Calls" +.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_LINK 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_LINK 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_MOVE 3 "29 May 2019" Linux "Linux Key Management Calls" +.TH KEYCTL_MOVE 3 "29 May 2019" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" Linux "Linux Public-Key Encryption" +.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" Linux "Linux Key Management Calls" +.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" Linux "Linux Public-Key Signatures" +.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_READ 3 "21 Feb 2014" Linux "Linux Key Management Calls" +.TH KEYCTL_READ 3 "21 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" Linux "Linux Key Management Calls" +.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_REVOKE 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_REVOKE 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SEARCH 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_SEARCH 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" Linux "Linux Key Management Calls" +.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SETPERM 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_SETPERM 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_UPDATE 3 "4 May 2006" Linux "Linux Key Management Calls" +.TH KEYCTL_UPDATE 3 "4 May 2006" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" Linux "Linux Key Management Calls" +.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYUTILS 7 "21 Feb 2014" Linux "Kernel key management" +.TH KEYUTILS 7 "21 Feb 2014" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" Linux "Linux Key Utility Calls" +.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY 8 "15 Nov 2011" Linux "Linux Key Management Utilities" +.TH REQUEST-KEY 8 "15 Nov 2011" keyutils .SH NAME request\-key \- handle key instantiation callback requests from the kernel .SH SYNOPSIS
man/request-key.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY.CONF 5 "15 November 2011" Linux "Linux Key Management Utilities" +.TH REQUEST-KEY.CONF 5 "15 November 2011" keyutils .SH NAME request\-key.conf \- Instantiation handler configuration file .SH DESCRIPTION
Signature · 1 line
2.45.2
PATCH 4/10 man: Update date in TH
In reply to Alejandro ColomarThe date in the TH line is meant to be the date of last modification of the page. Also, the recommended date format is YYYY-MM-DD, which conforms to ISO-8601, so switch to it.
mandoc_man(7) says:
TH Set the name of the manual page for use in the page header
and footer with the following syntax:
.TH name section date [source [volume]]
[...]. The recommended date format is YYYY‐MM‐DD as specified in the ISO‐8601 standard; if the argument does not conform, it is printed verbatim. If the date is empty or not specified, the current date is used. [...]
groff_man_style(7) says:
.TH identifier section [footer‐middle [footer‐inside [header‐middle]]]
[...]
By convention, footer‐middle is the date of the most recent modification to the man page source document, [...]
[...]
In the title heading (.TH), the date of the page’s last revision is more important than packaging information; it should not be omitted. Ideally, a page maintainer will keep both up to date.
--- man/asymmetric-key.7 | 2 +- man/find_key_by_type_and_name.3 | 2 +- man/key.dns_resolver.8 | 2 +- man/key.dns_resolver.conf.5 | 2 +- man/keyctl.1 | 2 +- man/keyctl.3 | 2 +- man/keyctl_capabilities.3 | 2 +- man/keyctl_chown.3 | 2 +- man/keyctl_clear.3 | 2 +- man/keyctl_describe.3 | 2 +- man/keyctl_dh_compute.3 | 2 +- man/keyctl_get_keyring_ID.3 | 2 +- man/keyctl_get_persistent.3 | 2 +- man/keyctl_get_security.3 | 2 +- man/keyctl_instantiate.3 | 2 +- man/keyctl_invalidate.3 | 2 +- man/keyctl_join_session_keyring.3 | 2 +- man/keyctl_link.3 | 2 +- man/keyctl_move.3 | 2 +- man/keyctl_pkey_encrypt.3 | 2 +- man/keyctl_pkey_query.3 | 2 +- man/keyctl_pkey_sign.3 | 2 +- man/keyctl_read.3 | 2 +- man/keyctl_restrict_keyring.3 | 2 +- man/keyctl_revoke.3 | 2 +- man/keyctl_search.3 | 2 +- man/keyctl_session_to_parent.3 | 2 +- man/keyctl_set_reqkey_keyring.3 | 2 +- man/keyctl_set_timeout.3 | 2 +- man/keyctl_setperm.3 | 2 +- man/keyctl_update.3 | 2 +- man/keyctl_watch_key.3 | 2 +- man/keyutils.7 | 2 +- man/recursive_key_scan.3 | 2 +- man/request-key.8 | 2 +- man/request-key.conf.5 | 2 +- 36 files changed, 36 insertions(+), 36 deletions(-)
man/asymmetric-key.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH ASYMMETRIC-KEY 7 "8 Nov 2018" keyutils +.TH ASYMMETRIC-KEY 7 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH FIND_KEY_BY_TYPE_AND_NAME 3 "10 Sep 2013" keyutils +.TH FIND_KEY_BY_TYPE_AND_NAME 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER 8 "18 May 2020" keyutils +.TH KEY.DNS_RESOLVER 8 2024-06-19 keyutils .SH NAME key.dns_resolver \- upcall for request\-key to handle dns_resolver keys .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER.CONF 5 "18 May 2020" keyutils +.TH KEY.DNS_RESOLVER.CONF 5 2024-06-19 keyutils .SH NAME key.dns_resolver.conf \- Kernel DNS resolver config .SH DESCRIPTION
man/keyctl.1 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL 1 "20 Feb 2014" keyutils +.TH KEYCTL 1 2024-06-19 keyutils .SH NAME keyctl \- key management facility control .SH SYNOPSIS
man/keyctl.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL 3 "21 Feb 2014" keyutils +.TH KEYCTL 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CAPABILITIES 3 "30 May 2019" keyutils +.TH KEYCTL_CAPABILITIES 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CHOWN 3 "4 May 2006" keyutils +.TH KEYCTL_CHOWN 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CLEAR 3 "4 May 2006" keyutils +.TH KEYCTL_CLEAR 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DESCRIBE 3 "4 May 2006" keyutils +.TH KEYCTL_DESCRIBE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DH_COMPUTE 3 "07 Apr 2016" keyutils +.TH KEYCTL_DH_COMPUTE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_KEYRING_ID 3 "4 May 2006" keyutils +.TH KEYCTL_GET_KEYRING_ID 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_persistent.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_PERSISTENT 3 "20 Feb 2014" keyutils +.TH KEYCTL_GET_PERSISTENT 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_persistent \- get the persistent keyring for a user
man/keyctl_get_security.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_SECURITY 3 "26 Feb 2010" keyutils +.TH KEYCTL_GET_SECURITY 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INSTANTIATE 3 "4 May 2006" keyutils +.TH KEYCTL_INSTANTIATE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INVALIDATE 3 "29 Aug 2013" keyutils +.TH KEYCTL_INVALIDATE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_JOIN_SESSION_KEYRING 3 "20 Feb 2014" keyutils +.TH KEYCTL_JOIN_SESSION_KEYRING 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_LINK 3 "4 May 2006" keyutils +.TH KEYCTL_LINK 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_MOVE 3 "29 May 2019" keyutils +.TH KEYCTL_MOVE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_ENCRYPT 3 "8 Nov 2018" keyutils +.TH KEYCTL_PKEY_ENCRYPT 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_QUERY 3 "8 Nov 2018" keyutils +.TH KEYCTL_PKEY_QUERY 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_SIGN 3 "8 Nov 2018" keyutils +.TH KEYCTL_PKEY_SIGN 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_READ 3 "21 Feb 2014" keyutils +.TH KEYCTL_READ 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_RESTRICT_KEYRING 3 "28 Feb 2017" keyutils +.TH KEYCTL_RESTRICT_KEYRING 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_REVOKE 3 "4 May 2006" keyutils +.TH KEYCTL_REVOKE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SEARCH 3 "4 May 2006" keyutils +.TH KEYCTL_SEARCH 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SESSION_TO_PARENT 3 "20 Feb 2014" keyutils +.TH KEYCTL_SESSION_TO_PARENT 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_REQKEY_KEYRING 3 "4 May 2006" keyutils +.TH KEYCTL_SET_REQKEY_KEYRING 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_TIMEOUT 3 "4 May 2006" keyutils +.TH KEYCTL_SET_TIMEOUT 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SETPERM 3 "4 May 2006" keyutils +.TH KEYCTL_SETPERM 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_UPDATE 3 "4 May 2006" keyutils +.TH KEYCTL_UPDATE 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GRANT_PERMISSION 3 "28 Aug 2019" keyutils +.TH KEYCTL_GRANT_PERMISSION 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYUTILS 7 "21 Feb 2014" keyutils +.TH KEYUTILS 7 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH RECURSIVE_KEY_SCAN 3 "10 Mar 2011" keyutils +.TH RECURSIVE_KEY_SCAN 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY 8 "15 Nov 2011" keyutils +.TH REQUEST-KEY 8 2024-06-19 keyutils .SH NAME request\-key \- handle key instantiation callback requests from the kernel .SH SYNOPSIS
man/request-key.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY.CONF 5 "15 November 2011" keyutils +.TH REQUEST-KEY.CONF 5 2024-06-19 keyutils .SH NAME request\-key.conf \- Instantiation handler configuration file .SH DESCRIPTION
Signature · 1 line
2.45.2
PATCH 5/10 man: Use lowercase in TH 1st argument
In reply to Alejandro ColomarThe maintainers of groff(1), mandoc(1), man(1), and the Linux man-pages project, and several others have reached a consensus that using upper case in the TH 1st argument is unnecessarily imprecise, and that it would be more appropriate to use the same case that the name of the thing to be documented: so for NULL, it would be upper case, but for printf, it would be lower case.
The use of upper case seems to have been inertia from a time when there was no bold face, so authors of the manual chose use upper case for emphasis. These days we can do better.
--- man/asymmetric-key.7 | 2 +- man/find_key_by_type_and_name.3 | 2 +- man/key.dns_resolver.8 | 2 +- man/key.dns_resolver.conf.5 | 2 +- man/keyctl.1 | 2 +- man/keyctl.3 | 2 +- man/keyctl_capabilities.3 | 2 +- man/keyctl_chown.3 | 2 +- man/keyctl_clear.3 | 2 +- man/keyctl_describe.3 | 2 +- man/keyctl_dh_compute.3 | 2 +- man/keyctl_get_keyring_ID.3 | 2 +- man/keyctl_get_security.3 | 2 +- man/keyctl_instantiate.3 | 2 +- man/keyctl_invalidate.3 | 2 +- man/keyctl_join_session_keyring.3 | 2 +- man/keyctl_link.3 | 2 +- man/keyctl_move.3 | 2 +- man/keyctl_pkey_encrypt.3 | 2 +- man/keyctl_pkey_query.3 | 2 +- man/keyctl_pkey_sign.3 | 2 +- man/keyctl_read.3 | 2 +- man/keyctl_restrict_keyring.3 | 2 +- man/keyctl_revoke.3 | 2 +- man/keyctl_search.3 | 2 +- man/keyctl_session_to_parent.3 | 2 +- man/keyctl_set_reqkey_keyring.3 | 2 +- man/keyctl_set_timeout.3 | 2 +- man/keyctl_setperm.3 | 2 +- man/keyctl_update.3 | 2 +- man/keyctl_watch_key.3 | 2 +- man/keyutils.7 | 2 +- man/recursive_key_scan.3 | 2 +- man/request-key.8 | 2 +- man/request-key.conf.5 | 2 +- 35 files changed, 35 insertions(+), 35 deletions(-)
man/asymmetric-key.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH ASYMMETRIC-KEY 7 2024-06-19 keyutils +.TH asymmetric-key 7 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME asymmetric \- Kernel key type for holding asymmetric keys
man/find_key_by_type_and_name.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH FIND_KEY_BY_TYPE_AND_NAME 3 2024-06-19 keyutils +.TH find_key_by_type_and_name 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME find_key_by_type_and_name \- find a key by type and name
man/key.dns_resolver.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER 8 2024-06-19 keyutils +.TH key.dns_resolver 8 2024-06-19 keyutils .SH NAME key.dns_resolver \- upcall for request\-key to handle dns_resolver keys .SH SYNOPSIS
man/key.dns_resolver.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEY.DNS_RESOLVER.CONF 5 2024-06-19 keyutils +.TH key.dns_resolver.conf 5 2024-06-19 keyutils .SH NAME key.dns_resolver.conf \- Kernel DNS resolver config .SH DESCRIPTION
man/keyctl.1 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL 1 2024-06-19 keyutils +.TH keyctl 1 2024-06-19 keyutils .SH NAME keyctl \- key management facility control .SH SYNOPSIS
man/keyctl.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL 3 2024-06-19 keyutils +.TH keyctl 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_*() \- key management function wrappers
man/keyctl_capabilities.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CAPABILITIES 3 2024-06-19 keyutils +.TH keyctl_capabilities 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_capabilities \- Query subsystem capabilities
man/keyctl_chown.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CHOWN 3 2024-06-19 keyutils +.TH keyctl_chown 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_chown \- change the ownership of a key
man/keyctl_clear.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_CLEAR 3 2024-06-19 keyutils +.TH keyctl_clear 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_clear \- clear a keyring
man/keyctl_describe.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DESCRIBE 3 2024-06-19 keyutils +.TH keyctl_describe 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_describe \- describe a key
man/keyctl_dh_compute.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_DH_COMPUTE 3 2024-06-19 keyutils +.TH keyctl_dh_compute 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_dh_compute \- Compute a Diffie-Hellman shared secret or public key
man/keyctl_get_keyring_ID.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_KEYRING_ID 3 2024-06-19 keyutils +.TH keyctl_get_keyring_ID 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_keyring_ID \- get the ID of a special keyring
man/keyctl_get_security.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GET_SECURITY 3 2024-06-19 keyutils +.TH keyctl_get_security 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_get_security \- retrieve a key's security context
man/keyctl_instantiate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INSTANTIATE 3 2024-06-19 keyutils +.TH keyctl_instantiate 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_assume_authority, keyctl_instantiate, keyctl_instantiate_iov, keyctl_reject, keyctl_negate \- key instantiation functions
man/keyctl_invalidate.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_INVALIDATE 3 2024-06-19 keyutils +.TH keyctl_invalidate 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_invalidate \- invalidate a key
man/keyctl_join_session_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_JOIN_SESSION_KEYRING 3 2024-06-19 keyutils +.TH keyctl_join_session_keyring 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_join_session_keyring \- join a different session keyring
man/keyctl_link.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_LINK 3 2024-06-19 keyutils +.TH keyctl_link 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_link, keyctl_unlink \- link/unlink a key to/from a keyring
man/keyctl_move.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_MOVE 3 2024-06-19 keyutils +.TH keyctl_move 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_move \- Move a key between keyrings
man/keyctl_pkey_encrypt.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_ENCRYPT 3 2024-06-19 keyutils +.TH keyctl_pkey_encrypt 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_encrypt, keyctl_pkey_decrypt \- Encrypt and decrypt data
man/keyctl_pkey_query.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_QUERY 3 2024-06-19 keyutils +.TH keyctl_pkey_query 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_query \- Query public key parameters
man/keyctl_pkey_sign.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYCTL_PKEY_SIGN 3 2024-06-19 keyutils +.TH keyctl_pkey_sign 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_pkey_sign, keyctl_pkey_verify \- Generate and verify signatures
man/keyctl_read.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_READ 3 2024-06-19 keyutils +.TH keyctl_read 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_read \- read a key
man/keyctl_restrict_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_RESTRICT_KEYRING 3 2024-06-19 keyutils +.TH keyctl_restrict_keyring 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_restrict_keyring \- restrict keys that may be linked to a keyring
man/keyctl_revoke.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_REVOKE 3 2024-06-19 keyutils +.TH keyctl_revoke 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_revoke \- revoke a key
man/keyctl_search.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SEARCH 3 2024-06-19 keyutils +.TH keyctl_search 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_search \- search a keyring for a key
man/keyctl_session_to_parent.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SESSION_TO_PARENT 3 2024-06-19 keyutils +.TH keyctl_session_to_parent 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_session_to_parent \- set the parent process's session keyring
man/keyctl_set_reqkey_keyring.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_REQKEY_KEYRING 3 2024-06-19 keyutils +.TH keyctl_set_reqkey_keyring 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_reqkey_keyring \- set the implicit destination keyring
man/keyctl_set_timeout.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SET_TIMEOUT 3 2024-06-19 keyutils +.TH keyctl_set_timeout 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_set_timeout \- set the expiration timer on a key
man/keyctl_setperm.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_SETPERM 3 2024-06-19 keyutils +.TH keyctl_setperm 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_setperm \- change the permissions mask on a key
man/keyctl_update.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_UPDATE 3 2024-06-19 keyutils +.TH keyctl_update 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_update \- update a key
man/keyctl_watch_key.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH KEYCTL_GRANT_PERMISSION 3 2024-06-19 keyutils +.TH keyctl_grant_permission 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyctl_watch_key \- Watch for changes to a key
man/keyutils.7 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH KEYUTILS 7 2024-06-19 keyutils +.TH keyutils 7 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME keyutils \- in-kernel key management utilities
man/recursive_key_scan.3 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the Licence, or (at your option) any later version. .\" -.TH RECURSIVE_KEY_SCAN 3 2024-06-19 keyutils +.TH recursive_key_scan 3 2024-06-19 keyutils .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH NAME recursive_key_scan, recursive_session_key_scan \- apply a function to all keys in a keyring tree
man/request-key.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY 8 2024-06-19 keyutils +.TH request-key 8 2024-06-19 keyutils .SH NAME request\-key \- handle key instantiation callback requests from the kernel .SH SYNOPSIS
man/request-key.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH REQUEST-KEY.CONF 5 2024-06-19 keyutils +.TH request-key.conf 5 2024-06-19 keyutils .SH NAME request\-key.conf \- Instantiation handler configuration file .SH DESCRIPTION
Signature · 1 line
2.45.2
PATCH 6/10 man: Escape dashes in TH
In reply to Alejandro ColomarWhen they document an identifier that uses a dash.
--- man/request-key.8 | 2 +- man/request-key.conf.5 | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-)
man/request-key.8 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH request-key 8 2024-06-19 keyutils +.TH request\-key 8 2024-06-19 keyutils .SH NAME request\-key \- handle key instantiation callback requests from the kernel .SH SYNOPSIS
man/request-key.conf.5 +1 -1
@@ -7,7 +7,7 @@ .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" -.TH request-key.conf 5 2024-06-19 keyutils +.TH request\-key.conf 5 2024-06-19 keyutils .SH NAME request\-key.conf \- Instantiation handler configuration file .SH DESCRIPTION
Signature · 1 line
2.45.2
PATCH 7/10 man: Add SYNOPSYS section
In reply to Alejandro ColomarThis is a simpler and more standard way of documenting the header that provides these functions.
--- man/keyctl.3 | 12 +++++------- man/keyutils.7 | 12 +++++------- 2 files changed, 10 insertions(+), 14 deletions(-)
man/keyctl.3 +5 -7
@@ -16,18 +16,16 @@ .SH LIBRARY Key management utilities library .RI ( libkeyutils ,\~ \-lkeyutils ) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH SYNOPSIS +.nf +.B #include <keyutils.h> +.fi +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH DESCRIPTION The .BR keyctl () system call is a multiplexor for a number of key management functions. These should be called via the wrappers in the libkeyutils library. -.P -The functions can be compiled in by including the \fBkeyutils\fR header file: -.sp -.RS -.nf -.B #include <keyutils.h> -.RE .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH KEYCTL FUNCTIONS .BR keyctl_assume_authority (3)
man/keyutils.7 +5 -7
@@ -16,19 +16,17 @@ .SH LIBRARY Key management utilities library .RI ( libkeyutils ,\~ \-lkeyutils ) .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" +.SH SYNOPSIS +.nf +.B #include <keyutils.h> +.fi +.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH DESCRIPTION The .B keyutils package is a library and a set of utilities for accessing the kernel \fBkeyrings\fP facility. .P -A header file is supplied to provide the definitions and declarations required -to access the library: -.P -.RS -.B #include <keyutils.h> -.RE -.P Three system calls are provided: .TP .BR add_key (2)
Signature · 1 line
2.45.2
PATCH 8/10 man: Improve formatting of SYNOPSIS of commands
In reply to Alejandro Colomar--- man/keyctl.1 | 426 ++++++++++++++++++++++++++++++++++------------ man/request-key.8 | 12 +- 2 files changed, 324 insertions(+), 114 deletions(-)
man/keyctl.1 +314 -112
@@ -11,118 +11,320 @@ .SH NAME keyctl \- key management facility control .SH SYNOPSIS -\fBkeyctl\fR \-\-version -.br -\fBkeyctl\fR supports [<cap> | --raw] -.br -\fBkeyctl\fR id [<keyring>] -.br -\fBkeyctl\fR show [\-x] [<keyring>] -.br -\fBkeyctl\fR add [\-x] <type> <desc> <data> <keyring> -.br -\fBkeyctl\fR padd [\-x] <type> <desc> <keyring> -.br -\fBkeyctl\fR request <type> <desc> [<dest_keyring>] -.br -\fBkeyctl\fR request2 <type> <desc> <info> [<dest_keyring>] -.br -\fBkeyctl\fR prequest2 <type> <desc> [<dest_keyring>] -.br -\fBkeyctl\fR update [\-x] <key> <data> -.br -\fBkeyctl\fR pupdate [\-x] <key> -.br -\fBkeyctl\fR newring <name> <keyring> -.br -\fBkeyctl\fR revoke <key> -.br -\fBkeyctl\fR clear <keyring> -.br -\fBkeyctl\fR link <key> <keyring> -.br -\fBkeyctl\fR unlink <key> [<keyring>] -.br -\fBkeyctl\fR move [-f] <key> <from_keyring> <to_keyring> -.br -\fBkeyctl\fR search <keyring> <type> <desc> [<dest_keyring>] -.br -\fBkeyctl\fR restrict_keyring <keyring> [<type> [<restriction>]] -.br -\fBkeyctl\fR read <key> -.br -\fBkeyctl\fR pipe <key> -.br -\fBkeyctl\fR print <key> -.br -\fBkeyctl\fR list <keyring> -.br -\fBkeyctl\fR rlist <keyring> -.br -\fBkeyctl\fR describe <keyring> -.br -\fBkeyctl\fR rdescribe <keyring> [sep] -.br -\fBkeyctl\fR chown <key> <uid> -.br -\fBkeyctl\fR chgrp <key> <gid> -.br -\fBkeyctl\fR setperm <key> <mask> -.br -\fBkeyctl\fR new_session [<name>] -.br -\fBkeyctl\fR session -.br -\fBkeyctl\fR session \- [<prog> <arg1> <arg2> ...] -.br -\fBkeyctl\fR session <name> [<prog> <arg1> <arg2> ...] -.br -\fBkeyctl\fR instantiate [\-x] <key> <data> <keyring> -.br -\fBkeyctl\fR pinstantiate [\-x] <key> <keyring> -.br -\fBkeyctl\fR negate <key> <timeout> <keyring> -.br -\fBkeyctl\fR reject <key> <timeout> <error> <keyring> -.br -\fBkeyctl\fR timeout <key> <timeout> -.br -\fBkeyctl\fR security <key> -.br -\fBkeyctl\fR reap [\-v] -.br -\fBkeyctl\fR purge <type> -.br -\fBkeyctl\fR purge [\-i] [\-p] <type> <desc> -.br -\fBkeyctl\fR purge \-s <type> <desc> -.br -\fBkeyctl\fR get_persistent <keyring> [<uid>] -.br -\fBkeyctl\fR dh_compute <private> <prime> <base> -.br -\fBkeyctl\fR dh_compute_kdf <private> <prime> <base> <output_length> <hash_type> -.br -\fBkeyctl\fR dh_compute_kdf_oi [\-x] <private> <prime> <base> <output_length> <hash_type> -.br -\fBkeyctl\fR pkey_query <key> <pass> [k=v]* -.br -\fBkeyctl\fR pkey_encrypt <key> <pass> <datafile> [k=v]* ><encfile> -.br -\fBkeyctl\fR pkey_decrypt <key> <pass> <encfile> [k=v]* ><datafile> -.br -\fBkeyctl\fR pkey_sign <key> <pass> <datafile> [k=v]* ><sigfile> -.br -\fBkeyctl\fR pkey_decrypt <key> <pass> <datafile> <sigfile> [k=v]* -.br -\fBkeyctl\fR watch [\-f<filters>] <key> -.br -\fBkeyctl\fR watch_add <fd> <key> -.br -\fBkeyctl\fR watch_rm <fd> <key> -.br -\fBkeyctl\fR watch_session [\-f <filters>] [-n <name>] \\ - <notifylog> <gclog> <fd> <prog> [<arg1> <arg2> ...] +.SY keyctl +.B \-\-version +.YS +.SY keyctl +.B supports +.RI [ cap \~|\~\fB--raw\fP] +.YS +.SY keyctl +.B id +.RI [ keyring ] +.YS +.SY keyctl +.B show +.RB [ \-x ] +.RI [ keyring ] +.YS +.SY keyctl +.B add +.RB [ \-x ] +.I type +.I desc +.I data +.I keyring +.YS +.SY keyctl +.B padd +.RB [ \-x ] +.I type +.I desc +.I keyring +.YS +.SY keyctl +.B request +.I type +.I desc +.RI [ dest_keyring ] +.YS +.SY keyctl +.B request2 +.I type +.I desc +.I info +.RI [ dest_keyring ] +.YS +.SY keyctl +.B prequest2 +.I type +.I desc +.RI [ dest_keyring ] +.YS +.SY keyctl +.B update +.RB [ \-x ] +.I key +.I data +.YS +.SY keyctl +.B pupdate +.RB [ \-x ] +.I key +.YS +.SY keyctl +.B newring +.I name +.I keyring +.YS +.SY keyctl +.B revoke +.I key +.YS +.SY keyctl +.B clear +.I keyring +.YS +.SY keyctl +.B link +.I key +.I keyring +.YS +.SY keyctl +.B unlink +.I key +.RI [ keyring ] +.YS +.SY keyctl +.B move +.RB [ -f ] +.I key +.I from_keyring +.I to_keyring +.YS +.SY keyctl +.B search +.I keyring +.I type +.I desc +.RI [ dest_keyring ] +.YS +.SY keyctl +.B restrict_keyring +.I keyring +.RI [ type +.RI [ restriction ]] +.YS +.SY keyctl +.B read +.I key +.YS +.SY keyctl +.B pipe +.I key +.YS +.SY keyctl +.B print +.I key +.YS +.SY keyctl +.B list +.I keyring +.YS +.SY keyctl +.B rlist +.I keyring +.YS +.SY keyctl +.B describe +.I keyring +.YS +.SY keyctl +.B rdescribe +.I keyring +.RB [ sep ] +.YS +.SY keyctl +.B chown +.I key +.I uid +.YS +.SY keyctl +.B chgrp +.I key +.I gid +.YS +.SY keyctl +.B setperm +.I key +.I mask +.YS +.SY keyctl +.B new_session +.RI [ name ] +.YS +.SY keyctl +.B session +.YS +.SY keyctl +.B session +.B \- +.RI [ prog +.IR args \~.\|.\|.] +.YS +.SY keyctl +.B session +.I name +.RI [ prog +.RI [ args \~.\|.\|.]] +.YS +.SY keyctl +.B instantiate +.RB [ \-x ] +.I key +.I data +.I keyring +.YS +.SY keyctl +.B pinstantiate +.RB [ \-x ] +.I key +.I keyring +.YS +.SY keyctl +.B negate +.I key +.I timeout +.I keyring +.YS +.SY keyctl +.B reject +.I key +.I timeout +.I error +.I keyring +.YS +.SY keyctl +.B timeout +.I key +.I timeout +.YS +.SY keyctl +.B security +.I key +.YS +.SY keyctl +.B reap +.RB [ \-v ] +.YS +.SY keyctl +.B purge +.I type +.YS +.SY keyctl +.B purge +.RB [ \-i ] +.RB [ \-p ] +.I type +.I desc +.YS +.SY keyctl +.B purge +.B \-s +.I type +.I desc +.YS +.SY keyctl +.B get_persistent +.I keyring +.RI [ uid ] +.YS +.SY keyctl +.B dh_compute +.I private +.I prime +.I base +.YS +.SY keyctl +.B dh_compute_kdf +.I private +.I prime +.I base +.I output_length +.I hash_type +.YS +.SY keyctl +.B dh_compute_kdf_oi +.RB [ \-x ] +.I private +.I prime +.I base +.I output_length +.I hash_type +.YS +.SY keyctl +.B pkey_query +.I key +.I pass +.RI [ k \fB=\fP v \~.\|.\|.] +.YS +.SY keyctl +.B pkey_encrypt +.I key +.I pass +.I datafile +.RI [ k \fB=\fP v \~.\|.\|.\&] +.I encfile +.YS +.SY keyctl +.B pkey_decrypt +.I key +.I pass +.I encfile +.RI [ k \fB=\fP v \~.\|.\|.\&] +.I datafile +.YS +.SY keyctl +.B pkey_sign +.I key +.I pass +.I datafile +.RI [ k \fB=\fP v \~.\|.\|.\&] +.I sigfile +.YS +.SY keyctl +.B pkey_decrypt +.I key +.I pass +.I datafile +.I sigfile +.RI [ k \fB=\fP v \~.\|.\|.] +.YS +.SY keyctl +.B watch +.RB [ \-f \~\fIfilters\fP] +.I key +.YS +.SY keyctl +.B watch_add +.I fd +.I key +.YS +.SY keyctl +.B watch_rm +.I fd +.I key +.YS +.SY keyctl +.B watch_session +.RB [ \-f \~\fIfilters\fP] +.RB [ \-n \~\fIname\fP] +.I notifylog +.I gclog +.I fd +.I prog +.RI [ args \~.\|.\|.] +.YS .SH DESCRIPTION This program is used to control the key management facility in various ways using a variety of subcommands.
man/request-key.8 +10 -2
@@ -11,8 +11,16 @@ .SH NAME request\-key \- handle key instantiation callback requests from the kernel .SH SYNOPSIS -\fB/sbin/request\-key \fR<op> <key> <uid> <gid> <threadring> <processring> - <sessionring> [<info>] +.SY /sbin/request\-key +.I op +.I key +.I uid +.I gid +.I threadring +.I processring +.I sessionring +.RI [ info ] +.YS .SH DESCRIPTION This program is invoked by the kernel when the kernel is asked for a key that it doesn't have immediately available. The kernel creates a partially set up
Signature · 1 line
2.45.2
PATCH 9/10 man/keyctl.1: Improve formatting
In reply to Alejandro Colomar--- man/keyctl.1 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
man/keyctl.1 +2 -2
@@ -369,11 +369,11 @@ .SH KEY IDENTIFIERS helper to permit it to access the callers keyrings and instantiate the target key. .TP -Keyring by name: \fB%:<name>\fR +Keyring by name: \f[B]%:\f[BI]name\f[R] A named keyring. This will be searched for in the process's keyrings and in .IR /proc/keys . .TP -Key by name: \fB%<type>:<name>\fR +Key by name: \f[B]%\f[BI]type\f[B]:\f[BI]name\f[R] A named key of the given type. This will be searched for in the process's keyrings and in .IR /proc/keys .
Signature · 1 line
2.45.2
PATCH 10/10 man: Organize manual pages in subdirectories
In reply to Alejandro Colomar---
Makefile | 10 +++++-----
man/{ => man1}/keyctl.1 | 0
man/{ => man3}/find_key_by_type_and_name.3 | 0
man/{ => man3}/keyctl.3 | 0
man/{ => man3}/keyctl_capabilities.3 | 0
man/{ => man3}/keyctl_chown.3 | 0
man/{ => man3}/keyctl_clear.3 | 0
man/{ => man3}/keyctl_describe.3 | 0
man/{ => man3}/keyctl_dh_compute.3 | 0
man/{ => man3}/keyctl_get_keyring_ID.3 | 0
man/{ => man3}/keyctl_get_persistent.3 | 0
man/{ => man3}/keyctl_get_security.3 | 0
man/{ => man3}/keyctl_instantiate.3 | 0
man/{ => man3}/keyctl_invalidate.3 | 0
man/{ => man3}/keyctl_join_session_keyring.3 | 0
man/{ => man3}/keyctl_link.3 | 0
man/{ => man3}/keyctl_move.3 | 0
man/{ => man3}/keyctl_pkey_decrypt.3 | 0
man/{ => man3}/keyctl_pkey_encrypt.3 | 0
man/{ => man3}/keyctl_pkey_query.3 | 0
man/{ => man3}/keyctl_pkey_sign.3 | 0
man/{ => man3}/keyctl_pkey_verify.3 | 0
man/{ => man3}/keyctl_read.3 | 0
man/{ => man3}/keyctl_restrict_keyring.3 | 0
man/{ => man3}/keyctl_revoke.3 | 0
man/{ => man3}/keyctl_search.3 | 0
man/{ => man3}/keyctl_session_to_parent.3 | 0
man/{ => man3}/keyctl_set_reqkey_keyring.3 | 0
man/{ => man3}/keyctl_set_timeout.3 | 0
man/{ => man3}/keyctl_setperm.3 | 0
man/{ => man3}/keyctl_update.3 | 0
man/{ => man3}/keyctl_watch_key.3 | 0
man/{ => man3}/recursive_key_scan.3 | 0
man/{ => man5}/key.dns_resolver.conf.5 | 0
man/{ => man5}/request-key.conf.5 | 0
man/{ => man7}/asymmetric-key.7 | 0
man/{ => man7}/keyutils.7 | 0
man/{ => man8}/key.dns_resolver.8 | 0
man/{ => man8}/request-key.8 | 0
39 files changed, 5 insertions(+), 5 deletions(-)
rename man/{ => man1}/keyctl.1 (100%)
rename man/{ => man3}/find_key_by_type_and_name.3 (100%)
rename man/{ => man3}/keyctl.3 (100%)
rename man/{ => man3}/keyctl_capabilities.3 (100%)
rename man/{ => man3}/keyctl_chown.3 (100%)
rename man/{ => man3}/keyctl_clear.3 (100%)
rename man/{ => man3}/keyctl_describe.3 (100%)
rename man/{ => man3}/keyctl_dh_compute.3 (100%)
rename man/{ => man3}/keyctl_get_keyring_ID.3 (100%)
rename man/{ => man3}/keyctl_get_persistent.3 (100%)
rename man/{ => man3}/keyctl_get_security.3 (100%)
rename man/{ => man3}/keyctl_instantiate.3 (100%)
rename man/{ => man3}/keyctl_invalidate.3 (100%)
rename man/{ => man3}/keyctl_join_session_keyring.3 (100%)
rename man/{ => man3}/keyctl_link.3 (100%)
rename man/{ => man3}/keyctl_move.3 (100%)
rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%)
rename man/{ => man3}/keyctl_pkey_encrypt.3 (100%)
rename man/{ => man3}/keyctl_pkey_query.3 (100%)
rename man/{ => man3}/keyctl_pkey_sign.3 (100%)
rename man/{ => man3}/keyctl_pkey_verify.3 (100%)
rename man/{ => man3}/keyctl_read.3 (100%)
rename man/{ => man3}/keyctl_restrict_keyring.3 (100%)
rename man/{ => man3}/keyctl_revoke.3 (100%)
rename man/{ => man3}/keyctl_search.3 (100%)
rename man/{ => man3}/keyctl_session_to_parent.3 (100%)
rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (100%)
rename man/{ => man3}/keyctl_set_timeout.3 (100%)
rename man/{ => man3}/keyctl_setperm.3 (100%)
rename man/{ => man3}/keyctl_update.3 (100%)
rename man/{ => man3}/keyctl_watch_key.3 (100%)
rename man/{ => man3}/recursive_key_scan.3 (100%)
rename man/{ => man5}/key.dns_resolver.conf.5 (100%)
rename man/{ => man5}/request-key.conf.5 (100%)
rename man/{ => man7}/asymmetric-key.7 (100%)
rename man/{ => man7}/keyutils.7 (100%)
rename man/{ => man8}/key.dns_resolver.8 (100%)
rename man/{ => man8}/request-key.8 (100%)Makefile +5 -5
@@ -221,15 +221,15 @@ endif mkdir -p $(DESTDIR)$(ETCDIR)/request-key.d mkdir -p $(DESTDIR)$(ETCDIR)/keyutils mkdir -p $(DESTDIR)$(MAN1) - $(INSTALL) -m 0644 $(wildcard man/*.1) $(DESTDIR)$(MAN1) + $(INSTALL) -m 0644 $(wildcard man/man1/*.1) $(DESTDIR)$(MAN1) mkdir -p $(DESTDIR)$(MAN3) - $(INSTALL) -m 0644 $(wildcard man/*.3) $(DESTDIR)$(MAN3) + $(INSTALL) -m 0644 $(wildcard man/man3/*.3) $(DESTDIR)$(MAN3) mkdir -p $(DESTDIR)$(MAN5) - $(INSTALL) -m 0644 $(wildcard man/*.5) $(DESTDIR)$(MAN5) + $(INSTALL) -m 0644 $(wildcard man/man5/*.5) $(DESTDIR)$(MAN5) mkdir -p $(DESTDIR)$(MAN7) - $(INSTALL) -m 0644 $(wildcard man/*.7) $(DESTDIR)$(MAN7) + $(INSTALL) -m 0644 $(wildcard man/man7/*.7) $(DESTDIR)$(MAN7) mkdir -p $(DESTDIR)$(MAN8) - $(INSTALL) -m 0644 $(wildcard man/*.8) $(DESTDIR)$(MAN8) + $(INSTALL) -m 0644 $(wildcard man/man8/*.8) $(DESTDIR)$(MAN8) $(LNS) keyctl_describe.3 $(DESTDIR)$(MAN3)/keyctl_describe_alloc.3 $(LNS) keyctl_get_security.3 $(DESTDIR)$(MAN3)/keyctl_get_security_alloc.3 $(LNS) keyctl_instantiate.3 $(DESTDIR)$(MAN3)/keyctl_instantiate_iov.3
man/man1/keyctl.1 renamed from man/keyctl.1 +0 -0
man/man3/find_key_by_type_and_name.3 renamed from man/find_key_by_type_and_name.3 +0 -0
man/man3/keyctl.3 renamed from man/keyctl.3 +0 -0
man/man3/keyctl_capabilities.3 renamed from man/keyctl_capabilities.3 +0 -0
man/man3/keyctl_chown.3 renamed from man/keyctl_chown.3 +0 -0
man/man3/keyctl_clear.3 renamed from man/keyctl_clear.3 +0 -0
man/man3/keyctl_describe.3 renamed from man/keyctl_describe.3 +0 -0
man/man3/keyctl_dh_compute.3 renamed from man/keyctl_dh_compute.3 +0 -0
man/man3/keyctl_get_keyring_ID.3 renamed from man/keyctl_get_keyring_ID.3 +0 -0
man/man3/keyctl_get_persistent.3 renamed from man/keyctl_get_persistent.3 +0 -0
man/man3/keyctl_get_security.3 renamed from man/keyctl_get_security.3 +0 -0
man/man3/keyctl_instantiate.3 renamed from man/keyctl_instantiate.3 +0 -0
man/man3/keyctl_invalidate.3 renamed from man/keyctl_invalidate.3 +0 -0
man/man3/keyctl_join_session_keyring.3 renamed from man/keyctl_join_session_keyring.3 +0 -0
man/man3/keyctl_link.3 renamed from man/keyctl_link.3 +0 -0
man/man3/keyctl_move.3 renamed from man/keyctl_move.3 +0 -0
man/man3/keyctl_pkey_decrypt.3 renamed from man/keyctl_pkey_decrypt.3 +0 -0
man/man3/keyctl_pkey_encrypt.3 renamed from man/keyctl_pkey_encrypt.3 +0 -0
man/man3/keyctl_pkey_query.3 renamed from man/keyctl_pkey_query.3 +0 -0
man/man3/keyctl_pkey_sign.3 renamed from man/keyctl_pkey_sign.3 +0 -0
man/man3/keyctl_pkey_verify.3 renamed from man/keyctl_pkey_verify.3 +0 -0
man/man3/keyctl_read.3 renamed from man/keyctl_read.3 +0 -0
man/man3/keyctl_restrict_keyring.3 renamed from man/keyctl_restrict_keyring.3 +0 -0
man/man3/keyctl_revoke.3 renamed from man/keyctl_revoke.3 +0 -0
man/man3/keyctl_search.3 renamed from man/keyctl_search.3 +0 -0
man/man3/keyctl_session_to_parent.3 renamed from man/keyctl_session_to_parent.3 +0 -0
man/man3/keyctl_set_reqkey_keyring.3 renamed from man/keyctl_set_reqkey_keyring.3 +0 -0
man/man3/keyctl_set_timeout.3 renamed from man/keyctl_set_timeout.3 +0 -0
man/man3/keyctl_setperm.3 renamed from man/keyctl_setperm.3 +0 -0
man/man3/keyctl_update.3 renamed from man/keyctl_update.3 +0 -0
man/man3/keyctl_watch_key.3 renamed from man/keyctl_watch_key.3 +0 -0
man/man3/recursive_key_scan.3 renamed from man/recursive_key_scan.3 +0 -0
man/man5/key.dns_resolver.conf.5 renamed from man/key.dns_resolver.conf.5 +0 -0
man/man5/request-key.conf.5 renamed from man/request-key.conf.5 +0 -0
man/man7/asymmetric-key.7 renamed from man/asymmetric-key.7 +0 -0
man/man7/keyutils.7 renamed from man/keyutils.7 +0 -0
man/man8/key.dns_resolver.8 renamed from man/key.dns_resolver.8 +0 -0
man/man8/request-key.8 renamed from man/request-key.8 +0 -0
Signature · 1 line
2.45.2
Quoted 4 lines · Alejandro Colomar
Hi David,
Here's a set of fixes and improvements to the manual pages. I'm preparing a lot more, but I'll send these already to taste the waters.
Ping.
Quoted 111 lines
Have a lovely day!
Alex*** BLURB HERE ***
Alejandro Colomar (10):
man/asymmetric-key.7: Use HISTORY instead of VERSIONS
man: Use the LIBRARY section
man: Fix TH arguments 4 and 5
man: Update date in TH
man: Use lowercase in TH 1st argument
man: Escape dashes in TH
man: Add SYNOPSYS section
man: Improve formatting of SYNOPSIS of commands man/keyctl.1: Improve formatting
man: Organize manual pages in subdirectoriesMakefile | 10 +- man/{ => man1}/keyctl.1 | 432 ++++++++++++++----- man/{ => man3}/find_key_by_type_and_name.3 | 11 +- man/{ => man3}/keyctl.3 | 25 +- man/{ => man3}/keyctl_capabilities.3 | 13 +- man/{ => man3}/keyctl_chown.3 | 13 +- man/{ => man3}/keyctl_clear.3 | 13 +- man/{ => man3}/keyctl_describe.3 | 13 +- man/{ => man3}/keyctl_dh_compute.3 | 13 +- man/{ => man3}/keyctl_get_keyring_ID.3 | 13 +- man/{ => man3}/keyctl_get_persistent.3 | 13 +- man/{ => man3}/keyctl_get_security.3 | 13 +- man/{ => man3}/keyctl_instantiate.3 | 13 +- man/{ => man3}/keyctl_invalidate.3 | 13 +- man/{ => man3}/keyctl_join_session_keyring.3 | 13 +- man/{ => man3}/keyctl_link.3 | 13 +- man/{ => man3}/keyctl_move.3 | 13 +- man/{ => man3}/keyctl_pkey_decrypt.3 | 0 man/{ => man3}/keyctl_pkey_encrypt.3 | 13 +- man/{ => man3}/keyctl_pkey_query.3 | 13 +- man/{ => man3}/keyctl_pkey_sign.3 | 13 +- man/{ => man3}/keyctl_pkey_verify.3 | 0 man/{ => man3}/keyctl_read.3 | 13 +- man/{ => man3}/keyctl_restrict_keyring.3 | 13 +- man/{ => man3}/keyctl_revoke.3 | 13 +- man/{ => man3}/keyctl_search.3 | 15 +- man/{ => man3}/keyctl_session_to_parent.3 | 13 +- man/{ => man3}/keyctl_set_reqkey_keyring.3 | 13 +- man/{ => man3}/keyctl_set_timeout.3 | 13 +- man/{ => man3}/keyctl_setperm.3 | 13 +- man/{ => man3}/keyctl_update.3 | 13 +- man/{ => man3}/keyctl_watch_key.3 | 13 +- man/{ => man3}/recursive_key_scan.3 | 11 +- man/{ => man5}/key.dns_resolver.conf.5 | 2 +- man/{ => man5}/request-key.conf.5 | 2 +- man/{ => man7}/asymmetric-key.7 | 4 +- man/{ => man7}/keyutils.7 | 26 +- man/{ => man8}/key.dns_resolver.8 | 2 +- man/{ => man8}/request-key.8 | 14 +- 39 files changed, 498 insertions(+), 381 deletions(-) rename man/{ => man1}/keyctl.1 (89%) rename man/{ => man3}/find_key_by_type_and_name.3 (92%) rename man/{ => man3}/keyctl.3 (89%) rename man/{ => man3}/keyctl_capabilities.3 (94%) rename man/{ => man3}/keyctl_chown.3 (91%) rename man/{ => man3}/keyctl_clear.3 (89%) rename man/{ => man3}/keyctl_describe.3 (93%) rename man/{ => man3}/keyctl_dh_compute.3 (95%) rename man/{ => man3}/keyctl_get_keyring_ID.3 (92%) rename man/{ => man3}/keyctl_get_persistent.3 (93%) rename man/{ => man3}/keyctl_get_security.3 (93%) rename man/{ => man3}/keyctl_instantiate.3 (96%) rename man/{ => man3}/keyctl_invalidate.3 (90%) rename man/{ => man3}/keyctl_join_session_keyring.3 (91%) rename man/{ => man3}/keyctl_link.3 (92%) rename man/{ => man3}/keyctl_move.3 (92%) rename man/{ => man3}/keyctl_pkey_decrypt.3 (100%) rename man/{ => man3}/keyctl_pkey_encrypt.3 (94%) rename man/{ => man3}/keyctl_pkey_query.3 (94%) rename man/{ => man3}/keyctl_pkey_sign.3 (95%) rename man/{ => man3}/keyctl_pkey_verify.3 (100%) rename man/{ => man3}/keyctl_read.3 (94%) rename man/{ => man3}/keyctl_restrict_keyring.3 (91%) rename man/{ => man3}/keyctl_revoke.3 (89%) rename man/{ => man3}/keyctl_search.3 (93%) rename man/{ => man3}/keyctl_session_to_parent.3 (91%) rename man/{ => man3}/keyctl_set_reqkey_keyring.3 (93%) rename man/{ => man3}/keyctl_set_timeout.3 (90%) rename man/{ => man3}/keyctl_setperm.3 (94%) rename man/{ => man3}/keyctl_update.3 (91%) rename man/{ => man3}/keyctl_watch_key.3 (95%) rename man/{ => man3}/recursive_key_scan.3 (95%) rename man/{ => man5}/key.dns_resolver.conf.5 (95%) rename man/{ => man5}/request-key.conf.5 (98%) rename man/{ => man7}/asymmetric-key.7 (99%) rename man/{ => man7}/keyutils.7 (89%) rename man/{ => man8}/key.dns_resolver.8 (95%) rename man/{ => man8}/request-key.8 (92%)Range-diff against v0:
-: ------- > 1: ec0c2fa man/asymmetric-key.7: Use HISTORY instead of VERSIONS -: ------- > 2: 8f02c27 man: Use the LIBRARY section -: ------- > 3: e3e616f man: Fix TH arguments 4 and 5 -: ------- > 4: 7762f59 man: Update date in TH -: ------- > 5: 7294951 man: Use lowercase in TH 1st argument -: ------- > 6: 3d6ef97 man: Escape dashes in TH -: ------- > 7: 5794916 man: Add SYNOPSYS section -: ------- > 8: 30c25a7 man: Improve formatting of SYNOPSIS of commands -: ------- > 9: ae1e052 man/keyctl.1: Improve formatting -: ------- > 10: 93e44ce man: Organize manual pages in subdirectoriesSignature · 1 line
2.45.2
Signature · 1 line
<https://www.alejandro-colomar.es/>