nvti.c File Reference

Implementation of API to handle NVT Info datasets. More...

#include "nvti.h"
#include <stdio.h>
#include <string.h>
#include <strings.h>
#include <time.h>

Include dependency graph for nvti.c:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	vtref
	The structure for a cross reference of a VT. More...
struct	vtseverity
	The structure for a severity of a VT. More...
struct	nvti
	The structure of a information record that corresponds to a NVT. More...
struct	nvtpref
	The structure for a preference of a NVT. More...

Macros
#define	_XOPEN_SOURCE
#define	G_LOG_DOMAIN   "libgvm base"
	GLib log domain.

Typedefs
typedef struct vtref	vtref_t
	The structure for a cross reference of a VT.
typedef struct vtseverity	vtseverity_t
	The structure for a severity of a VT.
typedef struct nvti	nvti_t
	The structure of a information record that corresponds to a NVT.
typedef struct nvtpref	nvtpref_t
	The structure for a preference of a NVT.

Functions
vtref_t *	vtref_new (const gchar *type, const gchar *ref_id, const gchar *ref_text)
	Create a new vtref structure filled with the given values.
void	vtref_free (vtref_t *ref)
	Free memory of a vtref structure.
const gchar *	vtref_type (const vtref_t *r)
	Get the type of a reference.
const gchar *	vtref_id (const vtref_t *r)
	Get the id of a reference.
const gchar *	vtref_text (const vtref_t *r)
	Get the text of a reference.
vtseverity_t *	vtseverity_new (const gchar *type, const gchar *origin, int date, double score, const gchar *value)
	Create a new vtseverity structure filled with the given values.
void	vtseverity_free (vtseverity_t *s)
	Free memory of a vtseverity structure.
const gchar *	vtseverity_type (const vtseverity_t *s)
	Get the type of a severity.
const gchar *	vtseverity_origin (const vtseverity_t *s)
	Get the origin of a severity.
const gchar *	vtseverity_value (const vtseverity_t *s)
	Get the value of a severity.
int	vtseverity_date (const vtseverity_t *s)
	Get the date of a severity.
double	vtseverity_score (const vtseverity_t *s)
	Get the score of a severity.
static time_t	parse_nvt_timestamp (const gchar *str_time)
	Try convert an NVT tag time string into epoch time or return 0 upon parse errors.
int	nvti_add_vtref (nvti_t *vt, vtref_t *ref)
	Add a reference to the VT Info.
int	nvti_add_vtseverity (nvti_t *vt, vtseverity_t *s)
	Add a severity to the VT Info.
nvtpref_t *	nvtpref_new (int id, const gchar *name, const gchar *type, const gchar *dflt)
	Create a new nvtpref structure filled with the given values.
void	nvtpref_free (nvtpref_t *np)
	Free memory of a nvtpref structure.
int	nvtpref_id (const nvtpref_t *np)
	Get the ID of a NVT Preference.
gchar *	nvtpref_name (const nvtpref_t *np)
	Get the Name of a NVT Preference.
gchar *	nvtpref_type (const nvtpref_t *np)
	Get the Type of a NVT Preference.
gchar *	nvtpref_default (const nvtpref_t *np)
	Get the Default of a NVT Preference.
nvti_t *	nvti_new (void)
	Create a new (empty) nvti structure.
void	nvti_free (nvti_t *n)
	Free memory of a nvti structure.
gchar *	nvti_oid (const nvti_t *n)
	Get the OID string.
gchar *	nvti_name (const nvti_t *n)
	Get the name.
gchar *	nvti_summary (const nvti_t *n)
	Get the summary.
gchar *	nvti_insight (const nvti_t *n)
	Get the text about insight.
gchar *	nvti_affected (const nvti_t *n)
	Get the text about affected systems.
gchar *	nvti_impact (const nvti_t *n)
	Get the text about impact.
time_t	nvti_creation_time (const nvti_t *n)
	Get the creation time.
time_t	nvti_modification_time (const nvti_t *n)
	Get the modification time.
guint	nvti_vtref_len (const nvti_t *n)
	Get the number of references of the NVT.
vtref_t *	nvti_vtref (const nvti_t *n, guint p)
	Get the n'th reference of the NVT.
gchar *	nvti_refs (const nvti_t *n, const gchar *type, const gchar *exclude_types, guint use_types)
	Get references as string.
guint	nvti_vtseverities_len (const nvti_t *n)
	Get the number of severities of the NVT.
vtseverity_t *	nvti_vtseverity (const nvti_t *n, guint p)
	Get the n'th reference of the NVT.
double	nvti_severity_score (const nvti_t *n)
	Get the maximum severity score.
gchar *	nvti_severity_vector_from_tag (const nvti_t *n)
	Get the severity score.
gchar *	nvti_solution (const nvti_t *n)
	Get the solution.
gchar *	nvti_solution_type (const nvti_t *n)
	Get the solution type.
gchar *	nvti_solution_method (const nvti_t *n)
	Get the solution method.
gchar *	nvti_tag (const nvti_t *n)
	Get the tags.
gchar *	nvti_get_tag (const nvti_t *n, const gchar *name)
	Get a tag value by a tag name.
gchar *	nvti_cvss_base (const nvti_t *n)
	Get the CVSS base.
gchar *	nvti_dependencies (const nvti_t *n)
	Get the dependencies list.
gchar *	nvti_required_keys (const nvti_t *n)
	Get the required keys list.
gchar *	nvti_mandatory_keys (const nvti_t *n)
	Get the mandatory keys list.
gchar *	nvti_excluded_keys (const nvti_t *n)
	Get the excluded keys list.
gchar *	nvti_required_ports (const nvti_t *n)
	Get the required ports list.
gchar *	nvti_required_udp_ports (const nvti_t *n)
	Get the required udp ports list.
gchar *	nvti_detection (const nvti_t *n)
	Get the text about detection.
gchar *	nvti_qod_type (const nvti_t *n)
	Get the QoD type.
gchar *	nvti_qod (const nvti_t *n)
	Get the QoD.
gchar *	nvti_family (const nvti_t *n)
	Get the family name.
guint	nvti_pref_len (const nvti_t *n)
	Get the number of preferences of the NVT.
const nvtpref_t *	nvti_pref (const nvti_t *n, guint p)
	Get the n'th preferences of the NVT.
gint	nvti_category (const nvti_t *n)
	Get the category for this NVT.
int	nvti_set_oid (nvti_t *n, const gchar *oid)
	Set the OID of a NVT Info.
int	nvti_set_name (nvti_t *n, const gchar *name)
	Set the name of a NVT.
int	nvti_put_name (nvti_t *n, gchar *name)
	Set the name of a NVT, using the given memory.
int	nvti_set_summary (nvti_t *n, const gchar *summary)
	Set the summary of a NVT.
int	nvti_put_summary (nvti_t *n, gchar *summary)
	Set the summary of a NVT, using the given memory.
int	nvti_set_insight (nvti_t *n, const gchar *insight)
	Set the insight text of a NVT.
int	nvti_put_insight (nvti_t *n, gchar *insight)
	Set the insight text of a NVT, using the given memory.
int	nvti_set_affected (nvti_t *n, const gchar *affected)
	Set the affected text of a NVT.
int	nvti_put_affected (nvti_t *n, gchar *affected)
	Set the affected text of a NVT, using the given memory.
int	nvti_set_impact (nvti_t *n, const gchar *impact)
	Set the impact text of a NVT.
int	nvti_put_impact (nvti_t *n, gchar *impact)
	Set the impact text of a NVT, using the given memory.
int	nvti_set_creation_time (nvti_t *n, const time_t creation_time)
	Set the creation time of a NVT.
int	nvti_set_modification_time (nvti_t *n, const time_t modification_time)
	Set the modification time of a NVT.
int	nvti_set_solution (nvti_t *n, const gchar *solution)
	Set the solution of a NVT.
int	nvti_put_solution (nvti_t *n, gchar *solution)
	Set the solution of a NVT, using the given memory.
