[thirdparty/systemd.git] / src / shared / macro.h

/*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/

#pragma once

/***
  This file is part of systemd.

  Copyright 2010 Lennart Poettering

  systemd 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.

  systemd 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 systemd; If not, see <http://www.gnu.org/licenses/>.
***/

#include <assert.h>
#include <sys/param.h>
#include <sys/types.h>
#include <sys/uio.h>
#include <inttypes.h>

#define _printf_attr_(a,b) __attribute__ ((format (printf, a, b)))
#define _alloc_(...) __attribute__ ((alloc_size(__VA_ARGS__)))
#define _sentinel_ __attribute__ ((sentinel))
#define _noreturn_ __attribute__((noreturn))
#define _unused_ __attribute__ ((unused))
#define _destructor_ __attribute__ ((destructor))
#define _pure_ __attribute__ ((pure))
#define _const_ __attribute__ ((const))
#define _deprecated_ __attribute__ ((deprecated))
#define _packed_ __attribute__ ((packed))
#define _malloc_ __attribute__ ((malloc))
#define _weak_ __attribute__ ((weak))
#define _likely_(x) (__builtin_expect(!!(x),1))
#define _unlikely_(x) (__builtin_expect(!!(x),0))
#define _public_ __attribute__ ((visibility("default")))
#define _hidden_ __attribute__ ((visibility("hidden")))
#define _weakref_(x) __attribute__((weakref(#x)))
#define _introspect_(x) __attribute__((section("introspect." x)))
#define _alignas_(x) __attribute__((aligned(__alignof(x))))
#define _cleanup_(x) __attribute__((cleanup(x)))

/* automake test harness */
#define EXIT_TEST_SKIP 77

#define XSTRINGIFY(x) #x
#define STRINGIFY(x) XSTRINGIFY(x)

/* Rounds up */

#define ALIGN4(l) (((l) + 3) & ~3)
#define ALIGN8(l) (((l) + 7) & ~7)

#if __SIZEOF_POINTER__ == 8
#define ALIGN(l) ALIGN8(l)
#elif __SIZEOF_POINTER__ == 4
#define ALIGN(l) ALIGN4(l)
#else
#error "Wut? Pointers are neither 4 nor 8 bytes long?"
#endif

#define ALIGN_PTR(p) ((void*) ALIGN((unsigned long) p))
#define ALIGN4_PTR(p) ((void*) ALIGN4((unsigned long) p))
#define ALIGN8_PTR(p) ((void*) ALIGN8((unsigned long) p))

static inline size_t ALIGN_TO(size_t l, size_t ali) {
        return ((l + ali - 1) & ~(ali - 1));
}

#define ALIGN_TO_PTR(p, ali) ((void*) ALIGN_TO((unsigned long) p))

#define ELEMENTSOF(x) (sizeof(x)/sizeof((x)[0]))

/*
 * container_of - cast a member of a structure out to the containing structure
 * @ptr: the pointer to the member.
 * @type: the type of the container struct this is embedded in.
 * @member: the name of the member within the struct.
 *
 */
#define container_of(ptr, type, member)                                 \
        __extension__ ({                                                \
                        const typeof( ((type *)0)->member ) *__mptr = (ptr); \
                        (type *)( (char *)__mptr - offsetof(type,member) ); \
                })

#undef MAX
#define MAX(a,b)                                 \
        __extension__ ({                         \
                        typeof(a) _a = (a);      \
                        typeof(b) _b = (b);      \
                        _a > _b ? _a : _b;       \
                })

#define MAX3(x,y,z)                              \
        __extension__ ({                         \
                        typeof(x) _c = MAX(x,y); \
                        MAX(_c, z);              \
                })

#undef MIN
#define MIN(a,b)                                \
        __extension__ ({                        \
                        typeof(a) _a = (a);     \
                        typeof(b) _b = (b);     \
                        _a < _b ? _a : _b;      \
                })

#ifndef CLAMP
#define CLAMP(x, low, high)                                             \
        __extension__ ({                                                \
                        typeof(x) _x = (x);                             \
                        typeof(low) _low = (low);                       \
                        typeof(high) _high = (high);                    \
                        ((_x > _high) ? _high : ((_x < _low) ? _low : _x)); \
                })
