Commit Graph

17019 Commits

Author SHA1 Message Date
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 bc32c62633 getrlimit.2: Minor fix to example program
See https://answers.launchpad.net/ubuntu/+source/manpages/+question/412735

Reported-by: Reverend Homer <mk.43.ecko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 08:53:16 +01:00
Michael Kerrisk 51dbffc566 stat.2: EXAMPLE: extend program to also show ID of the containing device
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:36:49 +01:00
Michael Kerrisk d510e7de7e namespaces.7: EXAMPLE: rename the example program
Use a more generic name, since this program may be expanded
in various ways in the future.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:28:54 +01:00
Michael Kerrisk e79c9e5825 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:26:09 +01:00
Michael Kerrisk 0fbabfc2d5 namespaces.7: Minor clarification in EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:22:27 +01:00
Michael Kerrisk c6ff0d07a0 namespaces.7: EXAMPLE: fix an error in shell session
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:18:46 +01:00
Michael Kerrisk 794652c5f0 namespaces.7: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:18:34 +01:00
Michael Kerrisk d3fca275d2 namespaces.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-23 09:05:41 +01:00
Michael Kerrisk 3c5253a5b9 kcmp.2: Mention the clone(2) flags relating to various kcmp() 'type' values
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-22 12:11:10 +01:00
Michael Kerrisk a579a5ab16 kcmp.2: KCMP_FILE: note reasons why FDs may refer to same open file description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-22 12:04:30 +01:00