Commit Graph

70 Commits

Author SHA1 Message Date
Michael Kerrisk 6cec06d03a keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 15164d8d61 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 3cc58bb81e keyctl.2: ERRORS: place in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk b6cb00aa77 keyctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk f38147ac30 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk f011ea5537 keyctl.2: Expand SEE ALSO list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk be428596d5 keyctl.2: Add notes on libkeyutils wrapper functions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 57ce8d0fe3 keyctl.2: srcfix: update copyright
Note mtk and Eugene Syromyatnikov as copyright holders, and,
since virtually nothing remains of the original page, remove
David Howells.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 53e88c3e98 keyctl.2: Rename 'option' argument to 'operation'
Yes, the kernel source says 'option', but 'operation' is
a more natural name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 1deb8c8ee8 keyctl.2: Improve KEYCTL_DH_COMPUTE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk f595473369 keyctl.2: Improve KEYCTL_GET_PERSISTENT details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 3234dd5f66 keyctl.2: Improve KEYCTL_SESSION_TO_PARENT details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 4887418925 keyctl.2: Improve KEYCTL_GET_SECURITY details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 076432afcb keyctl.2: Improve KEYCTL_ASSUME_AUTHORITY details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 0a45d56711 keyctl.2: Improve KEYCTL_SET_REQKEY_KEYRING details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 1f234c53ad keyctl.2: Improve KEYCTL_INVALIDATE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk adee707302 keyctl.2: Improve KEYCTL_SET_TIMEOUT details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 329c2892c0 keyctl.2: Improve KEYCTL_INSTANTIATE_IOV details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 8ab24543a8 keyctl.2: Improve KEYCTL_REJECT details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 39b91a53ca keyctl.2: Simplify KEYCTL_NEGATE details
This operation is just a special case of KEYCTL_REJECT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 9f79744c9a keyctl.2: Improve KEYCTL_INSTANTIATE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 8baa481508 keyctl.2: Improve KEYCTL_READ details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 4f5a5b13ac keyctl.2: Improve KEYCTL_SEARCH details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 9d7346eb5d keyctl.2: Note kernel version for all operations added in 2.6.11 (initial release)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 2981a43ffc keyctl.2: Improve KEYCTL_UNLINK details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk c336c20799 keyctl.2: Improve KEYCTL_LINK details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk c97582e5d9 keyctl.2: Improve KEYCTL_CLEAR details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 015c82d521 keyctl.2: Improve KEYCTL_DESCRIBE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 3d20acc9bc keyctl.2: Improve KEYCTL_SETPERM details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 14694cb5b2 keyctl.2: Improve KEYCTL_CHOWN details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk f8aead6a94 keyctl.2: Tweak description of ENOTDIR error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk fd2d68f9af keyctl.2: wfix: various fixes in discussion of casting types
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk efd4c0cdd1 keyctl.2: Note libkeyutils equivalents of various operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk cbf0e35e65 keyctl.2: Improve KEYCTL_REVOKE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 581f820339 keyctl.2: Improve KEYCTL_UPDATE details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk f9fa5a664f keyctl.2: Improve KEYCTL_JOIN_SESSION_KEYRING description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk d6c7244f84 keyctl.2: Improve KEYCTL_GET_KEYRING_ID details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 740fecc271 keyctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk a5987bfd77 keyctl.2: Add VERSIONS and CONFORMING TO sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk bfc2322825 keyctl.2: Add reference to kernel documentation file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk d374e8506d keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 60fc9e9564 keyctl.2: Various wording fixes
No technical content (intentionally) changed.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk d1d5839dbb keyctl.2: Rework KEYCTL_SET_REQKEY_KEYRING values as a list
We don't (IIUC) need the numeric values, just the constant
names. Reformatting as a list make things more readable.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 461a8ce535 keyctl.2: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Michael Kerrisk 9a9febc854 keyctl.2: Minor fix: reformat call signature in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:12 +01:00
Eugene Syromyatnikov fa76da808e keyctl.2: Updates regarding command usage, return values and error codes
I've drafted some updates to the keyctl.2 man page while
preparing test for strace syscall decoder. It is focused
mostly on description of argument format used in various
commands and return values/error codes.  Information is based
on Documentation/security/keys.txt, include/uapi/linux/keyctl.h,
and source code and comments in security/keys/ (mostly comments
from security/keys/keyctl.c).
2016-12-27 09:36:12 +01:00
Michael Kerrisk 914ab99576 keyctl.2: Revert "keyctl.2: updates regarding command usage, return values and error codes"
This reverts commit 8ec6a2110b.

This patch was accidentally applied in master. The patch needs
more work before it can be released.
2016-10-08 14:08:23 +02:00
Eugene Syromyatnikov 8ec6a2110b keyctl.2: updates regarding command usage, return values and error codes
Hello.

I've drafted some updates to the keyctl.2 man page while preparing test
for strace syscall decoder. It is focused mostly on description of argument
format used in various commands and return values/error codes.
Information is based on Documentation/security/keys.txt,
include/uapi/linux/keyctl.h, and source code and comments in
security/keys/ (mostly comments from security/keys/keyctl.c).
Hope you find it useful.
2016-10-07 09:13:57 +02:00
Michael Kerrisk d8f1a35cb5 keyctl.2: Fix order of SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:13 +10:00
Michael Kerrisk f5de7914ff keyctl.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-08-08 05:54:13 +10:00