#endif

#define assert_se(expr)                                                 \
        do {                                                            \
                if (_unlikely_(!(expr)))                                \
                        log_assert_failed(#expr, __FILE__, __LINE__, __PRETTY_FUNCTION__); \
        } while (false)                                                 \

/* We override the glibc assert() here. */
#undef assert
#ifdef NDEBUG
#define assert(expr) do {} while(false)
#else
#define assert(expr) assert_se(expr)
#endif

#define assert_not_reached(t)                                           \
        do {                                                            \
                log_assert_failed_unreachable(t, __FILE__, __LINE__, __PRETTY_FUNCTION__); \
        } while (false)

#if defined(static_assert)
#define assert_cc(expr)                         \
        do {                                    \
                static_assert(expr, #expr);     \
        } while (false)
#else
#define assert_cc(expr)                         \
        do {                                    \
                switch (0) {                    \
                case 0:                         \
                case !!(expr):                  \
                        ;                       \
                }                               \
        } while (false)
#endif

#define PTR_TO_INT(p) ((int) ((intptr_t) (p)))
#define INT_TO_PTR(u) ((void *) ((intptr_t) (u)))
#define PTR_TO_UINT(p) ((unsigned int) ((uintptr_t) (p)))
#define UINT_TO_PTR(u) ((void *) ((uintptr_t) (u)))

#define PTR_TO_LONG(p) ((long) ((intptr_t) (p)))
#define LONG_TO_PTR(u) ((void *) ((intptr_t) (u)))
#define PTR_TO_ULONG(p) ((unsigned long) ((uintptr_t) (p)))
#define ULONG_TO_PTR(u) ((void *) ((uintptr_t) (u)))

#define PTR_TO_INT32(p) ((int32_t) ((intptr_t) (p)))
#define INT32_TO_PTR(u) ((void *) ((intptr_t) (u)))
#define PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p)))
#define UINT32_TO_PTR(u) ((void *) ((uintptr_t) (u)))

#define PTR_TO_INT64(p) ((int64_t) ((intptr_t) (p)))
#define INT64_TO_PTR(u) ((void *) ((intptr_t) (u)))
#define PTR_TO_UINT64(p) ((uint64_t) ((uintptr_t) (p)))
#define UINT64_TO_PTR(u) ((void *) ((uintptr_t) (u)))

#define memzero(x,l) (memset((x), 0, (l)))
#define zero(x) (memzero(&(x), sizeof(x)))

#define CHAR_TO_STR(x) ((char[2]) { x, 0 })

#define char_array_0(x) x[sizeof(x)-1] = 0;

#define hasprefix(s, prefix) (memcmp(s, prefix, strlen(prefix)) == 0)

#define IOVEC_SET_STRING(i, s)                  \
        do {                                    \
                struct iovec *_i = &(i);        \
                char *_s = (char *)(s);         \
                _i->iov_base = _s;              \
                _i->iov_len = strlen(_s);       \
        } while(false)

static inline size_t IOVEC_TOTAL_SIZE(const struct iovec *i, unsigned n) {
        unsigned j;
        size_t r = 0;

        for (j = 0; j < n; j++)
                r += i[j].iov_len;

        return r;
}

static inline size_t IOVEC_INCREMENT(struct iovec *i, unsigned n, size_t k) {
        unsigned j;

        for (j = 0; j < n; j++) {
                size_t sub;

                if (_unlikely_(k <= 0))
                        break;

                sub = MIN(i[j].iov_len, k);
                i[j].iov_len -= sub;
                i[j].iov_base = (uint8_t*) i[j].iov_base + sub;
                k -= sub;
        }

        return k;
}

#define VA_FORMAT_ADVANCE(format, ap)                                   \
do {                                                                    \
        int _argtypes[128];                                             \
        size_t _i, _k;                                                  \
        _k = parse_printf_format((format), ELEMENTSOF(_argtypes), _argtypes); \
        assert(_k < ELEMENTSOF(_argtypes));                             \
        for (_i = 0; _i < _k; _i++) {                                   \
                if (_argtypes[_i] & PA_FLAG_PTR)  {                     \
                        (void) va_arg(ap, void*);                       \
                        continue;                                       \
                }                                                       \
                                                                        \
                switch (_argtypes[_i]) {                                \
                case PA_INT:                                            \
                case PA_INT|PA_FLAG_SHORT:                              \
                case PA_CHAR:                                           \
                        (void) va_arg(ap, int);                         \
                        break;                                          \
                case PA_INT|PA_FLAG_LONG:                               \
                        (void) va_arg(ap, long int);                    \
                        break;                                          \
                case PA_INT|PA_FLAG_LONG_LONG:                          \
                        (void) va_arg(ap, long long int);               \
                        break;                                          \
                case PA_WCHAR:                                          \
                        (void) va_arg(ap, wchar_t);                     \
                        break;                                          \
                case PA_WSTRING:                                        \
                case PA_STRING:                                         \
                case PA_POINTER:                                        \
                        (void) va_arg(ap, void*);                       \
                        break;                                          \
                case PA_FLOAT:                                          \
                case PA_DOUBLE:                                         \
                        (void) va_arg(ap, double);                      \
                        break;                                          \
                case PA_DOUBLE|PA_FLAG_LONG_DOUBLE:                     \
                        (void) va_arg(ap, long double);                 \
                        break;                                          \
                default:                                                \
                        assert_not_reached("Unknown format string argument."); \
                }                                                       \
        }                                                               \
} while(false)

 /* Because statfs.t_type can be int on some architecures, we have to cast
  * the const magic to the type, otherwise the compiler warns about
  * signed/unsigned comparison, because the magic can be 32 bit unsigned.
 */
#define F_TYPE_CMP(a, b) (a == (typeof(a)) b)


/* Returns the number of chars needed to format variables of the
 * specified type as a decimal string. Adds in extra space for a
 * negative '-' prefix. */

#define DECIMAL_STR_MAX(type)                                           \
        (1+(sizeof(type) <= 1 ? 3 :                                     \
            sizeof(type) <= 2 ? 5 :                                     \
            sizeof(type) <= 4 ? 10 :                                    \
            sizeof(type) <= 8 ? 20 : sizeof(int[-2*(sizeof(type) > 8)])))

#define SET_FLAG(v, flag, b) \
        (v) = (b) ? ((v) | (flag)) : ((v) & ~(flag))

#include "log.h"
Commit	Line	Data
03467c88	1	/-- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil --/
60918275	2
c2f1db8f	3	#pragma once
60918275	4
a7334b09 LP	5	/***
	6	This file is part of systemd.
	7
	8	Copyright 2010 Lennart Poettering
	9
	10	systemd is free software; you can redistribute it and/or modify it
5430f7f2 LP	11	under the terms of the GNU Lesser General Public License as published by
5430f7f2 LP	12	the Free Software Foundation; either version 2.1 of the License, or
a7334b09 LP	13	(at your option) any later version.
	14
	15	systemd is distributed in the hope that it will be useful, but
	16	WITHOUT ANY WARRANTY; without even the implied warranty of
	17	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5430f7f2	18	Lesser General Public License for more details.
a7334b09	19
5430f7f2	20	You should have received a copy of the GNU Lesser General Public License
a7334b09 LP	21	along with systemd; If not, see <http://www.gnu.org/licenses/>.
	22	***/
	23
60918275	24	#include <assert.h>
6a39419f	25	#include <sys/param.h>
60918275	26	#include <sys/types.h>
c31e1495 LP	27	#include <sys/uio.h>
c31e1495 LP	28	#include <inttypes.h>
60918275	29
93a46b0b	30	#define _printf_attr_(a,b) __attribute__ ((format (printf, a, b)))
750ef272	31	#define _alloc_(...) __attribute__ ((alloc_size(__VA_ARGS__)))
93a46b0b LP	32	#define _sentinel_ __attribute__ ((sentinel))
	33	#define _noreturn_ __attribute__((noreturn))
	34	#define _unused_ __attribute__ ((unused))
	35	#define _destructor_ __attribute__ ((destructor))
	36	#define _pure_ __attribute__ ((pure))
	37	#define _const_ __attribute__ ((const))
	38	#define _deprecated_ __attribute__ ((deprecated))
	39	#define _packed_ __attribute__ ((packed))
	40	#define _malloc_ __attribute__ ((malloc))
	41	#define _weak_ __attribute__ ((weak))
	42	#define _likely_(x) (__builtin_expect(!!(x),1))
	43	#define _unlikely_(x) (__builtin_expect(!!(x),0))
40473a70 LP	44	#define _public_ __attribute__ ((visibility("default")))
40473a70 LP	45	#define _hidden_ __attribute__ ((visibility("hidden")))
ad780f19	46	#define _weakref_(x) __attribute__((weakref(#x)))
9a60da28	47	#define _introspect_(x) __attribute__((section("introspect." x)))
19d1e4ee	48	#define _alignas_(x) __attribute__((aligned(__alignof(x))))
dfb33a97	49	#define _cleanup_(x) __attribute__((cleanup(x)))
60918275	50
49e5de64 ZJS	51	/* automake test harness */
	52	#define EXIT_TEST_SKIP 77
	53
bef2733f LP	54	#define XSTRINGIFY(x) #x
	55	#define STRINGIFY(x) XSTRINGIFY(x)
	56
60918275	57	/* Rounds up */
9be9c7cf LP	58
	59	#define ALIGN4(l) (((l) + 3) & ~3)
	60	#define ALIGN8(l) (((l) + 7) & ~7)
	61
	62	#if __SIZEOF_POINTER__ == 8
	63	#define ALIGN(l) ALIGN8(l)
	64	#elif __SIZEOF_POINTER__ == 4
	65	#define ALIGN(l) ALIGN4(l)
	66	#else
	67	#error "Wut? Pointers are neither 4 nor 8 bytes long?"
	68	#endif
	69
49aa47c7 LP	70	#define ALIGN_PTR(p) ((void*) ALIGN((unsigned long) p))
49aa47c7 LP	71	#define ALIGN4_PTR(p) ((void*) ALIGN4((unsigned long) p))
e86b80b8 LP	72	#define ALIGN8_PTR(p) ((void*) ALIGN8((unsigned long) p))
e86b80b8 LP	73
37f85e66	74	static inline size_t ALIGN_TO(size_t l, size_t ali) {
37f85e66	75	return ((l + ali - 1) & ~(ali - 1));
22be093f LP	76	}
22be093f LP	77
49aa47c7 LP	78	#define ALIGN_TO_PTR(p, ali) ((void*) ALIGN_TO((unsigned long) p))
49aa47c7 LP	79
60918275 LP	80	#define ELEMENTSOF(x) (sizeof(x)/sizeof((x)[0]))
60918275 LP	81
bbc98d32 KS	82	/*
	83	* container_of - cast a member of a structure out to the containing structure
	84	* @ptr: the pointer to the member.
	85	* @type: the type of the container struct this is embedded in.
	86	* @member: the name of the member within the struct.
	87	*
	88	*/
fa70beaa LP	89	#define container_of(ptr, type, member) \
	90	__extension__ ({ \
	91	const typeof( ((type )0)->member ) __mptr = (ptr); \
	92	(type )( (char )__mptr - offsetof(type,member) ); \
	93	})
bbc98d32	94
9607d947 CR	95	#undef MAX
	96	#define MAX(a,b) \
	97	__extension__ ({ \
	98	typeof(a) _a = (a); \
	99	typeof(b) _b = (b); \
	100	_a > _b ? _a : _b; \
60918275 LP	101	})
60918275 LP	102
9607d947 CR	103	#define MAX3(x,y,z) \
	104	__extension__ ({ \
	105	typeof(x) _c = MAX(x,y); \
	106	MAX(_c, z); \
	107	})
3b63d2d3	108
9607d947	109	#undef MIN
60918275 LP	110	#define MIN(a,b) \
	111	__extension__ ({ \
	112	typeof(a) _a = (a); \
	113	typeof(b) _b = (b); \
	114	_a < _b ? _a : _b; \
	115	})
	116
907809fc	117	#ifndef CLAMP
60918275 LP	118	#define CLAMP(x, low, high) \
	119	__extension__ ({ \
	120	typeof(x) _x = (x); \
	121	typeof(low) _low = (low); \
	122	typeof(high) _high = (high); \
	123	((_x > _high) ? _high : ((_x < _low) ? _low : _x)); \
	124	})
907809fc	125	#endif
60918275	126
dd8f71ee LP	127	#define assert_se(expr) \
dd8f71ee LP	128	do { \
93a46b0b	129	if (_unlikely_(!(expr))) \
b7f33638	130	log_assert_failed(#expr, __FILE__, __LINE__, __PRETTY_FUNCTION__); \
dd8f71ee LP	131	} while (false) \
	132
	133	/* We override the glibc assert() here. */
	134	#undef assert
	135	#ifdef NDEBUG
	136	#define assert(expr) do {} while(false)
	137	#else
	138	#define assert(expr) assert_se(expr)
	139	#endif
60918275	140
dd8f71ee LP	141	#define assert_not_reached(t) \
dd8f71ee LP	142	do { \
b7f33638	143	log_assert_failed_unreachable(t, __FILE__, __LINE__, __PRETTY_FUNCTION__); \
dd8f71ee	144	} while (false)
60918275	145
f791c684 LP	146	#if defined(static_assert)
	147	#define assert_cc(expr) \
	148	do { \
	149	static_assert(expr, #expr); \
60918275	150	} while (false)
f791c684 LP	151	#else
	152	#define assert_cc(expr) \
	153	do { \
	154	switch (0) { \
	155	case 0: \
	156	case !!(expr): \
	157	; \
	158	} \
	159	} while (false)
	160	#endif
60918275	161
a3dc3547 KS	162	#define PTR_TO_INT(p) ((int) ((intptr_t) (p)))
a3dc3547 KS	163	#define INT_TO_PTR(u) ((void *) ((intptr_t) (u)))
60918275	164	#define PTR_TO_UINT(p) ((unsigned int) ((uintptr_t) (p)))
a3dc3547	165	#define UINT_TO_PTR(u) ((void *) ((uintptr_t) (u)))
60918275	166
a3dc3547 KS	167	#define PTR_TO_LONG(p) ((long) ((intptr_t) (p)))
a3dc3547 KS	168	#define LONG_TO_PTR(u) ((void *) ((intptr_t) (u)))
c6c18be3	169	#define PTR_TO_ULONG(p) ((unsigned long) ((uintptr_t) (p)))
a3dc3547	170	#define ULONG_TO_PTR(u) ((void *) ((uintptr_t) (u)))
c6c18be3	171
a3dc3547 KS	172	#define PTR_TO_INT32(p) ((int32_t) ((intptr_t) (p)))
	173	#define INT32_TO_PTR(u) ((void *) ((intptr_t) (u)))
	174	#define PTR_TO_UINT32(p) ((uint32_t) ((uintptr_t) (p)))
	175	#define UINT32_TO_PTR(u) ((void *) ((uintptr_t) (u)))
60918275	176
a3dc3547 KS	177	#define PTR_TO_INT64(p) ((int64_t) ((intptr_t) (p)))
	178	#define INT64_TO_PTR(u) ((void *) ((intptr_t) (u)))
	179	#define PTR_TO_UINT64(p) ((uint64_t) ((uintptr_t) (p)))
	180	#define UINT64_TO_PTR(u) ((void *) ((uintptr_t) (u)))
c6c18be3	181
476fe607 LP	182	#define memzero(x,l) (memset((x), 0, (l)))
	183	#define zero(x) (memzero(&(x), sizeof(x)))
	184
a9c55a88 LP	185	#define CHAR_TO_STR(x) ((char[2]) { x, 0 })
a9c55a88 LP	186
034c6ed7 LP	187	#define char_array_0(x) x[sizeof(x)-1] = 0;
034c6ed7 LP	188
fd59d9f2 ZJS	189	#define hasprefix(s, prefix) (memcmp(s, prefix, strlen(prefix)) == 0)
fd59d9f2 ZJS	190
bff7c062	191	#define IOVEC_SET_STRING(i, s) \
2fa086a8	192	do { \
bff7c062 LP	193	struct iovec *_i = &(i); \
	194	char _s = (char )(s); \
	195	_i->iov_base = _s; \
	196	_i->iov_len = strlen(_s); \
9b3c575e	197	} while(false)
2fa086a8	198
c31e1495 LP	199	static inline size_t IOVEC_TOTAL_SIZE(const struct iovec *i, unsigned n) {
	200	unsigned j;
	201	size_t r = 0;
	202
	203	for (j = 0; j < n; j++)
	204	r += i[j].iov_len;
	205
	206	return r;
	207	}
	208
	209	static inline size_t IOVEC_INCREMENT(struct iovec *i, unsigned n, size_t k) {
	210	unsigned j;
	211
	212	for (j = 0; j < n; j++) {
	213	size_t sub;
	214
	215	if (_unlikely_(k <= 0))
	216	break;
	217
	218	sub = MIN(i[j].iov_len, k);
	219	i[j].iov_len -= sub;
	220	i[j].iov_base = (uint8_t*) i[j].iov_base + sub;
	221	k -= sub;
	222	}
	223
	224	return k;
	225	}
	226
cecd32f6 LP	227	#define VA_FORMAT_ADVANCE(format, ap) \
	228	do { \
	229	int _argtypes[128]; \
963ddb91 LP	230	size_t _i, _k; \
963ddb91 LP	231	_k = parse_printf_format((format), ELEMENTSOF(_argtypes), _argtypes); \
cecd32f6	232	assert(_k < ELEMENTSOF(_argtypes)); \
963ddb91 LP	233	for (_i = 0; _i < _k; _i++) { \
	234	if (_argtypes[_i] & PA_FLAG_PTR) { \
	235	(void) va_arg(ap, void*); \
	236	continue; \
	237	} \
	238	\
	239	switch (_argtypes[_i]) { \
	240	case PA_INT: \
	241	case PA_INT\|PA_FLAG_SHORT: \
	242	case PA_CHAR: \
	243	(void) va_arg(ap, int); \
	244	break; \
	245	case PA_INT\|PA_FLAG_LONG: \
	246	(void) va_arg(ap, long int); \
	247	break; \
	248	case PA_INT\|PA_FLAG_LONG_LONG: \
	249	(void) va_arg(ap, long long int); \
	250	break; \
	251	case PA_WCHAR: \
	252	(void) va_arg(ap, wchar_t); \
	253	break; \
	254	case PA_WSTRING: \
	255	case PA_STRING: \
	256	case PA_POINTER: \
	257	(void) va_arg(ap, void*); \
	258	break; \
	259	case PA_FLOAT: \
	260	case PA_DOUBLE: \
	261	(void) va_arg(ap, double); \
	262	break; \
	263	case PA_DOUBLE\|PA_FLAG_LONG_DOUBLE: \
	264	(void) va_arg(ap, long double); \
	265	break; \
	266	default: \
	267	assert_not_reached("Unknown format string argument."); \
	268	} \
	269	} \
	270	} while(false)
	271
bdd29249 HH	272	/* Because statfs.t_type can be int on some architecures, we have to cast
	273	* the const magic to the type, otherwise the compiler warns about
	274	* signed/unsigned comparison, because the magic can be 32 bit unsigned.
	275	*/
	276	#define F_TYPE_CMP(a, b) (a == (typeof(a)) b)
	277
	278
fa70beaa LP	279	/* Returns the number of chars needed to format variables of the
	280	* specified type as a decimal string. Adds in extra space for a
	281	* negative '-' prefix. */
	282
	283	#define DECIMAL_STR_MAX(type) \
	284	(1+(sizeof(type) <= 1 ? 3 : \
	285	sizeof(type) <= 2 ? 5 : \
	286	sizeof(type) <= 4 ? 10 : \
	287	sizeof(type) <= 8 ? 20 : sizeof(int[-2*(sizeof(type) > 8)])))
	288
264ad849 LP	289	#define SET_FLAG(v, flag, b) \
	290	(v) = (b) ? ((v) \| (flag)) : ((v) & ~(flag))
	291
dd8f71ee	292	#include "log.h"