manage_sql.h

/* Copyright (C) 2010-2022 Greenbone Networks GmbH
 *
 * SPDX-License-Identifier: AGPL-3.0-or-later
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
/*
 * @file manage_sql.h
 * @brief Manager Manage library: SQL backend headers.
 */
 
#ifndef _GVMD_MANAGE_SQL_H
#define _GVMD_MANAGE_SQL_H
 
#include <gvm/util/xmlutils.h>
 
#include "manage.h"
#include "manage_utils.h"
 
␌
/* Internal types and preprocessor definitions. */
 
#define LOCATION_TABLE 0
 
#define LOCATION_TRASH 1
 
#define MANAGE_NVT_SELECTOR_UUID_ALL "54b45713-d4f4-4435-b20d-304c175ed8c5"
 
#define PERMISSION_UUID_ADMIN_EVERYTHING "b3b56a8c-c2fd-11e2-a135-406186ea4fc5"
 
#define PERMISSION_UUID_SUPER_ADMIN_EVERYTHING "a9801074-6fe2-11e4-9d81-406186ea4fc5"
 
#define ROLE_UUID_ADMIN "7a8cb5b4-b74d-11e2-8187-406186ea4fc5"
 
#define ROLE_UUID_GUEST "cc9cac5e-39a3-11e4-abae-406186ea4fc5"
 
#define ROLE_UUID_INFO "5f8fd16c-c550-11e3-b6ab-406186ea4fc5"
 
#define ROLE_UUID_MONITOR "12cdb536-480b-11e4-8552-406186ea4fc5"
 
#define ROLE_UUID_USER "8d453140-b74d-11e2-b0be-406186ea4fc5"
 
#define ROLE_UUID_SUPER_ADMIN "9c5a6ec6-6fe2-11e4-8cb6-406186ea4fc5"
 
#define ROLE_UUID_OBSERVER "87a7ebce-b74d-11e2-a81f-406186ea4fc5"
 
#define SCANNER_UUID_DEFAULT "08b69003-5fc2-4037-a479-93b440211c73"
 
#define SCANNER_UUID_CVE "6acd0832-df90-11e4-b9d5-28d24461215b"
 
#define SETTING_UUID_ROWS_PER_PAGE "5f5a8712-8017-11e1-8556-406186ea4fc5"
 
#define SETTING_UUID_MAX_ROWS_PER_PAGE "76374a7a-0569-11e6-b6da-28d24461215b"
 
#define SETTING_UUID_DEFAULT_CA_CERT "9ac801ea-39f8-11e6-bbaa-28d24461215b"
 
#define SETTING_UUID_LSC_DEB_MAINTAINER "2fcbeac8-4237-438f-b52a-540a23e7af97"
 
#define SETTING_UUID_FEED_IMPORT_OWNER "78eceaec-3385-11ea-b237-28d24461215b"
 
#define SETTING_UUID_FEED_IMPORT_ROLES "ff000362-338f-11ea-9051-28d24461215b"
 
#define TRUST_ERROR 0
 
#define TRUST_YES 1
 
#define TRUST_NO 2
 
#define TRUST_UNKNOWN 3
 
#define TIMEVAL_SUBTRACT_MS(a,b) ((((a).tv_sec - (b).tv_sec) * 1000) + \
                                  ((a).tv_usec - (b).tv_usec) / 1000)
 
#define DB_SUPERUSER_ROLE "dba"
 
␌
/* Macros. */
 
#define DEF_ACCESS(name, col)                                     \
const char*                                                       \
name (iterator_t* iterator)                                       \
{                                                                 \
  const char *ret;                                                \
  if (iterator->done) return NULL;                                \
  ret = iterator_string (iterator, col);                          \
  return ret;                                                     \
}
 
