This file is indexed.

/usr/include/smbios_c/token.h is in libsmbios-dev 2.2.28-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
// vim:expandtab:autoindent:tabstop=4:shiftwidth=4:filetype=c:
/*
 * Copyright (C) 2005 Dell Inc.
 *  by Michael Brown <Michael_E_Brown@dell.com>
 * Licensed under the Open Software License version 2.1
 *
 * Alternatively, you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published
 * by the Free Software Foundation; either version 2 of the License,
 * or (at your option) any later version.

 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 */


#ifndef C_TOKEN_H
#define C_TOKEN_H

// include smbios_c/compat.h first
#include "smbios_c/compat.h"
#include "smbios_c/types.h"

EXTERN_C_BEGIN;

#define TOKEN_TYPE_D4  0xD4
#define TOKEN_TYPE_D5  0xD5
#define TOKEN_TYPE_D6  0xD6
#define TOKEN_TYPE_DA  0xDA

/** 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.
 */
LIBSMBIOS_C_DLL_SPEC const char * token_strerror();

/** Return token type.
 * tokens can be 0xD4, 0xD5, 0xD6, or 0xDA tokens, depending on the smbios
 * table structure they come from.
 */
LIBSMBIOS_C_DLL_SPEC int token_get_type(u16 id);

/** Check if a token is a boolean-type token.
 * @return true if token is bool, false if otherwise
 */
LIBSMBIOS_C_DLL_SPEC bool token_is_bool(u16 id);

/** Check if a boolean token is currently set.
 * @return -1 on error, 0 == false, 1 == true
 */
LIBSMBIOS_C_DLL_SPEC int token_is_active(u16 id);

/** Activate a boolean token.
 * @return 0 on success, <0 on failure.
 */
LIBSMBIOS_C_DLL_SPEC int token_activate(u16 id);

/** Check if a token is a string-type token.
 * @return true if token is a string, false otherwise.
 */
LIBSMBIOS_C_DLL_SPEC bool token_is_string(u16 id);

/** Get a new buffer containing the token string value.
 * @param id token id to get
 * @param 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.
 * @return pointer to allocated buffer (note: use token_free_string() to free
 * this value). 0 on failure.
 */
LIBSMBIOS_C_DLL_SPEC char * token_get_string(u16 id, size_t *len);

/** Set a string token value.
 * @param id token id
 * @param value pointer to new token buffer
 * @param size size of the buffer
 * @return 0 on success, <0 on failure.
 */
LIBSMBIOS_C_DLL_SPEC int token_set_string(u16 id, const char *value, size_t size);

/** Free allocated memory.
 * Use this to free any memory buffer pointers that you get from this module.
 * For example, token_get_string(...)
 */
LIBSMBIOS_C_DLL_SPEC void token_string_free(char *);

/** Get a pointer to the smbios struct containing this token.
 */
LIBSMBIOS_C_DLL_SPEC const struct smbios_struct * token_get_smbios_struct(u16 id);

/** Get a pointer to the actual token structure
 */
LIBSMBIOS_C_DLL_SPEC const void * token_get_ptr(u16 id);

/** For tokens that are password protected, check password
 */
LIBSMBIOS_C_DLL_SPEC int token_try_password(u16 id, const char *pass_ascii, const char *pass_scancode);


EXTERN_C_END;

#endif  /* TOKEN_H */