aboutsummaryrefslogtreecommitdiff
path: root/src/include/gnunet_nt_lib.h
blob: 014b4fbe0692ddba3ee784455debcd5abad9bba2 (plain) (blame)
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
/*
   This file is part of GNUnet.
   Copyright (C) 2010-2015, 2018 GNUnet e.V.

   GNUnet is free software: you can redistribute it and/or modify it
   under the terms of the GNU Affero General Public License as published
   by the Free Software Foundation, either version 3 of the License,
   or (at your option) any later version.

   GNUnet 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
   Affero General Public License for more details.

   You should have received a copy of the GNU Affero General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.

     SPDX-License-Identifier: AGPL3.0-or-later
 */

#if !defined (__GNUNET_UTIL_LIB_H_INSIDE__)
#error "Only <gnunet_util_lib.h> can be included directly."
#endif

/**
 * @addtogroup Backbone
 * @{
 *
 * @file network type characterization
 * @author Christian Grothoff
 * @author Matthias Wachs
 *
 * @defgroup nt  Network type characterization
 *
 * @{
 */
#ifndef GNUNET_NT_LIB_H
#define GNUNET_NT_LIB_H

/**
 * Types of networks (with separate quotas) we support.
 */
enum GNUNET_NetworkType
{
  /**
   * Category of last resort.
   */
  GNUNET_NT_UNSPECIFIED = 0,

  /**
   * Loopback (same host).
   */
  GNUNET_NT_LOOPBACK = 1,

  /**
   * Local area network.
   */
  GNUNET_NT_LAN = 2,

  /**
   * Wide area network (i.e. Internet)
   */
  GNUNET_NT_WAN = 3,

  /**
   * Wireless LAN (i.e. 802.11abgn)
   */
  GNUNET_NT_WLAN = 4,

  /**
   * Bluetooth LAN
   */
  GNUNET_NT_BT = 5

/**
 * Number of network types supported by ATS
 */
#define GNUNET_NT_COUNT 6
};


/**
 * Convert a `enum GNUNET_NetworkType` to a string
 *
 * @param net the network type
 * @return a string or NULL if invalid
 */
const char *
GNUNET_NT_to_string (enum GNUNET_NetworkType net);


/**
 * Handle for the LAN Characterization library.
 */
struct GNUNET_NT_InterfaceScanner;


/**
 * Returns where the address is located: loopback, LAN or WAN.
 *
 * @param is handle from #GNUNET_ATS_interface_scanner_init()
 * @param addr address
 * @param addrlen address length
 * @return type of the network the address belongs to
 */
enum GNUNET_NetworkType
GNUNET_NT_scanner_get_type (struct GNUNET_NT_InterfaceScanner *is,
                            const struct sockaddr *addr,
                            socklen_t addrlen);


/**
 * Initialize the address characterization client handle.
 *
 * @return scanner handle, NULL on error
 */
struct GNUNET_NT_InterfaceScanner *
GNUNET_NT_scanner_init (void);


/**
 * Terminate interface scanner.
 *
 * @param is scanner we are done with
 */
void
GNUNET_NT_scanner_done (struct GNUNET_NT_InterfaceScanner *is);


#endif

/** @} */  /* end of group */

/** @} */  /* end of group addition to backbone */