int	nvti_set_solution_type (nvti_t *n, const gchar *solution_type)
	Set the solution type of a NVT.
int	nvti_set_solution_method (nvti_t *n, const gchar *solution_method)
	Set the solution method of a NVT.
int	nvti_add_tag (nvti_t *n, const gchar *name, const gchar *value)
	Add a tag to the NVT tags. The tag names "severity_date", "last_modification" and "creation_date" are treated special: The value is expected to be a timestamp and it is being converted to seconds since epoch before added as a tag value. The tag name "cvss_base" will be ignored and not added.
int	nvti_set_tag (nvti_t *n, const gchar *tag)
	Set the tags of a NVT.
int	nvti_set_cvss_base (nvti_t *n, const gchar *cvss_base)
	Set the CVSS base of an NVT.
int	nvti_set_dependencies (nvti_t *n, const gchar *dependencies)
	Set the dependencies of a NVT.
int	nvti_set_required_keys (nvti_t *n, const gchar *required_keys)
	Set the required keys of a NVT.
int	nvti_set_mandatory_keys (nvti_t *n, const gchar *mandatory_keys)
	Set the mandatory keys of a NVT.
int	nvti_set_excluded_keys (nvti_t *n, const gchar *excluded_keys)
	Set the excluded keys of a NVT.
int	nvti_set_required_ports (nvti_t *n, const gchar *required_ports)
	Set the required ports of a NVT.
int	nvti_set_required_udp_ports (nvti_t *n, const gchar *required_udp_ports)
	Set the required udp ports of a NVT.
int	nvti_set_detection (nvti_t *n, const gchar *detection)
	Set the detection text of a NVT.
int	nvti_put_detection (nvti_t *n, gchar *detection)
	Set the detection text of a NVT, using the given memory.
int	nvti_set_qod_type (nvti_t *n, const gchar *qod_type)
	Set the QoD type of a NVT.
int	nvti_set_qod (nvti_t *n, const gchar *qod)
	Set the QoD of a NVT.
int	nvti_set_family (nvti_t *n, const gchar *family)
	Set the family of a NVT.
int	nvti_put_family (nvti_t *n, gchar *family)
	Set the family of a NVT, using the given memory.
int	nvti_set_category (nvti_t *n, const gint category)
	Set the category type of a NVT Info.
int	nvti_add_refs (nvti_t *n, const gchar *type, const gchar *ref_ids, const gchar *ref_text)
	Add many new vtref from a comma-separated list.
int	nvti_add_required_keys (nvti_t *n, const gchar *key)
	Add a required key of a NVT.
int	nvti_add_mandatory_keys (nvti_t *n, const gchar *key)
	Add a mandatory key of a NVT.
int	nvti_add_excluded_keys (nvti_t *n, const gchar *key)
	Add a excluded key of a NVT.
int	nvti_add_required_ports (nvti_t *n, const gchar *port)
	Add a required port of a NVT.
int	nvti_add_required_udp_ports (nvti_t *n, const gchar *port)
	Add a required udp port of a NVT.
int	nvti_add_pref (nvti_t *n, nvtpref_t *np)
	Add a preference to the NVT Info.
static void	free_nvti_for_hash_table (gpointer nvti)
	Free an NVT Info, for g_hash_table_destroy.
nvtis_t *	nvtis_new (void)
	Make a collection of NVT Infos.
void	nvtis_free (nvtis_t *nvtis)
	Free a collection of NVT Infos.
void	nvtis_add (nvtis_t *nvtis, nvti_t *nvti)
	Add an NVT Info to a collection of NVT Infos.
nvti_t *	nvtis_lookup (nvtis_t *nvtis, const char *oid)
	Add an NVT Info to a collection of NVT Infos.

Detailed Description

Implementation of API to handle NVT Info datasets.

This file contains all methods to handle NVT Information datasets (nvti_t).

The module consequently uses glib datatypes and api for memory management etc.

Definition in file nvti.c.

Macro Definition Documentation

_XOPEN_SOURCE

#define _XOPEN_SOURCE

Definition at line 35 of file nvti.c.

G_LOG_DOMAIN

#define G_LOG_DOMAIN   "libgvm base"

GLib log domain.

Definition at line 47 of file nvti.c.

Typedef Documentation

nvti_t

typedef struct nvti nvti_t

The structure of a information record that corresponds to a NVT.

nvtpref_t

typedef struct nvtpref nvtpref_t

The structure for a preference of a NVT.

vtref_t

typedef struct vtref vtref_t

The structure for a cross reference of a VT.

The elements of this structure should only be accessed by the respective functions.

vtseverity_t

typedef struct vtseverity vtseverity_t

The structure for a severity of a VT.

VTs can have one or several severities.

Function Documentation

free_nvti_for_hash_table()

void free_nvti_for_hash_table ( gpointer nvti )

static

Free an NVT Info, for g_hash_table_destroy.

Parameters

nvti	The NVT Info.

Definition at line 2197 of file nvti.c.

{
  nvti_free ((nvti_t *) nvti);
}

References nvti_free().

Referenced by nvtis_new().

Here is the call graph for this function:

Here is the caller graph for this function:

nvti_add_excluded_keys()

int nvti_add_excluded_keys	(	nvti_t *	n,
		const gchar *	key )

Add a excluded key of a NVT.

Parameters

n	The NVT Info structure.
key	The excluded key to add. A copy will be created from this.

Returns

0 for success. 1 if n was NULL. 2 if key was NULL.

Definition at line 2084 of file nvti.c.

{
  gchar *old;
 
  if (!n)
    return 1;
  if (!key)
    return 2;
 
  old = n->excluded_keys;
 
  if (old)
    {
      n->excluded_keys = g_strdup_printf ("%s, %s", old, key);
      g_free (old);
    }
  else
    n->excluded_keys = g_strdup (key);
 
  return 0;
}

References nvti::excluded_keys.

nvti_add_mandatory_keys()

int nvti_add_mandatory_keys	(	nvti_t *	n,
		const gchar *	key )

Add a mandatory key of a NVT.

Parameters

n	The NVT Info structure.
key	The mandatory key to add. A copy will be created from this.

Returns

0 for success. 1 if n was NULL. 2 if key was NULL.

Definition at line 2052 of file nvti.c.

{
  gchar *old;
 
  if (!n)
    return 1;
  if (!key)
    return 2;
 
  old = n->mandatory_keys;
 
  if (old)
    {
      n->mandatory_keys = g_strdup_printf ("%s, %s", old, key);
      g_free (old);
    }
  else
    n->mandatory_keys = g_strdup (key);
 
  return 0;
}

References nvti::mandatory_keys.

nvti_add_pref()

int nvti_add_pref	(	nvti_t *	n,
		nvtpref_t *	np )

Add a preference to the NVT Info.

Parameters

n	The NVT Info structure.
np	The NVT preference to add.

Returns

0 for success. Anything else indicates an error.

Definition at line 2180 of file nvti.c.

{
  if (!n)
    return -1;
 
  n->prefs = g_slist_append (n->prefs, np);
  return 0;
}

References nvti::prefs.

Referenced by add_preferences_to_nvt().

Here is the caller graph for this function:

nvti_add_refs()

int nvti_add_refs	(	nvti_t *	n,
		const gchar *	type,
		const gchar *	ref_ids,
		const gchar *	ref_text )

Add many new vtref from a comma-separated list.

Parameters

n	The NVTI where to add the references.
type	The type for all references. If NULL, then for ref_ids a syntax is expected that includes the type like "type:id,type:id".
ref_ids	A CSV of reference to be added.
ref_text	The optional text accompanying all references.

Returns

0 for success. 1 if n was NULL, 2 if ref_ids was NULL.

Definition at line 1968 of file nvti.c.

