Zephyr API Documentation  3.6.99
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
dhcpv4.h
Go to the documentation of this file.
1
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
35enum net_dhcpv4_state {
36 NET_DHCPV4_DISABLED,
37 NET_DHCPV4_INIT,
38 NET_DHCPV4_SELECTING,
39 NET_DHCPV4_REQUESTING,
40 NET_DHCPV4_RENEWING,
41 NET_DHCPV4_REBINDING,
42 NET_DHCPV4_BOUND,
43} __packed;
44
65};
66
67struct net_dhcpv4_option_callback;
68
84typedef void (*net_dhcpv4_option_callback_handler_t)(struct net_dhcpv4_option_callback *cb,
85 size_t length,
86 enum net_dhcpv4_msg_type msg_type,
87 struct net_if *iface);
88
101struct net_dhcpv4_option_callback {
105 sys_snode_t node;
106
109
111 uint8_t option;
112
114 size_t max_length;
115
119 void *data;
120};
121
132static inline void net_dhcpv4_init_option_callback(struct net_dhcpv4_option_callback *callback,
134 uint8_t option,
135 void *data,
136 size_t max_length)
137{
138 __ASSERT(callback, "Callback pointer should not be NULL");
139 __ASSERT(handler, "Callback handler pointer should not be NULL");
140 __ASSERT(data, "Data pointer should not be NULL");
141
142 callback->handler = handler;
143 callback->option = option;
144 callback->data = data;
145 callback->max_length = max_length;
146}
147
153int net_dhcpv4_add_option_callback(struct net_dhcpv4_option_callback *cb);
154
160int net_dhcpv4_remove_option_callback(struct net_dhcpv4_option_callback *cb);
161
171static inline void
172net_dhcpv4_init_option_vendor_callback(struct net_dhcpv4_option_callback *callback,
174 void *data, size_t max_length)
175{
176 __ASSERT(callback, "Callback pointer should not be NULL");
177 __ASSERT(handler, "Callback handler pointer should not be NULL");
178 __ASSERT(data, "Data pointer should not be NULL");
179
180 callback->handler = handler;
181 callback->option = option;
182 callback->data = data;
183 callback->max_length = max_length;
184}
185
191int net_dhcpv4_add_option_vendor_callback(struct net_dhcpv4_option_callback *cb);
192
198int net_dhcpv4_remove_option_vendor_callback(struct net_dhcpv4_option_callback *cb);
199
209void net_dhcpv4_start(struct net_if *iface);
210
220void net_dhcpv4_stop(struct net_if *iface);
221
231void net_dhcpv4_restart(struct net_if *iface);
232
240const char *net_dhcpv4_state_name(enum net_dhcpv4_state state);
241
251
256#ifdef __cplusplus
257}
258#endif
259
260#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.
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:132
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:56
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:84
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:172
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:59
@ NET_DHCPV4_MSG_TYPE_ACK
Acknowledge message.
Definition: dhcpv4.h:61
@ NET_DHCPV4_MSG_TYPE_OFFER
Offer message.
Definition: dhcpv4.h:58
@ NET_DHCPV4_MSG_TYPE_RELEASE
Release message.
Definition: dhcpv4.h:63
@ NET_DHCPV4_MSG_TYPE_NAK
Negative acknowledge message.
Definition: dhcpv4.h:62
@ NET_DHCPV4_MSG_TYPE_DISCOVER
Discover message.
Definition: dhcpv4.h:57
@ NET_DHCPV4_MSG_TYPE_INFORM
Inform message.
Definition: dhcpv4.h:64
@ NET_DHCPV4_MSG_TYPE_DECLINE
Decline message.
Definition: dhcpv4.h:60
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:675