summaryrefslogtreecommitdiffstats
path: root/src/providers/fail_over_srv.h
blob: fe4088e029ee05a77f699a9dee389f160615527b (plain)
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
/*
    Authors:
        Pavel Březina <pbrezina@redhat.com>

    Copyright (C) 2013 Red Hat

    This program is free software; you can redistribute it and/or modify
    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 __FAIL_OVER_SRV_H__
#define __FAIL_OVER_SRV_H__

#include <talloc.h>
#include <tevent.h>

#include "resolv/async_resolv.h"

/* SRV lookup plugin interface */

struct fo_server_info {
    char *host;
    int port;
    unsigned short priority;
};

/*
 * If discovery_domain is NULL, it should be detected automatically.
 */
typedef struct tevent_req *
(*fo_srv_lookup_plugin_send_t)(TALLOC_CTX *mem_ctx,
                               struct tevent_context *ev,
                               const char *service,
                               const char *protocol,
                               const char *discovery_domain,
                               void *pvt);

/*
 * Returns:
 *   EOK - at least one primary or backup server was found
 *   ERR_SRV_NOT_FOUND - no primary nor backup server found
 *   ERR_SRV_LOOKUP_ERROR - error communicating with SRV database
 *   other code - depends on plugin
 *
 * If EOK is returned:
 * - and no primary server is found:
 *   *_primary_servers = NULL
 *   *_num_primary_servers = 0
 * - and no backup server is found:
 *   *_backup_servers = NULL
 *   *_num_backup_servers = 0
 * - *_dns_domain = DNS domain name where the servers were found
 */
typedef errno_t
(*fo_srv_lookup_plugin_recv_t)(TALLOC_CTX *mem_ctx,
                               struct tevent_req *req,
                               char **_dns_domain,
                               uint32_t *_ttl,
                               struct fo_server_info **_primary_servers,
                               size_t *_num_primary_servers,
                               struct fo_server_info **_backup_servers,
                               size_t *_num_backup_servers);

struct tevent_req *fo_discover_srv_send(TALLOC_CTX *mem_ctx,
                                        struct tevent_context *ev,
                                        struct resolv_ctx *resolv_ctx,
                                        const char *service,
                                        const char *protocol,
                                        const char **discovery_domains);

errno_t fo_discover_srv_recv(TALLOC_CTX *mem_ctx,
                             struct tevent_req *req,
                             char **_dns_domain,
                             uint32_t *_ttl,
                             struct fo_server_info **_servers,
                             size_t *_num_servers);

struct tevent_req *fo_discover_servers_send(TALLOC_CTX *mem_ctx,
                                            struct tevent_context *ev,
                                            struct resolv_ctx *resolv_ctx,
                                            const char *service,
                                            const char *protocol,
                                            const char *primary_domain,
                                            const char *backup_domain);

errno_t fo_discover_servers_recv(TALLOC_CTX *mem_ctx,
                                 struct tevent_req *req,
                                 char **_dns_domain,
                                 uint32_t *_ttl,
                                 struct fo_server_info **_primary_servers,
                                 size_t *_num_primary_servers,
                                 struct fo_server_info **_backup_servers,
                                 size_t *_num_backup_servers);

/* Simple SRV lookup plugin */

struct fo_resolve_srv_dns_ctx;

struct fo_resolve_srv_dns_ctx *
fo_resolve_srv_dns_ctx_init(TALLOC_CTX *mem_ctx,
                            struct resolv_ctx *resolv_ctx,
                            enum restrict_family family_order,
                            enum host_database *host_dbs,
                            const char *hostname,
                            const char *sssd_domain);

struct tevent_req *fo_resolve_srv_dns_send(TALLOC_CTX *mem_ctx,
                                           struct tevent_context *ev,
                                           const char *service,
                                           const char *protocol,
                                           const char *discovery_domain,
                                           void *pvt);

errno_t fo_resolve_srv_dns_recv(TALLOC_CTX *mem_ctx,
                                struct tevent_req *req,
                                char **_dns_domain,
                                uint32_t *_ttl,
                                struct fo_server_info **_primary_servers,
                                size_t *_num_primary_servers,
                                struct fo_server_info **_backup_servers,
                                size_t *_num_backup_servers);

#endif /* __FAIL_OVER_SRV_H__ */