Linux Manuals session 3

pskc_set_key_algparm_resp_checkdigits – API function Synopsis #include <pskc.h> void pskc_set_key_algparm_resp_checkdigits(pskc_key_t *key, int checkdigit); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). int checkdigit non-zero to indicate setting true CheckDigit, 0 otherwise. Description Set the PSKC KeyPackage Key AlgorithmParameters ResponseFormat CheckDigits value. This attribute indicates whether the device needs to append a Luhn check digit, as…

pskc_set_key_algparm_chall_min – API function Synopsis #include <pskc.h> void pskc_set_key_algparm_chall_min(pskc_key_t *key, uint32_t challmin); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). uint32_t challmin the minimum challenge length to set. Description Set the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat Min value. This attribute defines the minimum size of the challenge accepted by the device for CR mode…

pskc_set_key_algparm_chall_max – API function Synopsis #include <pskc.h> void pskc_set_key_algparm_chall_max(pskc_key_t *key, uint32_t challmax); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). uint32_t challmax the maximum challenge length to set. Description Set the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat Max value. This attribute defines the maximum size of the challenge accepted by the device for CR mode…

pskc_set_key_algparm_chall_encoding – API function Synopsis #include <pskc.h> void pskc_set_key_algparm_chall_encoding(pskc_key_t *key, pskc_valueformat vf); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). pskc_valueformat vf the pskc_valueformat encoding type to set. Description Set the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat Encoding value. This attribute defines the encoding of the challenge accepted by the device. Since 2.2.0 Reporting Bugs…

pskc_set_key_algparm_chall_checkdigits – API function Synopsis #include <pskc.h> void pskc_set_key_algparm_chall_checkdigits(pskc_key_t *key, int checkdigit); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). int checkdigit non-zero to indicate setting true CheckDigit, 0 otherwise. Description Set the PSKC KeyPackage Key AlgorithmParameters ChallengeFormat CheckDigits value. This attribute indicates whether a device needs to check the appended Luhn check digit,…

pskc_set_key_algorithm – API function Synopsis #include <pskc.h> void pskc_set_key_algorithm(pskc_key_t *key, const char *keyalg); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const char * keyalg the key algorithm string to set. Description Set the PSKC KeyPackage Key Algorithm attribute value. This may be an URN, for example "urn:ietf:params:xml:ns:keyprov:pskc:hotp". The pointer is stored in container,…

pskc_set_id – API function Synopsis #include <pskc.h> void pskc_set_id(pskc_t *container, const char *id); Arguments pskc_t * container a pskc_t handle, from pskc_init(). const char * id pointer to id string to set. Description Set the PSKC KeyContainer Id attribute. The pointer is stored in container, not a copy of the data, so you must not…

pskc_set_device_userid – API function Synopsis #include <pskc.h> void pskc_set_device_userid(pskc_key_t *key, const char *userid); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const char * userid a string with user identity to set. Description Set the PSKC KeyPackage DeviceInfo Userid value. This indicates the user with whom the device is associated. The pointer is stored…

pskc_set_device_startdate – API function Synopsis #include <pskc.h> void pskc_set_device_startdate(pskc_key_t *key, const struct tm *startdate); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const struct tm * startdate pointer to a tm struct with device starting date to set. Description Set the PSKC KeyPackage DeviceInfo StartDate. This element denote the start date of a device…

pskc_set_device_serialno – API function Synopsis #include <pskc.h> void pskc_set_device_serialno(pskc_key_t *key, const char *serialno); Arguments pskc_key_t * key a pskc_key_t handle from, e.g., pskc_add_keypackage(). const char * serialno string with serial number to set. Description Set the PSKC KeyPackage DeviceInfo SerialNo value. This element indicates the serial number of the device. The pointer is stored in…

pskc_set_device_model – API function Synopsis #include <pskc.h> void pskc_set_device_model(pskc_key_t *key, const char *model); Arguments pskc_key_t * key a pskc_key_t handle from, e.g., pskc_add_keypackage(). const char * model a string with model name to set. Description Set the PSKC KeyPackage DeviceInfo Model value. This element describes the model of the device (e.g., "one-button-HOTP-token-V1"). The pointer is…