{
  gchar **split, **item;
 
  if (!n)
    return 1;
 
  if (!ref_ids)
    return 2;
 
  split = g_strsplit (ref_ids, ",", 0);
 
  for (item = split; *item; item++)
    {
      gchar *id;
 
      id = *item;
      g_strstrip (id);
 
      if (strcmp (id, "") == 0)
        continue;
 
      if (type)
        {
          nvti_add_vtref (n, vtref_new (type, id, ref_text));
        }
      else
        {
          gchar **split2;
 
          split2 = g_strsplit (id, ":", 2);
          if (split2[0] && split2[1])
            nvti_add_vtref (n, vtref_new (split2[0], split2[1], ""));
          g_strfreev (split2);
        }
    }
  g_strfreev (split);
 
  return 0;
}

References nvti_add_vtref(), and vtref_new().

Referenced by redis_get_nvt_all().

Here is the call graph for this function:

Here is the caller graph for this function:

nvti_add_required_keys()

int nvti_add_required_keys	(	nvti_t *	n,
		const gchar *	key )

Add a required key of a NVT.

Parameters

n	The NVT Info structure.
key	The required key to add. A copy will be created from this.

Returns

0 for success. 1 if n was NULL. 2 if key was NULL.

Definition at line 2020 of file nvti.c.

{
  gchar *old;
 
  if (!n)
    return 1;
  if (!key)
    return 2;
 
  old = n->required_keys;
 
  if (old)
    {
      n->required_keys = g_strdup_printf ("%s, %s", old, key);
      g_free (old);
    }
  else
    n->required_keys = g_strdup (key);
 
  return 0;
}

References nvti::required_keys.

nvti_add_required_ports()

int nvti_add_required_ports	(	nvti_t *	n,
		const gchar *	port )

Add a required port of a NVT.

Parameters

n	The NVT Info structure.
port	The required port to add. A copy will be created from this.

Returns

0 for success. 1 if n was NULL. 2 if port was NULL.

Definition at line 2116 of file nvti.c.

{
  gchar *old;
 
  if (!n)
    return 1;
  if (!port)
    return 2;
 
  old = n->required_ports;
 
  if (old)
    {
      n->required_ports = g_strdup_printf ("%s, %s", old, port);
      g_free (old);
    }
  else
    n->required_ports = g_strdup (port);
 
  return 0;
}

References nvti::required_ports.

nvti_add_required_udp_ports()

int nvti_add_required_udp_ports	(	nvti_t *	n,
		const gchar *	port )

Add a required udp port of a NVT.

Parameters

n	The NVT Info structure.
port	The required udp port to add. A copy will be created from this.

Returns

0 for success. 1 if n was NULL. 2 if port was NULL.

Definition at line 2148 of file nvti.c.

{
  gchar *old;
 
  if (!n)
    return 1;
  if (!port)
    return 2;
 
  old = n->required_udp_ports;
 
  if (old)
    {
      n->required_udp_ports = g_strdup_printf ("%s, %s", old, port);
      g_free (old);
    }
  else
    n->required_udp_ports = g_strdup (port);
 
  return 0;
}

References nvti::required_udp_ports.

nvti_add_tag()

int nvti_add_tag	(	nvti_t *	n,
		const gchar *	name,
		const gchar *	value )

Add a tag to the NVT tags. The tag names "severity_date", "last_modification" and "creation_date" are treated special: The value is expected to be a timestamp and it is being converted to seconds since epoch before added as a tag value. The tag name "cvss_base" will be ignored and not added.

Parameters

n	The NVT Info structure.
name	The tag name. A copy will be created from this.
value	The tag value. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1561 of file nvti.c.

{
  gchar *newvalue = NULL;
 
  if (!n)
    return -1;
 
  if (!name || !name[0])
    return -2;
 
  if (!value || !value[0])
    return -3;
 
  if (!strcmp (name, "last_modification"))
    {
      nvti_set_modification_time (n, parse_nvt_timestamp (value));
      newvalue = g_strdup_printf ("%i", (int) nvti_modification_time (n));
    }
  else if (!strcmp (name, "creation_date"))
    {
      nvti_set_creation_time (n, parse_nvt_timestamp (value));
      newvalue = g_strdup_printf ("%i", (int) nvti_creation_time (n));
    }
  else if (!strcmp (name, "severity_date"))
    newvalue = g_strdup_printf ("%i", (int) parse_nvt_timestamp (value));
  else if (!strcmp (name, "cvss_base"))
    {
      /* Ignore this tag because it is not being used.
       * It is redundant with the tag cvss_base_vector from which
       * it is computed.
       * Once GOS 6 and GVM 11 are retired, all set_tag commands
       * in the NASL scripts can be removed that set "cvss_base".
       * Once this happened this exception can be removed from the code.
       */
      return 0;
    }
 
  if (n->tag)
    {
      gchar *newtag;
 
      newtag =
        g_strconcat (n->tag, "|", name, "=", newvalue ? newvalue : value, NULL);
      g_free (n->tag);
      n->tag = newtag;
    }
  else
    n->tag = g_strconcat (name, "=", newvalue ? newvalue : value, NULL);
 
  g_free (newvalue);
 
  return 0;
}

References nvti_creation_time(), nvti_modification_time(), nvti_set_creation_time(), nvti_set_modification_time(), parse_nvt_timestamp(), and nvti::tag.

Referenced by add_tags_to_nvt().

Here is the call graph for this function:

Here is the caller graph for this function:

nvti_add_vtref()

int nvti_add_vtref	(	nvti_t *	vt,
		vtref_t *	ref )

Add a reference to the VT Info.

Parameters

vt	The VT Info structure.
ref	The VT reference to add.

Returns

0 for success. Anything else indicates an error.

Definition at line 408 of file nvti.c.

{
  if (!vt)
    return -1;
 
  vt->refs = g_slist_append (vt->refs, ref);
  return 0;
}

References nvti::refs.

Referenced by nvti_add_refs(), and parse_references().

Here is the caller graph for this function:

nvti_add_vtseverity()

int nvti_add_vtseverity	(	nvti_t *	vt,
		vtseverity_t *	s )

Add a severity to the VT Info.

Parameters

vt	The VT Info structure.
s	The VT severity to add.

Returns

0 for success. Anything else indicates an error.

Definition at line 426 of file nvti.c.

{
  if (!vt)
    return -1;
 
  vt->severities = g_slist_append (vt->severities, s);
  return 0;
}

References nvti::severities.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_affected()

gchar * nvti_affected

(

const nvti_t *

n

)

Get the text about affected systems.

Parameters

n	The NVT Info structure of which the affected description should be returned.

Returns

The affected string. Don't free this.

Definition at line 667 of file nvti.c.

{
  return n ? n->affected : NULL;
}

References nvti::affected.

nvti_category()

gint nvti_category

(

const nvti_t *

n

)

Get the category for this NVT.

Parameters

n	The NVT Info structure of which the category should be returned.

Returns

The category integer code. A value <= 0 indicates it is not set.

Definition at line 1199 of file nvti.c.

{
  return n ? n->category : -1;
}

References nvti::category.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_creation_time()

time_t nvti_creation_time

(

const nvti_t *

n

)

Get the creation time.

Parameters

n	The NVT Info structure of which the creation time should be returned.

Returns

The creation time in seconds since epoch.

Definition at line 695 of file nvti.c.

{
  return n ? n->creation_time : 0;
}

References nvti::creation_time.

Referenced by nvti_add_tag().

Here is the caller graph for this function:

nvti_cvss_base()

gchar * nvti_cvss_base

(

const nvti_t *

n

)

Get the CVSS base.

Parameters

n	The NVT Info structure of which the CVSS base should be returned.

Returns

The cvss_base string. Don't free this.

Definition at line 1018 of file nvti.c.

{
  return n ? n->cvss_base : NULL;
}

References nvti::cvss_base.

nvti_dependencies()

gchar * nvti_dependencies

(

const nvti_t *

n

)

Get the dependencies list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The dependencies string. Don't free this.

Definition at line 1032 of file nvti.c.

{
  return n ? n->dependencies : NULL;
}

References nvti::dependencies.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_detection()

gchar * nvti_detection

(

const nvti_t *

n

)

Get the text about detection.

Parameters

n	The NVT Info structure of which the detection should be returned.

Returns

The detection string. Don't free this.

Definition at line 1116 of file nvti.c.

