From 483ec7256d6c4d01ba6c41513fdf8bbd7df6b4b3 Mon Sep 17 00:00:00 2001 From: Robin Krahl Date: Sun, 20 Sep 2020 04:46:26 +0200 Subject: Re-generate bindings in src/ffi.rs Older versions of bindgen rendered C++ doc comments as Rust doc comments using the /// syntax. Newer versions use the doc attribute instead. This patch re-generates the src/ffi.rs file with bindgen 0.55.1 so that it uses the new format. This makes it easier to perform changes in the future. --- patches/deprecated.diff | 8 +- patches/remove-uint.diff | 6 +- src/ffi.rs | 834 +++++++++++++++++++++++------------------------ 3 files changed, 424 insertions(+), 424 deletions(-) diff --git a/patches/deprecated.diff b/patches/deprecated.diff index dff4b55..a7d2359 100644 --- a/patches/deprecated.diff +++ b/patches/deprecated.diff @@ -6,10 +6,10 @@ Index: nitrokey-sys-rs/src/ffi.rs =================================================================== --- nitrokey-sys-rs.orig/src/ffi.rs +++ nitrokey-sys-rs/src/ffi.rs -@@ -763,6 +763,7 @@ extern "C" { - /// deprecated in favor of NK_get_status_as_string. - /// @return string representation of the status or an empty string - /// if the command failed +@@ -762,6 +762,7 @@ extern "C" { + #[doc = " deprecated in favor of NK_get_status_as_string."] + #[doc = " @return string representation of the status or an empty string"] + #[doc = " if the command failed"] + #[deprecated(since = "3.5.0", note="use `NK_get_status_as_string` instead")] pub fn NK_status() -> *mut ::std::os::raw::c_char; } diff --git a/patches/remove-uint.diff b/patches/remove-uint.diff index 2db1d95..e4c24ba 100644 --- a/patches/remove-uint.diff +++ b/patches/remove-uint.diff @@ -10,12 +10,12 @@ Index: nitrokey-sys-rs/src/ffi.rs --- nitrokey-sys-rs.orig/src/ffi.rs +++ nitrokey-sys-rs/src/ffi.rs @@ -1,9 +1,5 @@ - /* automatically generated by rust-bindgen */ + /* automatically generated by rust-bindgen 0.55.1 */ -pub type __uint8_t = ::std::os::raw::c_uchar; -pub type __uint16_t = ::std::os::raw::c_ushort; -pub type __uint32_t = ::std::os::raw::c_uint; -pub type __uint64_t = ::std::os::raw::c_ulong; extern "C" { - #[link_name = "\u{1}NK_PWS_SLOT_COUNT"] - pub static mut NK_PWS_SLOT_COUNT: u8; + pub static NK_PWS_SLOT_COUNT: u8; + } diff --git a/src/ffi.rs b/src/ffi.rs index 799e5bc..810660f 100644 --- a/src/ffi.rs +++ b/src/ffi.rs @@ -1,30 +1,29 @@ -/* automatically generated by rust-bindgen */ +/* automatically generated by rust-bindgen 0.55.1 */ extern "C" { - #[link_name = "\u{1}NK_PWS_SLOT_COUNT"] - pub static mut NK_PWS_SLOT_COUNT: u8; + pub static NK_PWS_SLOT_COUNT: u8; } pub const MAXIMUM_STR_REPLY_LENGTH: ::std::os::raw::c_int = 8192; -/// Use, if no supported device is connected +#[doc = " Use, if no supported device is connected"] pub const NK_device_model_NK_DISCONNECTED: NK_device_model = 0; -/// Nitrokey Pro. +#[doc = " Nitrokey Pro."] pub const NK_device_model_NK_PRO: NK_device_model = 1; -/// Nitrokey Storage. +#[doc = " Nitrokey Storage."] pub const NK_device_model_NK_STORAGE: NK_device_model = 2; -/// The Nitrokey device models supported by the API. -pub type NK_device_model = u32; -/// The connection info for a Nitrokey device as a linked list. +#[doc = " The Nitrokey device models supported by the API."] +pub type NK_device_model = ::std::os::raw::c_uint; +#[doc = " The connection info for a Nitrokey device as a linked list."] #[repr(C)] #[derive(Debug, Copy, Clone)] pub struct NK_device_info { - /// The model of the Nitrokey device. + #[doc = " The model of the Nitrokey device."] pub model: NK_device_model, - /// The USB device path for NK_connect_with_path. + #[doc = " The USB device path for NK_connect_with_path."] pub path: *mut ::std::os::raw::c_char, - /// The serial number. + #[doc = " The serial number."] pub serial_number: *mut ::std::os::raw::c_char, - /// The pointer to the next element of the linked list or null - /// if this is the last element in the list. + #[doc = " The pointer to the next element of the linked list or null"] + #[doc = " if this is the last element in the list."] pub next: *mut NK_device_info, } #[test] @@ -80,30 +79,30 @@ fn bindgen_test_layout_NK_device_info() { ) ); } -/// Stores the common device status for all Nitrokey devices. +#[doc = " Stores the common device status for all Nitrokey devices."] #[repr(C)] #[derive(Debug, Copy, Clone)] pub struct NK_status { - /// The major firmware version, e. g. 0 in v0.40. + #[doc = " The major firmware version, e. g. 0 in v0.40."] pub firmware_version_major: u8, - /// The minor firmware version, e. g. 40 in v0.40. + #[doc = " The minor firmware version, e. g. 40 in v0.40."] pub firmware_version_minor: u8, - /// The serial number of the smart card. + #[doc = " The serial number of the smart card."] pub serial_number_smart_card: u32, - /// The HOTP slot to generate a password from if the numlock - /// key is pressed twice (slot 0-1, or any other value to - /// disable the function). + #[doc = " The HOTP slot to generate a password from if the numlock"] + #[doc = " key is pressed twice (slot 0-1, or any other value to"] + #[doc = " disable the function)."] pub config_numlock: u8, - /// The HOTP slot to generate a password from if the capslock - /// key is pressed twice (slot 0-1, or any other value to - /// disable the function). + #[doc = " The HOTP slot to generate a password from if the capslock"] + #[doc = " key is pressed twice (slot 0-1, or any other value to"] + #[doc = " disable the function)."] pub config_capslock: u8, - /// The HOTP slot to generate a password from if the scrolllock - /// key is pressed twice (slot 0-1, or any other value to - /// disable the function). + #[doc = " The HOTP slot to generate a password from if the scrolllock"] + #[doc = " key is pressed twice (slot 0-1, or any other value to"] + #[doc = " disable the function)."] pub config_scrolllock: u8, - /// Indicates whether the user password is required to generate - /// an OTP value. + #[doc = " Indicates whether the user password is required to generate"] + #[doc = " an OTP value."] pub otp_user_password: bool, } #[test] @@ -195,42 +194,42 @@ fn bindgen_test_layout_NK_status() { ) ); } -/// Stores the status of a Storage device. +#[doc = " Stores the status of a Storage device."] #[repr(C)] #[derive(Debug, Copy, Clone)] pub struct NK_storage_status { - /// Indicates whether the unencrypted volume is read-only. + #[doc = " Indicates whether the unencrypted volume is read-only."] pub unencrypted_volume_read_only: bool, - /// Indicates whether the unencrypted volume is active. + #[doc = " Indicates whether the unencrypted volume is active."] pub unencrypted_volume_active: bool, - /// Indicates whether the encrypted volume is read-only. + #[doc = " Indicates whether the encrypted volume is read-only."] pub encrypted_volume_read_only: bool, - /// Indicates whether the encrypted volume is active. + #[doc = " Indicates whether the encrypted volume is active."] pub encrypted_volume_active: bool, - /// Indicates whether the hidden volume is read-only. + #[doc = " Indicates whether the hidden volume is read-only."] pub hidden_volume_read_only: bool, - /// Indicates whether the hidden volume is active. + #[doc = " Indicates whether the hidden volume is active."] pub hidden_volume_active: bool, - /// The major firmware version, e. g. 0 in v0.40. + #[doc = " The major firmware version, e. g. 0 in v0.40."] pub firmware_version_major: u8, - /// The minor firmware version, e. g. 40 in v0.40. + #[doc = " The minor firmware version, e. g. 40 in v0.40."] pub firmware_version_minor: u8, - /// Indicates whether the firmware is locked. + #[doc = " Indicates whether the firmware is locked."] pub firmware_locked: bool, - /// The serial number of the SD card in the Storage stick. + #[doc = " The serial number of the SD card in the Storage stick."] pub serial_number_sd_card: u32, - /// The serial number of the smart card in the Storage stick. + #[doc = " The serial number of the smart card in the Storage stick."] pub serial_number_smart_card: u32, - /// The number of remaining login attempts for the user PIN. + #[doc = " The number of remaining login attempts for the user PIN."] pub user_retry_count: u8, - /// The number of remaining login attempts for the admin PIN. + #[doc = " The number of remaining login attempts for the admin PIN."] pub admin_retry_count: u8, - /// Indicates whether a new SD card was found. + #[doc = " Indicates whether a new SD card was found."] pub new_sd_card_found: bool, - /// Indicates whether the SD card is filled with random characters. + #[doc = " Indicates whether the SD card is filled with random characters."] pub filled_with_random: bool, - /// Indicates whether the stick has been initialized by generating - /// the AES keys. + #[doc = " Indicates whether the stick has been initialized by generating"] + #[doc = " the AES keys."] pub stick_initialized: bool, } #[test] @@ -446,15 +445,15 @@ fn bindgen_test_layout_NK_storage_status() { ) ); } -/// Data about the usage of the SD card. +#[doc = " Data about the usage of the SD card."] #[repr(C)] #[derive(Debug, Copy, Clone)] pub struct NK_SD_usage_data { - /// The minimum write level, as a percentage of the total card - /// size. + #[doc = " The minimum write level, as a percentage of the total card"] + #[doc = " size."] pub write_level_min: u8, - /// The maximum write level, as a percentage of the total card - /// size. + #[doc = " The maximum write level, as a percentage of the total card"] + #[doc = " size."] pub write_level_max: u8, } #[test] @@ -698,155 +697,155 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Set debug level of messages written on stderr - /// @param state state=True - most messages, state=False - only errors level + #[doc = " Set debug level of messages written on stderr"] + #[doc = " @param state state=True - most messages, state=False - only errors level"] pub fn NK_set_debug(state: bool); } extern "C" { - /// Set debug level of messages written on stderr - /// @param level (int) 0-lowest verbosity, 5-highest verbosity + #[doc = " Set debug level of messages written on stderr"] + #[doc = " @param level (int) 0-lowest verbosity, 5-highest verbosity"] pub fn NK_set_debug_level(level: ::std::os::raw::c_int); } extern "C" { - /// Get the major library version, e. g. the 3 in v3.2. - /// @return the major library version + #[doc = " Get the major library version, e. g. the 3 in v3.2."] + #[doc = " @return the major library version"] pub fn NK_get_major_library_version() -> ::std::os::raw::c_uint; } extern "C" { - /// Get the minor library version, e. g. the 2 in v3.2. - /// @return the minor library version + #[doc = " Get the minor library version, e. g. the 2 in v3.2."] + #[doc = " @return the minor library version"] pub fn NK_get_minor_library_version() -> ::std::os::raw::c_uint; } extern "C" { - /// Get the library version as a string. This is the output of - /// `git describe --always` at compile time, for example "v3.3" or - /// "v3.3-19-gaee920b". - /// The return value is a string literal and must not be freed. - /// @return the library version as a string + #[doc = " Get the library version as a string. This is the output of"] + #[doc = " `git describe --always` at compile time, for example \"v3.3\" or"] + #[doc = " \"v3.3-19-gaee920b\"."] + #[doc = " The return value is a string literal and must not be freed."] + #[doc = " @return the library version as a string"] pub fn NK_get_library_version() -> *const ::std::os::raw::c_char; } extern "C" { - /// Connect to device of given model. Currently library can be connected only to one device at once. - /// @param device_model char 'S': Nitrokey Storage, 'P': Nitrokey Pro - /// @return 1 if connected, 0 if wrong model or cannot connect + #[doc = " Connect to device of given model. Currently library can be connected only to one device at once."] + #[doc = " @param device_model char 'S': Nitrokey Storage, 'P': Nitrokey Pro"] + #[doc = " @return 1 if connected, 0 if wrong model or cannot connect"] pub fn NK_login(device_model: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Connect to device of given model. Currently library can be connected only to one device at once. - /// @param device_model NK_device_model: NK_PRO: Nitrokey Pro, NK_STORAGE: Nitrokey Storage - /// @return 1 if connected, 0 if wrong model or cannot connect + #[doc = " Connect to device of given model. Currently library can be connected only to one device at once."] + #[doc = " @param device_model NK_device_model: NK_PRO: Nitrokey Pro, NK_STORAGE: Nitrokey Storage"] + #[doc = " @return 1 if connected, 0 if wrong model or cannot connect"] pub fn NK_login_enum(device_model: NK_device_model) -> ::std::os::raw::c_int; } extern "C" { - /// Connect to first available device, starting checking from Pro 1st to Storage 2nd. - /// @return 1 if connected, 0 if wrong model or cannot connect + #[doc = " Connect to first available device, starting checking from Pro 1st to Storage 2nd."] + #[doc = " @return 1 if connected, 0 if wrong model or cannot connect"] pub fn NK_login_auto() -> ::std::os::raw::c_int; } extern "C" { - /// Disconnect from the device. - /// @return command processing error code + #[doc = " Disconnect from the device."] + #[doc = " @return command processing error code"] pub fn NK_logout() -> ::std::os::raw::c_int; } extern "C" { - /// Query the model of the connected device. - /// Returns the model of the connected device or NK_DISCONNECTED. - /// - /// @return true if a device is connected and the out argument has been set + #[doc = " Query the model of the connected device."] + #[doc = " Returns the model of the connected device or NK_DISCONNECTED."] + #[doc = ""] + #[doc = " @return true if a device is connected and the out argument has been set"] pub fn NK_get_device_model() -> NK_device_model; } extern "C" { - /// Return the debug status string. Debug purposes. This function is - /// deprecated in favor of NK_get_status_as_string. - /// @return string representation of the status or an empty string - /// if the command failed + #[doc = " Return the debug status string. Debug purposes. This function is"] + #[doc = " deprecated in favor of NK_get_status_as_string."] + #[doc = " @return string representation of the status or an empty string"] + #[doc = " if the command failed"] #[deprecated(since = "3.5.0", note="use `NK_get_status_as_string` instead")] pub fn NK_status() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Return the debug status string. Debug purposes. - /// @return string representation of the status or an empty string - /// if the command failed + #[doc = " Return the debug status string. Debug purposes."] + #[doc = " @return string representation of the status or an empty string"] + #[doc = " if the command failed"] pub fn NK_get_status_as_string() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get the stick status common to all Nitrokey devices and return the - /// command processing error code. If the code is zero, i. e. the - /// command was successful, the storage status is written to the output - /// pointer's target. The output pointer must not be null. - /// - /// @param out the output pointer for the status - /// @return command processing error code + #[doc = " Get the stick status common to all Nitrokey devices and return the"] + #[doc = " command processing error code. If the code is zero, i. e. the"] + #[doc = " command was successful, the storage status is written to the output"] + #[doc = " pointer's target. The output pointer must not be null."] + #[doc = ""] + #[doc = " @param out the output pointer for the status"] + #[doc = " @return command processing error code"] pub fn NK_get_status(out: *mut NK_status) -> ::std::os::raw::c_int; } extern "C" { - /// Return the device's serial number string in hex. - /// @return string device's serial number in hex + #[doc = " Return the device's serial number string in hex."] + #[doc = " @return string device's serial number in hex"] pub fn NK_device_serial_number() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get last command processing status. Useful for commands which returns the results of their own and could not return - /// an error code. - /// @return previous command processing error code + #[doc = " Get last command processing status. Useful for commands which returns the results of their own and could not return"] + #[doc = " an error code."] + #[doc = " @return previous command processing error code"] pub fn NK_get_last_command_status() -> u8; } extern "C" { - /// Lock device - cancel any user device unlocking. - /// @return command processing error code + #[doc = " Lock device - cancel any user device unlocking."] + #[doc = " @return command processing error code"] pub fn NK_lock_device() -> ::std::os::raw::c_int; } extern "C" { - /// Authenticates the user on USER privilages with user_password and sets user's temporary password on device to user_temporary_password. - /// @param user_password char[25] current user password - /// @param user_temporary_password char[25] user temporary password to be set on device for further communication (authentication command) - /// @return command processing error code + #[doc = " Authenticates the user on USER privilages with user_password and sets user's temporary password on device to user_temporary_password."] + #[doc = " @param user_password char[25] current user password"] + #[doc = " @param user_temporary_password char[25] user temporary password to be set on device for further communication (authentication command)"] + #[doc = " @return command processing error code"] pub fn NK_user_authenticate( user_password: *const ::std::os::raw::c_char, user_temporary_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Authenticates the user on ADMIN privilages with admin_password and sets user's temporary password on device to admin_temporary_password. - /// @param admin_password char[25] current administrator PIN - /// @param admin_temporary_password char[25] admin temporary password to be set on device for further communication (authentication command) - /// @return command processing error code + #[doc = " Authenticates the user on ADMIN privilages with admin_password and sets user's temporary password on device to admin_temporary_password."] + #[doc = " @param admin_password char[25] current administrator PIN"] + #[doc = " @param admin_temporary_password char[25] admin temporary password to be set on device for further communication (authentication command)"] + #[doc = " @return command processing error code"] pub fn NK_first_authenticate( admin_password: *const ::std::os::raw::c_char, admin_temporary_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Execute a factory reset. - /// @param admin_password char[20] current administrator PIN - /// @return command processing error code + #[doc = " Execute a factory reset."] + #[doc = " @param admin_password char[20] current administrator PIN"] + #[doc = " @return command processing error code"] pub fn NK_factory_reset(admin_password: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Generates AES key on the device - /// @param admin_password char[20] current administrator PIN - /// @return command processing error code + #[doc = " Generates AES key on the device"] + #[doc = " @param admin_password char[20] current administrator PIN"] + #[doc = " @return command processing error code"] pub fn NK_build_aes_key(admin_password: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Unlock user PIN locked after 3 incorrect codes tries. - /// @param admin_password char[20] current administrator PIN - /// @return command processing error code + #[doc = " Unlock user PIN locked after 3 incorrect codes tries."] + #[doc = " @param admin_password char[20] current administrator PIN"] + #[doc = " @return command processing error code"] pub fn NK_unlock_user_password( admin_password: *const ::std::os::raw::c_char, new_user_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Write general config to the device - /// @param numlock set value in range [0-1] to send HOTP code from slot 'numlock' after double pressing numlock - /// or outside the range to disable this function - /// @param capslock similar to numlock but with capslock - /// @param scrolllock similar to numlock but with scrolllock - /// @param enable_user_password set True to enable OTP PIN protection (require PIN each OTP code request) - /// @param delete_user_password (unused) - /// @param admin_temporary_password current admin temporary password - /// @return command processing error code + #[doc = " Write general config to the device"] + #[doc = " @param numlock set value in range [0-1] to send HOTP code from slot 'numlock' after double pressing numlock"] + #[doc = " or outside the range to disable this function"] + #[doc = " @param capslock similar to numlock but with capslock"] + #[doc = " @param scrolllock similar to numlock but with scrolllock"] + #[doc = " @param enable_user_password set True to enable OTP PIN protection (require PIN each OTP code request)"] + #[doc = " @param delete_user_password (unused)"] + #[doc = " @param admin_temporary_password current admin temporary password"] + #[doc = " @return command processing error code"] pub fn NK_write_config( numlock: u8, capslock: u8, @@ -857,60 +856,61 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Get currently set config - status of function Numlock/Capslock/Scrollock OTP sending and is enabled PIN protected OTP - /// @see NK_write_config - /// @return uint8_t general_config[5]: - /// uint8_t numlock; - /// uint8_t capslock; - /// uint8_t scrolllock; - /// uint8_t enable_user_password; - /// uint8_t delete_user_password; + #[doc = " Get currently set config - status of function Numlock/Capslock/Scrollock OTP sending and is enabled PIN protected OTP"] + #[doc = " @see NK_write_config"] + #[doc = " @return uint8_t general_config[5]:"] + #[doc = " uint8_t numlock;"] + #[doc = "uint8_t capslock;"] + #[doc = "uint8_t scrolllock;"] + #[doc = "uint8_t enable_user_password;"] + #[doc = "uint8_t delete_user_password;"] + #[doc = ""] pub fn NK_read_config() -> *mut u8; } extern "C" { - /// Get name of given TOTP slot - /// @param slot_number TOTP slot number, slot_number<15 - /// @return char[20] the name of the slot + #[doc = " Get name of given TOTP slot"] + #[doc = " @param slot_number TOTP slot number, slot_number<15"] + #[doc = " @return char[20] the name of the slot"] pub fn NK_get_totp_slot_name(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// @param slot_number HOTP slot number, slot_number<3 - /// @return char[20] the name of the slot + #[doc = " @param slot_number HOTP slot number, slot_number<3"] + #[doc = " @return char[20] the name of the slot"] pub fn NK_get_hotp_slot_name(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Erase HOTP slot data from the device - /// @param slot_number HOTP slot number, slot_number<3 - /// @param temporary_password admin temporary password - /// @return command processing error code + #[doc = " Erase HOTP slot data from the device"] + #[doc = " @param slot_number HOTP slot number, slot_number<3"] + #[doc = " @param temporary_password admin temporary password"] + #[doc = " @return command processing error code"] pub fn NK_erase_hotp_slot( slot_number: u8, temporary_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Erase TOTP slot data from the device - /// @param slot_number TOTP slot number, slot_number<15 - /// @param temporary_password admin temporary password - /// @return command processing error code + #[doc = " Erase TOTP slot data from the device"] + #[doc = " @param slot_number TOTP slot number, slot_number<15"] + #[doc = " @param temporary_password admin temporary password"] + #[doc = " @return command processing error code"] pub fn NK_erase_totp_slot( slot_number: u8, temporary_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Write HOTP slot data to the device - /// @param slot_number HOTP slot number, slot_number<3, 0-numbered - /// @param slot_name char[15] desired slot name. C string (requires ending '\0'; 16 bytes). - /// @param secret char[40] 160-bit or 320-bit (currently Pro v0.8 only) secret as a hex string. C string (requires ending '\0'; 41 bytes). - /// See NitrokeyManager::is_320_OTP_secret_supported. - /// @param hotp_counter uint32_t starting value of HOTP counter - /// @param use_8_digits should returned codes be 6 (false) or 8 digits (true) - /// @param use_enter press ENTER key after sending OTP code using double-pressed scroll/num/capslock - /// @param use_tokenID @see token_ID - /// @param token_ID @see https://openauthentication.org/token-specs/, 'Class A' section - /// @param temporary_password char[25] admin temporary password - /// @return command processing error code + #[doc = " Write HOTP slot data to the device"] + #[doc = " @param slot_number HOTP slot number, slot_number<3, 0-numbered"] + #[doc = " @param slot_name char[15] desired slot name. C string (requires ending '\\0'; 16 bytes)."] + #[doc = " @param secret char[40] 160-bit or 320-bit (currently Pro v0.8 only) secret as a hex string. C string (requires ending '\\0'; 41 bytes)."] + #[doc = " See NitrokeyManager::is_320_OTP_secret_supported."] + #[doc = " @param hotp_counter uint32_t starting value of HOTP counter"] + #[doc = " @param use_8_digits should returned codes be 6 (false) or 8 digits (true)"] + #[doc = " @param use_enter press ENTER key after sending OTP code using double-pressed scroll/num/capslock"] + #[doc = " @param use_tokenID @see token_ID"] + #[doc = " @param token_ID @see https://openauthentication.org/token-specs/, 'Class A' section"] + #[doc = " @param temporary_password char[25] admin temporary password"] + #[doc = " @return command processing error code"] pub fn NK_write_hotp_slot( slot_number: u8, slot_name: *const ::std::os::raw::c_char, @@ -924,18 +924,18 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Write TOTP slot data to the device - /// @param slot_number TOTP slot number, slot_number<15, 0-numbered - /// @param slot_name char[15] desired slot name. C string (requires ending '\0'; 16 bytes). - /// @param secret char[40] 160-bit or 320-bit (currently Pro v0.8 only) secret as a hex string. C string (requires ending '\0'; 41 bytes). - /// See NitrokeyManager::is_320_OTP_secret_supported. - /// @param time_window uint16_t time window for this TOTP - /// @param use_8_digits should returned codes be 6 (false) or 8 digits (true) - /// @param use_enter press ENTER key after sending OTP code using double-pressed scroll/num/capslock - /// @param use_tokenID @see token_ID - /// @param token_ID @see https://openauthentication.org/token-specs/, 'Class A' section - /// @param temporary_password char[20] admin temporary password - /// @return command processing error code + #[doc = " Write TOTP slot data to the device"] + #[doc = " @param slot_number TOTP slot number, slot_number<15, 0-numbered"] + #[doc = " @param slot_name char[15] desired slot name. C string (requires ending '\\0'; 16 bytes)."] + #[doc = " @param secret char[40] 160-bit or 320-bit (currently Pro v0.8 only) secret as a hex string. C string (requires ending '\\0'; 41 bytes)."] + #[doc = " See NitrokeyManager::is_320_OTP_secret_supported."] + #[doc = " @param time_window uint16_t time window for this TOTP"] + #[doc = " @param use_8_digits should returned codes be 6 (false) or 8 digits (true)"] + #[doc = " @param use_enter press ENTER key after sending OTP code using double-pressed scroll/num/capslock"] + #[doc = " @param use_tokenID @see token_ID"] + #[doc = " @param token_ID @see https://openauthentication.org/token-specs/, 'Class A' section"] + #[doc = " @param temporary_password char[20] admin temporary password"] + #[doc = " @return command processing error code"] pub fn NK_write_totp_slot( slot_number: u8, slot_name: *const ::std::os::raw::c_char, @@ -949,29 +949,29 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Get HOTP code from the device - /// @param slot_number HOTP slot number, slot_number<3 - /// @return HOTP code + #[doc = " Get HOTP code from the device"] + #[doc = " @param slot_number HOTP slot number, slot_number<3"] + #[doc = " @return HOTP code"] pub fn NK_get_hotp_code(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get HOTP code from the device (PIN protected) - /// @param slot_number HOTP slot number, slot_number<3 - /// @param user_temporary_password char[25] user temporary password if PIN protected OTP codes are enabled, - /// otherwise should be set to empty string - '' - /// @return HOTP code + #[doc = " Get HOTP code from the device (PIN protected)"] + #[doc = " @param slot_number HOTP slot number, slot_number<3"] + #[doc = " @param user_temporary_password char[25] user temporary password if PIN protected OTP codes are enabled,"] + #[doc = " otherwise should be set to empty string - ''"] + #[doc = " @return HOTP code"] pub fn NK_get_hotp_code_PIN( slot_number: u8, user_temporary_password: *const ::std::os::raw::c_char, ) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get TOTP code from the device - /// @param slot_number TOTP slot number, slot_number<15 - /// @param challenge TOTP challenge -- unused - /// @param last_totp_time last time -- unused - /// @param last_interval last interval --unused - /// @return TOTP code + #[doc = " Get TOTP code from the device"] + #[doc = " @param slot_number TOTP slot number, slot_number<15"] + #[doc = " @param challenge TOTP challenge -- unused"] + #[doc = " @param last_totp_time last time -- unused"] + #[doc = " @param last_interval last interval --unused"] + #[doc = " @return TOTP code"] pub fn NK_get_totp_code( slot_number: u8, challenge: u64, @@ -980,14 +980,14 @@ extern "C" { ) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get TOTP code from the device (PIN protected) - /// @param slot_number TOTP slot number, slot_number<15 - /// @param challenge TOTP challenge -- unused - /// @param last_totp_time last time -- unused - /// @param last_interval last interval -- unused - /// @param user_temporary_password char[25] user temporary password if PIN protected OTP codes are enabled, - /// otherwise should be set to empty string - '' - /// @return TOTP code + #[doc = " Get TOTP code from the device (PIN protected)"] + #[doc = " @param slot_number TOTP slot number, slot_number<15"] + #[doc = " @param challenge TOTP challenge -- unused"] + #[doc = " @param last_totp_time last time -- unused"] + #[doc = " @param last_interval last interval -- unused"] + #[doc = " @param user_temporary_password char[25] user temporary password if PIN protected OTP codes are enabled,"] + #[doc = " otherwise should be set to empty string - ''"] + #[doc = " @return TOTP code"] pub fn NK_get_totp_code_PIN( slot_number: u8, challenge: u64, @@ -997,20 +997,20 @@ extern "C" { ) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Set time on the device (for TOTP requests) - /// @param time seconds in unix epoch (from 01.01.1970) - /// @return command processing error code + #[doc = " Set time on the device (for TOTP requests)"] + #[doc = " @param time seconds in unix epoch (from 01.01.1970)"] + #[doc = " @return command processing error code"] pub fn NK_totp_set_time(time: u64) -> ::std::os::raw::c_int; } extern "C" { - /// Set the device time used for TOTP to the given time. Contrary to - /// {@code set_time(uint64_t)}, this command fails if {@code old_time} - /// > {@code time} or if {@code old_time} is zero (where {@code - /// old_time} is the current time on the device). - /// - /// @param time new device time as Unix timestamp (seconds since - /// 1970-01-01) - /// @return command processing error code + #[doc = " Set the device time used for TOTP to the given time. Contrary to"] + #[doc = " {@code set_time(uint64_t)}, this command fails if {@code old_time}"] + #[doc = " > {@code time} or if {@code old_time} is zero (where {@code"] + #[doc = " old_time} is the current time on the device)."] + #[doc = ""] + #[doc = " @param time new device time as Unix timestamp (seconds since"] + #[doc = " 1970-01-01)"] + #[doc = " @return command processing error code"] pub fn NK_totp_set_time_soft(time: u64) -> ::std::os::raw::c_int; } extern "C" { @@ -1018,73 +1018,73 @@ extern "C" { pub fn NK_totp_get_time() -> ::std::os::raw::c_int; } extern "C" { - /// Change administrator PIN - /// @param current_PIN char[25] current PIN - /// @param new_PIN char[25] new PIN - /// @return command processing error code + #[doc = " Change administrator PIN"] + #[doc = " @param current_PIN char[25] current PIN"] + #[doc = " @param new_PIN char[25] new PIN"] + #[doc = " @return command processing error code"] pub fn NK_change_admin_PIN( current_PIN: *const ::std::os::raw::c_char, new_PIN: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Change user PIN - /// @param current_PIN char[25] current PIN - /// @param new_PIN char[25] new PIN - /// @return command processing error code + #[doc = " Change user PIN"] + #[doc = " @param current_PIN char[25] current PIN"] + #[doc = " @param new_PIN char[25] new PIN"] + #[doc = " @return command processing error code"] pub fn NK_change_user_PIN( current_PIN: *const ::std::os::raw::c_char, new_PIN: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Get retry count of user PIN - /// @return user PIN retry count + #[doc = " Get retry count of user PIN"] + #[doc = " @return user PIN retry count"] pub fn NK_get_user_retry_count() -> u8; } extern "C" { - /// Get retry count of admin PIN - /// @return admin PIN retry count + #[doc = " Get retry count of admin PIN"] + #[doc = " @return admin PIN retry count"] pub fn NK_get_admin_retry_count() -> u8; } extern "C" { - /// Enable password safe access - /// @param user_pin char[30] current user PIN - /// @return command processing error code + #[doc = " Enable password safe access"] + #[doc = " @param user_pin char[30] current user PIN"] + #[doc = " @return command processing error code"] pub fn NK_enable_password_safe( user_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Get password safe slots' status - /// @return uint8_t[16] slot statuses - each byte represents one slot with 0 (not programmed) and 1 (programmed) + #[doc = " Get password safe slots' status"] + #[doc = " @return uint8_t[16] slot statuses - each byte represents one slot with 0 (not programmed) and 1 (programmed)"] pub fn NK_get_password_safe_slot_status() -> *mut u8; } extern "C" { - /// Get password safe slot name - /// @param slot_number password safe slot number, slot_number<16 - /// @return slot name + #[doc = " Get password safe slot name"] + #[doc = " @param slot_number password safe slot number, slot_number<16"] + #[doc = " @return slot name"] pub fn NK_get_password_safe_slot_name(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get password safe slot login - /// @param slot_number password safe slot number, slot_number<16 - /// @return login from the PWS slot + #[doc = " Get password safe slot login"] + #[doc = " @param slot_number password safe slot number, slot_number<16"] + #[doc = " @return login from the PWS slot"] pub fn NK_get_password_safe_slot_login(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get the password safe slot password - /// @param slot_number password safe slot number, slot_number<16 - /// @return password from the PWS slot + #[doc = " Get the password safe slot password"] + #[doc = " @param slot_number password safe slot number, slot_number<16"] + #[doc = " @return password from the PWS slot"] pub fn NK_get_password_safe_slot_password(slot_number: u8) -> *mut ::std::os::raw::c_char; } extern "C" { - /// Write password safe data to the slot - /// @param slot_number password safe slot number, slot_number<16 - /// @param slot_name char[11] name of the slot - /// @param slot_login char[32] login string - /// @param slot_password char[20] password string - /// @return command processing error code + #[doc = " Write password safe data to the slot"] + #[doc = " @param slot_number password safe slot number, slot_number<16"] + #[doc = " @param slot_name char[11] name of the slot"] + #[doc = " @param slot_login char[32] login string"] + #[doc = " @param slot_password char[20] password string"] + #[doc = " @return command processing error code"] pub fn NK_write_password_safe_slot( slot_number: u8, slot_name: *const ::std::os::raw::c_char, @@ -1093,81 +1093,81 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Erase the password safe slot from the device - /// @param slot_number password safe slot number, slot_number<16 - /// @return command processing error code + #[doc = " Erase the password safe slot from the device"] + #[doc = " @param slot_number password safe slot number, slot_number<16"] + #[doc = " @return command processing error code"] pub fn NK_erase_password_safe_slot(slot_number: u8) -> ::std::os::raw::c_int; } extern "C" { - /// Check whether AES is supported by the device - /// @return 0 for no and 1 for yes + #[doc = " Check whether AES is supported by the device"] + #[doc = " @return 0 for no and 1 for yes"] pub fn NK_is_AES_supported( user_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Get device's major firmware version - /// @return major part of the version number (e.g. 0 from 0.48, 0 from 0.7 etc.) + #[doc = " Get device's major firmware version"] + #[doc = " @return major part of the version number (e.g. 0 from 0.48, 0 from 0.7 etc.)"] pub fn NK_get_major_firmware_version() -> u8; } extern "C" { - /// Get device's minor firmware version - /// @return minor part of the version number (e.g. 7 from 0.7, 48 from 0.48 etc.) + #[doc = " Get device's minor firmware version"] + #[doc = " @return minor part of the version number (e.g. 7 from 0.7, 48 from 0.48 etc.)"] pub fn NK_get_minor_firmware_version() -> u8; } extern "C" { - /// Function to determine unencrypted volume PIN type - /// @param minor_firmware_version - /// @return Returns 1, if set unencrypted volume ro/rw pin type is User, 0 otherwise. + #[doc = " Function to determine unencrypted volume PIN type"] + #[doc = " @param minor_firmware_version"] + #[doc = " @return Returns 1, if set unencrypted volume ro/rw pin type is User, 0 otherwise."] pub fn NK_set_unencrypted_volume_rorw_pin_type_user() -> ::std::os::raw::c_int; } extern "C" { - /// This command is typically run to initiate - /// communication with the device (altough not required). - /// It sets time on device and returns its current status - /// - a combination of set_time and get_status_storage commands - /// Storage only - /// @param seconds_from_epoch date and time expressed in seconds + #[doc = " This command is typically run to initiate"] + #[doc = " communication with the device (altough not required)."] + #[doc = " It sets time on device and returns its current status"] + #[doc = " - a combination of set_time and get_status_storage commands"] + #[doc = " Storage only"] + #[doc = " @param seconds_from_epoch date and time expressed in seconds"] pub fn NK_send_startup(seconds_from_epoch: u64) -> ::std::os::raw::c_int; } extern "C" { - /// Unlock encrypted volume. - /// Storage only - /// @param user_pin user pin 20 characters - /// @return command processing error code + #[doc = " Unlock encrypted volume."] + #[doc = " Storage only"] + #[doc = " @param user_pin user pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_unlock_encrypted_volume( user_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Locks encrypted volume - /// @return command processing error code + #[doc = " Locks encrypted volume"] + #[doc = " @return command processing error code"] pub fn NK_lock_encrypted_volume() -> ::std::os::raw::c_int; } extern "C" { - /// Unlock hidden volume and lock encrypted volume. - /// Requires encrypted volume to be unlocked. - /// Storage only - /// @param hidden_volume_password 20 characters - /// @return command processing error code + #[doc = " Unlock hidden volume and lock encrypted volume."] + #[doc = " Requires encrypted volume to be unlocked."] + #[doc = " Storage only"] + #[doc = " @param hidden_volume_password 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_unlock_hidden_volume( hidden_volume_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Locks hidden volume - /// @return command processing error code + #[doc = " Locks hidden volume"] + #[doc = " @return command processing error code"] pub fn NK_lock_hidden_volume() -> ::std::os::raw::c_int; } extern "C" { - /// Create hidden volume. - /// Requires encrypted volume to be unlocked. - /// Storage only - /// @param slot_nr slot number in range 0-3 - /// @param start_percent volume begin expressed in percent of total available storage, int in range 0-99 - /// @param end_percent volume end expressed in percent of total available storage, int in range 1-100 - /// @param hidden_volume_password 20 characters - /// @return command processing error code + #[doc = " Create hidden volume."] + #[doc = " Requires encrypted volume to be unlocked."] + #[doc = " Storage only"] + #[doc = " @param slot_nr slot number in range 0-3"] + #[doc = " @param start_percent volume begin expressed in percent of total available storage, int in range 0-99"] + #[doc = " @param end_percent volume end expressed in percent of total available storage, int in range 1-100"] + #[doc = " @param hidden_volume_password 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_create_hidden_volume( slot_nr: u8, start_percent: u8, @@ -1176,240 +1176,240 @@ extern "C" { ) -> ::std::os::raw::c_int; } extern "C" { - /// Make unencrypted volume read-only. - /// Device hides unencrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Does nothing if firmware version is not matched - /// Firmware range: Storage v0.50, v0.48 and below - /// Storage only - /// @param user_pin 20 characters User PIN - /// @return command processing error code + #[doc = " Make unencrypted volume read-only."] + #[doc = " Device hides unencrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Does nothing if firmware version is not matched"] + #[doc = " Firmware range: Storage v0.50, v0.48 and below"] + #[doc = " Storage only"] + #[doc = " @param user_pin 20 characters User PIN"] + #[doc = " @return command processing error code"] pub fn NK_set_unencrypted_read_only( user_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Make unencrypted volume read-write. - /// Device hides unencrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Does nothing if firmware version is not matched - /// Firmware range: Storage v0.50, v0.48 and below - /// Storage only - /// @param user_pin 20 characters User PIN - /// @return command processing error code + #[doc = " Make unencrypted volume read-write."] + #[doc = " Device hides unencrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Does nothing if firmware version is not matched"] + #[doc = " Firmware range: Storage v0.50, v0.48 and below"] + #[doc = " Storage only"] + #[doc = " @param user_pin 20 characters User PIN"] + #[doc = " @return command processing error code"] pub fn NK_set_unencrypted_read_write( user_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Make unencrypted volume read-only. - /// Device hides unencrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Does nothing if firmware version is not matched - /// Firmware range: Storage v0.49, v0.51+ - /// Storage only - /// @param admin_pin 20 characters Admin PIN - /// @return command processing error code + #[doc = " Make unencrypted volume read-only."] + #[doc = " Device hides unencrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Does nothing if firmware version is not matched"] + #[doc = " Firmware range: Storage v0.49, v0.51+"] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters Admin PIN"] + #[doc = " @return command processing error code"] pub fn NK_set_unencrypted_read_only_admin( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Make unencrypted volume read-write. - /// Device hides unencrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Does nothing if firmware version is not matched - /// Firmware range: Storage v0.49, v0.51+ - /// Storage only - /// @param admin_pin 20 characters Admin PIN - /// @return command processing error code + #[doc = " Make unencrypted volume read-write."] + #[doc = " Device hides unencrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Does nothing if firmware version is not matched"] + #[doc = " Firmware range: Storage v0.49, v0.51+"] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters Admin PIN"] + #[doc = " @return command processing error code"] pub fn NK_set_unencrypted_read_write_admin( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Make encrypted volume read-only. - /// Device hides encrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Firmware range: v0.49 only, future (see firmware release notes) - /// Storage only - /// @param admin_pin 20 characters - /// @return command processing error code + #[doc = " Make encrypted volume read-only."] + #[doc = " Device hides encrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Firmware range: v0.49 only, future (see firmware release notes)"] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_set_encrypted_read_only( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Make encrypted volume read-write. - /// Device hides encrypted volume for a second therefore make sure - /// buffers are flushed before running. - /// Firmware range: v0.49 only, future (see firmware release notes) - /// Storage only - /// @param admin_pin 20 characters - /// @return command processing error code + #[doc = " Make encrypted volume read-write."] + #[doc = " Device hides encrypted volume for a second therefore make sure"] + #[doc = " buffers are flushed before running."] + #[doc = " Firmware range: v0.49 only, future (see firmware release notes)"] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_set_encrypted_read_write( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Exports device's firmware to unencrypted volume. - /// Storage only - /// @param admin_pin 20 characters - /// @return command processing error code + #[doc = " Exports device's firmware to unencrypted volume."] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_export_firmware(admin_pin: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Clear new SD card notification. It is set after factory reset. - /// Storage only - /// @param admin_pin 20 characters - /// @return command processing error code + #[doc = " Clear new SD card notification. It is set after factory reset."] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_clear_new_sd_card_warning( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Fill SD card with random data. - /// Should be done on first stick initialization after creating keys. - /// Storage only - /// @param admin_pin 20 characters - /// @return command processing error code + #[doc = " Fill SD card with random data."] + #[doc = " Should be done on first stick initialization after creating keys."] + #[doc = " Storage only"] + #[doc = " @param admin_pin 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_fill_SD_card_with_random_data( admin_pin: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Change update password. - /// Update password is used for entering update mode, where firmware - /// could be uploaded using dfu-programmer or other means. - /// Storage only - /// @param current_update_password 20 characters - /// @param new_update_password 20 characters - /// @return command processing error code + #[doc = " Change update password."] + #[doc = " Update password is used for entering update mode, where firmware"] + #[doc = " could be uploaded using dfu-programmer or other means."] + #[doc = " Storage only"] + #[doc = " @param current_update_password 20 characters"] + #[doc = " @param new_update_password 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_change_update_password( current_update_password: *const ::std::os::raw::c_char, new_update_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Enter update mode. Needs update password. - /// When device is in update mode it no longer accepts any HID commands until - /// firmware is launched (regardless of being updated or not). - /// Smartcard (through CCID interface) and its all volumes are not visible as well. - /// Its VID and PID are changed to factory-default (03eb:2ff1 Atmel Corp.) - /// to be detected by flashing software. Result of this command can be reversed - /// by using 'launch' command. - /// For dfu-programmer it would be: 'dfu-programmer at32uc3a3256s launch'. - /// Storage only - /// @param update_password 20 characters - /// @return command processing error code + #[doc = " Enter update mode. Needs update password."] + #[doc = " When device is in update mode it no longer accepts any HID commands until"] + #[doc = " firmware is launched (regardless of being updated or not)."] + #[doc = " Smartcard (through CCID interface) and its all volumes are not visible as well."] + #[doc = " Its VID and PID are changed to factory-default (03eb:2ff1 Atmel Corp.)"] + #[doc = " to be detected by flashing software. Result of this command can be reversed"] + #[doc = " by using 'launch' command."] + #[doc = " For dfu-programmer it would be: 'dfu-programmer at32uc3a3256s launch'."] + #[doc = " Storage only"] + #[doc = " @param update_password 20 characters"] + #[doc = " @return command processing error code"] pub fn NK_enable_firmware_update( update_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Get Storage stick status as string. - /// Storage only - /// @return string with devices attributes + #[doc = " Get Storage stick status as string."] + #[doc = " Storage only"] + #[doc = " @return string with devices attributes"] pub fn NK_get_status_storage_as_string() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get the Storage stick status and return the command processing - /// error code. If the code is zero, i. e. the command was successful, - /// the storage status is written to the output pointer's target. - /// The output pointer must not be null. - /// - /// @param out the output pointer for the storage status - /// @return command processing error code + #[doc = " Get the Storage stick status and return the command processing"] + #[doc = " error code. If the code is zero, i. e. the command was successful,"] + #[doc = " the storage status is written to the output pointer's target."] + #[doc = " The output pointer must not be null."] + #[doc = ""] + #[doc = " @param out the output pointer for the storage status"] + #[doc = " @return command processing error code"] pub fn NK_get_status_storage(out: *mut NK_storage_status) -> ::std::os::raw::c_int; } extern "C" { - /// Get SD card usage attributes. Usable during hidden volumes creation. - /// If the command was successful (return value 0), the usage data is - /// written to the output pointer’s target. The output pointer must - /// not be null. - /// Storage only - /// @param out the output pointer for the usage data - /// @return command processing error code + #[doc = " Get SD card usage attributes. Usable during hidden volumes creation."] + #[doc = " If the command was successful (return value 0), the usage data is"] + #[doc = " written to the output pointer\u{2019}s target. The output pointer must"] + #[doc = " not be null."] + #[doc = " Storage only"] + #[doc = " @param out the output pointer for the usage data"] + #[doc = " @return command processing error code"] pub fn NK_get_SD_usage_data(out: *mut NK_SD_usage_data) -> ::std::os::raw::c_int; } extern "C" { - /// Get SD card usage attributes as string. - /// Usable during hidden volumes creation. - /// Storage only - /// @return string with SD card usage attributes + #[doc = " Get SD card usage attributes as string."] + #[doc = " Usable during hidden volumes creation."] + #[doc = " Storage only"] + #[doc = " @return string with SD card usage attributes"] pub fn NK_get_SD_usage_data_as_string() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Get progress value of current long operation. - /// Storage only - /// @return int in range 0-100 or -1 if device is not busy or -2 if an - /// error occured + #[doc = " Get progress value of current long operation."] + #[doc = " Storage only"] + #[doc = " @return int in range 0-100 or -1 if device is not busy or -2 if an"] + #[doc = " error occured"] pub fn NK_get_progress_bar_value() -> ::std::os::raw::c_int; } extern "C" { - /// Returns a list of connected devices' id's, delimited by ';' character. Empty string is returned on no device found. - /// Each ID could consist of: - /// 1. SC_id:SD_id_p_path (about 40 bytes) - /// 2. path (about 10 bytes) - /// where 'path' is USB path (bus:num), 'SC_id' is smartcard ID, 'SD_id' is storage card ID and - /// '_p_' and ':' are field delimiters. - /// Case 2 (USB path only) is used, when the device cannot be asked about its status data (e.g. during a long operation, - /// like clearing SD card. - /// Internally connects to all available devices and creates a map between ids and connection objects. - /// Side effects: changes active device to last detected Storage device. - /// Storage only - /// @example Example of returned data: '00005d19:dacc2cb4_p_0001:0010:02;000037c7:4cf12445_p_0001:000f:02;0001:000c:02' - /// @return string delimited id's of connected devices + #[doc = " Returns a list of connected devices' id's, delimited by ';' character. Empty string is returned on no device found."] + #[doc = " Each ID could consist of:"] + #[doc = " 1. SC_id:SD_id_p_path (about 40 bytes)"] + #[doc = " 2. path (about 10 bytes)"] + #[doc = " where 'path' is USB path (bus:num), 'SC_id' is smartcard ID, 'SD_id' is storage card ID and"] + #[doc = " '_p_' and ':' are field delimiters."] + #[doc = " Case 2 (USB path only) is used, when the device cannot be asked about its status data (e.g. during a long operation,"] + #[doc = " like clearing SD card."] + #[doc = " Internally connects to all available devices and creates a map between ids and connection objects."] + #[doc = " Side effects: changes active device to last detected Storage device."] + #[doc = " Storage only"] + #[doc = " @example Example of returned data: '00005d19:dacc2cb4_p_0001:0010:02;000037c7:4cf12445_p_0001:000f:02;0001:000c:02'"] + #[doc = " @return string delimited id's of connected devices"] pub fn NK_list_devices_by_cpuID() -> *mut ::std::os::raw::c_char; } extern "C" { - /// Returns a linked list of all connected devices, or null if no devices - /// are connected or an error occured. The linked list must be freed by - /// calling NK_free_device_info. - /// @return a linked list of all connected devices + #[doc = " Returns a linked list of all connected devices, or null if no devices"] + #[doc = " are connected or an error occured. The linked list must be freed by"] + #[doc = " calling NK_free_device_info."] + #[doc = " @return a linked list of all connected devices"] pub fn NK_list_devices() -> *mut NK_device_info; } extern "C" { - /// Free a linked list returned by NK_list_devices. - /// @param the linked list to free or null + #[doc = " Free a linked list returned by NK_list_devices."] + #[doc = " @param the linked list to free or null"] pub fn NK_free_device_info(device_info: *mut NK_device_info); } extern "C" { - /// Connects to the device with given ID. ID's list could be created with NK_list_devices_by_cpuID. - /// Requires calling to NK_list_devices_by_cpuID first. Connecting to arbitrary ID/USB path is not handled. - /// On connection requests status from device and disconnects it / removes from map on connection failure. - /// Storage only - /// @param id Target device ID (example: '00005d19:dacc2cb4_p_0001:0010:02') - /// @return 1 on successful connection, 0 otherwise + #[doc = " Connects to the device with given ID. ID's list could be created with NK_list_devices_by_cpuID."] + #[doc = " Requires calling to NK_list_devices_by_cpuID first. Connecting to arbitrary ID/USB path is not handled."] + #[doc = " On connection requests status from device and disconnects it / removes from map on connection failure."] + #[doc = " Storage only"] + #[doc = " @param id Target device ID (example: '00005d19:dacc2cb4_p_0001:0010:02')"] + #[doc = " @return 1 on successful connection, 0 otherwise"] pub fn NK_connect_with_ID(id: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Connects to a device with the given path. The path is a USB device - /// path as returned by hidapi. - /// @param path the device path - /// @return 1 on successful connection, 0 otherwise + #[doc = " Connects to a device with the given path. The path is a USB device"] + #[doc = " path as returned by hidapi."] + #[doc = " @param path the device path"] + #[doc = " @return 1 on successful connection, 0 otherwise"] pub fn NK_connect_with_path(path: *const ::std::os::raw::c_char) -> ::std::os::raw::c_int; } extern "C" { - /// Blink red and green LED alternatively and infinitely (until device is reconnected). - /// @return command processing error code + #[doc = " Blink red and green LED alternatively and infinitely (until device is reconnected)."] + #[doc = " @return command processing error code"] pub fn NK_wink() -> ::std::os::raw::c_int; } extern "C" { - /// Enable update mode on Nitrokey Pro. - /// Supported from v0.11. - /// @param update_password 20 bytes update password - /// @return command processing error code + #[doc = " Enable update mode on Nitrokey Pro."] + #[doc = " Supported from v0.11."] + #[doc = " @param update_password 20 bytes update password"] + #[doc = " @return command processing error code"] pub fn NK_enable_firmware_update_pro( update_password: *const ::std::os::raw::c_char, ) -> ::std::os::raw::c_int; } extern "C" { - /// Change update-mode password on Nitrokey Pro. - /// Supported from v0.11. - /// @param current_firmware_password 20 bytes update password - /// @param new_firmware_password 20 bytes update password - /// @return command processing error code + #[doc = " Change update-mode password on Nitrokey Pro."] + #[doc = " Supported from v0.11."] + #[doc = " @param current_firmware_password 20 bytes update password"] + #[doc = " @param new_firmware_password 20 bytes update password"] + #[doc = " @return command processing error code"] pub fn NK_change_firmware_password_pro( current_firmware_password: *const ::std::os::raw::c_char, new_firmware_password: *const ::std::os::raw::c_char, -- cgit v1.2.1