ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / include

/* keyutils.h: key utility library interface
 *
 * Copyright (C) 2005,2011 Red Hat, Inc. All Rights Reserved.
 * Written by David Howells (dhowells@redhat.com)
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version
 * 2 of the License, or (at your option) any later version.
 */

#ifndef KEYUTILS_H
#define KEYUTILS_H

#include <stdint.h>

extern const char keyutils_version_string[];
extern const char keyutils_build_string[];

/* key serial number */
typedef int32_t key_serial_t;

/* special process keyring shortcut IDs */
#define KEY_SPEC_THREAD_KEYRING		-1	/* - key ID for thread-specific keyring */
#define KEY_SPEC_PROCESS_KEYRING	-2	/* - key ID for process-specific keyring */
#define KEY_SPEC_SESSION_KEYRING	-3	/* - key ID for session-specific keyring */
#define KEY_SPEC_USER_KEYRING		-4	/* - key ID for UID-specific keyring */
#define KEY_SPEC_USER_SESSION_KEYRING	-5	/* - key ID for UID-session keyring */
#define KEY_SPEC_GROUP_KEYRING		-6	/* - key ID for GID-specific keyring */
#define KEY_SPEC_REQKEY_AUTH_KEY	-7	/* - key ID for assumed request_key auth key */

/* request-key default keyrings */
#define KEY_REQKEY_DEFL_NO_CHANGE		-1
#define KEY_REQKEY_DEFL_DEFAULT			0
#define KEY_REQKEY_DEFL_THREAD_KEYRING		1
#define KEY_REQKEY_DEFL_PROCESS_KEYRING		2
#define KEY_REQKEY_DEFL_SESSION_KEYRING		3
#define KEY_REQKEY_DEFL_USER_KEYRING		4
#define KEY_REQKEY_DEFL_USER_SESSION_KEYRING	5
#define KEY_REQKEY_DEFL_GROUP_KEYRING		6

/* key handle permissions mask */
typedef uint32_t key_perm_t;

#define KEY_POS_VIEW	0x01000000	/* possessor can view a key's attributes */
#define KEY_POS_READ	0x02000000	/* possessor can read key payload / view keyring */
#define KEY_POS_WRITE	0x04000000	/* possessor can update key payload / add link to keyring */
#define KEY_POS_SEARCH	0x08000000	/* possessor can find a key in search / search a keyring */
#define KEY_POS_LINK	0x10000000	/* possessor can create a link to a key/keyring */
#define KEY_POS_SETATTR	0x20000000	/* possessor can set key attributes */
#define KEY_POS_ALL	0x3f000000

#define KEY_USR_VIEW	0x00010000	/* user permissions... */
#define KEY_USR_READ	0x00020000
#define KEY_USR_WRITE	0x00040000
#define KEY_USR_SEARCH	0x00080000
#define KEY_USR_LINK	0x00100000
#define KEY_USR_SETATTR	0x00200000
#define KEY_USR_ALL	0x003f0000

#define KEY_GRP_VIEW	0x00000100	/* group permissions... */
#define KEY_GRP_READ	0x00000200
#define KEY_GRP_WRITE	0x00000400
#define KEY_GRP_SEARCH	0x00000800
#define KEY_GRP_LINK	0x00001000
#define KEY_GRP_SETATTR	0x00002000
#define KEY_GRP_ALL	0x00003f00

#define KEY_OTH_VIEW	0x00000001	/* third party permissions... */
#define KEY_OTH_READ	0x00000002
#define KEY_OTH_WRITE	0x00000004
#define KEY_OTH_SEARCH	0x00000008
#define KEY_OTH_LINK	0x00000010
#define KEY_OTH_SETATTR	0x00000010
#define KEY_OTH_ALL	0x0000003f