{
  return n ? n->detection : NULL;
}

References nvti::detection.

nvti_excluded_keys()

gchar * nvti_excluded_keys

(

const nvti_t *

n

)

Get the excluded keys list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The excluded keys string. Don't free this.

Definition at line 1074 of file nvti.c.

{
  return n ? n->excluded_keys : NULL;
}

References nvti::excluded_keys.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_family()

gchar * nvti_family

(

const nvti_t *

n

)

Get the family name.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The family name string. Don't free this.

Definition at line 1158 of file nvti.c.

{
  return n ? n->family : NULL;
}

References nvti::family.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_free()

void nvti_free

(

nvti_t *

n

)

Free memory of a nvti structure.

Parameters

n	The structure to be freed.

Definition at line 570 of file nvti.c.

{
  if (!n)
    return;
 
  g_free (n->oid);
  g_free (n->name);
  g_free (n->summary);
  g_free (n->insight);
  g_free (n->affected);
  g_free (n->impact);
  g_free (n->solution);
  g_free (n->solution_type);
  g_free (n->solution_method);
  g_free (n->tag);
  g_free (n->cvss_base);
  g_free (n->dependencies);
  g_free (n->required_keys);
  g_free (n->mandatory_keys);
  g_free (n->excluded_keys);
  g_free (n->required_ports);
  g_free (n->required_udp_ports);
  g_free (n->detection);
  g_free (n->qod_type);
  g_free (n->qod);
  g_free (n->family);
  g_slist_free_full (n->refs, (void (*) (void *)) vtref_free);
  g_slist_free_full (n->severities, (void (*) (void *)) vtseverity_free);
  g_slist_free_full (n->prefs, (void (*) (void *)) nvtpref_free);
  g_free (n);
}

References nvti::affected, nvti::cvss_base, nvti::dependencies, nvti::detection, nvti::excluded_keys, nvti::family, nvti::impact, nvti::insight, nvti::mandatory_keys, nvti::name, nvtpref_free(), nvti::oid, nvti::prefs, nvti::qod, nvti::qod_type, nvti::refs, nvti::required_keys, nvti::required_ports, nvti::required_udp_ports, nvti::severities, nvti::solution, nvti::solution_method, nvti::solution_type, nvti::summary, nvti::tag, vtref_free(), and vtseverity_free().

Referenced by Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), free_nvti_for_hash_table(), and parse_vt_json().

Here is the call graph for this function:

Here is the caller graph for this function:

nvti_get_tag()

gchar * nvti_get_tag	(	const nvti_t *	n,
		const gchar *	name )

Get a tag value by a tag name.

Parameters

n	The NVT Info structure from where to search for the tag name.
name	The name of the tag for which to return the value.

Returns

The tag value string as a copy or NULL if not found. Needs to be free'd.

Definition at line 982 of file nvti.c.

{
  gchar **split, **point;
 
  if (!n || n->tag == NULL || !name)
    return NULL;
 
  split = g_strsplit (n->tag, "|", 0);
  point = split;
 
  while (*point)
    {
      if ((strlen (*point) > strlen (name))
          && (strncmp (*point, name, strlen (name)) == 0)
          && ((*point)[strlen (name)] == '='))
        {
          gchar *ret;
          ret = g_strdup (*point + strlen (name) + 1);
          g_strfreev (split);
          return ret;
        }
      point++;
    }
  g_strfreev (split);
  return NULL;
}

References nvti::tag.

Referenced by Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), and nvti_severity_vector_from_tag().

Here is the caller graph for this function:

nvti_impact()

gchar * nvti_impact

(

const nvti_t *

n

)

Get the text about impact.

Parameters

n	The NVT Info structure of which the impact description should be returned.

Returns

The impact string. Don't free this.

Definition at line 681 of file nvti.c.

{
  return n ? n->impact : NULL;
}

References nvti::impact.

nvti_insight()

gchar * nvti_insight

(

const nvti_t *

n

)

Get the text about insight.

Parameters

n	The NVT Info structure of which the insight description should be returned.

Returns

The insight string. Don't free this.

Definition at line 653 of file nvti.c.

{
  return n ? n->insight : NULL;
}

References nvti::insight.

nvti_mandatory_keys()

gchar * nvti_mandatory_keys

(

const nvti_t *

n

)

Get the mandatory keys list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The mandatory keys string. Don't free this.

Definition at line 1060 of file nvti.c.

{
  return n ? n->mandatory_keys : NULL;
}

References nvti::mandatory_keys.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_modification_time()

time_t nvti_modification_time

(

const nvti_t *

n

)

Get the modification time.

Parameters

n	The NVT Info structure of which the modification time should be returned.

Returns

The modification time in seconds since epoch.

Definition at line 709 of file nvti.c.

{
  return n ? n->modification_time : 0;
}

References nvti::modification_time.

Referenced by nvti_add_tag().

Here is the caller graph for this function:

nvti_name()

gchar * nvti_name

(

const nvti_t *

n

)

Get the name.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The name string. Don't free this.

Definition at line 625 of file nvti.c.

{
  return n ? n->name : NULL;
}

References nvti::name.

Referenced by Ensure(), and redis_add_nvt().

Here is the caller graph for this function:

nvti_new()

nvti_t * nvti_new

(

void

)

Create a new (empty) nvti structure.

Returns

An empty nvti structure which needs to be released using nvti_free . The whole struct is initialized with 0's.

Definition at line 559 of file nvti.c.

{
  return (nvti_t *) g_malloc0 (sizeof (nvti_t));
}

Referenced by Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), parse_vt_json(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_oid()

gchar * nvti_oid

(

const nvti_t *

n

)

Get the OID string.

Parameters

n	The NVT Info structure of which the OID should be returned.

Returns

The OID string. Don't free this.

Definition at line 611 of file nvti.c.

{
  return n ? n->oid : NULL;
}

References nvti::oid.

Referenced by add_tags_to_nvt(), Ensure(), nvticache_add(), nvtis_add(), and redis_add_nvt().

Here is the caller graph for this function:

nvti_pref()

const nvtpref_t * nvti_pref	(	const nvti_t *	n,
		guint	p )

Get the n'th preferences of the NVT.

Parameters

n	The NVT Info structure.
p	The position of the preference to return.

Returns

The preference. NULL on error.

Definition at line 1186 of file nvti.c.

{
  return n ? g_slist_nth_data (n->prefs, p) : NULL;
}

References nvti::prefs.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_pref_len()

guint nvti_pref_len

(

const nvti_t *

n

)

Get the number of preferences of the NVT.

Parameters

n	The NVT Info structure.

Returns

The number of preferences.

Definition at line 1171 of file nvti.c.

{
  return n ? g_slist_length (n->prefs) : 0;
}

References nvti::prefs.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_put_affected()

int nvti_put_affected	(	nvti_t *	n,
		gchar *	affected )

Set the affected text of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
affected	The affected text to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1374 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->affected);
  n->affected = affected;
  return 0;
}

References nvti::affected.

nvti_put_detection()

int nvti_put_detection	(	nvti_t *	n,
		gchar *	detection )

Set the detection text of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
detection	The detection text to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1835 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->detection);
  n->detection = detection;
  return 0;
}

References nvti::detection.

nvti_put_family()

int nvti_put_family	(	nvti_t *	n,
		gchar *	family )

Set the family of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
family	The family to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1923 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->family);
  n->family = family;
  return 0;
}

References nvti::family.

nvti_put_impact()

int nvti_put_impact	(	nvti_t *	n,
		gchar *	impact )

Set the impact text of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
impact	The impact text to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1414 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->impact);
  n->impact = impact;
  return 0;
}

References nvti::impact.

nvti_put_insight()

int nvti_put_insight	(	nvti_t *	n,
		gchar *	insight )

Set the insight text of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
insight	The insight text to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1334 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->insight);
  n->insight = insight;
  return 0;
}

References nvti::insight.

nvti_put_name()

int nvti_put_name	(	nvti_t *	n,
		gchar *	name )

Set the name of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
name	The name to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1254 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->name);
  n->name = name;
  return 0;
}

