Commit Graph

176 Commits

Author SHA1 Message Date
Michael Kerrisk c316108324 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 761fd292ea keyctl.2: Minor wording fix for KEYCTL_SET_REQKEY_KEYRING
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk ebf4eb2834 keyctl.2: Improve KEYCTL_REJECT description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 4e23dce354 keyctl.2: Minor improvement to KEYCTL_INSTANTIATE description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 16d9a8f924 keyctl.2: Minor improvements to KEYCTL_ASSUME_AUTHORITY description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 1ac6bb731e keyctl.2: Minor clarification for KEYCTL_UPDATE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 5bcea69928 keyctl.2: Minor clarification for KEYCTL_REJECT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 4c8ae2269c keyctl.2, request_key.2: Consistently use term "negatively instantiated key"
Eliminate uses of the term "negative key" in favor of
"negatively instantiated key".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk ee61f2666b keyctl.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 29708373b1 keyctl.2: Improvements to description of KEYCTL_GET_KEYRING_ID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 79319a254f keyctl.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Michael Kerrisk 17de986ef3 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-12 12:45:43 +01:00
Jakub Wilk 40aba91d56 keyctl.2: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-04 15:24:30 +13:00
Michael Kerrisk 64dd3b717a keyctl.2: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:23 +01:00
Michael Kerrisk 60be6628fa keyctl.2: KEYCTL_SET_REQKEY_KEYRING also has an effect for request_key(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:23 +01:00
Michael Kerrisk c69490ae43 keyctl.2: Improve a KEYCTL_SET_REQKEY_KEYRING detail
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:23 +01:00
Eugene Syromyatnikov 87c6aeea76 keyctl.2: tfix 2016-12-27 09:36:22 +01:00
Michael Kerrisk 6e810113f1 keyctl.2: Clarify permission rules for KEYCTL_SETPERM
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:21 +01:00
Michael Kerrisk cbf1ad35a2 keyctl.2: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
Michael Kerrisk 472f8204e5 keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
Michael Kerrisk a76439c9d0 keyctl.2: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
Michael Kerrisk 5685b18c27 add_key.2, keyctl.2, request_key.2, syscalls.2: Correct kernel version for keys syscalls
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
Michael Kerrisk 919d820670 keyctl.2: Note rationale for Diffie-Hellman computation to keyctl()
Heavily based on text supplied by Mat Martineau.

As noted by Mat, further context can be found in
http://www.spinics.net/lists/keyrings/msg00654.html

    Re: [RFC] Deriving Diffie-Hellman values through keyctl
    From: Mat Martineau <mathew.j.martineau@xxxxxxxxxxxxxxx>
    Date: Thu, 24 Mar 2016 12:02:57 -0700 (PDT)
    Cc: linux-security-module@..., keyrings@...

Cowritten-by: Mat Martineau <mathew.j.martineau@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
Michael Kerrisk 0e5c391f5f keyctl.2: SEE ALSO: add some refs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 7b4861d924 keyctl.2: Tweaks after discussions with David Howells
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk ab3d151e07 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 4e9afdfc39 keyctl.2: Minor tweaks to KEYCTL_JOIN_SESSION_KEYRING text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 2329c6d0be keyctl.2: Reworking and improvement after discussions with David Howells
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 38590ae0ff keyctl.2: Remove FIXMEs/update details after conversation with David Howells
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 152d5aab8a keyctl.2: Improvements to KEYCTL_DH_COMPUTE text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:19 +01:00
Michael Kerrisk 737d8596fd keyctl.2: Add EPERM error for KEYCTL_GET_PERSISTENT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 46c0179ab7 dd_key.2, keyctl.2, request_key.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 9879bf30e4 keyctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk b74b20aab0 keyctl.2: srcfix: FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 962dd42d8a keyctl.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 1fe70a6764 keyctl.2: srcfix: FIXME clean-up
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 0e4229d916 keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 293fcea036 keyctl.2: wfix + remove FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:15 +01:00
Michael Kerrisk 5aebf66a7f keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 6394674616 keyctl.2: srcfix: FIXME KEYCTL_NEGATE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk a12693896a keyctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 1f6c40f005 keyctl.2: Wording fixes for KEY_DESCRIBE
Avoid ambiguity w.r.t. "description".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 303ec07a21 keyctl.2: Consolidate list of special keyring IDs to a single location
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 0c1af0231f keyctl.2: srcfix: remove obsolete FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk e56eefd6b8 keyctl.2: Change license
Eugene Syromyatnikov and I are now the copyright holders,
and Eugene agreed with my suggestion to change the license.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 8cc6b9a7c9 keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk ff91beca5b keyctl.2: ERRORS: add EINVAL error case for KEYCTL_SEARCH
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk 29806cc80e keyctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:14 +01:00
Michael Kerrisk e02acf2fdc keyctl.2: SYNOPSIS: include <sys/types.h>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 64f2f3e7a1 keyctl.2: wfix: "partially constructed key" ==> "uninstantiated key"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk a6cca1b573 keyctl.2: Further details for KEYCTL_ASSUME_AUTHORITY
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 8fbff3c7d7 keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 5d711752e8 keyctl.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 10c4bf2286 keyctl.2: Further details for KEYCTL_READ
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 5c1cb82520 keyctl.2: Further detail for KEYCTL_REVOKE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
Michael Kerrisk 63eab5d8dd keyctl.2: Further details for KEYCTL_GET_KEYRING_ID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:13 +01:00
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