Greenbone Vulnerability Management Libraries 22.18.1
hosts.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2013-2023 Greenbone AG
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later
4 */
5
13
14#ifndef _GVM_HOSTS_H
15#define _GVM_HOSTS_H
16
20#define FEATURE_HOSTS_ALLOWED_ONLY 1
21
26#define FEATURE_REVERSE_LOOKUP_EXCLUDED 1
27
28#include <glib.h> /* for gchar, GList */
29#include <netinet/in.h> /* for in6_addr, in_addr */
30
31/* Static values */
32
34{
35 HOST_TYPE_NAME = 0, /* Hostname eg. foo */
36 HOST_TYPE_IPV4, /* eg. 192.168.1.1 */
37 HOST_TYPE_CIDR_BLOCK, /* eg. 192.168.15.0/24 */
38 HOST_TYPE_RANGE_SHORT, /* eg. 192.168.15.10-20 */
39 HOST_TYPE_RANGE_LONG, /* eg. 192.168.15.10-192.168.18.3 */
40 HOST_TYPE_IPV6, /* eg. ::1 */
41 HOST_TYPE_CIDR6_BLOCK, /* eg. ::ffee/120 */
42 HOST_TYPE_RANGE6_LONG, /* eg. ::1:200:7-::1:205:500 */
43 HOST_TYPE_RANGE6_SHORT, /* eg. ::1-fe10 */
44 HOST_TYPE_MAX /* Boundary checking. */
45};
46
47/* Typedefs */
48typedef struct gvm_host gvm_host_t;
49typedef struct gvm_vhost gvm_vhost_t;
50typedef struct gvm_hosts gvm_hosts_t;
51
52/* Data structures. */
53
61{
62 union
63 {
64 gchar *name;
65 struct in_addr addr;
66 struct in6_addr addr6;
67 };
69 GSList *vhosts;
70};
71
76{
77 char *value;
78 char *source;
79};
80
88{
89 gchar *orig_str;
91 size_t max_size;
92 size_t current;
93 size_t count;
94 size_t removed;
95 size_t duplicated;
96};
97
98/* Function prototypes. */
99
100/* gvm_hosts_t related */
101
103gvm_hosts_new (const gchar *);
104
106gvm_hosts_new_with_max (const gchar *, unsigned int);
107
110
111void
113
114void
116
117void
119
120void
122
123void
125
126GSList *
128
129int
130gvm_hosts_exclude (gvm_hosts_t *, const char *);
131
132int
133gvm_vhosts_exclude (gvm_host_t *, const char *);
134
135int
136gvm_hosts_exclude_with_max (gvm_hosts_t *, const char *, unsigned int);
137
138GSList *
139gvm_hosts_allowed_only (gvm_hosts_t *, const char *, const char *);
140
141char *
143
144int
146
147int
149
152
155
156unsigned int
158
159unsigned int
161
162unsigned int
164
165/* gvm_host_t related */
166
168gvm_host_from_str (const gchar *hosts_str);
169
170int
171gvm_host_in_hosts (const gvm_host_t *, const struct in6_addr *,
172 const gvm_hosts_t *);
173
175gvm_host_find_in_hosts (const gvm_host_t *, const struct in6_addr *,
176 const gvm_hosts_t *);
177
178gchar *
180
181enum host_type
182gvm_host_type (const gvm_host_t *);
183
184gchar *
186
187int
188gvm_host_resolve (const gvm_host_t *, void *, int);
189
190int
191gvm_host_get_addr6 (const gvm_host_t *, struct in6_addr *);
192
193void
195
196void gvm_host_free (gpointer);
197
198gpointer gvm_duplicate_vhost (gconstpointer, gpointer);
199
202
203/* Miscellaneous functions */
204
206gvm_vhost_new (char *, char *);
207
208int
209gvm_get_host_type (const gchar *);
210
211#endif /* not _GVM_HOSTS_H */
void gvm_hosts_shuffle(gvm_hosts_t *)
Randomizes the order of the hosts objects in the collection. Not to be used while iterating over the ...
Definition hosts.c:1383
void gvm_hosts_add(gvm_hosts_t *, gvm_host_t *)
Inserts a host object at the end of a hosts collection.
Definition hosts.c:962
int gvm_host_in_hosts(const gvm_host_t *, const struct in6_addr *, const gvm_hosts_t *)
Returns whether a host has an equal host in a hosts collection. eg. 192.168.10.1 has an equal in list...
Definition hosts.c:2226
void gvm_hosts_reverse(gvm_hosts_t *)
Reverses the order of the hosts objects in the collection. Not to be used while iterating over the si...
Definition hosts.c:1415
int gvm_hosts_exclude(gvm_hosts_t *, const char *)
Excludes a set of hosts provided as a string from a hosts collection. Not to be used while iterating ...
Definition hosts.c:1755
host_type
Definition hosts.h:34
@ HOST_TYPE_RANGE_SHORT
Definition hosts.h:38
@ HOST_TYPE_RANGE6_SHORT
Definition hosts.h:43
@ HOST_TYPE_RANGE_LONG
Definition hosts.h:39
@ HOST_TYPE_RANGE6_LONG
Definition hosts.h:42
@ HOST_TYPE_NAME
Definition hosts.h:35
@ HOST_TYPE_IPV6
Definition hosts.h:40
@ HOST_TYPE_CIDR6_BLOCK
Definition hosts.h:41
@ HOST_TYPE_MAX
Definition hosts.h:44
@ HOST_TYPE_IPV4
Definition hosts.h:36
@ HOST_TYPE_CIDR_BLOCK
Definition hosts.h:37
gvm_host_t * gvm_host_find_in_hosts(const gvm_host_t *, const struct in6_addr *, const gvm_hosts_t *)
Find the gvm_host_t from a gvm_hosts_t structure.
Definition hosts.c:2134
unsigned int gvm_hosts_removed(const gvm_hosts_t *)
Gets the count of single values in hosts string that were removed (duplicates / excluded....
Definition hosts.c:2104
gvm_host_t * gvm_duplicate_host(gvm_host_t *)
Creates a deep copy of a host. gvm_host_free has to be called on it.
Definition hosts.c:2183
GSList * gvm_hosts_resolve(gvm_hosts_t *)
Resolves host objects of type name in a hosts collection, replacing hostnames with IPv4 values....
Definition hosts.c:1441
int gvm_vhosts_exclude(gvm_host_t *, const char *)
Exclude a list of vhosts from a host's vhosts list.
Definition hosts.c:1509
void gvm_host_add_reverse_lookup(gvm_host_t *)
Add a host's reverse-lookup name to the vhosts list.
Definition hosts.c:1905
void gvm_hosts_move_current_host_to_end(gvm_hosts_t *)
Move the current gvm_host_t from a gvm_hosts_t structure to the end of the hosts list.
Definition hosts.c:1329
gvm_hosts_t * gvm_hosts_new_with_max(const gchar *, unsigned int)
Creates a new gvm_hosts_t structure and the associated hosts objects from the provided hosts_str.
Definition hosts.c:1100
int gvm_hosts_reverse_lookup_only(gvm_hosts_t *)
Removes hosts that don't reverse-lookup from the hosts collection. Not to be used while iterating ove...
Definition hosts.c:1988
struct gvm_host gvm_host_t
Definition hosts.h:48
gvm_hosts_t * gvm_hosts_reverse_lookup_unify_excluded(gvm_hosts_t *)
Removes hosts duplicates that reverse-lookup to the same value. Not to be used while iterating over t...
Definition hosts.c:2013
gchar * gvm_host_value_str(const gvm_host_t *)
Gets a host's value in printable format.
Definition hosts.c:2274
unsigned int gvm_hosts_count(const gvm_hosts_t *)
Gets the count of single hosts objects in a hosts collection.
Definition hosts.c:2090
struct gvm_vhost gvm_vhost_t
Definition hosts.h:49
gvm_host_t * gvm_hosts_next(gvm_hosts_t *)
Gets the next gvm_host_t from a gvm_hosts_t structure. The state of iteration is kept internally with...
Definition hosts.c:1311
void gvm_hosts_free(gvm_hosts_t *)
Frees memory occupied by an gvm_hosts_t structure.
Definition hosts.c:1359
char * gvm_host_reverse_lookup(gvm_host_t *)
Checks for a host object reverse dns lookup existence.
Definition hosts.c:1820
gchar * gvm_host_type_str(const gvm_host_t *)
Gets a host's type in printable format.
Definition hosts.c:2258
int gvm_host_get_addr6(const gvm_host_t *, struct in6_addr *)
Gives a host object's value as an IPv6 address. If the host type is hostname, it resolves the IPv4 ad...
Definition hosts.c:2352
int gvm_get_host_type(const gchar *)
Determines the host type in a buffer.
Definition hosts.c:810
int gvm_hosts_exclude_with_max(gvm_hosts_t *, const char *, unsigned int)
Excludes a set of hosts provided as a string from a hosts collection. Not to be used while iterating ...
Definition hosts.c:1564
struct gvm_hosts gvm_hosts_t
Definition hosts.h:50
gvm_hosts_t * gvm_hosts_new(const gchar *)
Creates a new gvm_hosts_t structure and the associated hosts objects from the provided hosts_str.
Definition hosts.c:1297
GSList * gvm_hosts_allowed_only(gvm_hosts_t *, const char *, const char *)
Returns a list of hosts after a host authorization check.
Definition hosts.c:1642
void gvm_host_free(gpointer)
Frees the memory occupied by an gvm_host_t object.
Definition hosts.c:941
unsigned int gvm_hosts_duplicated(const gvm_hosts_t *)
Gets the count of single values in hosts string that were duplicated and therefore removed from the l...
Definition hosts.c:2118
int gvm_hosts_reverse_lookup_unify(gvm_hosts_t *)
Removes hosts duplicates that reverse-lookup to the same value. Not to be used while iterating over t...
Definition hosts.c:2069
enum host_type gvm_host_type(const gvm_host_t *)
Gets a host object's type.
Definition hosts.c:2243
gpointer gvm_duplicate_vhost(gconstpointer, gpointer)
Creates a deep copy of a gvm_vhost_t object.
Definition hosts.c:906
gvm_vhost_t * gvm_vhost_new(char *, char *)
Creates a new gvm_vhost_t object.
Definition hosts.c:871
int gvm_host_resolve(const gvm_host_t *, void *, int)
Resolves a host object's name to an IPv4 or IPv6 address. Host object should be of type HOST_TYPE_NAM...
Definition hosts.c:2331
gvm_hosts_t * gvm_hosts_reverse_lookup_only_excluded(gvm_hosts_t *)
Removes hosts that don't reverse-lookup from the hosts collection. Not to be used while iterating ove...
Definition hosts.c:1947
gvm_host_t * gvm_host_from_str(const gchar *hosts_str)
Creates a new gvm_host_t from a host string.
Definition hosts.c:1771
The structure for a single host object.
Definition hosts.h:61
struct in6_addr addr6
Definition hosts.h:66
gchar * name
Definition hosts.h:64
GSList * vhosts
Definition hosts.h:69
struct in_addr addr
Definition hosts.h:65
enum host_type type
Definition hosts.h:68
The structure for Hosts collection.
Definition hosts.h:88
size_t max_size
Definition hosts.h:91
size_t removed
Definition hosts.h:94
gchar * orig_str
Definition hosts.h:89
size_t duplicated
Definition hosts.h:95
size_t current
Definition hosts.h:92
size_t count
Definition hosts.h:93
gvm_host_t ** hosts
Definition hosts.h:90
The structure for a single vhost object.
Definition hosts.h:76
char * value
Definition hosts.h:77
char * source
Definition hosts.h:78