Greenbone Vulnerability Management Libraries 22.18.1
serverutils.h
Go to the documentation of this file.
1/* SPDX-FileCopyrightText: 2009-2023 Greenbone AG
2 *
3 * SPDX-License-Identifier: GPL-2.0-or-later
4 */
5
13
14#ifndef _GVM_SERVERUTILS_H
15#define _GVM_SERVERUTILS_H
16
17#include <glib.h> /* for gchar, gboolean, gint */
18#include <gnutls/gnutls.h> /* for gnutls_session_t, gnutls_certificate_cred... */
19#include <stdarg.h> /* for va_list */
20#include <sys/param.h>
21#ifdef __FreeBSD__
22#include <netinet/in.h>
23#endif
24#include <netinet/ip.h>
25
29typedef struct
30{
31 int tls;
32 int socket;
33 gnutls_session_t session;
34 gnutls_certificate_credentials_t credentials;
35 gchar *username;
36 gchar *password;
37 gchar *host_string;
38 gchar *port_string;
39 gint port;
40 gboolean use_certs;
41 gchar *ca_cert;
42 gchar *pub_key;
43 gchar *priv_key;
45
46void
48
49void
51
52int gvm_server_verify (gnutls_session_t);
53
54int
55gvm_server_open (gnutls_session_t *, const char *, int);
56
57int
58gvm_server_open_verify (gnutls_session_t *, const char *, int, const char *,
59 const char *, const char *, int);
60
61int
62gvm_server_open_with_cert (gnutls_session_t *, const char *, int, const char *,
63 const char *, const char *);
64
65int
66gvm_server_close (int, gnutls_session_t);
67
68int
69gvm_server_attach (int, gnutls_session_t *);
70
71int
72gvm_server_sendf (gnutls_session_t *, const char *, ...)
73 __attribute__ ((format (printf, 2, 3)));
74
75int
76gvm_server_vsendf (gnutls_session_t *, const char *, va_list);
77int
78gvm_socket_vsendf (int, const char *, va_list);
79
80int
81gvm_server_sendf_xml (gnutls_session_t *, const char *, ...);
82int
83gvm_server_sendf_xml_quiet (gnutls_session_t *, const char *, ...);
84
85int
86gvm_connection_sendf_xml (gvm_connection_t *, const char *, ...);
87int
89
90int
91gvm_connection_sendf (gvm_connection_t *, const char *, ...);
92
93int
94gvm_server_new (unsigned int, gchar *, gchar *, gchar *, gnutls_session_t *,
95 gnutls_certificate_credentials_t *);
96
97int
98gvm_server_new_mem (unsigned int, const char *, const char *, const char *,
99 gnutls_session_t *, gnutls_certificate_credentials_t *);
100
101int
102gvm_server_free (int, gnutls_session_t, gnutls_certificate_credentials_t);
103
104int gvm_server_session_free (gnutls_session_t,
105 gnutls_certificate_credentials_t);
106
107int
108load_gnutls_file (const char *, gnutls_datum_t *);
109
110void
111unload_gnutls_file (gnutls_datum_t *);
112
113int
114set_gnutls_dhparams (gnutls_certificate_credentials_t, const char *);
115
116#endif /* not _GVM_SERVERUTILS_H */
__attribute__((weak))
Definition networking_tests.c:1030
int set_gnutls_dhparams(gnutls_certificate_credentials_t creds, const char *dhparams_file)
Set a gnutls session's Diffie-Hellman parameters.
Definition serverutils.c:1229
int gvm_server_new(unsigned int end_type, gchar *ca_cert_file, gchar *cert_file, gchar *key_file, gnutls_session_t *server_session, gnutls_certificate_credentials_t *server_credentials)
Make a session for connecting to a server.
Definition serverutils.c:1145
int gvm_connection_sendf(gvm_connection_t *connection, const char *format,...)
Format and send a string to the server.
Definition serverutils.c:824
int gvm_server_sendf_xml_quiet(gnutls_session_t *session, const char *format,...)
Format and send an XML string to the server.
Definition serverutils.c:939
int gvm_server_vsendf(gnutls_session_t *session, const char *fmt, va_list ap)
Send a string to the server.
Definition serverutils.c:728
int gvm_connection_sendf_xml(gvm_connection_t *connection, const char *format,...)
Format and send an XML string to the server.
Definition serverutils.c:912
int gvm_socket_vsendf(int socket, const char *fmt, va_list ap)
Send a string to the server.
Definition serverutils.c:743
int load_gnutls_file(const char *file, gnutls_datum_t *loaded_file)
Loads a file's data into gnutls_datum_t struct.
Definition serverutils.c:161
int gvm_server_new_mem(unsigned int end_type, const char *ca_cert, const char *pub_key, const char *priv_key, gnutls_session_t *session, gnutls_certificate_credentials_t *credentials)
Make a session for connecting to a server, with certificates stored in memory.
Definition serverutils.c:1167
int gvm_server_sendf_xml(gnutls_session_t *session, const char *format,...)
Format and send an XML string to the server.
Definition serverutils.c:887
void unload_gnutls_file(gnutls_datum_t *data)
Unloads a gnutls_datum_t struct's data.
Definition serverutils.c:189
int gvm_server_free(int server_socket, gnutls_session_t server_session, gnutls_certificate_credentials_t server_credentials)
Cleanup a server session.
Definition serverutils.c:1272
int gvm_connection_sendf_xml_quiet(gvm_connection_t *connection, const char *format,...)
Format and send an XML string to the server.
Definition serverutils.c:966
int gvm_server_verify(gnutls_session_t)
Verify certificate.
Definition serverutils.c:111
int gvm_server_open_verify(gnutls_session_t *, const char *, int, const char *, const char *, const char *, int)
Connect to the server using a given host, port and cert.
Definition serverutils.c:314
void gvm_connection_close(gvm_connection_t *)
Close a server connection and its socket.
Definition serverutils.c:505
int gvm_server_close(int, gnutls_session_t)
Close a server connection and its socket.
Definition serverutils.c:494
int gvm_server_session_free(gnutls_session_t, gnutls_certificate_credentials_t)
void gvm_connection_free(gvm_connection_t *)
Free connection.
Definition serverutils.c:92
int gvm_server_open_with_cert(gnutls_session_t *, const char *, int, const char *, const char *, const char *)
Connect to the server using a given host, port and cert.
Definition serverutils.c:462
int gvm_server_open(gnutls_session_t *, const char *, int)
Connect to the server using a given host and port.
Definition serverutils.c:480
int gvm_server_attach(int, gnutls_session_t *)
Attach a socket to a session, and shake hands with the peer.
Definition serverutils.c:570
int gvm_server_sendf(gnutls_session_t *, const char *,...) __attribute__((format(printf
Connection.
Definition serverutils.h:30
gint port
Port of server.
Definition serverutils.h:39
gboolean use_certs
Whether to use certs.
Definition serverutils.h:40
gchar * username
Username with which to connect.
Definition serverutils.h:35
gchar * ca_cert
CA certificate.
Definition serverutils.h:41
gchar * password
Password for user with which to connect.
Definition serverutils.h:36
gchar * priv_key
The private key.
Definition serverutils.h:43
gchar * port_string
Server port string.
Definition serverutils.h:38
int tls
Whether uses TCP-TLS (vs UNIX socket).
Definition serverutils.h:31
gchar * pub_key
The public key.
Definition serverutils.h:42
gnutls_certificate_credentials_t credentials
Credentials.
Definition serverutils.h:34
int socket
Socket.
Definition serverutils.h:32
gchar * host_string
Server host string.
Definition serverutils.h:37
gnutls_session_t session
Session.
Definition serverutils.h:33