ff54771cd1
If the SSL configuration of a server was altered successfully, it would overwrite an existing configuration leading to a true memory leak. Converting the SSL_LISTENER structure to a list allows it to store the old configurations without leaking the memory. This has no functional benefits apart from storing references which could aid in debugging. In the future, the discarded configurations could be freed once all connections that use it are closed.
121 lines
3.8 KiB
C
121 lines
3.8 KiB
C
#pragma once
|
|
/*
|
|
* Copyright (c) 2016 MariaDB Corporation Ab
|
|
*
|
|
* Use of this software is governed by the Business Source License included
|
|
* in the LICENSE.TXT file and at www.mariadb.com/bsl.
|
|
*
|
|
* Change Date: 2019-07-01
|
|
*
|
|
* On the date above, in accordance with the Business Source License, use
|
|
* of this software will be governed by version 2 or later of the General
|
|
* Public License.
|
|
*/
|
|
|
|
/**
|
|
* @file config_runtime.h - Functions for runtime configuration modifications
|
|
*/
|
|
|
|
#include <maxscale/cdefs.h>
|
|
|
|
#include <maxscale/filter.h>
|
|
#include <maxscale/monitor.h>
|
|
#include <maxscale/server.h>
|
|
#include <maxscale/service.h>
|
|
|
|
/**
|
|
* @brief Create a new server
|
|
*
|
|
* This function creates a new, persistent server by first allocating a new
|
|
* server and then storing the resulting configuration file on disk. This
|
|
* function should be used only from administrative interface modules and internal
|
|
* modules should use server_alloc() instead.
|
|
*
|
|
* @param name Server name
|
|
* @param address Network address
|
|
* @param port Network port
|
|
* @param protocol Protocol module name
|
|
* @param authenticator Authenticator module name
|
|
* @param options Options for the authenticator module
|
|
* @return True on success, false if an error occurred
|
|
*/
|
|
bool runtime_create_server(const char *name, const char *address,
|
|
const char *port, const char *protocol,
|
|
const char *authenticator, const char *options);
|
|
|
|
/**
|
|
* @brief Destroy a server
|
|
*
|
|
* This removes any created server configuration files and marks the server removed
|
|
* If the server is not in use.
|
|
*
|
|
* @param server Server to destroy
|
|
* @return True if server was destroyed
|
|
*/
|
|
bool runtime_destroy_server(SERVER *server);
|
|
|
|
/**
|
|
* @brief Link a server to an object
|
|
*
|
|
* This function links the server to another object. The target can be either
|
|
* a monitor or a service.
|
|
*
|
|
* @param server Server to link
|
|
* @param target The monitor or service where the server is added
|
|
* @return True if the object was found and the server was linked to it, false
|
|
* if no object matching @c target was found
|
|
*/
|
|
bool runtime_link_server(SERVER *server, const char *target);
|
|
|
|
/**
|
|
* @brief Unlink a server from an object
|
|
*
|
|
* This function unlinks the server from another object. The target can be either
|
|
* a monitor or a service.
|
|
*
|
|
* @param server Server to unlink
|
|
* @param target The monitor or service from which the server is removed
|
|
* @return True if the object was found and the server was unlinked from it, false
|
|
* if no object matching @c target was found
|
|
*/
|
|
bool runtime_unlink_server(SERVER *server, const char *target);
|
|
|
|
/**
|
|
* @brief Alter server parameters
|
|
*
|
|
* @param server Server to alter
|
|
* @param key Key to modify
|
|
* @param value New value
|
|
* @return True if @c key was one of the supported parameters
|
|
*/
|
|
bool runtime_alter_server(SERVER *server, char *key, char *value);
|
|
|
|
/**
|
|
* @brief Enable SSL for a server
|
|
*
|
|
* The @c key , @c cert and @c ca parameters are required. @c version and @c depth
|
|
* are optional.
|
|
*
|
|
* @note SSL cannot be disabled at runtime.
|
|
*
|
|
* @param server Server to configure
|
|
* @param key Path to SSL private key
|
|
* @param cert Path to SSL public certificate
|
|
* @param ca Path to certificate authority
|
|
* @param version Required SSL Version
|
|
* @param depth Certificate verification depth
|
|
* @return True if SSL was successfully enabled
|
|
*/
|
|
bool runtime_enable_server_ssl(SERVER *server, const char *key, const char *cert,
|
|
const char *ca, const char *version, const char *depth);
|
|
|
|
/**
|
|
* @brief Alter monitor parameters
|
|
*
|
|
* @param monitor Monitor to alter
|
|
* @param key Key to modify
|
|
* @param value New value
|
|
* @return True if @c key was one of the supported parameters
|
|
*/
|
|
bool runtime_alter_monitor(MONITOR *monitor, char *key, char *value);
|