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
|
/*
Copyright (C) CFEngine AS
This file is part of CFEngine 3 - written and maintained by CFEngine AS.
This program 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; version 3.
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.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
To the extent this program is licensed as part of the Enterprise
versions of CFEngine, the applicable Commercial Open Source License
(COSL) may apply to this file if you as a licensee so wish it. See
included file COSL.txt.
*/
#ifndef CFENGINE_MISC_LIB_H
#define CFENGINE_MISC_LIB_H
#include <platform.h>
#include <compiler.h>
#define ProgrammingError(...) __ProgrammingError(__FILE__, __LINE__, __VA_ARGS__)
#define UnexpectedError(...) __UnexpectedError(__FILE__, __LINE__, __VA_ARGS__)
#ifndef NDEBUG
# define CF_ASSERT(condition, ...) \
do { \
if (!(condition)) \
ProgrammingError(__VA_ARGS__); \
} while(0)
#else
/* TODO in non-debug builds, this could be UnexpectedError(), but it needs
* to be rate limited to avoid spamming the console. */
# define CF_ASSERT(condition, ...) (void)(0)
#endif
/*
In contrast to the standard C modulus operator (%), this gives
you an unsigned modulus. So where -1 % 3 => -1,
UnsignedModulus(-1, 3) => 2.
*/
unsigned long UnsignedModulus(long dividend, long divisor);
size_t UpperPowerOfTwo(size_t v);
void __ProgrammingError(const char *file, int lineno, const char *format, ...) \
FUNC_ATTR_PRINTF(3, 4) FUNC_ATTR_NORETURN;
void __UnexpectedError(const char *file, int lineno, const char *format, ...) \
FUNC_ATTR_PRINTF(3, 4);
/**
* Unchecked versions of common functions, i.e. functions that no longer
* return anything, but try to continue in case of failure.
*
* @NOTE call these only with arguments that will always succeed!
*/
void xclock_gettime(clockid_t clk_id, struct timespec *ts);
void xsnprintf(char *str, size_t str_size, const char *format, ...);
#endif
|
