mirror of
https://gitlab.torproject.org/tpo/core/tor.git
synced 2025-02-28 08:54:24 +01:00
83be4d2bbd
This representation is meant to save memory in microdescriptors --
we can't use it in routerinfo_t yet, since those families need to be
encoded losslessly for directory voting to work.
This representation saves memory in three ways:
1. It uses only one allocation per family. (The old way used a
smartlist (2 allocs) plus one strdup per entry.)
2. It stores identity digests in binary, not hex.
3. It keeps families in a canonical format, memoizes, and
reference-counts them.
Part of #27359.
47 lines
1.6 KiB
C
47 lines
1.6 KiB
C
/* Copyright (c) 2001 Matej Pfajfar.
|
|
* Copyright (c) 2001-2004, Roger Dingledine.
|
|
* Copyright (c) 2004-2006, Roger Dingledine, Nick Mathewson.
|
|
* Copyright (c) 2007-2018, The Tor Project, Inc. */
|
|
/* See LICENSE for licensing information */
|
|
|
|
/**
|
|
* \file nodefamily.h
|
|
* \brief Header file for nodefamily.c.
|
|
**/
|
|
|
|
#ifndef TOR_NODEFAMILY_H
|
|
#define TOR_NODEFAMILY_H
|
|
|
|
#include "lib/malloc/malloc.h"
|
|
#include <stdbool.h>
|
|
|
|
typedef struct nodefamily_t nodefamily_t;
|
|
struct node_t;
|
|
struct smartlist_t;
|
|
|
|
#define NF_WARN_MALFORMED (1u<<0)
|
|
#define NF_REJECT_MALFORMED (1u<<1)
|
|
|
|
nodefamily_t *nodefamily_parse(const char *s,
|
|
const uint8_t *rsa_id_self,
|
|
unsigned flags);
|
|
nodefamily_t *nodefamily_from_members(const struct smartlist_t *members,
|
|
const uint8_t *rsa_id_self,
|
|
unsigned flags);
|
|
void nodefamily_free_(nodefamily_t *family);
|
|
#define nodefamily_free(family) \
|
|
FREE_AND_NULL(nodefamily_t, nodefamily_free_, (family))
|
|
|
|
bool nodefamily_contains_rsa_id(const nodefamily_t *family,
|
|
const uint8_t *rsa_id);
|
|
bool nodefamily_contains_nickname(const nodefamily_t *family,
|
|
const char *name);
|
|
bool nodefamily_contains_node(const nodefamily_t *family,
|
|
const struct node_t *node);
|
|
void nodefamily_add_nodes_to_smartlist(const nodefamily_t *family,
|
|
struct smartlist_t *out);
|
|
char *nodefamily_format(const nodefamily_t *family);
|
|
|
|
void nodefamily_free_all(void);
|
|
|
|
#endif
|