References nvti::name.

nvti_put_solution()

int nvti_put_solution	(	nvti_t *	n,
		gchar *	solution )

Set the solution of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
solution	The solution to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1492 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->solution);
  n->solution = solution;
  return 0;
}

References nvti::solution.

nvti_put_summary()

int nvti_put_summary	(	nvti_t *	n,
		gchar *	summary )

Set the summary of a NVT, using the given memory.

Parameters

n	The NVT Info structure.
summary	The summary to set. The string will be used directly.

Returns

0 for success. Anything else indicates an error.

Definition at line 1294 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->summary);
  n->summary = summary;
  return 0;
}

References nvti::summary.

nvti_qod()

gchar * nvti_qod

(

const nvti_t *

n

)

Get the QoD.

Parameters

n	The NVT Info structure of which the QoD should be returned.

Returns

The QoD as string. Don't free this.

Definition at line 1144 of file nvti.c.

{
  return n ? n->qod : NULL;
}

References nvti::qod.

nvti_qod_type()

gchar * nvti_qod_type

(

const nvti_t *

n

)

Get the QoD type.

Parameters

n	The NVT Info structure of which the QoD type should be returned.

Returns

The QoD type as string. Don't free this.

Definition at line 1130 of file nvti.c.

{
  return n ? n->qod_type : NULL;
}

References nvti::qod_type.

nvti_refs()

gchar * nvti_refs	(	const nvti_t *	n,
		const gchar *	type,
		const gchar *	exclude_types,
		guint	use_types )

Get references as string.

Parameters

n	The NVT Info structure of which the references should be returned.
type	Optional type to collect. If NULL, all types are collected.
exclude_types	Optional CSC list of types to exclude from collection. If NULL, no types are excluded.
use_types	If 0, then a simple comma separated list will be returned. If not 0, then for each reference the syntax "type:id" is applied.

Returns

The references as string. This needs to be free'd. The format of the string depends on the "use_types" parameter. If use_types is 0 it is a comma-separated list "id, id, id" is returned. If use_types is not 0 a comma-separated list like "type:id, type:id, type:id" is returned. NULL is returned in case n is NULL.

Definition at line 766 of file nvti.c.

{
  gchar *refs, *refs2, **exclude_item;
  vtref_t *ref;
  guint i, exclude;
  gchar **exclude_split;
 
  if (!n)
    return NULL;
 
  refs = NULL;
  refs2 = NULL;
  exclude = 0;
 
  if (exclude_types && exclude_types[0])
    exclude_split = g_strsplit (exclude_types, ",", 0);
  else
    exclude_split = NULL;
 
  for (i = 0; i < g_slist_length (n->refs); i++)
    {
      ref = g_slist_nth_data (n->refs, i);
      if (type && strcasecmp (ref->type, type) != 0)
        continue;
 
      if (exclude_split)
        {
          exclude = 0;
          for (exclude_item = exclude_split; *exclude_item; exclude_item++)
            {
              if (strcasecmp (g_strstrip (*exclude_item), ref->type) == 0)
                {
                  exclude = 1;
                  break;
                }
            }
        }
 
      if (!exclude)
        {
          if (use_types)
            {
              if (refs)
                refs2 =
                  g_strdup_printf ("%s, %s:%s", refs, ref->type, ref->ref_id);
              else
                refs2 = g_strdup_printf ("%s:%s", ref->type, ref->ref_id);
            }
          else
            {
              if (refs)
                refs2 = g_strdup_printf ("%s, %s", refs, ref->ref_id);
              else
                refs2 = g_strdup_printf ("%s", ref->ref_id);
            }
          g_free (refs);
          refs = refs2;
        }
    }
 
  g_strfreev (exclude_split);
 
  return refs;
}

References vtref::ref_id, nvti::refs, and vtref::type.

Referenced by Ensure(), and redis_add_nvt().

Here is the caller graph for this function:

nvti_required_keys()

gchar * nvti_required_keys

(

const nvti_t *

n

)

Get the required keys list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The required keys string. Don't free this.

Definition at line 1046 of file nvti.c.

{
  return n ? n->required_keys : NULL;
}

References nvti::required_keys.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_required_ports()

gchar * nvti_required_ports

(

const nvti_t *

n

)

Get the required ports list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The required ports string. Don't free this.

Definition at line 1088 of file nvti.c.

{
  return n ? n->required_ports : NULL;
}

References nvti::required_ports.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_required_udp_ports()

gchar * nvti_required_udp_ports

(

const nvti_t *

n

)

Get the required udp ports list.

Parameters

n	The NVT Info structure of which the name should be returned.

Returns

The required udp ports string. Don't free this.

Definition at line 1102 of file nvti.c.

{
  return n ? n->required_udp_ports : NULL;
}

References nvti::required_udp_ports.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_set_affected()

int nvti_set_affected	(	nvti_t *	n,
		const gchar *	affected )

Set the affected text of a NVT.

Parameters

n	The NVT Info structure.
affected	The affected text to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1354 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->affected);
  n->affected = g_strdup (affected);
  return 0;
}

References nvti::affected.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_category()

int nvti_set_category	(	nvti_t *	n,
		const gint	category )

Set the category type of a NVT Info.

Parameters

n	The NVT Info structure.
category	The category to set. Values <= 0 will indicate it is not set.

Returns

0 for success. Anything else indicates an error.

Definition at line 1943 of file nvti.c.

{
  if (!n)
    return -1;
 
  n->category = category;
  return 0;
}

References nvti::category.

Referenced by parse_vt_json(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_creation_time()

int nvti_set_creation_time	(	nvti_t *	n,
		const time_t	creation_time )

Set the creation time of a NVT.

Parameters

n	The NVT Info structure.
creation_time	The creation time to set.

Returns

0 for success. Anything else indicates an error.

Definition at line 1434 of file nvti.c.

{
  if (!n)
    return -1;
 
  n->creation_time = creation_time;
  return 0;
}

References nvti::creation_time.

Referenced by add_tags_to_nvt(), and nvti_add_tag().

Here is the caller graph for this function:

nvti_set_cvss_base()

int nvti_set_cvss_base	(	nvti_t *	n,
		const gchar *	cvss_base )

Set the CVSS base of an NVT.

Parameters

n	The NVT Info structure.
cvss_base	The CVSS base to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1648 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->cvss_base);
  if (cvss_base && cvss_base[0])
    n->cvss_base = g_strdup (cvss_base);
  else
    n->cvss_base = NULL;
  return 0;
}

References nvti::cvss_base.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_dependencies()

int nvti_set_dependencies	(	nvti_t *	n,
		const gchar *	dependencies )

Set the dependencies of a NVT.

Parameters

n	The NVT Info structure.
dependencies	The dependencies to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1672 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->dependencies);
  if (dependencies && dependencies[0])
    n->dependencies = g_strdup (dependencies);
  else
    n->dependencies = NULL;
  return 0;
}

References nvti::dependencies.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_detection()

int nvti_set_detection	(	nvti_t *	n,
		const gchar *	detection )

Set the detection text of a NVT.

Parameters

n	The NVT Info structure.
detection	The detection text to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1815 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->detection);
  n->detection = g_strdup (detection);
  return 0;
}

References nvti::detection.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_excluded_keys()

int nvti_set_excluded_keys	(	nvti_t *	n,
		const gchar *	excluded_keys )

Set the excluded keys of a NVT.

Parameters

n	The NVT Info structure.
excluded_keys	The excluded keys to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1744 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->excluded_keys);
  if (excluded_keys && excluded_keys[0])
    n->excluded_keys = g_strdup (excluded_keys);
  else
    n->excluded_keys = NULL;
  return 0;
}

References nvti::excluded_keys.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_family()

int nvti_set_family	(	nvti_t *	n,
		const gchar *	family )

Set the family of a NVT.

Parameters

n	The NVT Info structure.
family	The family to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1903 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->family);
  n->family = g_strdup (family);
  return 0;
}

References nvti::family.

