/usr/include/hidrd/opt/inst.h is in libhidrd0-dev 0.2.0-11.
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 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 | /** @file
* @brief HID report descriptor - option instance
*
* Copyright (C) 2010 Nikolai Kondrashov
*
* This file is part of hidrd.
*
* Hidrd is free software; 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.
*
* Hidrd 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.
*
* You should have received a copy of the GNU General Public License
* along with hidrd; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* @author Nikolai Kondrashov <spbnick@gmail.com>
*
* @(#) $Id: inst.h 311 2010-03-27 12:51:20Z spb_nick $
*/
#ifndef __HIDRD_OPT_INST_H__
#define __HIDRD_OPT_INST_H__
#include <stdbool.h>
#include "hidrd/opt/spec.h"
#ifdef __cplusplus
extern "C" {
#endif
/** Option */
typedef struct hidrd_opt {
const char *name;
hidrd_opt_type type;
hidrd_opt_value value;
} hidrd_opt;
/**
* Check if an option is valid.
*
* @param opt Option to check.
*
* @return True if the option is valid, false otherwise.
*/
extern bool hidrd_opt_valid(const hidrd_opt *opt);
/**
* Get a string value.
*
* @param opt Option pointer.
*
* @return Option value.
*/
extern const char *hidrd_opt_get_string(const hidrd_opt *opt);
/**
* Get a boolean value.
*
* @param opt Option pointer.
*
* @return Option value.
*/
extern bool hidrd_opt_get_boolean(const hidrd_opt *opt);
/**
* Get a signed 32-bit integer value.
*
* @param opt Option pointer.
*
* @return Option value.
*/
extern int32_t hidrd_opt_get_s32(const hidrd_opt *opt);
/**
* Get an unsigned 32-bit integer value.
*
* @param opt Option pointer.
*
* @return Option value.
*/
extern uint32_t hidrd_opt_get_u32(const hidrd_opt *opt);
/**
* Parse a token pair representation of an option.
*
* @param opt Output option; will contain name and possibly value
* referenced from the token pair.
* @param spec Option specification to apply to conversion.
* @param tkns Token pair to parse; the name and possibly value tokens will
* be referenced in the resulting option.
*
* @return True if parsed successfully, false otherwise.
*/
extern bool hidrd_opt_parse_tkns(hidrd_opt *opt,
const hidrd_opt_spec *spec,
const hidrd_opt_tkns *tkns);
/**
* Parse a string representation of an option, modifying and referencing in
* the resulting option.
*
* @param opt Output option; will contain name and possibly value
* referenced from the original string.
* @param spec Option specification to apply to conversion.
* @param buf String to parse; will be modified and referenced in the
* resulting option.
*
* @return True if parsed successfully, false otherwise.
*/
extern bool hidrd_opt_parse(hidrd_opt *opt,
const hidrd_opt_spec *spec,
char *buf);
/**
* Format a token pair representation of an option.
*
* @param tkns Output token pair, will contain dynamically allocated value.
* @param opt The option to convert to the token pair representation.
*
* @return True if converted successfully, false if failed to allocate
* memory.
*/
extern bool hidrd_opt_format_tkns(hidrd_opt_tkns *tkns,
const hidrd_opt *opt);
/**
* Format a string representation of an option.
*
* @param spec Option to format.
*
* @return Dynamically allocated string representation of the option, or
* NULL, if failed to allocate memory.
*/
extern char *hidrd_opt_format(const hidrd_opt *opt);
#ifdef __cplusplus
} /* extern "C" */
#endif
#endif /* __HIDRD_OPT_INST_H__ */
|