/* keyctl commands */
#define KEYCTL_GET_KEYRING_ID		0	/* ask for a keyring's ID */
#define KEYCTL_JOIN_SESSION_KEYRING	1	/* join or start named session keyring */
#define KEYCTL_UPDATE			2	/* update a key */
#define KEYCTL_REVOKE			3	/* revoke a key */
#define KEYCTL_CHOWN			4	/* set ownership of a key */
#define KEYCTL_SETPERM			5	/* set perms on a key */
#define KEYCTL_DESCRIBE			6	/* describe a key */
#define KEYCTL_CLEAR			7	/* clear contents of a keyring */
#define KEYCTL_LINK			8	/* link a key into a keyring */
#define KEYCTL_UNLINK			9	/* unlink a key from a keyring */
#define KEYCTL_SEARCH			10	/* search for a key in a keyring */
#define KEYCTL_READ			11	/* read a key or keyring's contents */
#define KEYCTL_INSTANTIATE		12	/* instantiate a partially constructed key */
#define KEYCTL_NEGATE			13	/* negate a partially constructed key */
#define KEYCTL_SET_REQKEY_KEYRING	14	/* set default request-key keyring */
#define KEYCTL_SET_TIMEOUT		15	/* set timeout on a key */
#define KEYCTL_ASSUME_AUTHORITY		16	/* assume authority to instantiate key */
#define KEYCTL_GET_SECURITY		17	/* get key security label */
#define KEYCTL_SESSION_TO_PARENT	18	/* set my session keyring on my parent process */
#define KEYCTL_REJECT			19	/* reject a partially constructed key */
#define KEYCTL_INSTANTIATE_IOV		20	/* instantiate a partially constructed key */
#define KEYCTL_INVALIDATE		21	/* invalidate a key */
#define KEYCTL_GET_PERSISTENT		22	/* get a user's persistent keyring */

/*
 * syscall wrappers
 */
extern key_serial_t add_key(const char *type,
			    const char *description,
			    const void *payload,
			    size_t plen,
			    key_serial_t ringid);

extern key_serial_t request_key(const char *type,
				const char *description,
				const char *callout_info,
				key_serial_t destringid);

extern long keyctl(int cmd, ...);

/*
 * keyctl function wrappers
 */
extern key_serial_t keyctl_get_keyring_ID(key_serial_t id, int create);
extern key_serial_t keyctl_join_session_keyring(const char *name);
extern long keyctl_update(key_serial_t id, const void *payload, size_t plen);
extern long keyctl_revoke(key_serial_t id);
extern long keyctl_chown(key_serial_t id, uid_t uid, gid_t gid);
extern long keyctl_setperm(key_serial_t id, key_perm_t perm);
extern long keyctl_describe(key_serial_t id, char *buffer, size_t buflen);
extern long keyctl_clear(key_serial_t ringid);
extern long keyctl_link(key_serial_t id, key_serial_t ringid);
extern long keyctl_unlink(key_serial_t id, key_serial_t ringid);
extern long keyctl_search(key_serial_t ringid,
			  const char *type,
			  const char *description,
			  key_serial_t destringid);
extern long keyctl_read(key_serial_t id, char *buffer, size_t buflen);
extern long keyctl_instantiate(key_serial_t id,
			       const void *payload,
			       size_t plen,
			       key_serial_t ringid);
extern long keyctl_negate(key_serial_t id, unsigned timeout, key_serial_t ringid);
extern long keyctl_set_reqkey_keyring(int reqkey_defl);
extern long keyctl_set_timeout(key_serial_t key, unsigned timeout);
extern long keyctl_assume_authority(key_serial_t key);
extern long keyctl_get_security(key_serial_t key, char *buffer, size_t buflen);
extern long keyctl_session_to_parent(void);
extern long keyctl_reject(key_serial_t id, unsigned timeout, unsigned error,
			  key_serial_t ringid);
struct iovec;
extern long keyctl_instantiate_iov(key_serial_t id,
				   const struct iovec *payload_iov,
				   unsigned ioc,
				   key_serial_t ringid);
extern long keyctl_invalidate(key_serial_t id);
extern long keyctl_get_persistent(uid_t uid, key_serial_t id);

/*
 * utilities
 */
extern int keyctl_describe_alloc(key_serial_t id, char **_buffer);
extern int keyctl_read_alloc(key_serial_t id, void **_buffer);
extern int keyctl_get_security_alloc(key_serial_t id, char **_buffer);

typedef int (*recursive_key_scanner_t)(key_serial_t parent, key_serial_t key,
				       char *desc, int desc_len, void *data);
extern int recursive_key_scan(key_serial_t key, recursive_key_scanner_t func, void *data);
extern int recursive_session_key_scan(recursive_key_scanner_t func, void *data);
extern key_serial_t find_key_by_type_and_desc(const char *type, const char *desc,
					      key_serial_t destringid);

#endif /* KEYUTILS_H */

