gdhcp/gdhcp.h

   1 /*
   2  *
   3  *  DHCP library with GLib integration
   4  *
   5  *  Copyright (C) 2009-2013  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #ifndef __G_DHCP_H
  23 #define __G_DHCP_H
  24
  25 #include <stdbool.h>
  26 #include <stdint.h>
  27 #include <arpa/inet.h>
  28
  29 #include <glib.h>
  30
  31 #ifdef __cplusplus
  32 extern "C" {
  33 #endif
  34
  35 /* DHCP Client part*/
  36 struct _GDHCPClient;
  37
  38 typedef struct _GDHCPClient GDHCPClient;
  39
  40 typedef enum {
  41         G_DHCP_CLIENT_ERROR_NONE,
  42         G_DHCP_CLIENT_ERROR_INTERFACE_UNAVAILABLE,
  43         G_DHCP_CLIENT_ERROR_INTERFACE_IN_USE,
  44         G_DHCP_CLIENT_ERROR_INTERFACE_DOWN,
  45         G_DHCP_CLIENT_ERROR_NOMEM,
  46         G_DHCP_CLIENT_ERROR_INVALID_INDEX,
  47         G_DHCP_CLIENT_ERROR_INVALID_OPTION
  48 } GDHCPClientError;
  49
  50 typedef enum {
  51         G_DHCP_CLIENT_EVENT_LEASE_AVAILABLE,
  52         G_DHCP_CLIENT_EVENT_IPV4LL_AVAILABLE,
  53         G_DHCP_CLIENT_EVENT_NO_LEASE,
  54         G_DHCP_CLIENT_EVENT_LEASE_LOST,
  55         G_DHCP_CLIENT_EVENT_IPV4LL_LOST,
  56         G_DHCP_CLIENT_EVENT_ADDRESS_CONFLICT,
  57         G_DHCP_CLIENT_EVENT_INFORMATION_REQ,
  58         G_DHCP_CLIENT_EVENT_SOLICITATION,
  59         G_DHCP_CLIENT_EVENT_ADVERTISE,
  60         G_DHCP_CLIENT_EVENT_REQUEST,
  61         G_DHCP_CLIENT_EVENT_RENEW,
  62         G_DHCP_CLIENT_EVENT_REBIND,
  63         G_DHCP_CLIENT_EVENT_RELEASE,
  64         G_DHCP_CLIENT_EVENT_CONFIRM,
  65         G_DHCP_CLIENT_EVENT_DECLINE,
  66 } GDHCPClientEvent;
  67
  68 typedef enum {
  69         G_DHCP_IPV4,
  70         G_DHCP_IPV6,
  71         G_DHCP_IPV4LL,
  72 } GDHCPType;
  73
  74 #define G_DHCP_SUBNET           0x01
  75 #define G_DHCP_ROUTER           0x03
  76 #define G_DHCP_TIME_SERVER      0x04
  77 #define G_DHCP_DNS_SERVER       0x06
  78 #define G_DHCP_DOMAIN_NAME      0x0f
  79 #define G_DHCP_HOST_NAME        0x0c
  80 #define G_DHCP_MTU              0x1a
  81 #define G_DHCP_NTP_SERVER       0x2a
  82 #define G_DHCP_VENDOR_CLASS_ID  0x3c
  83 #define G_DHCP_CLIENT_ID        0x3d
  84
  85 #define G_DHCPV6_CLIENTID       1
  86 #define G_DHCPV6_SERVERID       2
  87 #define G_DHCPV6_IA_NA          3
  88 #define G_DHCPV6_IA_TA          4
  89 #define G_DHCPV6_IAADDR         5
  90 #define G_DHCPV6_ORO            6
  91 #define G_DHCPV6_PREFERENCE     7
  92 #define G_DHCPV6_ELAPSED_TIME   8
  93 #define G_DHCPV6_STATUS_CODE    13
  94 #define G_DHCPV6_RAPID_COMMIT   14
  95 #define G_DHCPV6_DNS_SERVERS    23
  96 #define G_DHCPV6_DOMAIN_LIST    24
  97 #define G_DHCPV6_IA_PD          25
  98 #define G_DHCPV6_IA_PREFIX      26
  99 #define G_DHCPV6_SNTP_SERVERS   31
 100
 101 #define G_DHCPV6_ERROR_SUCCESS  0
 102 #define G_DHCPV6_ERROR_FAILURE  1
 103 #define G_DHCPV6_ERROR_NO_ADDR  2
 104 #define G_DHCPV6_ERROR_BINDING  3
 105 #define G_DHCPV6_ERROR_LINK     4
 106 #define G_DHCPV6_ERROR_MCAST    5
 107 #define G_DHCPV6_ERROR_NO_PREFIX 6
 108
 109 typedef enum {
 110         G_DHCPV6_DUID_LLT = 1,
 111         G_DHCPV6_DUID_EN  = 2,
 112         G_DHCPV6_DUID_LL  = 3,
 113 } GDHCPDuidType;
 114
 115 typedef struct {
 116         /*
 117          * Note that no field in this struct can be allocated
 118          * from heap or there will be a memory leak when the
 119          * struct is freed by client.c:remove_option_value()
 120          */
 121         struct in6_addr prefix;
 122         unsigned char prefixlen;
 123         uint32_t preferred;
 124         uint32_t valid;
 125         time_t expire;
 126 } GDHCPIAPrefix;
 127
 128 typedef void (*GDHCPClientEventFunc) (GDHCPClient *client, gpointer user_data);
 129
 130 typedef void (*GDHCPDebugFunc)(const char *str, gpointer user_data);
 131
 132 GDHCPClient *g_dhcp_client_new(GDHCPType type, int index,
 133                                                 GDHCPClientError *error);
 134
 135 int g_dhcp_client_start(GDHCPClient *client, const char *last_address);
 136 void g_dhcp_client_stop(GDHCPClient *client);
 137
 138 GDHCPClient *g_dhcp_client_ref(GDHCPClient *client);
 139 void g_dhcp_client_unref(GDHCPClient *client);
 140
 141 void g_dhcp_client_register_event(GDHCPClient *client,
 142                                         GDHCPClientEvent event,
 143                                         GDHCPClientEventFunc func,
 144                                         gpointer user_data);
 145
 146 GDHCPClientError g_dhcp_client_set_request(GDHCPClient *client,
 147                                                 unsigned int option_code);
 148 void g_dhcp_client_clear_requests(GDHCPClient *dhcp_client);
 149 void g_dhcp_client_clear_values(GDHCPClient *dhcp_client);
 150 GDHCPClientError g_dhcp_client_set_id(GDHCPClient *client);
 151 GDHCPClientError g_dhcp_client_set_send(GDHCPClient *client,
 152                                                 unsigned char option_code,
 153                                                 const char *option_value);
 154
 155 char *g_dhcp_client_get_server_address(GDHCPClient *client);
 156 char *g_dhcp_client_get_address(GDHCPClient *client);
 157 char *g_dhcp_client_get_netmask(GDHCPClient *client);
 158 GList *g_dhcp_client_get_option(GDHCPClient *client,
 159                                                 unsigned char option_code);
 160 int g_dhcp_client_get_index(GDHCPClient *client);
 161
 162 void g_dhcp_client_set_debug(GDHCPClient *client,
 163                                 GDHCPDebugFunc func, gpointer user_data);
 164 int g_dhcpv6_create_duid(GDHCPDuidType duid_type, int index, int type,
 165                         unsigned char **duid, int *duid_len);
 166 int g_dhcpv6_client_set_duid(GDHCPClient *dhcp_client, unsigned char *duid,
 167                         int duid_len);
 168 int g_dhcpv6_client_set_pd(GDHCPClient *dhcp_client, uint32_t *T1, uint32_t *T2,
 169                         GSList *prefixes);
 170 GSList *g_dhcpv6_copy_prefixes(GSList *prefixes);
 171 gboolean g_dhcpv6_client_clear_send(GDHCPClient *dhcp_client, uint16_t code);
 172 void g_dhcpv6_client_set_send(GDHCPClient *dhcp_client, uint16_t option_code,
 173                         uint8_t *option_value, uint16_t option_len);
 174 uint16_t g_dhcpv6_client_get_status(GDHCPClient *dhcp_client);
 175 int g_dhcpv6_client_set_oro(GDHCPClient *dhcp_client, int args, ...);
 176 void g_dhcpv6_client_create_iaid(GDHCPClient *dhcp_client, int index,
 177                                 unsigned char *iaid);
 178 int g_dhcpv6_client_get_timeouts(GDHCPClient *dhcp_client,
 179                                 uint32_t *T1, uint32_t *T2,
 180                                 time_t *started, time_t *expire);
 181 uint32_t g_dhcpv6_client_get_iaid(GDHCPClient *dhcp_client);
 182 void g_dhcpv6_client_set_iaid(GDHCPClient *dhcp_client, uint32_t iaid);
 183 int g_dhcpv6_client_set_ia(GDHCPClient *dhcp_client, int index,
 184                         int code, uint32_t *T1, uint32_t *T2,
 185                         bool add_addresses, const char *address);
 186 int g_dhcpv6_client_set_ias(GDHCPClient *dhcp_client, int index,
 187                         int code, uint32_t *T1, uint32_t *T2,
 188                         GSList *addresses);
 189 void g_dhcpv6_client_reset_request(GDHCPClient *dhcp_client);
 190 void g_dhcpv6_client_set_retransmit(GDHCPClient *dhcp_client);
 191 void g_dhcpv6_client_clear_retransmit(GDHCPClient *dhcp_client);
 192
 193 /* DHCP Server */
 194 typedef enum {
 195         G_DHCP_SERVER_ERROR_NONE,
 196         G_DHCP_SERVER_ERROR_INTERFACE_UNAVAILABLE,
 197         G_DHCP_SERVER_ERROR_INTERFACE_IN_USE,
 198         G_DHCP_SERVER_ERROR_INTERFACE_DOWN,
 199         G_DHCP_SERVER_ERROR_NOMEM,
 200         G_DHCP_SERVER_ERROR_INVALID_INDEX,
 201         G_DHCP_SERVER_ERROR_INVALID_OPTION,
 202         G_DHCP_SERVER_ERROR_IP_ADDRESS_INVALID
 203 } GDHCPServerError;
 204
 205 typedef void (*GDHCPSaveLeaseFunc) (unsigned char *mac,
 206                         unsigned int nip, unsigned int expire);
 207
 208 typedef void (*GDHCPLeaseAddedCb) (unsigned char *mac, uint32_t ip);
 209
 210 struct _GDHCPServer;
 211
 212 typedef struct _GDHCPServer GDHCPServer;
 213
 214 GDHCPServer *g_dhcp_server_new(GDHCPType type,
 215                 int ifindex, GDHCPServerError *error);
 216 int g_dhcp_server_start(GDHCPServer *server);
 217 void g_dhcp_server_stop(GDHCPServer *server);
 218
 219 GDHCPServer *g_dhcp_server_ref(GDHCPServer *server);
 220 void g_dhcp_server_unref(GDHCPServer *server);
 221
 222 int g_dhcp_server_set_option(GDHCPServer *server,
 223                 unsigned char option_code, const char *option_value);
 224 int g_dhcp_server_set_ip_range(GDHCPServer *server,
 225                 const char *start_ip, const char *end_ip);
 226 void g_dhcp_server_set_debug(GDHCPServer *server,
 227                                 GDHCPDebugFunc func, gpointer user_data);
 228 void g_dhcp_server_set_lease_time(GDHCPServer *dhcp_server,
 229                                                 unsigned int lease_time);
 230 void g_dhcp_server_set_save_lease(GDHCPServer *dhcp_server,
 231                                 GDHCPSaveLeaseFunc func, gpointer user_data);
 232 void g_dhcp_server_set_lease_added_cb(GDHCPServer *dhcp_server,
 233                                                         GDHCPLeaseAddedCb cb);
 234
 235 int dhcp_get_random(uint64_t *val);
 236 void dhcp_cleanup_random(void);
 237
 238 #ifdef __cplusplus
 239 }
 240 #endif
 241
 242 #endif /* __G_DHCP_H */