Commit Graph

186 Commits

Author SHA1 Message Date
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
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
Joe Stein f0e9ccbc88 keyctl.2: tfix
Signed-off-by: Joe Stein <joeaarons@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-25 14:32:09 +01:00
Michael Kerrisk 67d2c6873c add_key.2, chown.2, epoll_ctl.2, epoll_wait.2, execve.2, fcntl.2, get_mempolicy.2, getxattr.2, ioctl.2, keyctl.2, listxattr.2, mkdir.2, mknod.2, mmap.2, msync.2, nfsservctl.2, open.2, prctl.2, removexattr.2, request_key.2, sendfile.2, set_mempolicy.2, setxattr.2, shmget.2, shutdown.2, sigaction.2, syslog.2, truncate.2, umask.2, CPU_SET.3, atexit.3, bsearch.3, cmsg.3, err.3, gethostid.3, getmntent.3, getopt.3, iconv_close.3, inet_ntop.3, longjmp.3, lsearch.3, mcheck.3, on_exit.3, putpwent.3, regex.3, resolver.3, setbuf.3, setjmp.3, setlocale.3, setlogmask.3, sleep.3, strsignal.3, sysconf.3, undocumented.3, tty_ioctl.4, proc.5, resolv.conf.5, tzfile.5, aio.7, bootparam.7, capabilities.7, fanotify.7, inotify.7, ip.7, packet.7, pthreads.7, raw.7, signal.7, socket.7, unix.7, ld.so.8, nscd.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 08:26:32 +02:00
Michael Kerrisk d3c203f1a2 keyctl.2: srcfix: add FIXMES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 09:44:03 +02:00
Michael Kerrisk 32fc240749 add_key.2, keyctl.2, request_key.2: SEE ALSO: add keyrings(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 14:38:56 +02:00
Michael Kerrisk 7e7454efaa keyctl.2: SEE ALSO: mention Documentation/security/keys.txt
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 10:55:00 +01:00
Michael Kerrisk 1c27d5d827 keyctl.2: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-22 10:54:09 +01:00
Michael Kerrisk 23dbdcbe30 add_key.2, keyctl.2, request_key.2: s/GPLv2+_ONEPARA_SW/GPLv2+_SW_ONEPARA/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:11 +01:00
Michael Kerrisk 722b678847 add_key.2, keyctl.2, request_key.2: Added LICENSE_START(GPLv2+_ONEPARA_SW)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:10 +01:00
Michael Kerrisk fd351c1ab2 _syscall.2, add_key.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, getxattr.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, keyctl.2, listxattr.2, removexattr.2, request_key.2, setxattr.2, dir_colors.5, epoll.7, mailaddr.7, uri.7: srcfix: remove blank comment line from top of source
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-10 10:57:08 +01:00
Michael Kerrisk 19626e2aa8 keyctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-11 22:44:14 +01:00
Michael Kerrisk f68512e9fe intro.1, add_key.2, get_mempolicy.2, get_thread_area.2, intro.2, keyctl.2, mbind.2, request_key.2, set_thread_area.2, clock.3, cmsg.3, getcwd.3, getpw.3, intro.3, malloc.3, posix_memalign.3, shm_open.3, sleep.3, sysconf.3, intro.4, sd.4, intro.5, locale.5, slabinfo.5, intro.6, boot.7, bootparam.7, futex.7, glob.7, hier.7, intro.7, libc.7, locale.7, mq_overview.7, netlink.7, sem_overview.7, shm_overview.7, unix.7, intro.8: Global fix: Use consistent capitalization in NAME section
The line(s) in the NAME section should only use capitals
where English usage dictates that. Otherwise, use
lowercase throughout.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
Michael Kerrisk e264f02416 keyctl.2: ffix: prevent hyphenation and justification under SEE ALSO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:05:33 +02:00
David Prévot cf4d436127 keyctl.2: Reorder SEE ALSO, without .br
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:00:07 +02:00
Michael Kerrisk 96668cfdbb keyctl.2: srcfix: Added FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
Bjarni Ingi Gislason a92d3bb413 keyctl.2: Strip trailing tabs from source line
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=664688

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-21 06:54:30 +13:00
Michael Kerrisk 6030f2d859 add_key.2, keyctl.2, request_key.2, offsetof.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_equal.3, pthread_exit.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_testcancel.3: Global formatting fix: balance .nf/.fi pairs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:37:22 +13:00
Michael Kerrisk 27807c324f Changes, keyctl.2, request_key.2, subpage_prot.2, syslog.2, pthread_kill.3: ERRORS: Place errors in alphabetical order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 07:18:03 +01:00
Michael Kerrisk 02234c5df0 add_key.2, keyctl.2, request_key.2: srcfix: remove strange .\"""...""" comments
Reported-by: Jianhua Li <jhlicc@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-27 06:47:23 +02:00
Michael Kerrisk 513051f769 add_key.2, keyctl.2, request_key.2, stime.2, time.2, ctime.3, difftime.3, ftime.3, getspnam.3, mq_receive.3, mq_send.3, rtime.3, sem_wait.3, string.3, timeradd.3, tzset.3, rtc.4, core.5, icmp.7, time.7, zic.8: Updated .TH timestamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 10:43:57 +01:00
Michael Kerrisk 4509c62e84 keyctl.2: New page documenting keyctl(2)
Taken from keyutils-1.1 package.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-02-25 08:29:42 +01:00