Referenced by parse_vt_json(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_impact()

int nvti_set_impact	(	nvti_t *	n,
		const gchar *	impact )

Set the impact text of a NVT.

Parameters

n	The NVT Info structure.
impact	The impact text to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1394 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->impact);
  n->impact = g_strdup (impact);
  return 0;
}

References nvti::impact.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_insight()

int nvti_set_insight	(	nvti_t *	n,
		const gchar *	insight )

Set the insight text of a NVT.

Parameters

n	The NVT Info structure.
insight	The insight text to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1314 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->insight);
  n->insight = g_strdup (insight);
  return 0;
}

References nvti::insight.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_mandatory_keys()

int nvti_set_mandatory_keys	(	nvti_t *	n,
		const gchar *	mandatory_keys )

Set the mandatory keys of a NVT.

Parameters

n	The NVT Info structure.
mandatory_keys	The mandatory keys to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1720 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->mandatory_keys);
  if (mandatory_keys && mandatory_keys[0])
    n->mandatory_keys = g_strdup (mandatory_keys);
  else
    n->mandatory_keys = NULL;
  return 0;
}

References nvti::mandatory_keys.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_modification_time()

int nvti_set_modification_time	(	nvti_t *	n,
		const time_t	modification_time )

Set the modification time of a NVT.

Parameters

n	The NVT Info structure.
modification_time	The modification time to set.

Returns

0 for success. Anything else indicates an error.

Definition at line 1453 of file nvti.c.

{
  if (!n)
    return -1;
 
  n->modification_time = modification_time;
  return 0;
}

References nvti::modification_time.

Referenced by add_tags_to_nvt(), and nvti_add_tag().

Here is the caller graph for this function:

nvti_set_name()

int nvti_set_name	(	nvti_t *	n,
		const gchar *	name )

Set the name of a NVT.

Parameters

n	The NVT Info structure.
name	The name to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1234 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->name);
  n->name = g_strdup (name);
  return 0;
}

References nvti::name.

Referenced by parse_vt_json(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_oid()

int nvti_set_oid	(	nvti_t *	n,
		const gchar *	oid )

Set the OID of a NVT Info.

Parameters

n	The NVT Info structure.
oid	The OID to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1214 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->oid);
  n->oid = g_strdup (oid);
  return 0;
}

References nvti::oid.

Referenced by Ensure(), parse_vt_json(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_qod()

int nvti_set_qod	(	nvti_t *	n,
		const gchar *	qod )

Set the QoD of a NVT.

Parameters

n	The NVT Info structure.
qod	The QoD to set. A copy will be created from this. The string is not checked, any string is accepted as type.

Returns

0 for success. Anything else indicates an error.

Definition at line 1880 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->qod);
  if (qod && qod[0])
    n->qod = g_strdup (qod);
  else
    n->qod = NULL;
  return 0;
}

References nvti::qod.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_qod_type()

int nvti_set_qod_type	(	nvti_t *	n,
		const gchar *	qod_type )

Set the QoD type of a NVT.

Parameters

n	The NVT Info structure.
qod_type	The QoD type to set. A copy will be created from this. The string is not checked, any string is accepted as type.

Returns

0 for success. Anything else indicates an error.

Definition at line 1856 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->qod_type);
  if (qod_type && qod_type[0])
    n->qod_type = g_strdup (qod_type);
  else
    n->qod_type = NULL;
  return 0;
}

References nvti::qod_type.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_required_keys()

int nvti_set_required_keys	(	nvti_t *	n,
		const gchar *	required_keys )

Set the required keys of a NVT.

Parameters

n	The NVT Info structure.
required_keys	The required keys to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1696 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->required_keys);
  if (required_keys && required_keys[0])
    n->required_keys = g_strdup (required_keys);
  else
    n->required_keys = NULL;
  return 0;
}

References nvti::required_keys.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_required_ports()

int nvti_set_required_ports	(	nvti_t *	n,
		const gchar *	required_ports )

Set the required ports of a NVT.

Parameters

n	The NVT Info structure.
required_ports	The required ports to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1768 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->required_ports);
  if (required_ports && required_ports[0])
    n->required_ports = g_strdup (required_ports);
  else
    n->required_ports = NULL;
  return 0;
}

References nvti::required_ports.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_required_udp_ports()

int nvti_set_required_udp_ports	(	nvti_t *	n,
		const gchar *	required_udp_ports )

Set the required udp ports of a NVT.

Parameters

n	The NVT Info structure.
required_udp_ports	The required udp ports to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1792 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->required_udp_ports);
  if (required_udp_ports && required_udp_ports[0])
    n->required_udp_ports = g_strdup (required_udp_ports);
  else
    n->required_udp_ports = NULL;
  return 0;
}

References nvti::required_udp_ports.

Referenced by redis_get_nvt_all().

Here is the caller graph for this function:

nvti_set_solution()

int nvti_set_solution	(	nvti_t *	n,
		const gchar *	solution )

Set the solution of a NVT.

Parameters

n	The NVT Info structure.
solution	The solution to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1472 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->solution);
  n->solution = g_strdup (solution);
  return 0;
}

References nvti::solution.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_solution_method()

int nvti_set_solution_method	(	nvti_t *	n,
		const gchar *	solution_method )

Set the solution method of a NVT.

Parameters

n	The NVT Info structure.
solution_method	The solution method to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1534 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->solution_method);
  n->solution_method = g_strdup (solution_method);
  return 0;
}

References nvti::solution_method.

Referenced by add_tags_to_nvt(), and Ensure().

Here is the caller graph for this function:

nvti_set_solution_type()

int nvti_set_solution_type	(	nvti_t *	n,
		const gchar *	solution_type )

Set the solution type of a NVT.

Parameters

n	The NVT Info structure.
solution_type	The solution type to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1513 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->solution_type);
  n->solution_type = g_strdup (solution_type);
  return 0;
}

References nvti::solution_type.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_summary()

int nvti_set_summary	(	nvti_t *	n,
		const gchar *	summary )

Set the summary of a NVT.

Parameters

n	The NVT Info structure.
summary	The summary to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1274 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->summary);
  n->summary = g_strdup (summary);
  return 0;
}

References nvti::summary.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

nvti_set_tag()

int nvti_set_tag	(	nvti_t *	n,
		const gchar *	tag )

Set the tags of a NVT.

Parameters

n	The NVT Info structure.
tag	The tags to set. A copy will be created from this.

Returns

0 for success. Anything else indicates an error.

Definition at line 1625 of file nvti.c.

{
  if (!n)
    return -1;
 
  g_free (n->tag);
  if (tag && tag[0])
    n->tag = g_strdup (tag);
  else
    n->tag = NULL;
  return 0;
}

References nvti::tag.

Referenced by Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), and redis_get_nvt_all().

Here is the caller graph for this function:

nvti_severity_score()

double nvti_severity_score

(

const nvti_t *

n

)

Get the maximum severity score.

Parameters

n	The NVT Info structure.

Returns

The severity score, -1 indicates an error.

Definition at line 868 of file nvti.c.

{
  unsigned int i;
  double score = -1.0;
 
  for (i = 0; i < nvti_vtseverities_len (n); i++)
    {
      vtseverity_t *severity;
 
      severity = nvti_vtseverity (n, i);
      if (vtseverity_score (severity) > score)
        score = vtseverity_score (severity);
    }
 
  return score;
}

References nvti_vtseverities_len(), nvti_vtseverity(), and vtseverity_score().

Here is the call graph for this function:

nvti_severity_vector_from_tag()

gchar * nvti_severity_vector_from_tag

(

const nvti_t *

n

)

Get the severity score.

Extended severity was introduced but still not all vts are using it. Therefore it must be checked if we can calculate the score from the severity_vector tag or if we have to calculate it from the deprecated cvss_base_vector tag.

Parameters

n	The NVT Info structure.

Returns

The severity_vector if present or cvss_base_vector otherwise. NULL indicates an error. Must be free()'d by the caller.

Definition at line 900 of file nvti.c.

