OpenVAS Scanner 21.4.1
Macros | Functions | Variables
plugutils.c File Reference

Plugin-specific stuff. More...

#include "plugutils.h"
#include "network.h"
#include <errno.h>
#include <gvm/base/hosts.h>
#include <gvm/base/networking.h>
#include <gvm/base/prefs.h>
#include <gvm/util/nvticache.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/wait.h>
#include <unistd.h>

Macros

#define G_LOG_DOMAIN   "lib misc"
 GLib logging domain. More...
 
#define MAX_CANDIDATES   16
 

Functions

const char * plug_current_vhost (void)
 
static int plug_fork_child (kb_t)
 
void plug_set_dep (struct script_infos *args, const char *depname)
 
void host_add_port_proto (struct script_infos *args, int portnum, char *proto)
 
static int unscanned_ports_as_closed (port_protocol_t ptype)
 Report state of preferences "unscanned_closed". More...
 
int kb_get_port_state_proto (kb_t kb, int portnum, char *proto)
 
int host_get_port_state_proto (struct script_infos *args, int portnum, char *proto)
 
int host_get_port_state (struct script_infos *plugdata, int portnum)
 
int host_get_port_state_udp (struct script_infos *plugdata, int portnum)
 
static int check_duplicated_vhost (struct script_infos *args, const char *hostname)
 Check for duplicated vhosts before inserting a new one. More...
 
int plug_add_host_fqdn (struct script_infos *args, const char *hostname, const char *source)
 
char * plug_get_host_fqdn (struct script_infos *args)
 
GSList * plug_get_host_fqdn_list (struct script_infos *args)
 
char * plug_get_host_source (struct script_infos *args, const char *hostname)
 
struct in6_addr * plug_get_host_ip (struct script_infos *args)
 
char * plug_get_host_ip_str (struct script_infos *desc)
 
void proto_post_wrapped (const char *oid, struct script_infos *desc, int port, const char *proto, const char *action, const char *what, const char *uri)
 Post a security message (e.g. LOG, NOTE, WARNING ...). More...
 
void proto_post_alarm (const char *oid, struct script_infos *desc, int port, const char *proto, const char *action, const char *uri)
 
void post_alarm (const char *oid, struct script_infos *desc, int port, const char *action, const char *uri)
 
void proto_post_log (const char *oid, struct script_infos *desc, int port, const char *proto, const char *action, const char *uri)
 Post a log message. More...
 
void post_log (const char *oid, struct script_infos *desc, int port, const char *action)
 Post a log message about a tcp port. More...
 
void post_log_with_uri (const char *oid, struct script_infos *desc, int port, const char *action, const char *uri)
 Post a log message about a tcp port with a uri. More...
 
void proto_post_error (const char *oid, struct script_infos *desc, int port, const char *proto, const char *action, const char *uri)
 
void post_error (const char *oid, struct script_infos *desc, int port, const char *action, const char *uri)
 
char * get_plugin_preference (const char *oid, const char *name, int pref_id)
 Get the a plugins preference. More...
 
const char * get_plugin_preference_fname (struct script_infos *desc, const char *filename)
 Get the file name of a plugins preference that is of type "file". More...
 
char * get_plugin_preference_file_content (struct script_infos *desc, const char *identifier)
 Get the file contents of a plugins preference that is of type "file". More...
 
long get_plugin_preference_file_size (struct script_infos *desc, const char *identifier)
 Get the file size of a plugins preference that is of type "file". More...
 
void plug_set_key_len (struct script_infos *args, char *name, int type, const void *value, size_t len)
 
void plug_set_key (struct script_infos *args, char *name, int type, const void *value)
 
void plug_replace_key_len (struct script_infos *args, char *name, int type, void *value, size_t len)
 
void plug_replace_key (struct script_infos *args, char *name, int type, void *value)
 
void scanner_add_port (struct script_infos *args, int port, char *proto)
 
kb_t plug_get_kb (struct script_infos *args)
 
kb_t plug_get_results_kb (struct script_infos *args)
 
static void plug_get_key_sigchld ()
 
static void sig_n (int signo, void(*fnc)(int))
 
static void sig_term (void(*fcn)())
 
static void sig_chld (void(*fcn)())
 
void * plug_get_key (struct script_infos *args, char *name, int *type, size_t *len, int single)
 Get values from a kb under the given key name. More...
 
unsigned int plug_get_host_open_port (struct script_infos *desc)
 
void plug_set_port_transport (struct script_infos *args, int port, int tr)
 
int plug_get_port_transport (struct script_infos *args, int port)
 
static void plug_set_ssl_item (struct script_infos *args, char *item, char *itemfname)
 
void plug_set_ssl_cert (struct script_infos *args, char *cert)
 
void plug_set_ssl_key (struct script_infos *args, char *key)
 
