src/include/smbios_c/token.h File Reference
#include "smbios_c/compat.h"
#include "smbios_c/types.h"
Go to the source code of this file.
Define Documentation
#define TOKEN_TYPE_D4 0xD4 |
#define TOKEN_TYPE_D5 0xD5 |
#define TOKEN_TYPE_D6 0xD6 |
#define TOKEN_TYPE_DA 0xDA |
Function Documentation
int DLL_SPEC token_activate |
( |
u16 |
id |
) |
|
Activate a boolean token.
- Returns:
- 0 on success, <0 on failure.
const void* DLL_SPEC token_get_ptr |
( |
u16 |
id |
) |
|
Get a pointer to the actual token structure.
struct smbios_struct* DLL_SPEC token_get_smbios_struct |
( |
u16 |
id |
) |
[read] |
Get a pointer to the smbios struct containing this token.
char* DLL_SPEC token_get_string |
( |
u16 |
id, |
|
|
size_t * |
len | |
|
) |
| | |
Get a new buffer containing the token string value.
- Parameters:
-
| id | token id to get |
| len | pointer to size_t where final string size will be stored. Size does not include final '\0', but may not always be equal to strlen() if cmos has embedded '\0' chars. You must use token_free_string() to free this buffer, or memory will leak. |
- Returns:
- pointer to allocated buffer (note: use token_free_string() to free this value). 0 on failure.
int DLL_SPEC token_get_type |
( |
u16 |
id |
) |
|
Return token type.
tokens can be 0xD4, 0xD5, 0xD6, or 0xDA tokens, depending on the smbios table structure they come from.
int DLL_SPEC token_is_active |
( |
u16 |
id |
) |
|
Check if a boolean token is currently set.
- Returns:
- -1 on error, 0 == false, 1 == true
bool DLL_SPEC token_is_bool |
( |
u16 |
id |
) |
|
Check if a token is a boolean-type token.
- Returns:
- true if token is bool, false if otherwise
bool DLL_SPEC token_is_string |
( |
u16 |
id |
) |
|
Check if a token is a string-type token.
- Returns:
- true if token is a string, false otherwise.
int DLL_SPEC token_set_string |
( |
u16 |
id, |
|
|
const char * |
value, |
|
|
size_t |
size | |
|
) |
| | |
Set a string token value.
- Parameters:
-
| id | token id |
| value | pointer to new token buffer |
| size | size of the buffer |
- Returns:
- 0 on success, <0 on failure.
const char* DLL_SPEC token_strerror |
( |
|
) |
|
Returns string describing the last error condition.
Can return 0. The buffer used is guaranteed to be valid until the next call to any token_* function. Copy the contents if you need it longer.
void DLL_SPEC token_string_free |
( |
char * |
|
) |
|
Free allocated memory.
Use this to free any memory buffer pointers that you get from this module. For example, token_get_string(...)
DLL_SPEC int token_try_password |
( |
u16 |
id, |
|
|
const char * |
pass_ascii, |
|
|
const char * |
pass_scancode | |
|
) |
| | |
For tokens that are password protected, check password.