{
  gchar *vector;
 
  /* Currently, only one severity_vector can be stored as tag.
   * Therfore we just check this one. */
  vector = nvti_get_tag (n, "severity_vector");
  if (vector)
    return vector;
 
  vector = nvti_get_tag (n, "cvss_base_vector");
 
  return vector;
}

References nvti_get_tag().

Referenced by Ensure(), Ensure(), and Ensure().

Here is the call graph for this function:

Here is the caller graph for this function:

nvti_solution()

gchar * nvti_solution

(

const nvti_t *

n

)

Get the solution.

Parameters

n	The NVT Info structure of which the solution should be returned.

Returns

The solution string. Don't free this.

Definition at line 924 of file nvti.c.

{
  return n ? n->solution : NULL;
}

References nvti::solution.

nvti_solution_method()

gchar * nvti_solution_method

(

const nvti_t *

n

)

Get the solution method.

Parameters

n	The NVT Info structure of which the solution method should be returned.

Returns

The solution method string. Don't free this.

Definition at line 952 of file nvti.c.

{
  return n ? n->solution_method : NULL;
}

References nvti::solution_method.

Referenced by Ensure().

Here is the caller graph for this function:

nvti_solution_type()

gchar * nvti_solution_type

(

const nvti_t *

n

)

Get the solution type.

Parameters

n	The NVT Info structure of which the solution type should be returned.

Returns

The solution type string. Don't free this.

Definition at line 938 of file nvti.c.

{
  return n ? n->solution_type : NULL;
}

References nvti::solution_type.

nvti_summary()

gchar * nvti_summary

(

const nvti_t *

n

)

Get the summary.

Parameters

n	The NVT Info structure of which the summary should be returned.

Returns

The summary string. Don't free this.

Definition at line 639 of file nvti.c.

{
  return n ? n->summary : NULL;
}

References nvti::summary.

nvti_tag()

gchar * nvti_tag

(

const nvti_t *

n

)

Get the tags.

Parameters

n	The NVT Info structure of which the tags should be returned.

Returns

The tags string. Don't free this.

Definition at line 966 of file nvti.c.

{
  return n ? n->tag : NULL;
}

References nvti::tag.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvti_vtref()

vtref_t * nvti_vtref	(	const nvti_t *	n,
		guint	p )

Get the n'th reference of the NVT.

Parameters

n	The NVT Info structure.
p	The position of the reference to return.

Returns

The reference. NULL on error.

Definition at line 737 of file nvti.c.

{
  return n ? g_slist_nth_data (n->refs, p) : NULL;
}

References nvti::refs.

nvti_vtref_len()

guint nvti_vtref_len

(

const nvti_t *

n

)

Get the number of references of the NVT.

Parameters

n	The NVT Info structure.

Returns

The number of references.

Definition at line 722 of file nvti.c.

{
  return n ? g_slist_length (n->refs) : 0;
}

References nvti::refs.

nvti_vtseverities_len()

guint nvti_vtseverities_len

(

const nvti_t *

n

)

Get the number of severities of the NVT.

Parameters

n	The NVT Info structure.

Returns

The number of severities.

Definition at line 840 of file nvti.c.

{
  return n ? g_slist_length (n->severities) : 0;
}

References nvti::severities.

Referenced by nvti_severity_score().

Here is the caller graph for this function:

nvti_vtseverity()

vtseverity_t * nvti_vtseverity	(	const nvti_t *	n,
		guint	p )

Get the n'th reference of the NVT.

Parameters

n	The NVT Info structure.
p	The position of the reference to return.

Returns

The reference. NULL on error.

Definition at line 855 of file nvti.c.

{
  return n ? g_slist_nth_data (n->severities, p) : NULL;
}

References nvti::severities.

Referenced by nvti_severity_score().

Here is the caller graph for this function:

nvtis_add()

void nvtis_add	(	nvtis_t *	nvtis,
		nvti_t *	nvti )

Add an NVT Info to a collection of NVT Infos.

Parameters

nvtis	The collection of NVT Infos.
nvti	The NVT Info to add.

Definition at line 2233 of file nvti.c.

{
  if (nvti)
    g_hash_table_insert (
      nvtis, (gpointer) (nvti_oid (nvti) ? g_strdup (nvti_oid (nvti)) : NULL),
      (gpointer) nvti);
}

References nvti_oid().

Referenced by Ensure().

Here is the call graph for this function:

Here is the caller graph for this function:

nvtis_free()

void nvtis_free

(

nvtis_t *

nvtis

)

Free a collection of NVT Infos.

Parameters

nvtis

The collection of NVT Infos.

Definition at line 2220 of file nvti.c.

{
  if (nvtis)
    g_hash_table_destroy (nvtis);
}

Referenced by Ensure().

Here is the caller graph for this function:

nvtis_lookup()

nvti_t * nvtis_lookup	(	nvtis_t *	nvtis,
		const char *	oid )

Add an NVT Info to a collection of NVT Infos.

Parameters

nvtis	The collection of NVT Infos.
oid	The OID of the NVT.

Returns

The NVT Info, if found, else NULL.

Definition at line 2250 of file nvti.c.

{
  return g_hash_table_lookup (nvtis, oid);
}

Referenced by Ensure().

Here is the caller graph for this function:

nvtis_new()

nvtis_t * nvtis_new

(

void

)

Make a collection of NVT Infos.

Returns

An empty collection of NVT Infos.

Definition at line 2208 of file nvti.c.

{
  return g_hash_table_new_full (g_str_hash, g_str_equal, g_free,
                                free_nvti_for_hash_table);
}

References free_nvti_for_hash_table().

Referenced by Ensure().

Here is the call graph for this function:

Here is the caller graph for this function:

nvtpref_default()

gchar * nvtpref_default

(

const nvtpref_t *

np

)

Get the Default of a NVT Preference.

Parameters

np	The NVT Pref structure of which the Default should be returned.

Returns

The default string. Don't free this.

Definition at line 546 of file nvti.c.

{
  return np ? np->dflt : NULL;
}

References nvtpref::dflt.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvtpref_free()

void nvtpref_free

(

nvtpref_t *

np

)

Free memory of a nvtpref structure.

Parameters

np	The structure to be freed.

Definition at line 484 of file nvti.c.

{
  if (!np)
    return;
 
  g_free (np->name);
  g_free (np->type);
  g_free (np->dflt);
  g_free (np);
}

References nvtpref::dflt, nvtpref::name, and nvtpref::type.

Referenced by nvti_free().

Here is the caller graph for this function:

nvtpref_id()

int nvtpref_id

(

const nvtpref_t *

np

)

Get the ID of a NVT Preference.

Parameters

np	The NVT Pref structure of which the Name should be returned.

Returns

The ID value.

Definition at line 504 of file nvti.c.

{
  return np ? np->id : -1;
}

References nvtpref::id.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvtpref_name()

gchar * nvtpref_name

(

const nvtpref_t *

np

)

Get the Name of a NVT Preference.

Parameters

np	The NVT Pref structure of which the Name should be returned.

Returns

The name string. Don't free this.

Definition at line 518 of file nvti.c.

{
  return np ? np->name : NULL;
}

References nvtpref::name.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

nvtpref_new()

nvtpref_t * nvtpref_new	(	int	id,
		const gchar *	name,
		const gchar *	type,
		const gchar *	dflt )

Create a new nvtpref structure filled with the given values.

Parameters

id	The ID to be set.
name	The name to be set. A copy will created of this.
type	The type to be set. A copy will created of this.
dflt	The default to be set. A copy will created of this.

Returns

An nvtpref structure which needs to be released using nvtpref_free .

Definition at line 463 of file nvti.c.

{
  nvtpref_t *np = g_malloc0 (sizeof (nvtpref_t));
 
  np->id = id;
  if (name)
    np->name = g_strdup (name);
  if (type)
    np->type = g_strdup (type);
  if (dflt)
    np->dflt = g_strdup (dflt);
 
  return np;
}

References nvtpref::dflt, nvtpref::id, nvtpref::name, and nvtpref::type.

Referenced by add_preferences_to_nvt(), and nvticache_get_prefs().

Here is the caller graph for this function:

nvtpref_type()

gchar * nvtpref_type

(

const nvtpref_t *

np

)

Get the Type of a NVT Preference.

Parameters

np	The NVT Pref structure of which the Type should be returned.

Returns

The type string. Don't free this.

Definition at line 532 of file nvti.c.

{
  return np ? np->type : NULL;
}

References nvtpref::type.

Referenced by redis_add_nvt().

Here is the caller graph for this function:

parse_nvt_timestamp()

time_t parse_nvt_timestamp ( const gchar * str_time )

static

Try convert an NVT tag time string into epoch time or return 0 upon parse errors.

Parameters

[in]

str_time

Time stamp as string in one of the forms used in NVTs.

Returns

Time as seconds since the epoch.

Definition at line 295 of file nvti.c.

{
  time_t epoch_time;
  int offset;
  struct tm tm;
 
  if (strcmp ((char *) str_time, "") == 0)
    return 0;
 
  /* Parse the time. */
 
  /* 2011-08-09 08:20:34 +0200 (Tue, 09 Aug 2011) */
  memset (&tm, 0, sizeof (struct tm));
  if (strptime ((char *) str_time, "%F %T %z", &tm) == NULL)
    {
      memset (&tm, 0, sizeof (struct tm));
      if (strptime ((char *) str_time, "%a %b %d %T %Y %z", &tm) == NULL)
        {
          g_warning ("%s: Failed to parse time: %s", __func__, str_time);
          return 0;
        }
    }
  epoch_time = mktime (&tm);
  if (epoch_time == -1)
    {
      g_warning ("%s: Failed to make time: %s", __func__, str_time);
      return 0;
    }
 
  /* Get the timezone offset from the str_time. */
 
  if ((sscanf ((char *) str_time, "%*u-%*u-%*u %*u:%*u:%*u %d%*[^]]", &offset)
       != 1)
      && (sscanf ((char *) str_time, "%*s %*s %*s %*u:%*u:%*u %*u %d%*[^]]",
                  &offset)
          != 1))
    {
      g_warning ("%s: Failed to parse timezone offset: %s", __func__, str_time);
      return 0;
    }
 
  /* Use the offset to convert to UTC. */
 
  if (offset < 0)
    {
      epoch_time += ((-offset) / 100) * 60 * 60;
      epoch_time += ((-offset) % 100) * 60;
    }
  else if (offset > 0)
    {
      epoch_time -= (offset / 100) * 60 * 60;
      epoch_time -= (offset % 100) * 60;
    }
 
  return epoch_time;
}

Referenced by Ensure(), and nvti_add_tag().

Here is the caller graph for this function:

vtref_free()

void vtref_free

(

vtref_t *

ref

)

Free memory of a vtref structure.

Parameters

ref	The structure to be freed.

Definition at line 97 of file nvti.c.

{
  if (!ref)
    return;
 
  g_free (ref->type);
  g_free (ref->ref_id);
  g_free (ref->ref_text);
  g_free (ref);
}

References vtref::ref_id, vtref::ref_text, and vtref::type.

Referenced by nvti_free().

Here is the caller graph for this function:

vtref_id()

const gchar * vtref_id

(

const vtref_t *

r

)

Get the id of a reference.

Parameters

r	The VT Reference structure of which the id should be returned.

Returns

The id string. Don't free this.

Definition at line 131 of file nvti.c.

{
  return r ? r->ref_id : NULL;
}

References vtref::ref_id.

vtref_new()

vtref_t * vtref_new	(	const gchar *	type,
		const gchar *	ref_id,
		const gchar *	ref_text )

Create a new vtref structure filled with the given values.

Parameters

type	The type to be set.
ref_id	The actual reference to be set.
ref_text	The optional text accompanying a reference.

Returns

A vtref structure which needs to be released using vtref_free .

Definition at line 77 of file nvti.c.

{
  vtref_t *ref = g_malloc0 (sizeof (vtref_t));
 
  if (type)
    ref->type = g_strdup (type);
  if (ref_id)
    ref->ref_id = g_strdup (ref_id);
  if (ref_text)
    ref->ref_text = g_strdup (ref_text);
 
  return ref;
}

References vtref::ref_id, vtref::ref_text, and vtref::type.

Referenced by nvti_add_refs(), and parse_references().

Here is the caller graph for this function:

vtref_text()

const gchar * vtref_text

(

const vtref_t *

r

)

Get the text of a reference.

Parameters

r	The VT Reference structure of which the id should be returned.

Returns

The id string. Don't free this.

Definition at line 145 of file nvti.c.

{
  return r ? r->ref_text : NULL;
}

References vtref::ref_text.

vtref_type()

const gchar * vtref_type

(

const vtref_t *

r

)

Get the type of a reference.

Parameters

r	The VT Reference structure of which the type should be returned.

Returns

The type string. Don't free this.

Definition at line 117 of file nvti.c.

{
  return r ? r->type : NULL;
}

References vtref::type.

vtseverity_date()

int vtseverity_date

(

const vtseverity_t *

s

)

Get the date of a severity.

Parameters

s	The VT Severity structure of which the date should be returned.

Returns

The date.

Definition at line 265 of file nvti.c.

{
  return s->date;
}

References vtseverity::date.

vtseverity_free()

void vtseverity_free

(

vtseverity_t *

s

)

Free memory of a vtseverity structure.

Parameters

s	The structure to be freed.

Definition at line 203 of file nvti.c.

{
  if (!s)
    return;
 
  g_free (s->type);
  g_free (s->origin);
  g_free (s->value);
  g_free (s);
}

References vtseverity::origin, vtseverity::type, and vtseverity::value.

Referenced by nvti_free().

Here is the caller graph for this function:

vtseverity_new()

vtseverity_t * vtseverity_new	(	const gchar *	type,
		const gchar *	origin,
		int	date,
		double	score,
		const gchar *	value )

Create a new vtseverity structure filled with the given values.

Parameters

[in]	type	The severity type to be set.
[in]	origin	The origin reference to be set, can be NULL.
[in]	date	The date to be set.
[in]	score	The score to be set.
[in]	value	The value corresponding to the type.

Returns

A vtref structure which needs to be released using vtref_free .

Definition at line 180 of file nvti.c.

{
  vtseverity_t *s = g_malloc0 (sizeof (vtseverity_t));
 
  if (type)
    s->type = g_strdup (type);
  if (origin)
    s->origin = g_strdup (origin);
  s->date = date;
  s->score = score;
  if (value)
    s->value = g_strdup (value);
 
  return s;
}

References vtseverity::date, vtseverity::origin, vtseverity::score, vtseverity::type, and vtseverity::value.

Referenced by add_tags_to_nvt().

Here is the caller graph for this function:

vtseverity_origin()

const gchar * vtseverity_origin

(

const vtseverity_t *

s

)

Get the origin of a severity.

Parameters

s	The VT Severity structure of which the origin should be returned.

Returns

The origin string. Don't free this.

Definition at line 237 of file nvti.c.

{
  return s ? s->origin : NULL;
}

References vtseverity::origin.

vtseverity_score()

double vtseverity_score

(

const vtseverity_t *

s

)

Get the score of a severity.

Parameters

s	The VT Severity structure of which the score should be returned.

Returns

The score.

Definition at line 279 of file nvti.c.

{
  return s->score;
}

References vtseverity::score.

Referenced by nvti_severity_score().

Here is the caller graph for this function:

vtseverity_type()

const gchar * vtseverity_type

(

const vtseverity_t *

s

)

Get the type of a severity.

Parameters

s	The VT Severity structure of which the type should be returned.

Returns

The type string. Don't free this.

Definition at line 223 of file nvti.c.

{
  return s ? s->type : NULL;
}

References vtseverity::type.

vtseverity_value()

const gchar * vtseverity_value

(

const vtseverity_t *

s

)

Get the value of a severity.

Parameters

s	The VT Severity structure of which the value should be returned.

Returns

The value string. Don't free this.

Definition at line 251 of file nvti.c.

{
  return s ? s->value : NULL;
}

References vtseverity::value.