pskc_set_device_manufacturer – API function Synopsis #include <pskc.h> void pskc_set_device_manufacturer(pskc_key_t *key, const char *devmfr); Arguments pskc_key_t * key a pskc_key_t handle from, e.g., pskc_add_keypackage(). const char * devmfr string with device manufacturer name to set. Description Set the PSKC KeyPackage DeviceInfo Manufacturer value. This element indicates the manufacturer of the device. The pointer is stored in…

pskc_set_device_issueno – API function Synopsis #include <pskc.h> void pskc_set_device_issueno(pskc_key_t *key, const char *issueno); Arguments pskc_key_t * key a pskc_key_t handle from, e.g., pskc_add_keypackage(). const char * issueno a string with issue number to set. Description Set the PSKC KeyPackage DeviceInfo IssueNo value. This element contains the issue number in case there are devices with the…

pskc_set_device_expirydate – API function Synopsis #include <pskc.h> void pskc_set_device_expirydate(pskc_key_t *key, const struct tm *expirydate); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const struct tm * expirydate pointer to a tm struct with device expiry date to set. Description Set the PSKC KeyPackage DeviceInfo ExpiryDate. This element denote the end date of a device…

pskc_set_device_devicebinding – API function Synopsis #include <pskc.h> void pskc_set_device_devicebinding(pskc_key_t *key, const char *devbind); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const char * devbind a string with device binding to set. Description Set the PSKC KeyPackage DeviceInfo DeviceBinding value. This element allows a provisioning server to ensure that the key is going to…

pskc_set_cryptomodule_id – API function Synopsis #include <pskc.h> void pskc_set_cryptomodule_id(pskc_key_t *key, const char *cid); Arguments pskc_key_t * key a pskc_key_t handle, from pskc_get_keypackage(). const char * cid the cryptomodule id to set Description Set the PSKC KeyPackage CryptoModule Id value. This element carries a unique identifier for the CryptoModule and is implementation specific. As such, it…

pskc_pinusagemode2str – API function Synopsis #include <pskc.h> const char *pskc_pinusagemode2str(pskc_pinusagemode pinusagemode); Arguments pskc_pinusagemode pinusagemode an pskc_pinusagemode enumeration type Description Convert pskc_pinusagemode to a string. For example, pskc_pinusagemode2str(PSKC_PINUSAGEMODE_LOCAL) will return "Local". The returned string must not be deallocated. Returns String corresponding to pskc_pinusagemode. Reporting Bugs Report bugs to <oath-toolkit-help [at] nongnu.org>. libpskc home page: http://www.gnu.org/software/libpskc/ General…

pskc_parse_from_memory – API function Synopsis #include <pskc.h> int pskc_parse_from_memory(pskc_t *container, size_t len, const char *buffer); Arguments pskc_t * container a pskc_t handle, from pskc_init(). size_t len length of buffer. const char * buffer XML data to parse. Description This function will parse the XML data in buffer of len size into container. If PSKC_PARSE_ERROR is…

pskc_output – API function Synopsis #include <pskc.h> int pskc_output(pskc_t *container, pskc_output_formats_t format, char **out, size_t *len); Arguments pskc_t * container a pskc_t handle, from pskc_init(). pskc_output_formats_t format an pskc_output_formats_t enumeration type indicating format. char ** out pointer to output variable holding newly allocated string. size_t * len pointer to output variable hold length of *out….

pskc_keyusage2str – API function Synopsis #include <pskc.h> const char *pskc_keyusage2str(pskc_keyusage keyusage); Arguments pskc_keyusage keyusage an pskc_keyusage enumeration type Description Convert pskc_keyusage to a string. For example, pskc_keyusage2str(PSKC_KEYUSAGE_OTP) will return "OTP". The returned string must not be deallocated. Returns String corresponding to pskc_keyusage. Reporting Bugs Report bugs to <oath-toolkit-help [at] nongnu.org>. libpskc home page: http://www.gnu.org/software/libpskc/ General…