mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-19 18:11:28 +01:00
1e34d8989d
We have several of these, and they're not always called obvious things like "delete" or "free". `STEALS` provides a strong hint here. I only added it to a couple I knew about off the top of my head. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
110 lines
3.6 KiB
C
110 lines
3.6 KiB
C
#ifndef LIGHTNING_COMMON_UTILS_H
|
|
#define LIGHTNING_COMMON_UTILS_H
|
|
#include "config.h"
|
|
#include <ccan/crypto/ripemd160/ripemd160.h>
|
|
#include <ccan/crypto/sha256/sha256.h>
|
|
#include <ccan/short_types/short_types.h>
|
|
#include <ccan/structeq/structeq.h>
|
|
#include <ccan/tal/tal.h>
|
|
#include <secp256k1.h>
|
|
|
|
extern secp256k1_context *secp256k1_ctx;
|
|
|
|
extern const struct chainparams *chainparams;
|
|
|
|
/* Marker which indicates an (tal) pointer argument is stolen
|
|
* (i.e. eventually freed) by the function. Unlike TAKEN, which
|
|
* indicates it's only stolen if caller says take() */
|
|
#define STEALS
|
|
|
|
/* Simple accessor function for our own dependencies to use, in order to avoid
|
|
* circular dependencies (should only be used in `bitcoin/y`). */
|
|
bool is_elements(const struct chainparams *chainparams);
|
|
|
|
/* Allocate and fill in a hex-encoded string of this data. */
|
|
char *tal_hexstr(const tal_t *ctx, const void *data, size_t len);
|
|
|
|
/* Allocate and fill a hex-encoding of this tal pointer. */
|
|
char *tal_hex(const tal_t *ctx, const tal_t *data);
|
|
|
|
/* Allocate and fill a buffer with the data of this hex string. */
|
|
u8 *tal_hexdata(const tal_t *ctx, const void *str, size_t len);
|
|
|
|
/* Macro to set memberptr in tal object outer to point to tal object obj,
|
|
* if it isn't NULL.
|
|
* The 0*sizeof() checks that *memberptr = obj is valid */
|
|
#define set_softref(outer, memberptr, obj) \
|
|
set_softref_((outer), sizeof(*(outer)) + 0*sizeof(*(memberptr) = obj), \
|
|
(void **)(memberptr), (obj))
|
|
|
|
/* Macro to clear a (set) softref ptr to NULL */
|
|
#define clear_softref(outer, memberptr) \
|
|
clear_softref_((outer), sizeof(*(outer)), (void **)(memberptr))
|
|
|
|
void set_softref_(const tal_t *outer, size_t outersize, void **ptr, tal_t *obj);
|
|
void clear_softref_(const tal_t *outer, size_t outersize, void **ptr);
|
|
|
|
/* Note: p is never a complex expression, otherwise this multi-evaluates! */
|
|
#define tal_arr_expand(p, s) \
|
|
do { \
|
|
size_t n = tal_count(*(p)); \
|
|
tal_resize((p), n+1); \
|
|
(*(p))[n] = (s); \
|
|
} while(0)
|
|
|
|
/**
|
|
* Remove an element from an array
|
|
*
|
|
* This will shift the elements past the removed element, changing
|
|
* their position in memory, so only use this for arrays of pointers.
|
|
*/
|
|
#define tal_arr_remove(p, n) tal_arr_remove_((p), sizeof(**p), (n))
|
|
void tal_arr_remove_(void *p, size_t elemsize, size_t n);
|
|
|
|
/**
|
|
* The comon case of duplicating an entire tal array.
|
|
*
|
|
* A macro because we must not double-evaluate p.
|
|
*/
|
|
#define tal_dup_talarr(ctx, type, p) \
|
|
((type *)tal_dup_talarr_((ctx), tal_typechk_(p, type *), \
|
|
TAL_LABEL(type, "[]")))
|
|
void *tal_dup_talarr_(const tal_t *ctx, const tal_t *src TAKES,
|
|
const char *label);
|
|
|
|
/* Use the POSIX C locale. */
|
|
void setup_locale(void);
|
|
|
|
/* Global temporary convenience context: children freed in io loop core. */
|
|
extern const tal_t *tmpctx;
|
|
|
|
/* Initial creation of tmpctx. */
|
|
void setup_tmpctx(void);
|
|
|
|
/* Free any children of tmpctx. */
|
|
void clean_tmpctx(void);
|
|
|
|
/* Define sha256_eq. */
|
|
STRUCTEQ_DEF(sha256, 0, u);
|
|
|
|
/* Define ripemd160_eq. */
|
|
STRUCTEQ_DEF(ripemd160, 0, u);
|
|
|
|
/* If gcc complains about 'may be uninitialized' even at -O3, and the code is
|
|
* clear, use this to suppress it. Argument should be gcc version it
|
|
* complained on, so we can re-test as gcc evolves. */
|
|
#define COMPILER_WANTS_INIT(compiler_versions) = 0
|
|
|
|
/* For case where we want one thing if DEVELOPER, another if not, particularly
|
|
* for function parameters.
|
|
*
|
|
* Usefully, you can refer to DEVELOPER-only fields here. */
|
|
#if DEVELOPER
|
|
/* Make sure that nondev is evaluated, and valid */
|
|
#define IFDEV(dev, nondev) ((void)(nondev), (dev))
|
|
#else
|
|
#define IFDEV(dev, nondev) (nondev)
|
|
#endif
|
|
|
|
#endif /* LIGHTNING_COMMON_UTILS_H */
|