ndhc/duiaid.h

// Copyright 2014-2018 Nicholas J. Kain <njkain at gmail dot com>
// SPDX-License-Identifier: MIT
#ifndef NJK_NDHC_DUIAID_H_
#define NJK_NDHC_DUIAID_H_

#include "ndhc.h"

void get_clientid(struct client_state_t *cs, struct client_config_t *cc);

#endif
Relicense as MIT. It's a lot more common than BSD 2-clause it is both compatible and nearly identical in effect. 2022-02-06 20:05:29 -05:00			`// Copyright 2014-2018 Nicholas J. Kain <njkain at gmail dot com>`
			`// SPDX-License-Identifier: MIT`
Support RFC4361. RFC4361 requires clients to send a clientid, and specifies that by default that clientid should be a combination of a machine-static DUID and an interface-static IAID. There are several RFC-compliant DUIDs. ndhc uses RFC6355's DUID-UUID, but chooses not to follow RFC4122 for the UUID and instead simply uses random bytes from its combined Tausworthe PRNG. RFC4122 is excessively complex, and 128-bit random values are more than sufficiently collision-resistant on even large DHCP segments. ndhc requires a read/writable directory to store the DUID/IAID states. By default this directory is /etc/ndhc. It exists outside the chroot. The DUID will be stored in a single file, DUID. The IAIDs exist per-interface and are stored in files with names similar to IAID-xx:xx:xx:xx:xx:xx, where the xx values are replaced by the Ethernet hardware address of the interface. If it is impossible to read or store the DUIDs or IAIDs, ndhc will fail at start time before it performs any network activity or forks any subprocesses. If the host system lacks volatile storage, then a clientid should manually be specified using the -c or --clientid command arguments. 2014-03-19 00:42:32 -04:00			`#ifndef NJK_NDHC_DUIAID_H_`
			`#define NJK_NDHC_DUIAID_H_`

			`#include "ndhc.h"`

Replace mostly obsolete -[static 1] with reliable old *-. This notation originally had the sole advantage of implying that the pointer was non-NULL, but it has seen little use and now clang presents warnings about it in certain contexts. 2022-01-11 22:35:19 -05:00			`void get_clientid(struct client_state_t cs, struct client_config_t cc);`
Support RFC4361. RFC4361 requires clients to send a clientid, and specifies that by default that clientid should be a combination of a machine-static DUID and an interface-static IAID. There are several RFC-compliant DUIDs. ndhc uses RFC6355's DUID-UUID, but chooses not to follow RFC4122 for the UUID and instead simply uses random bytes from its combined Tausworthe PRNG. RFC4122 is excessively complex, and 128-bit random values are more than sufficiently collision-resistant on even large DHCP segments. ndhc requires a read/writable directory to store the DUID/IAID states. By default this directory is /etc/ndhc. It exists outside the chroot. The DUID will be stored in a single file, DUID. The IAIDs exist per-interface and are stored in files with names similar to IAID-xx:xx:xx:xx:xx:xx, where the xx values are replaced by the Ethernet hardware address of the interface. If it is impossible to read or store the DUIDs or IAIDs, ndhc will fail at start time before it performs any network activity or forks any subprocesses. If the host system lacks volatile storage, then a clientid should manually be specified using the -c or --clientid command arguments. 2014-03-19 00:42:32 -04:00
Relicense as MIT. It's a lot more common than BSD 2-clause it is both compatible and nearly identical in effect. 2022-02-06 20:05:29 -05:00			`#endif`