[+] ..
[-] krb5.h [edit]
[-] lauxlib.h [edit]
[-] execinfo.h [edit]
[-] zlib.h [edit]
[+] drm
[-] sched.h [edit]
[-] netdb.h [edit]
[-] fmtmsg.h [edit]
[+] mtd
[-] kdb.h [edit]
[+] libpng15
[-] ctype.h [edit]
[-] xf86drm.h [edit]
[-] gpg-error.h [edit]
[-] gshadow.h [edit]
[-] spawn.h [edit]
[-] wchar.h [edit]
[-] gdfontg.h [edit]
[+] rpc
[-] FlexLexer.h [edit]
[-] cpufreq.h [edit]
[-] monetary.h [edit]
[-] autosprintf.h [edit]
[-] ldap.h [edit]
[-] punycode.h [edit]
[-] db_185.h [edit]
[+] gtk-2.0
[+] gnu
[+] GL
[+] pixman-1
[-] string.h [edit]
[-] unistd.h [edit]
[-] lber_types.h [edit]
[-] pcreposix.h [edit]
[-] endian.h [edit]
[+] libexslt
[+] autotrace
[-] stdio_ext.h [edit]
[+] nfs
[-] pcre.h [edit]
[-] locale.h [edit]
[-] idn-free.h [edit]
[+] pango-1.0
[-] jmorecfg.h [edit]
[+] ImageMagick-6
[+] libkms
[-] getopt.h [edit]
[-] gcrypt.h [edit]
[-] dirent.h [edit]
[-] expat_external.h [edit]
[-] xlocale.h [edit]
[+] ijs
[-] grp.h [edit]
[-] gconv.h [edit]
[-] tiffconf.h [edit]
[-] jpeglib.h [edit]
[-] unctrl.h [edit]
[+] gio-unix-2.0
[-] utime.h [edit]
[+] net
[+] rdma
[-] bzlib.h [edit]
[-] png.h [edit]
[+] netax25
[-] mntent.h [edit]
[-] cursesp.h [edit]
[+] libltdl
[-] pwd.h [edit]
[+] libxslt
[+] neteconet
[-] aio.h [edit]
[+] db4.7.25
[-] fenv.h [edit]
[+] libxml2
[+] netash
[+] gdbm
[+] xen
[+] openssl
[+] sepol
[-] mcheck.h [edit]
[-] syscall.h [edit]
[-] nl_types.h [edit]
[-] crypt.h [edit]
[+] protocols
[-] com_err.h [edit]
[+] selinux
[+] rpcsvc
[-] errno.h [edit]
[-] argp.h [edit]
[-] regex.h [edit]
[-] fcntl.h [edit]
[-] stdc-predef.h [edit]
[-] gssapi.h [edit]
[-] cursesw.h [edit]
[-] malloc.h [edit]
[-] mqueue.h [edit]
[-] pnglibconf.h [edit]
[+] scsi
[-] dbm.h [edit]
[-] xf86drmMode.h [edit]
[-] ndbm.h [edit]
[-] math.h [edit]
[-] cursslk.h [edit]
[-] krad.h [edit]
[+] netrose
[-] ncurses_dll.h [edit]
[+] fontconfig
[-] libsync.h [edit]
[-] err.h [edit]
[-] termcap.h [edit]
[-] jerror.h [edit]
[-] semaphore.h [edit]
[+] glib-2.0
[-] gcrypt-module.h [edit]
[-] obstack.h [edit]
[-] _G_config.h [edit]
[-] luaconf.h [edit]
[-] cursesf.h [edit]
[-] ldap_cdefs.h [edit]
[-] sysexits.h [edit]
[-] envz.h [edit]
[+] harfbuzz
[-] stdint.h [edit]
[-] lber.h [edit]
[+] graphite2
[+] gssrpc
[-] gnu-versions.h [edit]
[+] unicode
[-] cursesm.h [edit]
[-] re_comp.h [edit]
[+] kadm5
[-] printf.h [edit]
[-] gdfontl.h [edit]
[+] arpa
[-] pthread.h [edit]
[-] pcre_scanner.h [edit]
[-] gdfontt.h [edit]
[-] slapi-plugin.h [edit]
[+] uapi
[+] mysql
[+] freetype2
[-] tld.h [edit]
[-] ldif.h [edit]
[-] lualib.h [edit]
[+] libwmf
[-] time.h [edit]
[+] X11
[-] pcrecpp.h [edit]
[+] quota
[+] sys
[-] setjmp.h [edit]
[-] regexp.h [edit]
[-] features.h [edit]
[-] libaio.h [edit]
[-] eti.h [edit]
[-] term.h [edit]
[-] utmpx.h [edit]
[+] gdk-pixbuf-2.0
[-] ar.h [edit]
[-] panel.h [edit]
[-] iconv.h [edit]
[+] ncurses
[-] gd_io.h [edit]
[-] gdbm.h [edit]
[+] uuid
[-] ncurses.h [edit]
[+] librsvg-2.0
[-] fnmatch.h [edit]
[+] c++
[-] stdlib.h [edit]
[-] stringprep.h [edit]
[-] gdcache.h [edit]
[-] tiff.h [edit]
[-] sgtty.h [edit]
[-] pngconf.h [edit]
[-] wctype.h [edit]
[-] ldap_schema.h [edit]
[-] syslog.h [edit]
[-] cursesapp.h [edit]
[-] complex.h [edit]
[+] asm
[-] ifaddrs.h [edit]
[-] ieee754.h [edit]
[-] limits.h [edit]
[-] fstab.h [edit]
[+] krb5
[+] netpacket
[-] libio.h [edit]
[-] lua.h [edit]
[+] misc
[-] poll.h [edit]
[-] values.h [edit]
[+] ghostscript
[+] netipx
[+] netrom
[-] stdio.h [edit]
[-] tiffvers.h [edit]
[+] netiucv
[-] memory.h [edit]
[+] layout
[-] db.h [edit]
[-] alloca.h [edit]
[-] uchar.h [edit]
[-] tiffio.hxx [edit]
[-] tiffconf-64.h [edit]
[-] nc_tparm.h [edit]
[+] netinet
[-] pcrecpparg.h [edit]
[-] aliases.h [edit]
[-] ulimit.h [edit]
[-] verto.h [edit]
[-] tic.h [edit]
[+] python3.6m
[-] lzma.h [edit]
[-] paths.h [edit]
[+] et
[-] idna.h [edit]
[+] cairo
[-] term_entry.h [edit]
[-] fpu_control.h [edit]
[-] profile.h [edit]
[+] ncursesw
[+] KHR
[-] jconfig.h [edit]
[+] sasl
[+] sound
[-] search.h [edit]
[-] fts.h [edit]
[-] termios.h [edit]
[-] ltdl.h [edit]
[-] verto-module.h [edit]
[+] bits
[-] elf.h [edit]
[-] expat.h [edit]
[+] atk-1.0
[-] termio.h [edit]
[-] ustat.h [edit]
[-] nss.h [edit]
[+] apache2
[-] wait.h [edit]
[-] error.h [edit]
[-] ttyent.h [edit]
[-] inttypes.h [edit]
[-] assert.h [edit]
[+] video
[+] python2.7
[-] wordexp.h [edit]
[-] a.out.h [edit]
[-] tgmath.h [edit]
[-] shadow.h [edit]
[-] zconf.h [edit]
[-] ftw.h [edit]
[-] resolv.h [edit]
[-] libintl.h [edit]
[+] fribidi
[-] ldap_features.h [edit]
[-] glob.h [edit]
[+] xcb
[-] curses.h [edit]
[-] gdfonts.h [edit]
[-] tiffio.h [edit]
[-] entities.h [edit]
[+] gtk-unix-print-2.0
[+] asm-generic
[-] argz.h [edit]
[-] lastlog.h [edit]
[-] keyutils.h [edit]
[-] tcpd.h [edit]
[-] gd.h [edit]
[-] ucontext.h [edit]
[+] linux
[-] menu.h [edit]
[+] ext2fs
[-] stab.h [edit]
[-] form.h [edit]
[-] idn-int.h [edit]
[-] langinfo.h [edit]
[+] e2p
[-] libgen.h [edit]
[-] thread_db.h [edit]
[-] signal.h [edit]
[+] netatalk
[-] dlfcn.h [edit]
[-] ldap_utf8.h [edit]
[-] pcre_stringpiece.h [edit]
[-] cpio.h [edit]
[+] glvnd
[+] gail-1.0
[-] gdfx.h [edit]
[-] pty.h [edit]
[+] bind9
[-] gdfontmb.h [edit]
[-] utmp.h [edit]
[+] jasper
[+] libdrm
[-] byteswap.h [edit]
[+] gssapi
[-] fam.h [edit]
[-] pr29.h [edit]
[-] tar.h [edit]
[-] etip.h [edit]
[+] EGL
[+] libdb
[+] ffmpeg
[+] security
[-] link.h [edit]
[-] strings.h [edit]
[-] gettext-po.h [edit]
[+] lzma
[-] lua.hpp [edit]