73c8ced784
```
21.16. Vendor Class Option
This option is used by a client to identify the vendor that
manufactured the hardware on which the client is running. The
information contained in the data area of this option is contained in
one or more opaque fields that identify details of the hardware
configuration. The format of the Vendor Class option is:
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| OPTION_VENDOR_CLASS | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| enterprise-number |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
. .
. vendor-class-data .
. . . . .
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 28: Vendor Class Option Format
option-code OPTION_VENDOR_CLASS (16).
option-len 4 + length of vendor-class-data field.
enterprise-number The vendor's registered Enterprise Number as
maintained by IANA [IANA-PEN]. A 4-octet
field containing an unsigned integer.
vendor-class-data The hardware configuration of the node on
which the client is running. A
variable-length field (4 octets less than the
value in the option-len field).
The vendor-class-data field is composed of a series of separate
items, each of which describes some characteristic of the client's
hardware configuration. Examples of vendor-class-data instances
might include the version of the operating system the client is
running or the amount of memory installed on the client.
Each instance of vendor-class-data is formatted as follows:
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-...-+-+-+-+-+-+-+
| vendor-class-len | opaque-data |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-...-+-+-+-+-+-+-+
Figure 29: Format of vendor-class-data Field
The vendor-class-len field is 2 octets long and specifies the length
of the opaque vendor-class-data in network byte order.
Servers and clients MUST NOT include more than one instance of
OPTION_VENDOR_CLASS with the same Enterprise Number. Each instance
of OPTION_VENDOR_CLASS can carry multiple vendor-class-data
instances.
```
172 lines
6.8 KiB
C
172 lines
6.8 KiB
C
/* SPDX-License-Identifier: LGPL-2.1+ */
|
|
#ifndef foosddhcp6clienthfoo
|
|
#define foosddhcp6clienthfoo
|
|
|
|
/***
|
|
Copyright © 2014 Intel Corporation. All rights reserved.
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
systemd 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
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
***/
|
|
|
|
#include <inttypes.h>
|
|
#include <net/ethernet.h>
|
|
#include <sys/types.h>
|
|
|
|
#include "sd-dhcp6-lease.h"
|
|
#include "sd-dhcp6-option.h"
|
|
#include "sd-event.h"
|
|
|
|
#include "_sd-common.h"
|
|
|
|
_SD_BEGIN_DECLARATIONS;
|
|
|
|
enum {
|
|
SD_DHCP6_CLIENT_EVENT_STOP = 0,
|
|
SD_DHCP6_CLIENT_EVENT_RESEND_EXPIRE = 10,
|
|
SD_DHCP6_CLIENT_EVENT_RETRANS_MAX = 11,
|
|
SD_DHCP6_CLIENT_EVENT_IP_ACQUIRE = 12,
|
|
SD_DHCP6_CLIENT_EVENT_INFORMATION_REQUEST = 13,
|
|
};
|
|
|
|
enum {
|
|
SD_DHCP6_OPTION_CLIENTID = 1,
|
|
SD_DHCP6_OPTION_SERVERID = 2,
|
|
SD_DHCP6_OPTION_IA_NA = 3,
|
|
SD_DHCP6_OPTION_IA_TA = 4,
|
|
SD_DHCP6_OPTION_IAADDR = 5,
|
|
SD_DHCP6_OPTION_ORO = 6,
|
|
SD_DHCP6_OPTION_PREFERENCE = 7,
|
|
SD_DHCP6_OPTION_ELAPSED_TIME = 8,
|
|
SD_DHCP6_OPTION_RELAY_MSG = 9,
|
|
/* option code 10 is unassigned */
|
|
SD_DHCP6_OPTION_AUTH = 11,
|
|
SD_DHCP6_OPTION_UNICAST = 12,
|
|
SD_DHCP6_OPTION_STATUS_CODE = 13,
|
|
SD_DHCP6_OPTION_RAPID_COMMIT = 14,
|
|
SD_DHCP6_OPTION_USER_CLASS = 15,
|
|
SD_DHCP6_OPTION_VENDOR_CLASS = 16,
|
|
SD_DHCP6_OPTION_VENDOR_OPTS = 17,
|
|
SD_DHCP6_OPTION_INTERFACE_ID = 18,
|
|
SD_DHCP6_OPTION_RECONF_MSG = 19,
|
|
SD_DHCP6_OPTION_RECONF_ACCEPT = 20,
|
|
|
|
SD_DHCP6_OPTION_DNS_SERVERS = 23, /* RFC 3646 */
|
|
SD_DHCP6_OPTION_DOMAIN_LIST = 24, /* RFC 3646 */
|
|
SD_DHCP6_OPTION_IA_PD = 25, /* RFC 3633, prefix delegation */
|
|
SD_DHCP6_OPTION_IA_PD_PREFIX = 26, /* RFC 3633, prefix delegation */
|
|
|
|
SD_DHCP6_OPTION_SNTP_SERVERS = 31, /* RFC 4075, deprecated */
|
|
SD_DHCP6_OPTION_INFORMATION_REFRESH_TIME = 32, /* RFC 8415, sec. 21.23 */
|
|
|
|
/* option code 35 is unassigned */
|
|
|
|
SD_DHCP6_OPTION_FQDN = 39, /* RFC 4704 */
|
|
|
|
SD_DHCP6_OPTION_NTP_SERVER = 56, /* RFC 5908 */
|
|
SD_DHCP6_OPTION_MUD_URL = 112, /* RFC 8250 */
|
|
|
|
/* option codes 89-142 are unassigned */
|
|
/* option codes 144-65535 are unassigned */
|
|
};
|
|
|
|
typedef struct sd_dhcp6_client sd_dhcp6_client;
|
|
|
|
typedef void (*sd_dhcp6_client_callback_t)(sd_dhcp6_client *client, int event, void *userdata);
|
|
int sd_dhcp6_client_set_callback(
|
|
sd_dhcp6_client *client,
|
|
sd_dhcp6_client_callback_t cb,
|
|
void *userdata);
|
|
|
|
int sd_dhcp6_client_set_ifindex(
|
|
sd_dhcp6_client *client,
|
|
int interface_index);
|
|
int sd_dhcp6_client_set_local_address(
|
|
sd_dhcp6_client *client,
|
|
const struct in6_addr *local_address);
|
|
int sd_dhcp6_client_set_mac(
|
|
sd_dhcp6_client *client,
|
|
const uint8_t *addr,
|
|
size_t addr_len,
|
|
uint16_t arp_type);
|
|
int sd_dhcp6_client_set_duid(
|
|
sd_dhcp6_client *client,
|
|
uint16_t duid_type,
|
|
const void *duid,
|
|
size_t duid_len);
|
|
int sd_dhcp6_client_set_duid_llt(
|
|
sd_dhcp6_client *client,
|
|
uint64_t llt_time);
|
|
int sd_dhcp6_client_set_iaid(
|
|
sd_dhcp6_client *client,
|
|
uint32_t iaid);
|
|
int sd_dhcp6_client_set_fqdn(
|
|
sd_dhcp6_client *client,
|
|
const char *fqdn);
|
|
int sd_dhcp6_client_set_information_request(
|
|
sd_dhcp6_client *client,
|
|
int enabled);
|
|
int sd_dhcp6_client_get_information_request(
|
|
sd_dhcp6_client *client,
|
|
int *enabled);
|
|
int sd_dhcp6_client_set_request_option(
|
|
sd_dhcp6_client *client,
|
|
uint16_t option);
|
|
int sd_dhcp6_client_set_request_mud_url(
|
|
sd_dhcp6_client *client,
|
|
const char *mudurl);
|
|
int sd_dhcp6_client_set_request_user_class(
|
|
sd_dhcp6_client *client,
|
|
char** user_class);
|
|
int sd_dhcp6_client_set_request_vendor_class(
|
|
sd_dhcp6_client *client,
|
|
char** vendor_class);
|
|
int sd_dhcp6_client_set_prefix_delegation_hint(
|
|
sd_dhcp6_client *client,
|
|
uint8_t prefixlen,
|
|
const struct in6_addr *pd_address);
|
|
int sd_dhcp6_client_get_prefix_delegation(sd_dhcp6_client *client,
|
|
int *delegation);
|
|
int sd_dhcp6_client_set_prefix_delegation(sd_dhcp6_client *client,
|
|
int delegation);
|
|
int sd_dhcp6_client_get_address_request(sd_dhcp6_client *client,
|
|
int *request);
|
|
int sd_dhcp6_client_set_address_request(sd_dhcp6_client *client,
|
|
int request);
|
|
int sd_dhcp6_client_set_transaction_id(sd_dhcp6_client *client, uint32_t transaction_id);
|
|
|
|
int sd_dhcp6_client_get_lease(
|
|
sd_dhcp6_client *client,
|
|
sd_dhcp6_lease **ret);
|
|
|
|
int sd_dhcp6_client_add_option(sd_dhcp6_client *client, sd_dhcp6_option *v);
|
|
|
|
int sd_dhcp6_client_stop(sd_dhcp6_client *client);
|
|
int sd_dhcp6_client_start(sd_dhcp6_client *client);
|
|
int sd_dhcp6_client_is_running(sd_dhcp6_client *client);
|
|
int sd_dhcp6_client_attach_event(
|
|
sd_dhcp6_client *client,
|
|
sd_event *event,
|
|
int64_t priority);
|
|
int sd_dhcp6_client_detach_event(sd_dhcp6_client *client);
|
|
sd_event *sd_dhcp6_client_get_event(sd_dhcp6_client *client);
|
|
sd_dhcp6_client *sd_dhcp6_client_ref(sd_dhcp6_client *client);
|
|
sd_dhcp6_client *sd_dhcp6_client_unref(sd_dhcp6_client *client);
|
|
int sd_dhcp6_client_new(sd_dhcp6_client **ret);
|
|
|
|
_SD_DEFINE_POINTER_CLEANUP_FUNC(sd_dhcp6_client, sd_dhcp6_client_unref);
|
|
|
|
_SD_END_DECLARATIONS;
|
|
|
|
#endif
|