SysTutorials Posts

pskc_get_key_algparm_chall_max – API function Synopsis #include <pskc.h> uint32_t pskc_get_key_algparm_chall_max(pskc_key_t * key, int * present); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). int * present output variable indicating whether data was provided or not. Description Get the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat Max value. This attribute defines the maximum size of the challenge accepted…

pskc_get_key_algparm_chall_encoding – API function Synopsis #include <pskc.h> pskc_valueformat pskc_get_key_algparm_chall_encoding(pskc_key_t * key, int * present); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). int * present output variable indicating whether data was provided or not. Description Get the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat Encoding value. This attribute defines the encoding of the challenge accepted by…

pskc_get_key_algparm_chall_checkdigits – API function Synopsis #include <pskc.h> int pskc_get_key_algparm_chall_checkdigits(pskc_key_t *key, int *present); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). int * present output variable indicating whether data was provided or not. Description Get the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat CheckDigits value. This attribute indicates whether a device needs to check the appended Luhn…

pskc_get_key_algorithm – API function Synopsis #include <pskc.h> const char *pskc_get_key_algorithm(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage Key Algorithm attribute value. This may be an URN, for example "urn:ietf:params:xml:ns:keyprov:pskc:hotp". Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting Bugs…

pskc_get_id – API function Synopsis #include <pskc.h> const char *pskc_get_id(pskc_t *container); Arguments pskc_t * container a pskc_t handle, from pskc_init(). Description Get the PSKC KeyContainer Id attribute. Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting Bugs Report bugs to <oath-toolkit-help [at] nongnu.org>. libpskc home page: http://www.gnu.org/software/libpskc/…

pskc_get_device_userid – API function Synopsis #include <pskc.h> const char *pskc_get_device_userid(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo Userid value. This indicates the user with whom the device is associated. Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting…

pskc_get_device_startdate – API function Synopsis #include <pskc.h> const struct tm *pskc_get_device_startdate(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo StartDate. This element denote the start date of a device (such as the one on a payment card, used when issue numbers are not printed on cards). Returns…

pskc_get_device_serialno – API function Synopsis #include <pskc.h> const char *pskc_get_device_serialno(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo SerialNo value. This element contains the serial number of the device. Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting Bugs…

pskc_get_device_model – API function Synopsis #include <pskc.h> const char *pskc_get_device_model(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo Model value. This element describes the model of the device (e.g., "one-button-HOTP-token-V1"). Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting…

pskc_get_device_manufacturer – API function Synopsis #include <pskc.h> const char *pskc_get_device_manufacturer(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo Manufacturer value. This element indicates the manufacturer of the device. Returns a constant string (must not be deallocated) holding the content, or NULL if not set. Reporting Bugs Report…

pskc_get_device_issueno – API function Synopsis #include <pskc.h> const char *pskc_get_device_issueno(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo IssueNo value. This element contains the issue number in case there are devices with the same serial number so that they can be distinguished by different issue numbers. Returns…

pskc_get_device_expirydate – API function Synopsis #include <pskc.h> const struct tm *pskc_get_device_expirydate(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo ExpiryDate. This element denote the end date of a device (such as the one on a payment card, used when issue numbers are not printed on cards). Returns…

pskc_get_device_devicebinding – API function Synopsis #include <pskc.h> const char *pskc_get_device_devicebinding(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage DeviceInfo DeviceBinding value. This element allows a provisioning server to ensure that the key is going to be loaded into the device for which the key provisioning request was approved….

pskc_get_cryptomodule_id – API function Synopsis #include <pskc.h> const char *pskc_get_cryptomodule_id(pskc_key_t *key); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). Description Get the PSKC KeyPackage CryptoModule Id value. This element carries a unique identifier for the CryptoModule and is implementation specific. As such, it helps to identify a specific CryptoModule to which the key is…

pskc_free – API function Synopsis #include <pskc.h> void pskc_free(void *ptr); Arguments void * ptr memory region to deallocate, or NULL. Description Deallocates memory region by calling free(). If ptr is NULL no operation is performed. This function is necessary on Windows, where different parts of the same application may use different memory heaps. Reporting Bugs…

pskc_done – API function Synopsis #include <pskc.h> void pskc_done(pskc_t *container); Arguments pskc_t * container a pskc_t handle, from pskc_init(). Description This function releases the resources associated with the PSKC container handle. Reporting Bugs Report bugs to <oath-toolkit-help [at] nongnu.org>. libpskc home page: http://www.gnu.org/software/libpskc/ General help using GNU software: http://www.gnu.org/gethelp/ Copyright Copyright © 2012 Simon Josefsson….

pskc_check_version – API function Synopsis #include <pskc.h> const char *pskc_check_version(const char *req_version); Arguments const char * req_version version string to compare with, or NULL. Description Check PSKC library version. See PSKC_VERSION for a suitable req_version string. This function is one of few in the library that can be used without a successful call to pskc_global_init()….

pskc_build_xml – API function Synopsis #include <pskc.h> int pskc_build_xml(pskc_t *container, char **out, size_t *len); Arguments pskc_t * container a pskc_t handle, from pskc_init(). char ** out pointer to output variable to hold newly allocated string. size_t * len output variable holding length of *out. Description This function builds a XML file from the data in…

pskc_add_keypackage – API function Synopsis #include <pskc.h> int pskc_add_keypackage(pskc_t *container, pskc_key_t **key); Arguments pskc_t * container a pskc_t handle, from pskc_init(). pskc_key_t ** key pointer to pskc_key_t key package handle. Description Add a new a PSKC keypackage to the container and give back a pskc_key_t handle. Returns PSKC_MALLOC_ERROR on memory allocation errors, or PSKC_OK on…

psignal, psiginfo – print signal description Synopsis #include <signal.h> void psignal(int sig, const char *s); void psiginfo(const siginfo_t *pinfo, const char *s); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): psignal():     Since glibc 2.19:         _DEFAULT_SOURCE     Glibc 2.19 and earlier:         _BSD_SOURCE || _SVID_SOURCE psiginfo(): _POSIX_C_SOURCE >= 200809L Description The psignal() function displays a message on stderr consisting of the…