Section 3: library functions
keyctl_revoke – Revoke a key Synopsis#include <keyutils.h> long keyctl_revoke(key_serial_t key);Descriptionkeyctl_revoke() marks a key as being revoked. After this operation has been performed on a key, attempts to access it will meet with error EKEYREVOKED. The caller must have write permission on a key to be able revoke it. Return ValueOn success keyctl_revoke() returns 0. On…
keyctl_read – Read a key Synopsis#include <keyutils.h> long keyctl_read(key_serial_t key, char *buffer, size_tbuflen); long keyctl_read_alloc(key_serial_t key, void **_buffer);Descriptionkeyctl_read() reads the payload of a key if the key type supports it. The caller must have read permission on a key to be able to read it. buffer and buflen specify the buffer into which the payload…
keyctl_link – Link a key to a keyring keyctl_unlink – Unlink a key from a keyring Synopsis#include <keyutils.h> long keyctl_link(key_serial_t key, key_serial_t keyring); long keyctl_unlink(key_serial_t key, key_serial_t keyring);Descriptionkeyctl_link() creates a link from keyring to key, displacing any link to another key of the same type and description in that keyring if one exists. keyctl_unlink() removes…
keyctl_join_session_keyring – Join a different session keyring Synopsis#include <keyutils.h> key_serial_t keyctl_join_session_keyring(const char *name);Descriptionkeyctl_join_session_keyring() changes the session keyring to which a process is subscribed. If name is NULL then a new anonymous keyring will be created, and the process will be subscribed to that. If name points to a string, then if a keyring of that…
keyctl_invalidate – Invalidate a key Synopsis#include <keyutils.h> long keyctl_invalidate(key_serial_t key);Descriptionkeyctl_invalidate() invalidates a key. The key is scheduled for immediate removal from all the keyrings that point to it, after which it will be deleted. The key will be ignored by all searches once this function is called even if it is not yet fully dealt…
keyctl_assume_authority – Assume the authority to instantiate a key keyctl_instantiate – Instantiate a key from flat data keyctl_instantiate_iov – Instantiate a key from segmented data keyctl_reject – Negatively instantiate a key specifying search error keyctl_negate – Negatively instantiate a key Synopsis#include <keyutils.h> long keyctl_assume_authority(key_serial_t key); long keyctl_instantiate(key_serial_t key, const void *payload, size_t plen, key_serial_t keyring);…
keyctl_get_security – Retrieve a key’s security context Synopsis#include <keyutils.h> long keyctl_get_security(key_serial_t key, char *buffer, size_t buflen); long keyctl_get_security_alloc(key_serial_t key, char **_buffer);Descriptionkeyctl_get_security() retrieves the security context of a key as a NUL-terminated string. This will be rendered in a form appropriate to the LSM in force – for instance, with SELinux, it may look like unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023…
keyctl_get_persistent – Get the persistent keyring for a user Synopsis#include <keyutils.h> long keyctl_get_persistent(uid_t uid, key_serial_t keyring);Descriptionkeyctl_get_persistent() gets the persistent keyring for the specified user ID. Unlike the session and user keyrings, this keyring will persist once all login sessions have been deleted and can thus be used to carry authentication tokens for processes that run…
keyctl_get_keyring_ID – Get the ID of a special keyring Synopsis#include <keyutils.h> key_serial_t keyctl_get_keyring_ID(key_serial_t key, int create);Descriptionkeyctl_get_keyring_ID() maps a special key or keyring ID to the serial number of the key actually representing that feature. The serial number will be returned if that key exists. If the key or keyring does not yet exist, then if…
keyctl_describe – Describe a key Synopsis#include <keyutils.h> long keyctl_describe(key_serial_t key, char *buffer, size_tbuflen); long keyctl_describe_alloc(key_serial_t key, char **_buffer);Descriptionkeyctl_describe() describes the attributes of a key as a NUL-terminated string. The caller must have view permission on a key to be able to get a description of it. buffer and buflen specify the buffer into which the…
keyctl_clear – Clear a keyring Synopsis#include <keyutils.h> long keyctl_clear(key_serial_t keyring);Descriptionkeyctl_clear() clears the contents of a keyring. The caller must have write permission on a keyring to be able clear it. Return ValueOn success keyctl_clear() returns 0. On error, the value -1 will be returned and errno will have been set to an appropriate error. ErrorsENOKEY…
keyctl_chown – Change the ownership of a key Synopsis#include <keyutils.h> long keyctl_chown(key_serial_t key, uid_t uid, gid_t gid);Descriptionkeyctl_chown() changes the user and group ownership details of a key. A setting of -1 on either uid or gid will cause that setting to be ignored. A process that does not have the SysAdmin capability may not change…
keyctl_*() – Key management function wrappers DescriptionThe keyctl() system call is a multiplexor for a number of key management functions. These should be called via the wrappers in the libkeyutils library. The functions can be compiled in by including the keyutils header file: #include <keyutils.h> and then telling the linker it should link in the…
keyboard_ucallback – User specified unicode keyboard callback handler. Allegro game programming library. Synopsis#include <allegro.h> extern int (*keyboard_ucallback)(int key, int *scancode); DescriptionUnicode-aware version of keyboard_callback(). If set, this function is called by the keyboard handler in response to every keypress. It is passed the character value and scancode that are about to be added into the…
keyboard_lowlevel_callback – User specified low level keyboard event handler. Allegro game programming library. Synopsis#include <allegro.h> extern void (*keyboard_lowlevel_callback)(int scancode); DescriptionIf set, this function is called by the keyboard handler in response to every keyboard event, both presses (including keyboard repeat rate) and releases. It will be passed a raw keyboard scancode byte (scancodes are 7…
keyboard_callback – User specified keyboard callback handler. Allegro game programming library. Synopsis#include <allegro.h> extern int (*keyboard_callback)(int key); DescriptionIf set, this function is called by the keyboard handler in response to every keypress. It is passed a copy of the value that is about to be added into the input buffer, and can either return this…
QuantLib::TimeSeries – Container for historical data. Synopsis#include <ql/timeseries.hpp> Public Typestypedef Date key_type typedef T value_type Public Member FunctionsTimeSeries () template<class DateIterator , class ValueIterator > TimeSeries (DateIterator dBegin, DateIterator dEnd, ValueIterator vBegin) template<class ValueIterator > TimeSeries (const Date &firstDate, ValueIterator begin, ValueIterator end) Inspectors Date firstDate () const returns the first date for which a…
key_shifts – Bitmask containing the current state of modifier keys. Allegro game programming library. Synopsis#include <allegro.h> extern volatile int key_shifts; DescriptionBitmask containing the current state of shift/ctrl/alt, the special Windows keys, and the accent escape characters. Wherever possible this value will be updated asynchronously, but if keyboard_needs_poll() returns TRUE, you must manually call poll_keyboard() to…
key_decryptsession, key_encryptsession, key_setsecret, key_gendes, key_secretkey_is_set – interfaces to rpc keyserver daemon Synopsis#include <rpc/rpc.h> int key_decryptsession(char *remotename, des_block *deskey); int key_encryptsession(char *remotename, des_block *deskey); int key_gendes(des_block *deskey); int key_setsecret(char *key); int key_secretkey_is_set(void); DescriptionThe functions here are used within the RPC’s secure authentication mechanism (AUTH_DES). There should be no need for user programs to use this functions….
key_decryptsession, key_encryptsession, key_setsecret, key_gendes, key_secretkey_is_set – interfaces to rpc keyserver daemon Synopsis#include <rpc/rpc.h> int key_decryptsession(char *remotename, des_block *deskey); int key_encryptsession(char *remotename, des_block *deskey); int key_gendes(des_block *deskey); int key_setsecret(char *key); int key_secretkey_is_set(void); DescriptionThe functions here are used within the RPC’s secure authentication mechanism (AUTH_DES). There should be no need for user programs to use this functions….