1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
|
/* SPDX-FileCopyrightText: 2009-2023 Greenbone AG
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
/**
* @file
* @brief GnuTLS based functions for server communication - header file.
*
* This module supplies low-level communication functions for communication
* with a server over GnuTLS.
*/
#ifndef _GVM_SERVERUTILS_H
#define _GVM_SERVERUTILS_H
#include <glib.h> /* for gchar, gboolean, gint */
#include <gnutls/gnutls.h> /* for gnutls_session_t, gnutls_certificate_cred... */
#include <stdarg.h> /* for va_list */
#include <sys/param.h>
#ifdef __FreeBSD__
#include <netinet/in.h>
#endif
#include <netinet/ip.h>
/**
* @brief Connection.
*/
typedef struct
{
int tls; ///< Whether uses TCP-TLS (vs UNIX socket).
int socket; ///< Socket.
gnutls_session_t session; ///< Session.
gnutls_certificate_credentials_t credentials; ///< Credentials.
gchar *username; ///< Username with which to connect.
gchar *password; ///< Password for user with which to connect.
gchar *host_string; ///< Server host string.
gchar *port_string; ///< Server port string.
gint port; ///< Port of server.
gboolean use_certs; ///< Whether to use certs.
gchar *ca_cert; ///< CA certificate.
gchar *pub_key; ///< The public key.
gchar *priv_key; ///< The private key.
} gvm_connection_t;
void
gvm_connection_free (gvm_connection_t *);
void
gvm_connection_close (gvm_connection_t *);
int gvm_server_verify (gnutls_session_t);
int
gvm_server_open (gnutls_session_t *, const char *, int);
int
gvm_server_open_verify (gnutls_session_t *, const char *, int, const char *,
const char *, const char *, int);
int
gvm_server_open_with_cert (gnutls_session_t *, const char *, int, const char *,
const char *, const char *);
int
gvm_server_close (int, gnutls_session_t);
int
gvm_server_attach (int, gnutls_session_t *);
int
gvm_server_sendf (gnutls_session_t *, const char *, ...)
__attribute__ ((format (printf, 2, 3)));
int
gvm_server_vsendf (gnutls_session_t *, const char *, va_list);
int
gvm_socket_vsendf (int, const char *, va_list);
int
gvm_server_sendf_xml (gnutls_session_t *, const char *, ...);
int
gvm_server_sendf_xml_quiet (gnutls_session_t *, const char *, ...);
int
gvm_connection_sendf_xml (gvm_connection_t *, const char *, ...);
int
gvm_connection_sendf_xml_quiet (gvm_connection_t *, const char *, ...);
int
gvm_connection_sendf (gvm_connection_t *, const char *, ...);
int
gvm_server_new (unsigned int, gchar *, gchar *, gchar *, gnutls_session_t *,
gnutls_certificate_credentials_t *);
int
gvm_server_new_mem (unsigned int, const char *, const char *, const char *,
gnutls_session_t *, gnutls_certificate_credentials_t *);
int
gvm_server_free (int, gnutls_session_t, gnutls_certificate_credentials_t);
int gvm_server_session_free (gnutls_session_t,
gnutls_certificate_credentials_t);
int
load_gnutls_file (const char *, gnutls_datum_t *);
void
unload_gnutls_file (gnutls_datum_t *);
int
set_gnutls_dhparams (gnutls_certificate_credentials_t, const char *);
#endif /* not _GVM_SERVERUTILS_H */
|