#define PRINT(stream, format, args...)                                       \
  do                                                                         \
    {                                                                        \
      gchar *msg;                                                            \
      msg = g_markup_printf_escaped (format, ## args);                       \
      if (fprintf (stream, "%s", msg) < 0)                                   \
        {                                                                    \
          g_free (msg);                                                      \
          fclose (stream);                                                   \
          return -1;                                                         \
        }                                                                    \
      g_free (msg);                                                          \
    }                                                                        \
  while (0)
 
␌
/* Iterator definitions. */
 
typedef struct
{
  gchar *select;       
  gchar *filter;       
  keyword_type_t type; 
} column_t;
 
#define ANON_GET_ITERATOR_FILTER_COLUMNS "uuid", \
 "created", "modified", "_owner"
 
#define GET_ITERATOR_FILTER_COLUMNS "uuid", "name", "comment", \
 "created", "modified", "_owner"
 
#define GET_ITERATOR_COLUMNS_STRING                                \
  "id, uuid, name, comment, iso_time (creation_time),"             \
  " iso_time (modification_time), creation_time AS created,"       \
  " modification_time AS modified"
 
#define GET_ITERATOR_COLUMNS_PREFIX(prefix)                                 \
  { prefix "id", NULL, KEYWORD_TYPE_INTEGER },                              \
  { prefix "uuid", NULL, KEYWORD_TYPE_STRING },                             \
  { prefix "name", NULL, KEYWORD_TYPE_STRING },                             \
  { prefix "comment", NULL, KEYWORD_TYPE_STRING },                          \
  { " iso_time (" prefix "creation_time)", NULL, KEYWORD_TYPE_STRING },     \
  { " iso_time (" prefix "modification_time)", NULL, KEYWORD_TYPE_STRING }, \
  { prefix "creation_time", "created", KEYWORD_TYPE_INTEGER },              \
  { prefix "modification_time", "modified", KEYWORD_TYPE_INTEGER }
 
#define GET_ITERATOR_COLUMNS(table)                                             \
  GET_ITERATOR_COLUMNS_PREFIX(""),                                              \
  {                                                                             \
    "(SELECT name FROM users AS inner_users"                                    \
    " WHERE inner_users.id = " G_STRINGIFY (table) ".owner)",                   \
    "_owner",                                                                   \
    KEYWORD_TYPE_STRING                                                         \
  },                                                                            \
  { "owner", NULL, KEYWORD_TYPE_INTEGER }
 
#define GET_ITERATOR_COLUMN_COUNT 10
 
␌
/* Variables */
 
extern db_conn_info_t gvmd_db_conn_info;
 
␌
/* Function prototypes */
 
typedef long long int rowid_t;
 
int manage_db_empty ();
 
gboolean
host_nthlast_report_host (const char *, report_host_t *, int);
 
char*
report_host_ip (const char *);
 
void trim_report (report_t);
 
int delete_report_internal (report_t);
 
int set_report_scan_run_status (report_t, task_status_t);
 
int update_report_modification_time (report_t);
 
int set_report_slave_progress (report_t, int);
 
void init_task_file_iterator (iterator_t *, task_t, const char *);
const char *task_file_iterator_name (iterator_t *);
const char *task_file_iterator_content (iterator_t *);
 
void set_task_schedule_next_time (task_t, time_t);
 
void set_task_schedule_next_time_uuid (const gchar *, time_t);
 
void init_preference_iterator (iterator_t *, config_t, const char *);
const char *preference_iterator_name (iterator_t *);
const char *preference_iterator_value (iterator_t *);
 
port_list_t target_port_list (target_t);
credential_t target_ssh_credential (target_t);
credential_t target_smb_credential (target_t);
credential_t target_esxi_credential (target_t);
credential_t target_ssh_elevate_credential (target_t);
 
int create_current_report (task_t, char **, task_status_t);
 
char *alert_data (alert_t, const char *, const char *);
 
int init_task_schedule_iterator (iterator_t *);
 
void cleanup_task_schedule_iterator (iterator_t *);
 
task_t task_schedule_iterator_task (iterator_t *);
 
const char *task_schedule_iterator_task_uuid (iterator_t *);
 
schedule_t task_schedule_iterator_schedule (iterator_t *);
 
const char *task_schedule_iterator_icalendar (iterator_t *);
 
const char *task_schedule_iterator_timezone (iterator_t *);
 
const char *task_schedule_iterator_owner_uuid (iterator_t *);
 
const char *task_schedule_iterator_owner_name (iterator_t *);
 
gboolean task_schedule_iterator_timed_out (iterator_t *);
 
gboolean task_schedule_iterator_start_due (iterator_t *);
 
gboolean task_schedule_iterator_stop_due (iterator_t *);
 
time_t task_schedule_iterator_initial_offset (iterator_t *);
 
int set_task_schedule_uuid (const gchar*, schedule_t, int);
 
void reinit_manage_process ();
 
int manage_update_nvti_cache ();
 
int manage_report_host_details (report_t, const char *, entity_t);
 
const char *run_status_name_internal (task_status_t);
 
void update_config_cache_init (const char *);
 
alive_test_t target_alive_tests (target_t);
 
void manage_session_init (const char *);
 
int valid_gmp_command (const char *);
 
void check_generate_scripts ();
 
void auto_delete_reports ();
 
int parse_iso_time (const char *);
 
void set_report_scheduled (report_t);
 
gchar *resource_uuid (const gchar *, resource_t);
 
gboolean find_resource_with_permission (const char *, const char *,
                                        resource_t *, const char *, int);
 
int
resource_predefined (const gchar *, resource_t);
 
void parse_osp_report (task_t, report_t, const char *);
 
void reschedule_task (const gchar *);
 
void insert_port_range (port_list_t, port_protocol_t, int, int);
 
int manage_cert_db_exists ();
 
int manage_scap_db_exists ();
 
int
count (const char *, const get_data_t *, column_t *, column_t *, const char **,
       int, const char *, const char *, int);
 
int
init_get_iterator (iterator_t*, const char *, const get_data_t *, column_t *,
                   column_t *, const char **, int, const char *, const char *,
                   int);
 
gchar *
columns_build_select (column_t *);
 
gchar *
filter_clause (const char*, const char*, const char **, column_t *,
               column_t *, int, gchar **, int *, int *, array_t **, gchar **);
 
void
check_alerts ();
 
int
manage_option_setup (GSList *, const db_conn_info_t *);
 
void
manage_option_cleanup ();
 
void
update_all_config_caches ();
 
void
event (event_t, void *, resource_t, resource_t);
 
gboolean
find_trash (const char *, const char *, resource_t *);
 
void
tags_remove_resource (const char *, resource_t, int);
 
void
tags_set_locations (const char *, resource_t, resource_t, int);
 
void
permissions_set_locations (const char *, resource_t, resource_t, int);
 
void
permissions_set_orphans (const char *, resource_t, int);
 
int
copy_resource (const char *, const char *, const char *, const char *,
               const char *, int, resource_t *, resource_t *);
 
gboolean
resource_with_name_exists (const char *, const char *, resource_t);
 
int
create_permission_internal (int, const char *, const char *, const char *,
                            const char *, const char *, const char *,
                            permission_t *);
 
int
create_permission_no_acl (const char *, const char *, const char *, const char *,
                          const char *, const char *, permission_t *);
 
int
copy_resource_lock (const char *, const char *, const char *, const char *,
                    const char *, int, resource_t *, resource_t *);
 
nvti_t *
lookup_nvti (const gchar *);
 
int
setting_value (const char *, char **);
 
int
valid_type (const char *);
 
void
add_role_permission_resource (const gchar *, const gchar *, const gchar *,
                              const gchar *);
 
void
create_view_vulns ();
 
int
config_family_entire_and_growing (config_t, const char*);
 
void
reports_clear_count_cache_dynamic ();
 
int
cleanup_config_sequences ();
 
int
cleanup_port_list_sequences ();
 
int
cleanup_nvt_sequences ();
 
int
cleanup_ids_for_table (const char *);
 
#endif /* not _GVMD_MANAGE_SQL_H */