void plug_set_ssl_pem_password (struct script_infos *args, char *key)
 
void plug_set_ssl_CA_file (struct script_infos *args, char *key)
 

Variables

int global_nasl_debug = 0
 
gvm_vhost_t * current_vhost = NULL
 

Detailed Description

Plugin-specific stuff.

Macro Definition Documentation

◆ G_LOG_DOMAIN

#define G_LOG_DOMAIN   "lib misc"

GLib logging domain.

◆ MAX_CANDIDATES

#define MAX_CANDIDATES   16

Function Documentation

◆ check_duplicated_vhost()

static int check_duplicated_vhost ( struct script_infos args,
const char *  hostname 
)
static

Check for duplicated vhosts before inserting a new one.

Parameters
argsscript info structure
hostnamehostname to check
Returns
0 if the vhosts was still not added. -1 if the vhosts already exists.

◆ get_plugin_preference()

char * get_plugin_preference ( const char *  oid,
const char *  name,
int  pref_id 
)

Get the a plugins preference.

Search in the preferences set by the client. If it is not present, search in redis cache for the default.

Parameters
[in]oidScript OID to get the preference from
[in]nameName of the preference to get
[in]pref_idId of the preferences to get
Returns
script preference on success, Null otherwise.

◆ get_plugin_preference_file_content()

char * get_plugin_preference_file_content ( struct script_infos desc,
const char *  identifier 
)

Get the file contents of a plugins preference that is of type "file".

As files sent to the scanner (e.g. as plugin preference) are stored in a hash table with an identifier supplied by the client as the key, the contents have to be looked up here.

Parameters
identifierIdentifier that was supplied by the client when the file was uploaded.
Returns
Contents of the file identified by identifier, NULL if not found or setup broken.

◆ get_plugin_preference_file_size()

long get_plugin_preference_file_size ( struct script_infos desc,
const char *  identifier 
)

Get the file size of a plugins preference that is of type "file".

Files sent to the scanner (e.g. as plugin preference) are stored in a hash table with an identifier supplied by the client as the key. The size of the file is stored in a separate hash table with the same identifier as key, which can be looked up here.

Parameters
identifierIdentifier that was supplied by the client when the file was uploaded.
Returns
Size of the file identified by identifier, -1 if not found or setup broken.

◆ get_plugin_preference_fname()

const char * get_plugin_preference_fname ( struct script_infos desc,
const char *  filename 
)

Get the file name of a plugins preference that is of type "file".

As files sent to the server (e.g. as plugin preference) are stored at pseudo-random locations with different names, the "real" file name has to be looked up in a hashtable.

Returns
Filename on disc for filename, NULL if not found or setup broken.

◆ host_add_port_proto()

void host_add_port_proto ( struct script_infos args,
int  portnum,
char *  proto 
)

◆ host_get_port_state()

int host_get_port_state ( struct script_infos plugdata,
int  portnum 
)

◆ host_get_port_state_proto()

int host_get_port_state_proto ( struct script_infos args,
int  portnum,
char *  proto 
)

◆ host_get_port_state_udp()

int host_get_port_state_udp ( struct script_infos plugdata,
int  portnum 
)

◆ kb_get_port_state_proto()

int kb_get_port_state_proto ( kb_t  kb,
int  portnum,
char *  proto 
)
Parameters
protoProtocol (udp/tcp). If NULL, "tcp" will be used.

◆ plug_add_host_fqdn()

int plug_add_host_fqdn ( struct script_infos args,
const char *  hostname,
const char *  source 
)

◆ plug_current_vhost()

const char * plug_current_vhost ( void  )

◆ plug_fork_child()

static int plug_fork_child ( kb_t  kb)
static

◆ plug_get_host_fqdn()

char * plug_get_host_fqdn ( struct script_infos args)

◆ plug_get_host_fqdn_list()

GSList * plug_get_host_fqdn_list ( struct script_infos args)

◆ plug_get_host_ip()

struct in6_addr * plug_get_host_ip ( struct script_infos args)

◆ plug_get_host_ip_str()

char * plug_get_host_ip_str ( struct script_infos desc)

◆ plug_get_host_open_port()

unsigned int plug_get_host_open_port ( struct script_infos desc)

Don't always return the first open port, otherwise we might get bitten by OSes doing active SYN flood countermeasures. Also, avoid returning 80 and 21 as open ports, as many transparent proxies are acting for these...

◆ plug_get_host_source()

char * plug_get_host_source ( struct script_infos args,
const char *  hostname 
)

◆ plug_get_kb()

kb_t plug_get_kb ( struct script_infos args)

◆ plug_get_key()

void * plug_get_key ( struct script_infos args,
char *  name,
int *  type,
size_t *  len,
int  single 
)

Get values from a kb under the given key name.

