dhcp6_messages.mes 43.4 KB
Newer Older
1
# Copyright (C) 2012-2018 Internet Systems Consortium, Inc. ("ISC")
2
#
3
4
5
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
6
7
8

$NAMESPACE isc::dhcp

9
10
11
12
13
% DHCP6_ACTIVATE_INTERFACE activating interface %1
This message is printed when DHCPv6 server enabled an interface to be used
to receive DHCPv6 traffic. IPv6 socket on this interface will be opened once
Interface Manager starts up procedure of opening sockets.

14
15
16
17
18
19
20
21
22
23
24
25
% DHCP6_ADD_GLOBAL_STATUS_CODE %1: adding Status Code to DHCPv6 packet: %2
This message is logged when the server is adding the top-level
Status Code option. The first argument includes the client and the
transaction identification information. The second argument includes
the details of the status code.

% DHCP6_ADD_STATUS_CODE_FOR_IA %1: adding Status Code to IA with iaid=%2: %3
This message is logged when the server is adding the Status Code
option to an IA. The first argument includes the client and the
transaction identification information. The second argument specifies
the IAID. The third argument includes the details of the status code.

26
27
28
29
30
31
32
33
34
35
36
% DHCP6_ALREADY_RUNNING %1 already running? %2
This is an error message that occurs when the DHCPv6 server encounters
a pre-existing PID file which contains the PID of a running process.
This most likely indicates an attempt to start a second instance of
the server using the same configuration file.  It is possible, though
unlikely that the PID file is a remnant left behind by a server crash or
power failure and the PID it contains refers to a process other than
the server.  In such an event, it would be necessary to manually remove
the PID file.  The first argument is the DHCPv6 process name, the second
contains the PID and PID file.

37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
% DHCP6_BUFFER_RECEIVED received buffer from %1:%2 to %3:%4 over interface %5
This debug message is logged when the server has received a packet
over the socket. When the message is logged the contents of the received
packet hasn't been parsed yet. The only available information is the
interface and the source and destination addresses/ports.

% DHCP6_BUFFER_UNPACK parsing buffer received from %1 to %2 over interface %3
This debug message is issued when the server starts parsing the received
buffer holding the DHCPv6 message. The arguments specify the source and
destination addresses as well as the interface over which the buffer has
been received.

% DHCP6_BUFFER_WAIT_SIGNAL signal received while waiting for next packet, next waiting signal is %1
This debug message is issued when the server was waiting for the
packet, but the wait has been interrupted by the signal received
by the process. The signal will be handled before the server starts
waiting for next packets. The argument specifies the next signal to
be handled by the server.

56
% DHCP6_CLASS_ASSIGNED %1: client packet has been assigned to the following class(es): %2
57
This debug message informs that incoming packet has been assigned to specified
58
59
60
61
class or classes. This is a normal behavior and indicates successful operation.
The first argument specifies the client and transaction identification
information. The second argument includes all classes to which the
packet has been assigned.
62

63
% DHCP6_CLASS_UNCONFIGURED %1: client packet belongs to an unconfigured class: %1
64
65
66
67
68
This debug message informs that incoming packet belongs to a class
which cannot be found in the configuration. Either a hook written
before the classification was added to Kea is used, or class naming is
inconsistent.

69
70
% DHCP6_COMMAND_RECEIVED received command %1, arguments: %2
A debug message listing the command (and possible arguments) received
71
from the Kea control system by the IPv6 DHCP server.
72

73
74
75
76
77
78
% DHCP6_CONFIG_COMPLETE DHCPv6 server has completed configuration: %1
This is an informational message announcing the successful processing of a
new configuration. it is output during server startup, and when an updated
configuration is committed by the administrator.  Additional information
may be provided.

