hosts.h

Go to the documentation of this file.

/* SPDX-FileCopyrightText: 2013-2023 Greenbone AG
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */

 
#ifndef _GVM_BASE_HOSTS_H
#define _GVM_BASE_HOSTS_H

#define FEATURE_HOSTS_ALLOWED_ONLY 1

#define FEATURE_REVERSE_LOOKUP_EXCLUDED 1
 
#include <glib.h>       /* for gchar, GList */
#include <netinet/in.h> /* for in6_addr, in_addr */
 
/* Static values */
 
enum host_type
{
  HOST_TYPE_NAME = 0,     /* Hostname eg. foo */
  HOST_TYPE_IPV4,         /* eg. 192.168.1.1 */
  HOST_TYPE_CIDR_BLOCK,   /* eg. 192.168.15.0/24 */
  HOST_TYPE_RANGE_SHORT,  /* eg. 192.168.15.10-20 */
  HOST_TYPE_RANGE_LONG,   /* eg. 192.168.15.10-192.168.18.3 */
  HOST_TYPE_IPV6,         /* eg. ::1 */
  HOST_TYPE_CIDR6_BLOCK,  /* eg. ::ffee/120 */
  HOST_TYPE_RANGE6_LONG,  /* eg. ::1:200:7-::1:205:500 */
  HOST_TYPE_RANGE6_SHORT, /* eg. ::1-fe10 */
  HOST_TYPE_MAX           /* Boundary checking. */
};
 
/* Typedefs */
typedef struct gvm_host gvm_host_t;
typedef struct gvm_vhost gvm_vhost_t;
typedef struct gvm_hosts gvm_hosts_t;
 
/* Data structures. */

struct gvm_host
{
  union
  {
    gchar *name;           
    struct in_addr addr;   
    struct in6_addr addr6; 
  };
  enum host_type type; 
  GSList *vhosts;      
};

struct gvm_vhost
{
  char *value;  
  char *source; 
};

struct gvm_hosts
{
  gchar *orig_str;    
  gvm_host_t **hosts; 
  size_t max_size;    
  size_t current;     
  size_t count;       
  size_t removed;     
  size_t duplicated;  
};
 
/* Function prototypes. */
 
/* gvm_hosts_t related */
 
gvm_hosts_t *
gvm_hosts_new (const gchar *);
 
gvm_hosts_t *
gvm_hosts_new_with_max (const gchar *, unsigned int);
 
gvm_host_t *
gvm_hosts_next (gvm_hosts_t *);
 
void
gvm_hosts_move_current_host_to_end (gvm_hosts_t *);
 
void
gvm_hosts_free (gvm_hosts_t *);
 
void
gvm_hosts_shuffle (gvm_hosts_t *);
 
void
gvm_hosts_reverse (gvm_hosts_t *);
 
void
gvm_hosts_add (gvm_hosts_t *, gvm_host_t *);
 
GSList *
gvm_hosts_resolve (gvm_hosts_t *);
 
int
gvm_hosts_exclude (gvm_hosts_t *, const char *);
 
int
gvm_vhosts_exclude (gvm_host_t *, const char *);
 
int
gvm_hosts_exclude_with_max (gvm_hosts_t *, const char *, unsigned int);
 
GSList *
gvm_hosts_allowed_only (gvm_hosts_t *, const char *, const char *);
 
char *
gvm_host_reverse_lookup (gvm_host_t *);
 
int
gvm_hosts_reverse_lookup_only (gvm_hosts_t *);
 
int
gvm_hosts_reverse_lookup_unify (gvm_hosts_t *);
 
gvm_hosts_t *
gvm_hosts_reverse_lookup_only_excluded (gvm_hosts_t *);
 
gvm_hosts_t *
gvm_hosts_reverse_lookup_unify_excluded (gvm_hosts_t *);
 
unsigned int
gvm_hosts_count (const gvm_hosts_t *);
 
unsigned int
gvm_hosts_removed (const gvm_hosts_t *);
 
unsigned int
gvm_hosts_duplicated (const gvm_hosts_t *);
 
/* gvm_host_t related */
 
gvm_host_t *
gvm_host_from_str (const gchar *hosts_str);
 
int
gvm_host_in_hosts (const gvm_host_t *, const struct in6_addr *,
                   const gvm_hosts_t *);
 
gvm_host_t *
gvm_host_find_in_hosts (const gvm_host_t *, const struct in6_addr *,
                        const gvm_hosts_t *);
 
gchar *
gvm_host_type_str (const gvm_host_t *);
 
enum host_type
gvm_host_type (const gvm_host_t *);
 
gchar *
gvm_host_value_str (const gvm_host_t *);
 
int
gvm_host_resolve (const gvm_host_t *, void *, int);
 
int
gvm_host_get_addr6 (const gvm_host_t *, struct in6_addr *);
 
void
gvm_host_add_reverse_lookup (gvm_host_t *);
 
void gvm_host_free (gpointer);
 
gpointer gvm_duplicate_vhost (gconstpointer, gpointer);
 
gvm_host_t *
gvm_duplicate_host (gvm_host_t *);
 
/* Miscellaneous functions */
 
gvm_vhost_t *
gvm_vhost_new (char *, char *);
 
int
gvm_get_host_type (const gchar *);
 
int
gvm_is_cidr6_block (const char *);
 
int
gvm_cidr6_get_block (const char *, unsigned int *);
 
int
gvm_cidr6_get_ip (const char *, struct in6_addr *);
 
int
gvm_cidr6_block_ips (const char *str, struct in6_addr *first,
                     struct in6_addr *last);
 
#endif /* not _GVM_BASE_HOSTS_H */