Zephyr API Documentation 4.2.0-rc3
A Scalable Open Source RTOS
 4.2.0-rc3
dhcpv4.h
Go to the documentation of this file.
1
4
5/*
6 * Copyright (c) 2016 Intel Corporation
7 *
8 * SPDX-License-Identifier: Apache-2.0
9 */
10
11#ifndef ZEPHYR_INCLUDE_NET_DHCPV4_H_
12#define ZEPHYR_INCLUDE_NET_DHCPV4_H_
13
14#include <zephyr/sys/slist.h>
15#include <zephyr/types.h>
16
17#ifdef __cplusplus
18extern "C" {
19#endif
20
29
31
37enum net_dhcpv4_state {
38 NET_DHCPV4_DISABLED,
39 NET_DHCPV4_INIT,
40 NET_DHCPV4_INIT_REBOOT,
41 NET_DHCPV4_SELECTING,
42 NET_DHCPV4_REQUESTING,
43 NET_DHCPV4_RENEWING,
44 NET_DHCPV4_REBINDING,
45 NET_DHCPV4_BOUND,
46 NET_DHCPV4_DECLINE,
47} __packed;
48
50
70
71struct net_dhcpv4_option_callback;
72
88typedef void (*net_dhcpv4_option_callback_handler_t)(struct net_dhcpv4_option_callback *cb,
89 size_t length,
90 enum net_dhcpv4_msg_type msg_type,
91 struct net_if *iface);
92
94
105struct net_dhcpv4_option_callback {
109 sys_snode_t node;
110
113
115 uint8_t option;
116
118 size_t max_length;
119
123 void *data;
124};
125
127
136static inline void net_dhcpv4_init_option_callback(struct net_dhcpv4_option_callback *callback,
138 uint8_t option,
139 void *data,
140 size_t max_length)
141{
142 __ASSERT(callback, "Callback pointer should not be NULL");
143 __ASSERT(handler, "Callback handler pointer should not be NULL");
144 __ASSERT(data, "Data pointer should not be NULL");
145
146 callback->handler = handler;
147 callback->option = option;
148 callback->data = data;
149 callback->max_length = max_length;
150}
151
157int net_dhcpv4_add_option_callback(struct net_dhcpv4_option_callback *cb);
158
164int net_dhcpv4_remove_option_callback(struct net_dhcpv4_option_callback *cb);
165
175static inline void
176net_dhcpv4_init_option_vendor_callback(struct net_dhcpv4_option_callback *callback,
178 void *data, size_t max_length)
179{
180 __ASSERT(callback, "Callback pointer should not be NULL");
181 __ASSERT(handler, "Callback handler pointer should not be NULL");
182 __ASSERT(data, "Data pointer should not be NULL");
183
184 callback->handler = handler;
185 callback->option = option;
186 callback->data = data;
187 callback->max_length = max_length;
188}
189
195int net_dhcpv4_add_option_vendor_callback(struct net_dhcpv4_option_callback *cb);
196
202int net_dhcpv4_remove_option_vendor_callback(struct net_dhcpv4_option_callback *cb);
203
213void net_dhcpv4_start(struct net_if *iface);
214
224void net_dhcpv4_stop(struct net_if *iface);
225
235void net_dhcpv4_restart(struct net_if *iface);
236
238
244const char *net_dhcpv4_state_name(enum net_dhcpv4_state state);
245
247
255
259
260#ifdef __cplusplus
261}
262#endif
263
264#endif /* ZEPHYR_INCLUDE_NET_DHCPV4_H_ */
int net_dhcpv4_remove_option_vendor_callback(struct net_dhcpv4_option_callback *cb)
Remove an application callback for encapsulated vendor-specific options.
const char * net_dhcpv4_msg_type_name(enum net_dhcpv4_msg_type msg_type)
Return a text representation of the msg_type.
void net_dhcpv4_restart(struct net_if *iface)
Restart DHCPv4 client on an iface.
void(* net_dhcpv4_option_callback_handler_t)(struct net_dhcpv4_option_callback *cb, size_t length, enum net_dhcpv4_msg_type msg_type, struct net_if *iface)
Define the application callback handler function signature.
Definition dhcpv4.h:88
static void net_dhcpv4_init_option_callback(struct net_dhcpv4_option_callback *callback, net_dhcpv4_option_callback_handler_t handler, uint8_t option, void *data, size_t max_length)
Helper to initialize a struct net_dhcpv4_option_callback properly.
Definition dhcpv4.h:136
void net_dhcpv4_stop(struct net_if *iface)
Stop DHCPv4 client on an iface.
int net_dhcpv4_remove_option_callback(struct net_dhcpv4_option_callback *cb)
Remove an application callback.
int net_dhcpv4_add_option_vendor_callback(struct net_dhcpv4_option_callback *cb)
Add an application callback for encapsulated vendor-specific options.
net_dhcpv4_msg_type
DHCPv4 message types.
Definition dhcpv4.h:60
static void net_dhcpv4_init_option_vendor_callback(struct net_dhcpv4_option_callback *callback, net_dhcpv4_option_callback_handler_t handler, uint8_t option, void *data, size_t max_length)
Helper to initialize a struct net_dhcpv4_option_callback for encapsulated vendor-specific options pro...
Definition dhcpv4.h:176
int net_dhcpv4_add_option_callback(struct net_dhcpv4_option_callback *cb)
Add an application callback.
void net_dhcpv4_start(struct net_if *iface)
Start DHCPv4 client on an iface.
@ NET_DHCPV4_MSG_TYPE_REQUEST
Request message.
Definition dhcpv4.h:63
@ NET_DHCPV4_MSG_TYPE_ACK
Acknowledge message.
Definition dhcpv4.h:65
@ NET_DHCPV4_MSG_TYPE_OFFER
Offer message.
Definition dhcpv4.h:62
@ NET_DHCPV4_MSG_TYPE_RELEASE
Release message.
Definition dhcpv4.h:67
@ NET_DHCPV4_MSG_TYPE_NAK
Negative acknowledge message.
Definition dhcpv4.h:66
@ NET_DHCPV4_MSG_TYPE_DISCOVER
Discover message.
Definition dhcpv4.h:61
@ NET_DHCPV4_MSG_TYPE_INFORM
Inform message.
Definition dhcpv4.h:68
@ NET_DHCPV4_MSG_TYPE_DECLINE
Decline message.
Definition dhcpv4.h:64
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:39
state
Definition parser_state.h:29
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
Network Interface structure.
Definition net_if.h:726