Parameters
[in]argsThe script infos where to get the kb from.
[in]nameKey name to search in the kb.
[in/out]type If 1 is given, the answer is forced to be KB_TYPE_INT type. Otherwise it returns the fetched type.
[in]lenDesired string length to be returned.
[in]singleIn case of a list, fetch only the last element
Returns
Null if no result, or a void pointer to the result in success.

◆ plug_get_key_sigchld()

static void plug_get_key_sigchld ( )
static

◆ plug_get_port_transport()

int plug_get_port_transport ( struct script_infos args,
int  port 
)

◆ plug_get_results_kb()

kb_t plug_get_results_kb ( struct script_infos args)

◆ plug_replace_key()

void plug_replace_key ( struct script_infos args,
char *  name,
int  type,
void *  value 
)

◆ plug_replace_key_len()

void plug_replace_key_len ( struct script_infos args,
char *  name,
int  type,
void *  value,
size_t  len 
)

◆ plug_set_dep()

void plug_set_dep ( struct script_infos args,
const char *  depname 
)

◆ plug_set_key()

void plug_set_key ( struct script_infos args,
char *  name,
int  type,
const void *  value 
)

◆ plug_set_key_len()

void plug_set_key_len ( struct script_infos args,
char *  name,
int  type,
const void *  value,
size_t  len 
)

◆ plug_set_port_transport()

void plug_set_port_transport ( struct script_infos args,
int  port,
int  tr 
)
Todo:
Those brain damaged functions should probably be in another file They are use to remember who speaks SSL or not

◆ plug_set_ssl_CA_file()

void plug_set_ssl_CA_file ( struct script_infos args,
char *  key 
)
Todo:
Also, all plug_set_ssl*-functions set values that are only accessed in network.c:open_stream_connection under specific conditions. Check whether these conditions can actually occur. Document the functions on the way.

◆ plug_set_ssl_cert()

void plug_set_ssl_cert ( struct script_infos args,
char *  cert 
)

◆ plug_set_ssl_item()

static void plug_set_ssl_item ( struct script_infos args,
char *  item,
char *  itemfname 
)
static

◆ plug_set_ssl_key()

void plug_set_ssl_key ( struct script_infos args,
char *  key 
)

◆ plug_set_ssl_pem_password()

void plug_set_ssl_pem_password ( struct script_infos args,
char *  key 
)

◆ post_alarm()

void post_alarm ( const char *  oid,
struct script_infos desc,
int  port,
const char *  action,
const char *  uri 
)

◆ post_error()

void post_error ( const char *  oid,
struct script_infos desc,
int  port,
const char *  action,
const char *  uri 
)

◆ post_log()

void post_log ( const char *  oid,
struct script_infos desc,
int  port,
const char *  action 
)

Post a log message about a tcp port.

◆ post_log_with_uri()

void post_log_with_uri ( const char *  oid,
struct script_infos desc,
int  port,
const char *  action,
const char *  uri 
)

Post a log message about a tcp port with a uri.

◆ proto_post_alarm()

void proto_post_alarm ( const char *  oid,
struct script_infos desc,
int  port,
const char *  proto,
const char *  action,
const char *  uri 
)

◆ proto_post_error()

void proto_post_error ( const char *  oid,
struct script_infos desc,
int  port,
const char *  proto,
const char *  action,
const char *  uri 
)

◆ proto_post_log()

void proto_post_log ( const char *  oid,
struct script_infos desc,
int  port,
const char *  proto,
const char *  action,
const char *  uri 
)

Post a log message.

◆ proto_post_wrapped()

void proto_post_wrapped ( const char *  oid,
struct script_infos desc,
int  port,
const char *  proto,
const char *  action,
const char *  what,
const char *  uri 
)

Post a security message (e.g. LOG, NOTE, WARNING ...).

Parameters
oidThe oid of the NVT
descThe script infos where to get settings.
portPort number related to the issue.
protoProtocol related to the issue (tcp or udp).
actionThe actual result text
whatThe type, like "LOG".
uriLocation like file path or webservice URL.

◆ scanner_add_port()

void scanner_add_port ( struct script_infos args,
int  port,
char *  proto 
)

◆ sig_chld()

static void sig_chld ( void(*)()  fcn)
static

◆ sig_n()

static void sig_n ( int  signo,
void(*)(int)  fnc 
)
static

◆ sig_term()

static void sig_term ( void(*)()  fcn)
static

◆ unscanned_ports_as_closed()

static int unscanned_ports_as_closed ( port_protocol_t  ptype)
static

Report state of preferences "unscanned_closed".

Returns
0 if pref is "yes", 1 otherwise.

Variable Documentation

◆ current_vhost

gvm_vhost_t* current_vhost = NULL

◆ global_nasl_debug

int global_nasl_debug = 0