backend.h revision bf83a0faacf16196ab9bd37dcf6190b4209ccaf7
/*
SSSD
Data Provider, private header file
Copyright (C) Simo Sorce <ssorce@redhat.com> 2008
it under the terms of the GNU 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 General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __DP_BACKEND_H__
#define __DP_BACKEND_H__
#include "providers/data_provider.h"
#include "providers/fail_over.h"
#include "providers/be_refresh.h"
#include "providers/data_provider/dp.h"
#include "util/child_common.h"
/* a special token, if used in place of the hostname, denotes that real
* hostnames should be looked up from DNS using SRV requests
*/
#define BE_SRV_IDENTIFIER "_srv_"
struct be_ctx;
typedef void (*be_callback_t)(void *);
struct be_offline_status {
bool offline;
};
struct be_resolv_ctx {
struct resolv_ctx *resolv;
enum restrict_family family_order;
};
struct be_svc_data {
struct be_svc_data *prev;
struct be_svc_data *next;
const char *name;
struct fo_service *fo_service;
struct fo_server *last_good_srv;
bool run_callbacks;
struct be_svc_callback *callbacks;
struct fo_server *first_resolved;
};
struct be_failover_ctx {
struct be_resolv_ctx *be_res;
struct be_svc_data *svcs;
struct tevent_timer *primary_server_handler;
};
struct be_cb;
struct be_ctx {
struct tevent_context *ev;
struct confdb_ctx *cdb;
struct sss_domain_info *domain;
const char *identity;
const char *conf_path;
struct be_failover_ctx *be_fo;
struct be_resolv_ctx *be_res;
/* Functions to be invoked when the
* backend goes online or offline
*/
struct be_cb *online_cb_list;
bool run_online_cb;
struct be_cb *offline_cb_list;
struct be_cb *reconnect_cb_list;
/* In contrast to online_cb_list which are only run if the backend is
* offline the unconditional_online_cb_list should be run whenever the
* backend receives a request to go online. The typical use case is to
* reset timers independenly of the state of the backend. */
struct be_cb *unconditional_online_cb_list;
struct be_offline_status offstat;
/* Periodicly check if we can go online. */
struct be_ptask *check_if_online_ptask;
struct sbus_connection *mon_conn;
struct be_refresh_ctx *refresh_ctx;
struct data_provider *provider;
};
void *pvt,
struct be_cb **reconnect_cb);
void *pvt,
struct be_cb **unconditional_online_cb);
void *pvt,
/* from data_provider_fo.c */
enum be_fo_protocol {
};
typedef void (be_svc_callback_fn_t)(void *, struct fo_server *);
int be_fo_is_srv_identifier(const char *server);
void *pvt,
const char *plugin_name);
const char *hostname);
const char *service_name,
const char *query_service,
const char *default_discovery_domain,
enum be_fo_protocol proto,
bool proto_fallback, void *user_data);
bool primary);
struct tevent_context *ev,
const char *service_name,
bool first_try);
const char *service_name,
enum port_status status,
int line,
const char *file,
const char *function);
/*
* Instruct fail-over to try next server on the next connect attempt.
* Should be used after connection to service was unexpectedly dropped
* but there is no authoritative information on whether active server is down.
*/
const char *service_name);
const char *service_name);
#endif /* __DP_BACKEND_H___ */