|
Greenbone Vulnerability Management Libraries 22.26.0
|
API for Greenbone Management Protocol communication. More...
#include "../base/array.h"#include "../util/serverutils.h"#include "../util/xmlutils.h"#include <glib.h>#include <glib/gtypes.h>#include <gnutls/gnutls.h>#include <stddef.h>Go to the source code of this file.
Data Structures | |
| struct | gmp_authenticate_info_opts_t |
| Struct holding options for authentication. More... | |
| struct | gmp_get_report_opts_t |
| Struct holding options for gmp get_report command. More... | |
| struct | gmp_get_tasks_opts_t |
| Struct holding options for gmp get_tasks command. More... | |
| struct | gmp_get_task_opts_t |
| Struct holding options for gmp get_tasks command. More... | |
| struct | gmp_create_task_opts_t |
| Struct holding options for gmp create_task command. More... | |
| struct | gmp_create_target_opts_t |
| Struct holding options for gmp create_target command. More... | |
| struct | gmp_get_system_reports_opts_t |
| Struct holding options for gmp get_system_reports command. More... | |
| struct | gmp_create_lsc_credential_opts_t |
| Struct holding options for gmp create_lsc_credential command. More... | |
| struct | gmp_delete_opts_t |
| Struct holding options for various gmp delete_[...] commands. More... | |
| struct | gmp_start_task_opts_t |
| Struct holding options for gmp start_task command. More... | |
Functions | |
| int | gmp_read_create_response (gnutls_session_t *, gchar **) |
| Read response status and resource UUID. | |
| const char * | gmp_task_status (entity_t status_response) |
| Get the task status from a GMP GET_TASKS response. | |
| int | gmp_ping (gnutls_session_t *, int) |
| "Ping" the manager. | |
| int | gmp_ping_c (gvm_connection_t *, int, gchar **) |
| "Ping" the manager. | |
| int | gmp_authenticate (gnutls_session_t *session, const char *username, const char *password) |
| Authenticate with the manager. | |
| int | gmp_authenticate_info_ext (gnutls_session_t *, gmp_authenticate_info_opts_t) |
| Authenticate with the manager. | |
| int | gmp_authenticate_info_ext_c (gvm_connection_t *, gmp_authenticate_info_opts_t) |
| Authenticate with the manager. | |
| int | gmp_create_task (gnutls_session_t *, const char *, const char *, const char *, const char *, gchar **) |
| Create a task given a config and target. | |
| int | gmp_create_task_ext (gnutls_session_t *, gmp_create_task_opts_t, gchar **) |
| Create a task. | |
| int | gmp_start_task_report (gnutls_session_t *, const char *, char **) |
| Start a task and read the manager response. | |
| int | gmp_start_task_report_c (gvm_connection_t *, const char *, char **) |
| Start a task and read the manager response. | |
| int | gmp_start_task_ext_c (gvm_connection_t *, gmp_start_task_opts_t) |
| Start a task and read the manager response. | |
| int | gmp_stop_task (gnutls_session_t *, const char *) |
| Stop a task and read the manager response. | |
| int | gmp_stop_task_c (gvm_connection_t *, const char *) |
| Stop a task and read the manager response. | |
| int | gmp_resume_task_report (gnutls_session_t *, const char *, char **) |
| Resume a task and read the manager response. | |
| int | gmp_resume_task_report_c (gvm_connection_t *, const char *, char **) |
| Resume a task and read the manager response. | |
| int | gmp_get_tasks (gnutls_session_t *, const char *, int, int, entity_t *) |
| Get the status of a task. | |
| int | gmp_get_tasks_ext (gnutls_session_t *, gmp_get_tasks_opts_t, entity_t *) |
| Get all tasks (generic version). | |
| int | gmp_get_task_ext (gnutls_session_t *, gmp_get_task_opts_t, entity_t *) |
| Get a task (generic version). | |
| int | gmp_get_targets (gnutls_session_t *, const char *, int, int, entity_t *) |
| Get a target. | |
| int | gmp_get_report_ext (gnutls_session_t *, gmp_get_report_opts_t, entity_t *) |
| Get a report (generic version). | |
| int | gmp_delete_port_list_ext (gnutls_session_t *, const char *, gmp_delete_opts_t) |
| Delete a port list. | |
| int | gmp_delete_task (gnutls_session_t *, const char *) |
| Delete a task and read the manager response. | |
| int | gmp_delete_task_ext (gnutls_session_t *, const char *, gmp_delete_opts_t) |
| Delete a task and read the manager response. | |
| int | gmp_modify_task_file (gnutls_session_t *, const char *, const char *, const void *, gsize) |
| Modify a file on a task. | |
| int | gmp_delete_report (gnutls_session_t *, const char *) |
| Remove a report. | |
| int | gmp_create_target_ext (gnutls_session_t *, gmp_create_target_opts_t, gchar **) |
| Create a target. | |
| int | gmp_delete_target_ext (gnutls_session_t *, const char *, gmp_delete_opts_t) |
| Delete a target. | |
| int | gmp_delete_config_ext (gnutls_session_t *, const char *, gmp_delete_opts_t) |
| Delete a config. | |
| int | gmp_create_lsc_credential_ext (gnutls_session_t *, gmp_create_lsc_credential_opts_t, gchar **) |
| Create an LSC credential. | |
| int | gmp_create_lsc_credential (gnutls_session_t *, const char *, const char *, const char *, const char *, gchar **) |
| Create an LSC Credential. | |
| int | gmp_create_lsc_credential_key (gnutls_session_t *, const char *, const char *, const char *, const char *, const char *, gchar **) |
| Create an LSC Credential with a key. | |
| int | gmp_delete_lsc_credential_ext (gnutls_session_t *, const char *, gmp_delete_opts_t) |
| Delete a LSC credential. | |
| int | gmp_get_system_reports (gnutls_session_t *, const char *, int, entity_t *) |
| Get system reports. | |
| int | gmp_get_system_reports_ext (gnutls_session_t *, gmp_get_system_reports_opts_t, entity_t *) |
| Get system reports. | |
API for Greenbone Management Protocol communication.
| int gmp_authenticate | ( | gnutls_session_t * | session, |
| const char * | username, | ||
| const char * | password ) |
Authenticate with the manager.
| [in] | session | Pointer to GNUTLS session. |
| [in] | username | Username. |
| [in] | password | Password. |
| int gmp_authenticate_info_ext | ( | gnutls_session_t * | session, |
| gmp_authenticate_info_opts_t | opts ) |
Authenticate with the manager.
| [in] | session | Pointer to GNUTLS session. |
| [in,out] | opts | In: Struct containing the options to apply. Out: Additional account information if authentication was successful. |
| int gmp_authenticate_info_ext_c | ( | gvm_connection_t * | connection, |
| gmp_authenticate_info_opts_t | opts ) |
Authenticate with the manager.
| [in] | connection | Connection |
| [in] | opts | Struct containing the options to apply. |
| int gmp_create_lsc_credential | ( | gnutls_session_t * | session, |
| const char * | name, | ||
| const char * | login, | ||
| const char * | password, | ||
| const char * | comment, | ||
| gchar ** | uuid ) |
Create an LSC Credential.
| [in] | session | Pointer to GNUTLS session. |
| [in] | name | Name of LSC Credential. |
| [in] | login | Login associated with name. |
| [in] | password | Password, or NULL for autogenerated credentials. |
| [in] | comment | LSC Credential comment. |
| [out] | uuid | Either NULL or address for UUID of created credential. |
| int gmp_create_lsc_credential_ext | ( | gnutls_session_t * | session, |
| gmp_create_lsc_credential_opts_t | opts, | ||
| gchar ** | id ) |
Create an LSC credential.
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | id | Pointer for newly allocated ID of new LSC credential, or NULL. Only set on successful return. |
| int gmp_create_lsc_credential_key | ( | gnutls_session_t * | session, |
| const char * | name, | ||
| const char * | login, | ||
| const char * | passphrase, | ||
| const char * | private_key, | ||
| const char * | comment, | ||
| gchar ** | uuid ) |
Create an LSC Credential with a key.
| [in] | session | Pointer to GNUTLS session. |
| [in] | name | Name of LSC Credential. |
| [in] | login | Login associated with name. |
| [in] | passphrase | Passphrase for private key. |
| [in] | private_key | Private key. |
| [in] | comment | LSC Credential comment. |
| [out] | uuid | Either NULL or address for UUID of created credential. |
| int gmp_create_target_ext | ( | gnutls_session_t * | session, |
| gmp_create_target_opts_t | opts, | ||
| gchar ** | id ) |
Create a target.
FIXME: Using the according opts it should be possible to generate any type of create_target request defined by the spec.
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | id | Pointer for newly allocated ID of new target, or NULL. Only set on successful return. |
| int gmp_create_task | ( | gnutls_session_t * | session, |
| const char * | name, | ||
| const char * | config, | ||
| const char * | target, | ||
| const char * | comment, | ||
| gchar ** | id ) |
Create a task given a config and target.
| [in] | session | Pointer to GNUTLS session. |
| [in] | name | Task name. |
| [in] | config | Task config name. |
| [in] | target | Task target name. |
| [in] | comment | Task comment. |
| [out] | id | Pointer for newly allocated ID of new task. Only set on successful return. |
| int gmp_create_task_ext | ( | gnutls_session_t * | session, |
| gmp_create_task_opts_t | opts, | ||
| gchar ** | id ) |
Create a task.
FIXME: Using the according opts it should be possible to generate any type of create_task request defined by the spec.
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | id | Pointer for newly allocated ID of new task, or NULL. Only set on successful return. |
| int gmp_delete_config_ext | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| gmp_delete_opts_t | opts ) |
Delete a config.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | UUID of config. |
| [in] | opts | Struct containing the options to apply. |
| int gmp_delete_lsc_credential_ext | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| gmp_delete_opts_t | opts ) |
Delete a LSC credential.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | UUID of LSC credential. |
| [in] | opts | Struct containing the options to apply. |
| int gmp_delete_port_list_ext | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| gmp_delete_opts_t | opts ) |
Delete a port list.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | UUID of port list. |
| [in] | opts | Struct containing the options to apply. |
| int gmp_delete_report | ( | gnutls_session_t * | session, |
| const char * | id ) |
Remove a report.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of report. |
| int gmp_delete_target_ext | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| gmp_delete_opts_t | opts ) |
Delete a target.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | UUID of target. |
| [in] | opts | Struct containing the options to apply. |
| int gmp_delete_task | ( | gnutls_session_t * | session, |
| const char * | id ) |
Delete a task and read the manager response.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of task. |
| int gmp_delete_task_ext | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| gmp_delete_opts_t | opts ) |
Delete a task and read the manager response.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of task. |
| [in] | opts | Struct containing the options to apply. |
| int gmp_get_report_ext | ( | gnutls_session_t * | session, |
| gmp_get_report_opts_t | opts, | ||
| entity_t * | response ) |
Get a report (generic version).
FIXME: Using the according opts it should be possible to generate any type of get_reports request defined by the spec.
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | response | Report. On success contains GET_REPORT response. |
| int gmp_get_system_reports | ( | gnutls_session_t * | session, |
| const char * | name, | ||
| int | brief, | ||
| entity_t * | reports ) |
Get system reports.
| [in] | session | Pointer to GNUTLS session. |
| [in] | name | Name of system report. NULL for all. |
| [in] | brief | Whether to request brief response. |
| [out] | reports | Reports return. On success contains GET_SYSTEM_REPORTS response. |
| int gmp_get_system_reports_ext | ( | gnutls_session_t * | session, |
| gmp_get_system_reports_opts_t | opts, | ||
| entity_t * | reports ) |
Get system reports.
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | reports | Reports return. On success contains GET_SYSTEM_REPORTS response. |
| int gmp_get_targets | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| int | tasks, | ||
| int | include_rcfile, | ||
| entity_t * | target ) |
Get a target.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of target or NULL for all targets. |
| [in] | tasks | Whether to include tasks that use the target. |
| [in] | include_rcfile | Not used. |
| [out] | target | Target return. On success contains GET_TARGETS response. |
| int gmp_get_task_ext | ( | gnutls_session_t * | session, |
| gmp_get_task_opts_t | opts, | ||
| entity_t * | response ) |
Get a task (generic version).
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | response | Task. On success contains GET_TASKS response. |
| int gmp_get_tasks | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| int | details, | ||
| int | include_rcfile, | ||
| entity_t * | status ) |
Get the status of a task.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of task or NULL for all tasks. |
| [in] | details | Whether to request task details. |
| [in] | include_rcfile | Ignored. Removed since GMP 6.0. |
| [out] | status | Status return. On success contains GET_TASKS response. |
| int gmp_get_tasks_ext | ( | gnutls_session_t * | session, |
| gmp_get_tasks_opts_t | opts, | ||
| entity_t * | response ) |
Get all tasks (generic version).
| [in] | session | Pointer to GNUTLS session. |
| [in] | opts | Struct containing the options to apply. |
| [out] | response | Tasks. On success contains GET_TASKS response. |
| int gmp_modify_task_file | ( | gnutls_session_t * | session, |
| const char * | id, | ||
| const char * | name, | ||
| const void * | content, | ||
| gsize | content_len ) |
Modify a file on a task.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of task. |
| [in] | name | Name of file. |
| [in] | content | New content. NULL to remove file. |
| [in] | content_len | Length of content. |
| int gmp_ping | ( | gnutls_session_t * | session, |
| int | timeout ) |
"Ping" the manager.
| [in] | session | Pointer to GNUTLS session. |
| [in] | timeout | Server idle time before giving up, in milliseconds. 0 to wait forever. |
| int gmp_ping_c | ( | gvm_connection_t * | connection, |
| int | timeout, | ||
| gchar ** | version ) |
"Ping" the manager.
| [in] | connection | Pointer to GNUTLS session. |
| [in] | timeout | Server idle time before giving up, in milliseconds. 0 to wait forever. |
| [out] | version | Return location for freshly allocated version if required, else NULL. |
| int gmp_read_create_response | ( | gnutls_session_t * | session, |
| gchar ** | uuid ) |
Read response status and resource UUID.
| [in] | session | Pointer to GNUTLS session. |
| [out] | uuid | Either NULL or address for freshly allocated UUID of created response. |
| int gmp_resume_task_report | ( | gnutls_session_t * | session, |
| const char * | task_id, | ||
| char ** | report_id ) |
Resume a task and read the manager response.
| [in] | session | Pointer to GNUTLS session. |
| [in] | task_id | ID of task. |
| [out] | report_id | ID of report. |
| int gmp_resume_task_report_c | ( | gvm_connection_t * | connection, |
| const char * | task_id, | ||
| char ** | report_id ) |
Resume a task and read the manager response.
| [in] | connection | Connection. |
| [in] | task_id | ID of task. |
| [out] | report_id | ID of report. |
| int gmp_start_task_ext_c | ( | gvm_connection_t * | connection, |
| gmp_start_task_opts_t | opts ) |
Start a task and read the manager response.
| [in] | connection | Connection. |
| [in] | opts | Options to apply. |
| int gmp_start_task_report | ( | gnutls_session_t * | session, |
| const char * | task_id, | ||
| char ** | report_id ) |
Start a task and read the manager response.
| [in] | session | Pointer to GNUTLS session. |
| [in] | task_id | ID of task. |
| [out] | report_id | ID of report. |
| int gmp_start_task_report_c | ( | gvm_connection_t * | connection, |
| const char * | task_id, | ||
| char ** | report_id ) |
Start a task and read the manager response.
| [in] | connection | Connection. |
| [in] | task_id | ID of task. |
| [out] | report_id | ID of report. |
| int gmp_stop_task | ( | gnutls_session_t * | session, |
| const char * | id ) |
Stop a task and read the manager response.
| [in] | session | Pointer to GNUTLS session. |
| [in] | id | ID of task. |
| int gmp_stop_task_c | ( | gvm_connection_t * | connection, |
| const char * | id ) |
Stop a task and read the manager response.
| [in] | connection | Connection. |
| [in] | id | ID of task. |
| const char * gmp_task_status | ( | entity_t | response | ) |
Get the task status from a GMP GET_TASKS response.
| [in] | response | GET_TASKS response. |
|
static |
Sensible default values for gmp_authenticate_info_opts_t.
|
static |
Sensible default values for gmp_create_lsc_credential_opts_t.
|
static |
Sensible default values for gmp_get_report_opts_t.
|
static |
Sensible default values for gmp_get_report_opts_t.
|
static |
Sensible default values for gmp_get_report_opts_t.
|
static |
Default values for gmp_get_report_opts_t for ultimate deletion.
|
static |
Sensible default values for gmp_get_report_opts_t.
|
static |
Sensible default values for gmp_get_report_opts_t.
|
static |
Sensible default values for gmp_get_tasks_opts_t.
|
static |
Sensible default values for gmp_get_tasks_opts_t.
|
static |