This file is indexed.

/usr/include/libee/int.h is in libee-dev 0.4.1-1ubuntu1.

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
/**
 * @file int.h
 * The internal file format class.
 *
 * @class ee_int int.h
 *
 * The internal format is a very basic but easy to write and handle
 * event representation. Its primary purpose is to help with testing
 * libee.
 *
 * Events are represented in plain text files, which should be handable as
 * usual text files.
 *
 * The format is line-oriented. Each line has exactly one meaning 
 * (being a field name or value) or is a comment. Position within file
 * is important.
 *
 * each line consits of three parts:
 * - a single-character record type indicator
 * - a colon (only used for visual appearence and some error checking
 * - a value, terminated by LF
 *
 * Field types:
 * # - comment
 * e - start of a new event, value is ignored
 * f - start of a new field, value is field name
 * v - value is a field value for the last defined field
 *
 * It is invalid to have a "v" record type without a f directly in front
 * of it. It is valid to have fields without values (assuming this
 * is permitted for the field in question in the schema, if validation 
 * is active).
 *
 * Values:
 * UTF-8 encoded, but characters 0x0-0x1f, 0x7f must be escaped. Within
 * the value, C escape sequences are supported, with the most
 * important ones being (Note: double backslashes are for Doxygen, of course
 * this is to be used with single backslashes):
 * - \\0 NUL
 * - \\a BEL
 * - \\b Backspace
 * - \\f FF
 * - \\n LF
 * - \\r CR
 * - \\t HT
 * - \\' singlu quotation mark
 * - \\" double quotation mark
 * - \\? question mark
 * - \\\\ backslash character
 * - \\ooo ASCII Character in octal notation (o being octal digit)
 * - \\xhh ASCC character in hexadecimal notation
 * - \\xhhhh Unicode characer in headecimal notation
 * All other escape sequences are undefined. Currently, this is
 * interpreted as the escape character itself, but this is not
 * guaranteed. Most importantly, a special meaning may be assigned
 * to any of the currently-unassigned characters in the future.
 *
 * Sample:
 * # event with two fields
 * e:
 * f:field1
 * v:This\tis a test\n
 * v:Multiple values
 * f:field2
 * v:single value for this field
 *
 *//*
 *
 * Libee - An Event Expression Library inspired by CEE
 * Copyright 2010 by Rainer Gerhards and Adiscon GmbH.
 *
 * This file is part of libee.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * A copy of the LGPL v2.1 can be found in the file "COPYING" in this distribution.
 */
#ifndef LIBEE_INT_H_INCLUDED
#define	LIBEE_INT_H_INCLUDED
#include <libestr.h>

/**
 * Decode an internal representation into a CEE structure.
 *
 * The interface is heavily callback-based. The idea is to provide
 * greatest flexibility by doing so.
 *
 * @memberof ee_int
 * @public
 *
 * @param[in] ctx library context to use
 * @param[in] cbGetLine get next line to be processed. Returns
 *            0 if all went well, EE_EOF at end of file and something
 *            else otherwise.
 * @param[in] cbNewEvt callback for function that receives newly created
 *            events. It must return 0 on success and something else otherwise.
 * @param[out] errStr printable error message, provided only if an error
 *             occurs. If so, the caller must delete the provided pointer.
 * @returns 0 on success, something else otherwise
 */
int ee_intDec(ee_ctx ctx, int (*cbGetLine)(es_str_t **ln),
              int (*cbNewEvt)(struct ee_event *event),
	      es_str_t **errMsg);

#endif /* #ifndef LIBEE_INT_H_INCLUDED */