79
80
81
82
83
% DHCP6_CONFIG_LOAD_FAIL configuration error using file: %1, reason: %2
This error message indicates that the DHCPv6 configuration has failed.
If this is an initial configuration (during server's startup) the server
will fail to start. If this is a dynamic reconfiguration attempt the
server will continue to use an old configuration.
84

85
86
87
88
% DHCP6_CONFIG_RECEIVED received configuration: %1
A debug message listing the configuration received by the DHCPv6 server.
The source of that configuration depends on used configuration backend.

89
90
91
92
93
% DHCP6_CONFIG_START DHCPv6 server is processing the following configuration: %1
This is a debug message that is issued every time the server receives a
configuration. That happens start up and also when a server configuration
change is committed by the administrator.

94
95
% DHCP6_CONFIG_UPDATE updated configuration received: %1
A debug message indicating that the IPv6 DHCP server has received an
96
updated configuration from the Kea configuration system.
97

98
% DHCP6_DB_BACKEND_STARTED lease database started (type: %1, name: %2)
99
100
101
This informational message is printed every time the IPv6 DHCP server
is started.  It indicates what database backend type is being to store
lease and other information.
102

103
104
105
106
% DHCP6_DDNS_CREATE_ADD_NAME_CHANGE_REQUEST created name change request: %1
This debug message is logged when the new Name Change Request has been created
to perform the DNS Update, which adds new RRs.

107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
% DHCP6_DDNS_FQDN_GENERATED %1: generated FQDN for the client: %2
This debug message is logged when the server generated FQDN (name)
for the client which message is processed. The names may be
generated by the server when required by the server's policy or
when the client doesn't provide any specific FQDN in its message
to the server. The first argument includes the client and
transaction identification information. The second argument includes
the generated FQDN.

% DHCP6_DDNS_GENERATED_FQDN_UPDATE_FAIL %1: failed to update the lease using address %2, after generating FQDN for a client, reason: %3
This message indicates the failure when trying to update the lease and/or
options in the server's response with the hostname generated by the server
from the acquired address. The first argument includes the client and the
transaction identification information. The second argument is a leased
address. The third argument includes the reason for the failure.
122

123
124
125
126
127
128
% DHCP6_DDNS_GENERATE_FQDN %1: client did not send a FQDN option; FQDN will be
generated for the client.
This debug message is issued when the server did not receive a FQDN option
from the client and client name replacement is enabled.  This provides a means
to create DNS entries for unsophisticated clients.

129
% DHCP6_DDNS_LEASE_RENEW_FQDN_CHANGE FQDN %1: FQDN for the renewed lease: %2 has changed. New values: hostname = %3, reverse mapping = %4, forward mapping = %5
130
131
This debug message is logged when FQDN mapping for a particular lease has been
changed by the recent Renew message. This mapping will be changed in DNS.
132
133
134
135
The first argument includes the client and the transaction identification
information. The second argument holds the details about the lease for which
the FQDN information and/or mappings have changed. The remaining arguments
hold the new FQDN information and flags for mappings.
136

137
% DHCP6_DDNS_RECEIVE_FQDN %1: received DHCPv6 Client FQDN option: %2
138
This debug message is logged when server has found the DHCPv6 Client FQDN Option
139
140
141
sent by a client and started processing it. The first argument includes the
client and transaction identification information. The second argument
includes the received FQDN.
142

143
% DHCP6_DDNS_REQUEST_SEND_FAILED failed sending a request to kea-dhcp-ddns, error: %1,  ncr: %2
144
This error message indicates that IPv6 DHCP server failed to send a DDNS
Francis Dupont's avatar
Francis Dupont committed
145
update request to the DHCP-DDNS server. This is most likely a configuration or
146
147
networking error.

148
149
150
151
152
153
154
155
% DHCP6_DDNS_RESPONSE_FQDN_DATA %1: including FQDN option in the server's response: %2
This debug message is issued when the server is adding the Client FQDN
option in its response to the client. The first argument includes the
client and transaction identification information. The second argument
includes the details of the FQDN option being included. Note that the
name carried in the FQDN option may be modified by the server when
the lease is acquired for the client.

156
157
158
159
% DHCP6_DDNS_SEND_FQDN sending DHCPv6 Client FQDN Option to the client: %1
This debug message is logged when server includes an DHCPv6 Client FQDN Option
in its response to the client.

160
161
162
163
% DHCP6_DEACTIVATE_INTERFACE deactivate interface %1
This message is printed when DHCPv6 server disables an interface from being
used to receive DHCPv6 traffic. Sockets on this interface will not be opened
by the Interface Manager until interface is enabled.
164

Tomek Mrugalski's avatar
Tomek Mrugalski committed
165
% DHCP6_DECLINE_FAIL_DUID_MISMATCH Client %1 sent DECLINE for address %2, but it belongs to client with DUID %3
166
This informational message is printed when a client attempts to decline
Tomek Mrugalski's avatar
Tomek Mrugalski committed
167
168
a lease, but that lease belongs to a different client. The decline request
will be rejected.
169

Tomek Mrugalski's avatar
Tomek Mrugalski committed
170
% DHCP6_DECLINE_FAIL_IAID_MISMATCH Client %1 sent DECLINE for address %2, but used a wrong IAID (%3), instead of expected %4
171
172
173
174
175
This informational message is printed when a client attempts to decline
a lease. The server has a lease for this address, it belongs to this client,
but the recorded IAID does not match what client has sent. This means
the server will reject this Decline.

Tomek Mrugalski's avatar
Tomek Mrugalski committed
176
% DHCP6_DECLINE_FAIL_LEASE_WITHOUT_DUID Client %1 sent DECLINE for address %2, but the associated lease has no DUID
177
178
179
This error condition likely indicates database corruption, as every IPv6
lease is supposed to have a DUID, even if it is an empty one.

Tomek Mrugalski's avatar
Tomek Mrugalski committed
180
% DHCP6_DECLINE_FAIL_NO_LEASE Client %1 sent DECLINE for address %2, but there's no lease for it
181
182
183
This informational message is printed when a client tried to decline an address,
but the server has no lease for said address. This means that the server's
and client's perception of the leases are different. The likely causes
184
of this could be: a confused (e.g. skewed clock) or broken client (e.g. client
185
186
187
188
189
moved to a different location and didn't notice) or possibly an attack
(a rogue client is trying to decline random addresses). The server will
inform the client that his decline request was rejected and client should
be able to recover from that.

Tomek Mrugalski's avatar
Tomek Mrugalski committed
190
% DHCP6_DECLINE_LEASE Client %1 sent DECLINE for address %2 and the server marked it as declined. The lease will be recovered in %3 seconds.
191
This informational message indicates that the client leased an address, but
Jeremy C. Reed's avatar
Jeremy C. Reed committed
192
discovered that it is being used by some other device and reported this to the
193
194
server by sending a Decline message. The server marked the lease as
declined. This likely indicates a misconfiguration in the network. Either
195
196
the server is configured with an incorrect pool or there are devices that have
statically assigned addresses that are supposed to be assigned by the DHCP
197
198
199
200
201
server. Both client (will request a different address) and server (will recover
the lease after decline-probation-time elapses) will recover automatically.
However, if the underlying problem is not solved, the conditions leading
to this message may reappear.

202
203
204
205
206
207
% DHCP6_DECLINE_PROCESS_IA Processing of IA (IAID: %1) from client %2 started.
This debug message is printed when the server starts processing an IA_NA option
received in Decline message. It's expected that the option will contain an
address that is being declined. Specific information will be printed in a
separate message.

208
209
210
211
212
213
214
215
216
217
218
% DHCP6_DHCP4O6_PACKET_RECEIVED received DHCPv4o6 packet from DHCPv4 server (type %1) for %2 on interface %3
This debug message is printed when the server is receiving a DHCPv4o6
from the DHCPv4 server over inter-process communication.

% DHCP6_DHCP4O6_RECEIVE_FAIL failed to receive DHCPv4o6: %1
This debug message indicates the inter-process communication with the
DHCPv4 server failed. The reason for the error is included in
the message.

% DHCP6_DHCP4O6_RECEIVING receiving DHCPv4o6 packet from DHCPv4 server
This debug message is printed when the server is receiving a DHCPv4o6
Francis Dupont's avatar
Francis Dupont committed
219
from the DHCPv4 server over inter-process communication socket.
220
221
222
223
224
225

% DHCP6_DHCP4O6_SEND_FAIL failed to send DHCPv4o6 packet: %1
This error is output if the IPv6 DHCP server fails to send an assembled
DHCPv4o6 message to a client. The reason for the error is included in the
message.

Francis Dupont's avatar
Francis Dupont committed
226
% DHCP6_DYNAMIC_RECONFIGURATION initiate server reconfiguration using file: %1, after receiving SIGHUP signal
227
228
229
This is the info message logged when the DHCPv6 server starts reconfiguration
as a result of receiving SIGHUP signal.

230
% DHCP6_DYNAMIC_RECONFIGURATION_FAIL dynamic server reconfiguration failed with file: %1
231
232
233
This is an error message logged when the dynamic reconfiguration of the
DHCP server failed.

234
235
236
% DHCP6_FLEX_ID flexible identifier generated for incoming packet: %1
This debug message is printed when host reservation type is set to flexible identifier
and the expression specified in its configuration generated (was evaluated to)
Josh Soref's avatar
Josh Soref committed
237
an identifier for incoming packet. This debug message is mainly intended as a
238
239
debugging assistance for flexible identifier.

Tomek Mrugalski's avatar
Tomek Mrugalski committed
240
241
% DHCP6_HANDLE_SIGNAL_EXCEPTION An exception was thrown while handing signal: %1
This error message is printed when an exception was raised during signal
242
243
processing. This likely indicates a coding error and should be reported to ISC.

244
245
246
247
248
% DHCP6_HOOKS_LIBS_RELOAD_FAIL reload of hooks libraries failed
A "libreload" command was issued to reload the hooks libraries but for
some reason the reload failed.  Other error messages issued from the
hooks framework will indicate the nature of the problem.

249
% DHCP6_HOOK_BUFFER_RCVD_DROP received buffer from %1 to %2 over interface %3 was dropped because a callout set the drop flag
250
This debug message is printed when a callout installed on buffer6_receive
251
hook point set the drop flag. For this particular hook point, the
252
setting of the flag by a callout instructs the server to drop the packet.
253
254
The arguments specify the source and destination address as well as
the name of the interface over which the buffer has been received.
255

256
% DHCP6_HOOK_BUFFER_RCVD_SKIP received buffer from %1 to %2 over interface %3 is not parsed because a callout set the next step to SKIP
257
This debug message is printed when a callout installed on
258
259
buffer6_receive hook point set the next step status to skip. For this particular
hook point, this value set by a callout instructs the server to
260
261
262
263
not parse the buffer because it was already parsed by the hook. The
arguments specify the source and destination address as well as the
name of the interface over which the buffer has been received.

264
% DHCP6_HOOK_BUFFER_SEND_SKIP %1: prepared DHCPv6 response was dropped because a callout set the next step to SKIP
265
This debug message is printed when a callout installed on buffer6_send
266
267
hook point set the next step to SKIP value. For this particular hook point, the
SKIP setting a callout instructs the server to drop the packet.
268
269
Server completed all the processing (e.g. may have assigned, updated
or released leases), but the response will not be send to the client.
270
271
The argument includes the client and transaction identification
information.
272

273
% DHCP6_HOOK_DECLINE_DROP During Decline processing (client=%1, interface=%2, addr=%3) hook callout set next step to DROP, dropping packet.
274
275
276
277
278
279
This message indicates that the server received DECLINE message, it was verified
to be correct and matching server's lease information. The server called hooks
for the lease6_decline hook point and one of the callouts set next step status to DROP.
The server will now abort processing of the packet as if it was never
received. The lease will continue to be assigned to this client.

Tomek Mrugalski's avatar
Tomek Mrugalski committed
280
% DHCP6_HOOK_DECLINE_SKIP During Decline processing (client=%1, interface=%2, addr=%3) hook callout set status to SKIP, skipping decline.
281
282
283
284
This message indicates that the server received DECLINE message, it was verified
to be correct and matching server's lease information. The server called hooks
for the lease6_decline hook point and one of the callouts set next step status to SKIP.
The server will skip the operation of moving the lease to the declined state and
Tomek Mrugalski's avatar
Tomek Mrugalski committed
285
286
will continue processing the packet. In particular, it will send a REPLY message
as if the decline actually took place.
287

288
% DHCP6_HOOK_LEASE6_RELEASE_NA_SKIP %1: DHCPv6 address lease was not released because a callout set the next step to SKIP
289
This debug message is printed when a callout installed on the
290
291
lease6_release hook point set the next step to SKIP. For this particular hook
point, this setting by a callout instructs the server to not
292
293
release a lease. If a client requested the release of multiples leases
(by sending multiple IA options), the server will retain this particular
294
295
lease and proceed with other releases as usual. The argument holds the
client and transaction identification information.
296

297
% DHCP6_HOOK_LEASE6_RELEASE_PD_SKIP %1: prefix lease was not released because a callout set the next step to SKIP
298
This debug message is printed when a callout installed on lease6_release
299
300
hook point set the next step to SKIP value. For this particular hook point, that
setting by a callout instructs the server to not release
301
302
a lease. If client requested release of multiples leases (by sending
multiple IA options), the server will retains this particular lease and
303
304
will proceed with other renewals as usual. The argument holds the
client and transaction identification information.
305

306
% DHCP6_HOOK_PACKET_RCVD_SKIP %1: packet is dropped, because a callout set the next step to SKIP
307
This debug message is printed when a callout installed on the pkt6_receive
308
309
hook point sets the next step to SKIP. For this particular hook point, the
value setting instructs the server to drop the packet.
310

311
% DHCP6_HOOK_PACKET_SEND_DROP %1: prepared DHCPv6 response was not sent because a callout set the next ste to DROP
312
This debug message is printed when a callout installed on the pkt6_send
313
314
hook point set the next step to DROP. For this particular hook point, the setting
of the value by a callout instructs the server to drop the packet. This
315
316
effectively means that the client will not get any response, even though
the server processed client's request and acted on it (e.g. possibly
317
318
allocated a lease). The argument specifies the client and transaction
identification information.
319

320
% DHCP6_HOOK_PACKET_SEND_SKIP %1: prepared DHCPv6 response is not built because a callout set the next step to SKIP
321
This debug message is printed when a callout installed on the
322
323
pkt6_send hook point set the next step to SKIP. For this particular hook
point, the setting of the value by a callout instructs the server to
324
325
326
327
not build the wire data (pack) because it was already done by the
book. The argument specifies the client and transaction identification
information.

328
% DHCP6_HOOK_SUBNET6_SELECT_SKIP %1: no subnet was selected because a callout set the next step to SKIP
329
This debug message is printed when a callout installed on the
330
331
subnet6_select hook point set the next step to SKIP value. For this particular hook
point, the setting of this value instructs the server not to choose a
332
333
subnet, an action that severely limits further processing; the server
will be only able to offer global options - no addresses or prefixes
334
335
will be assigned. The argument holds the client and transaction
identification information.
336

337
338
339
340
341
342
343
% DHCP6_HOOK_SUBNET6_SELECT_DROP %1: packet was dropped because a callout set the drop flag
This debug message is printed when a callout installed on the
subnet6_select hook point set the drop flag. For this particular hook
point, the setting of the flag instructs the server to drop the
received packet. The argument holds the client and transaction
identification information.

344
345
% DHCP6_INIT_FAIL failed to initialize Kea server: %1
The server has failed to establish communication with the rest of Kea,
Francis Dupont's avatar
Francis Dupont committed
346
failed to read JSON configuration file or encountered any other critical
347
348
349
issue that prevents it from starting up properly. Attached error message
provides more details about the issue.

350
% DHCP6_LEASE_ADVERT %1: lease for address %2 and iaid=%3 will be advertised
351
This informational message indicates that the server will advertise an
352
353
354
355
356
address to the client in the ADVERTISE message. The client will
request allocation of this address with the REQUEST message sent
in the next message exchange. The first argument includes the client
and transaction identification information. The remaining arguments
hold the allocated address and IAID.
357

358
% DHCP6_LEASE_ADVERT_FAIL %1: failed to advertise an address lease for iaid=%2
359
360
361
This message indicates that in response to a received SOLICIT, the server
failed to advertise a non-temporary lease for a given client. There may
be many reasons for such failure. Each failure is logged in a separate
362
363
log entry. The first argument holds the client and transaction identification
information. The second argument holds the IAID.
364

365
% DHCP6_LEASE_ALLOC %1: lease for address %2 and iaid=%3 has been allocated
366
367
This informational message indicates that in response to a client's REQUEST
message, the server successfully granted a non-temporary address
368
lease. This is a normal behavior and indicates successful operation.
369
370
371
The first argument includes the client and transaction identification
information. The remaining arguments hold the allocated address and
IAID.
372

373
% DHCP6_LEASE_ALLOC_FAIL %1: failed to grant an address lease for iaid=%2
374
375
376
This message indicates that in response to a received REQUEST, the server
failed to grant a non-temporary address lease for the client. There may
be many reasons for such failure. Each failure is logged in a separate
377
378
379
380
381
382
383
384
385
log entry. The first argument holds the client and transaction identification
information. The second argument holds the IAID.

% DHCP6_LEASE_DATA %1: detailed lease information for iaid=%2: %3
This debug message is used to print the detailed information about the
allocated lease or a lease which will be advertised to the client.
The first argument holds the client and the transaction identification
information. The second argument holds the IAID. The third argument
holds the detailed lease information.
386

387
% DHCP6_LEASE_NA_WITHOUT_DUID %1: address lease for address %2 does not have a DUID
388
This error message indicates a database consistency problem. The lease
389
390
391
database has an entry indicating that the given address is in use,
but the lease does not contain any client identification. This is most
likely due to a software error: please raise a bug report. As a temporary
392
393
394
workaround, manually remove the lease entry from the database. The first
argument includes the client and transaction identification information.
The second argument holds the address to be released.
Tomek Mrugalski's avatar
Tomek Mrugalski committed
395

396
% DHCP6_LEASE_PD_WITHOUT_DUID %1: lease for prefix %2/%3 does not have a DUID
397
398
399
400
This error message indicates a database consistency failure. The lease
database has an entry indicating that the given prefix is in use,
but the lease does not contain any client identification. This is most
likely due to a software error: please raise a bug report. As a temporary
401
402
403
404
workaround, manually remove the lease entry from the database. The
first argument includes client and transaction identification
information. The second and third argument hold the prefix and the
prefix length.
405

406
407
408
409
410
411
412
413
% DHCP6_LEASE_RENEW %1: lease for address %2 and iaid=%3 has been allocated
This informational message indicates that in response to a client's REQUEST
message, the server successfully renewed a non-temporary address
lease. This is a normal behavior and indicates successful operation.
The first argument includes the client and transaction identification
information. The remaining arguments hold the allocated address and
IAID.

414
415
416
417
418
419
420
421
% DHCP6_NOT_RUNNING IPv6 DHCP server is not running
A warning message is issued when an attempt is made to shut down the
IPv6 DHCP server but it is not running.

% DHCP6_NO_INTERFACES failed to detect any network interfaces
During startup the IPv6 DHCP server failed to detect any network
interfaces and is therefore shutting down.

422
423
424
425
426
% DHCP6_NO_SOCKETS_OPEN no interface configured to listen to DHCP traffic
This warning message is issued when current server configuration specifies
no interfaces that server should listen on, or specified interfaces are not
configured to receive the traffic.

427
428
429
430
% DHCP6_OPEN_SOCKET opening sockets on port %1
A debug message issued during startup, this indicates that the IPv6 DHCP
server is about to open sockets on the specified port.

431
% DHCP6_OPEN_SOCKET_FAIL failed to open socket: %1
432
433
434
A warning message issued when IfaceMgr fails to open and bind a socket. The reason
for the failure is appended as an argument of the log message.

435
436
437
438
439
440
% DHCP6_PACKET_DROP_DHCP_DISABLED %1: DHCP service is globally disabled
This debug message is issued when a packet is dropped because the DHCP service
has been temporarily disabled. This affects all received DHCP packets. The
service may be enabled by the "dhcp-enable" control command or automatically
after a specified amount of time since receiving "dhcp-disable" command.

Francis Dupont's avatar
Francis Dupont committed
441
% DHCP6_PACKET_DROP_PARSE_FAIL failed to parse packet from %1 to %2, received over interface %3, reason: %4
442
The DHCPv6 server has received a packet that it is unable to
443
444
445
interpret. The reason why the packet is invalid is included in the message.

% DHCP6_PACKET_DROP_SERVERID_MISMATCH %1: dropping packet with server identifier: %2, server is using: %3
446
447
448
A debug message noting that server has received message with server identifier
option that not matching server identifier that server is using.

449
450
451
452
453
% DHCP6_PACKET_DROP_UNICAST %1: dropping unicast %2 packet as this packet should be sent to multicast
This debug message is issued when the server drops the unicast packet,
because packets of this type must be sent to multicast. The first argument
specifies the client and transaction identification information, the
second argument specifies packet type.
454

455
456
457
458
459
% DHCP6_PACKET_PROCESS_EXCEPTION exception occurred during packet processing
This error message indicates that a non-standard exception was raised
during packet processing that was not caught by other, more specific
exception handlers. This packet will be dropped and the server will
continue operation.
460

461
462
463
464
465
% DHCP6_PACKET_PROCESS_FAIL processing of %1 message received from %2 failed: %3
This is a general catch-all message indicating that the processing of the
specified packet type from the indicated address failed.  The reason is given in the
message.  The server will not send a response but will instead ignore the packet.

466
467
468
469
470
471
% DHCP6_PACKET_PROCESS_STD_EXCEPTION exception occurred during packet processing: %1
This error message indicates that a standard exception was raised
during packet processing that was not caught by other, more specific
exception handlers. This packet will be dropped and the server will
continue operation.

472
473
474
475
476
477
478
479
% DHCP6_PACKET_RECEIVED %1: %2 (type %3) received from %4 to %5 on interface %6
A debug message noting that the server has received the specified type of
packet on the specified interface. The first argument specifies the
client and transaction identification information. The second and third
argument specify the name of the DHCPv6 message and its numeric type
respectively. The remaining arguments specify the source address,
destination IP address and the name of the interface on which the
message has been received.
480

481
482
% DHCP6_PACKET_RECEIVE_FAIL error on attempt to receive packet: %1
The IPv6 DHCP server tried to receive a packet but an error
483
occurred during this attempt. The reason for the error is included in
484
485
the message.

Marcin Siodelski's avatar
Marcin Siodelski committed
486
% DHCP6_PACKET_SEND_FAIL failed to send DHCPv6 packet: %1
487
488
489
This error is output if the IPv6 DHCP server fails to send an assembled
DHCP message to a client. The reason for the error is included in the
message.
490

491
492
% DHCP6_PACK_FAIL failed to assemble response correctly
This error is output if the server failed to assemble the data to be
493
494
returned to the client into a valid packet.  The reason is most likely
to be to a programming error: please raise a bug report.
495

496
497
498
499
500
501
502
503
504
505
506
507
% DHCP6_PARSER_COMMIT_EXCEPTION parser failed to commit changes
On receipt of message containing details to a change of the IPv6 DHCP
server configuration, a set of parsers were successfully created, but one
of them failed to commit its changes due to a low-level system exception
being raised.  Additional messages may be output indicating the reason.

% DHCP6_PARSER_COMMIT_FAIL parser failed to commit changes: %1
On receipt of message containing details to a change of the IPv6 DHCP
server configuration, a set of parsers were successfully created, but
one of them failed to commit its changes.  The reason for the failure
is given in the message.

508
% DHCP6_PARSER_EXCEPTION failed to create or run parser for configuration element %1
509
On receipt of message containing details to a change of its configuration,
510
511
512
the IPv6 DHCP server failed to create a parser to decode the contents of
the named configuration element, or the creation succeeded but the parsing
actions and committal of changes failed.  The message has been output in
513
response to a non-Kea exception being raised.  Additional messages
514
515
may give further information.

516
517
The most likely cause of this is that the specification file for the
server (which details the allowable contents of the configuration) is
518
519
not correct for this version of Kea.  This may be the result of an
interrupted installation of an update to Kea.
520

521
522
523
524
525
526
527
% DHCP6_PARSER_FAIL failed to create or run parser for configuration element %1: %2
On receipt of message containing details to a change of its configuration,
the IPv6 DHCP server failed to create a parser to decode the contents
of the named configuration element, or the creation succeeded but the
parsing actions and committal of changes failed.  The reason for the
failure is given in the message.

528
% DHCP6_PD_LEASE_ADVERT %1: lease for prefix %2/%3 and iaid=%4 will be advertised
529
This informational message indicates that the server will advertise a
530
531
532
533
534
prefix to the client in the ADVERTISE message. The client will
request allocation of this prefix with the REQUEST message sent
in the next message exchange. The first argument includes the client
and transaction identification information. The remaining arguments
hold the allocated prefix, prefix length and IAID.
535

536
% DHCP6_PD_LEASE_ADVERT_FAIL %1: failed to advertise a prefix lease for iaid=%2
537
This message indicates that in response to a received SOLICIT, the
538
server failed to advertise a prefix lease for a given client. There may
539
be many reasons for such failure. Each failure is logged in a separate
540
541
log entry. The first argument holds the client and transaction identification
information. The second argument holds the IAID.
542

543
% DHCP6_PD_LEASE_ALLOC %1: lease for prefix %2/%3 and iaid=%4 has been allocated
544
545
546
This informational message indicates that in response to a client's REQUEST
message, the server successfully granted a prefix lease.
This is a normal behavior and indicates successful operation.
547
548
The first argument includes the client and transaction identification
information. The remaining arguments hold the allocated prefix,
Francis Dupont's avatar
Francis Dupont committed
549
prefix length and and IAID.
550

551
552
553
554
555
556
557
% DHCP6_PD_LEASE_ALLOC_FAIL %1: failed to grant a prefix lease for iaid=%2
This message indicates that in response to a received REQUEST, the server
failed to grant a prefix lease for the client. There may be many reasons
for such failure. Each failure is logged in a separate log entry. The first
argument holds the client and transaction identification information.
The second argument holds the IAID.

558
559
560
561
562
563
564
565
% DHCP6_PD_LEASE_RENEW %1: lease for prefix %2/%3 and iaid=%4 has been allocated
This informational message indicates that in response to a client's REQUEST
message, the server successfully renewed a prefix lease.
This is a normal behavior and indicates successful operation.
The first argument includes the client and transaction identification
information. The remaining arguments hold the allocated prefix,
prefix length and and IAID.

566
567
568
569
570
571
572
573
574
575
576
577
578
% DHCP6_PROCESS_IA_NA_EXTEND %1: extending lease lifetime for IA_NA option with iaid=%2
This message is logged when the server is starting to extend the lifetime
of the address lease associated with the particular IAID. The first argument
includes the client and transaction identification information. The second
argument contains the IAID.

% DHCP6_PROCESS_IA_NA_RELEASE %1: releasing lease for IA_NA option with iaid=%2
This message is logged when the server is trying to release the client's
as a result of receiving the RELEASE message. The first argument
includes the client and transaction identification information. The second
argument contains the IAID.

% DHCP6_PROCESS_IA_NA_REQUEST %1: server is processing IA_NA option with iaid=%2 and hint=%3
579
This is a debug message that indicates the processing of a received
580
581
582
583
584
585
586
587
588
589
590
591
592
593
IA_NA option. The first argument contains the client and the transaction
identification information. The second argument holds the IAID of the
IA_NA option. The third argument may hold the hint for the server
about the address that the client would like to have allocated.
If there is no hint, the argument should provide the text indicating
that the hint hasn't been sent.

% DHCP6_PROCESS_IA_PD_EXTEND %1: extending lease lifetime for IA_PD option with iaid=%2
This message is logged when the server is starting to extend the lifetime
of the prefix lease associated with the particular IAID. The first argument
includes the client and transaction identification information. The second
argument contains the IAID.

% DHCP6_PROCESS_IA_PD_REQUEST %1: server is processing IA_PD option with iaid=%2 and hint=%3
594
This is a debug message that indicates a processing of received IA_PD
595
596
597
598
599
600
601
602
603
604
605
606
option. The first argument contains the client and the transaction
identification information. The second argument holds the IAID of the
IA_PD option. The third argument may hold the hint for the server
about the prefix that the client would like to have allocated.
If there is no hint, the argument should provide the text indicating
that the hint hasn't been sent.

% DHCP6_QUERY_DATA %1, packet details: %2
A debug message printing the details of the received packet. The first
argument includes the client and the transaction identification
information.

607
% DHCP6_RAPID_COMMIT %1: Rapid Commit option received, following 2-way exchange
Francis Dupont's avatar
Francis Dupont committed
608
This debug message is issued when the server found a Rapid Commit option
609
610
in the client's message and 2-way exchanges are supported by the
server for the subnet on which the client is connected. The argument
611
612
specifies the client and transaction identification information.

613
% DHCP6_RELEASE_NA %1: binding for address %2 and iaid=%3 was released properly
614
This informational message indicates that an address was released properly. It
615
616
is a normal operation during client shutdown.

617
% DHCP6_RELEASE_NA_FAIL %1: failed to remove address lease for address %2 and iaid=%3
618
This error message indicates that the software failed to remove an address
619
620
621
622
lease from the lease database.  It probably due to an error during a
database operation: resolution will most likely require administrator
intervention (e.g. check if DHCP process has sufficient privileges to
update the database). It may also be triggered if a lease was manually
623
624
625
626
removed from the database during RELEASE message processing. The first
argument holds the client and transaction identification information.
The second and third argument hold the released address and IAID
respectively.
627

628
% DHCP6_RELEASE_NA_FAIL_WRONG_DUID %1: client tried to release address %2, but it belongs to another client using duid=%3
629
630
631
632
633
634
This warning message indicates that a client tried to release an address
that belongs to a different client. This should not happen in normal
circumstances and may indicate a misconfiguration of the client.  However,
since the client releasing the address will stop using it anyway, there
is a good chance that the situation will correct itself.

635
% DHCP6_RELEASE_NA_FAIL_WRONG_IAID %1: client tried to release address %2, but it used wrong IAID (expected %3, but got %4)
636
637
638
639
640
This warning message indicates that client tried to release an address
that does belong to it, but the address was expected to be in a different
IA (identity association) container. This probably means that the client's
support for multiple addresses is flawed.

641
% DHCP6_RELEASE_PD %1: prefix %2/%3 for iaid=%4 was released properly
642
This informational message indicates that a prefix was released properly. It
643
644
is a normal operation during client shutdown. The first argument holds
the client and transaction identification information. The second and
645
third argument define the prefix and its length. The fourth argument
646
holds IAID.
647

648
% DHCP6_RELEASE_PD_FAIL %1: failed to release prefix %2/%3 for iaid=%4
649
650
651
652
653
This error message indicates that the software failed to remove a prefix
lease from the lease database.  It probably due to an error during a
database operation: resolution will most likely require administrator
intervention (e.g. check if DHCP process has sufficient privileges to
update the database). It may also be triggered if a lease was manually
654
655
656
removed from the database during RELEASE message processing. The
first argument hold the client and transaction identification
information. The second and third argument define the prefix and
657
its length. The fourth argument holds the IAID.
658

659
% DHCP6_RELEASE_PD_FAIL_WRONG_DUID %1: client tried to release prefix %2/%3, but it belongs to another client (duid=%4)
660
661
662
663
This warning message indicates that client tried to release a prefix
that belongs to a different client. This should not happen in normal
circumstances and may indicate a misconfiguration of the client.  However,
since the client releasing the prefix will stop using it anyway, there
664
665
666
667
668
is a good chance that the situation will correct itself. The first
argument includes the client and the transaction identification
information. The second and third argument include the prefix and
prefix length. The last argument holds the DUID of the client holding
the lease.
669

670
% DHCP6_RELEASE_PD_FAIL_WRONG_IAID %1: client tried to release prefix %2/%3, but it used wrong IAID (expected %4, but got %5)
671
672
673
This warning message indicates that client tried to release a prefix
that does belong to it, but the address was expected to be in a different
IA (identity association) container. This probably means that the client's
674
675
support for multiple prefixes is flawed. The first argument includes the
client and transaction identification information. The second and third
676
argument identify the prefix. The fourth and fifth argument hold the
677
expected IAID and IAID found respectively.
678

Jeremy C. Reed's avatar
Jeremy C. Reed committed
679
680
681
682
683
684
685
% DHCP6_REQUIRED_OPTIONS_CHECK_FAIL %1 message received from %2 failed the following check: %3
This message indicates that received DHCPv6 packet is invalid.  This may be due
to a number of reasons, e.g. the mandatory client-id option is missing,
the server-id forbidden in that particular type of message is present,
there is more than one instance of client-id or server-id present,
etc. The exact reason for rejecting the packet is included in the message.

686
% DHCP6_RESPONSE_DATA responding with packet type %1 data is %2
687
688
A debug message listing the data returned to the client.

689
690
691
692
% DHCP6_SERVER_FAILED server failed: %1
The IPv6 DHCP server has encountered a fatal error and is terminating.
The reason for the failure is included in the message.

693
694
695
696
697
698
699
700
% DHCP6_SHUTDOWN server shutdown
The IPv6 DHCP server has terminated normally.

% DHCP6_SHUTDOWN_REQUEST shutdown of server requested
This debug message indicates that a shutdown of the IPv6 server has
been requested via a call to the 'shutdown' method of the core Dhcpv6Srv
object.

701
702
703
% DHCP6_SOCKET_UNICAST server is about to open socket on address %1 on interface %2
This is a debug message that inform that a unicast socket will be opened.

704
705
706
707
708
709
% DHCP6_SRV_CONSTRUCT_ERROR error creating Dhcpv6Srv object, reason: %1
This error message indicates that during startup, the construction of a
core component within the IPv6 DHCP server (the Dhcpv6 server object)
has failed.  As a result, the server will exit.  The reason for the
failure is given within the message.

710
% DHCP6_SRV_D2STOP_ERROR error stopping IO with DHCP_DDNS during shutdown: %1
Jeremy C. Reed's avatar
Jeremy C. Reed committed
711
This error message indicates that during shutdown, an error occurred while
712
713
714
715
stopping IO between the DHCPv6 server and the DHCP_DDNS server.  This is
probably due to a programmatic error is not likely to impact either server
upon restart.  The reason for the failure is given within the message.

716
717
718
719
720
721
% DHCP6_STANDALONE skipping message queue, running standalone
This is a debug message indicating that the IPv6 server is running in
standalone mode, not connected to the message queue.  Standalone mode
is only useful during program development, and should not be used in a
production environment.

722
723
724
725
726
% DHCP6_STARTED Kea DHCPv6 server version %1 started
This informational message indicates that the IPv6 DHCP server has
processed all configuration information and is ready to process
DHCPv6 packets.  The version is also printed.

727
% DHCP6_STARTING Kea DHCPv6 server version %1 starting
728
This informational message indicates that the IPv6 DHCP server has
729
730
processed any command-line switches and is starting. The version
is also printed.
731

Tomek Mrugalski's avatar
Tomek Mrugalski committed
732
% DHCP6_START_INFO pid: %1, port: %2, verbose: %3
733
734
735
This is a debug message issued during the IPv6 DHCP server startup.
It lists some information about the parameters with which the server
is running.
736

737
738
739
% DHCP6_SUBNET_DATA %1: the selected subnet details: %2
This debug message includes the details of the subnet selected for
the client. The first argument includes the client and the
740
transaction identification information. The second argument
741
742
includes the subnet details.

743
744
745
746
747
748
749
750
% DHCP6_SUBNET_DYNAMICALLY_CHANGED %1: changed selected subnet %2 to subnet %3 from shared network %4 for client assignments
This debug message indicates that the server is using another subnet
than initially selected for client assignments. This newly selected
subnet belongs to the same shared network as the original subnet.
Some reasons why the new subnet was selected include: address pool
exhaustion in the original subnet or the fact that the new subnet
includes some static reservations for this client.

751
752
753
754
755
756
757
758
759
760
761
762
763
764
% DHCP6_SUBNET_SELECTED %1: the subnet with ID %2 was selected for client assignments
This is a debug message noting the selection of a subnet to be used for
address and option assignment. Subnet selection is one of the early
steps in the processing of incoming client message. The first
argument includes the client and the transaction identification
information. The second argument holds the selected subnet id.

% DHCP6_SUBNET_SELECTION_FAILED %1: failed to select subnet for the client
This debug message indicates that the server failed to select the
subnet for the client which has sent a message to the server.
The cause is likely due to a misconfiguration of the server. The packet
processing will continue, but the response will only contain generic
configuration and no addresses or prefixes. The argument includes
the client and the transaction identification information.
765

766
% DHCP6_UNKNOWN_MSG_RECEIVED received unknown message (type %1) on interface %2
Tomek Mrugalski's avatar
Tomek Mrugalski committed
767
768
769
This debug message is printed when server receives a message of unknown type.
That could either mean missing functionality or invalid or broken relay or client.
The list of formally defined message types is available here:
770
http://www.iana.org/assignments/dhcpv6-parameters.
771

772
% DHCP6_USING_SERVERID server is using server-id %1 and stores in the file %2
773
774
775
776
777
778
779
780
781
This info message is logged when the server reads its server-id from a
file or generates it. This message is a notification to the administrator
what server-id will be used and where it is persisted. Typically, there is
no need to modify the server id. However, it is possible to do it in the
Kea configuration file. It is important to understand the implications of
such modification. The clients will remember previous server-id, and will
use it to extend their leases. As a result, they will have to go through
a rebinding phase to re-acquire their leases and associate them with a
new server id.