1 | /* $Id: bootp.c 51032 2014-04-10 11:55:43Z vboxsync $ */
|
---|
2 | /** @file
|
---|
3 | * NAT - BOOTP/DHCP server emulation.
|
---|
4 | */
|
---|
5 |
|
---|
6 | /*
|
---|
7 | * Copyright (C) 2006-2012 Oracle Corporation
|
---|
8 | *
|
---|
9 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | * available from http://www.virtualbox.org. This file is free software;
|
---|
11 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | * General Public License (GPL) as published by the Free Software
|
---|
13 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | */
|
---|
17 |
|
---|
18 | /*
|
---|
19 | * This code is based on:
|
---|
20 | *
|
---|
21 | * QEMU BOOTP/DHCP server
|
---|
22 | *
|
---|
23 | * Copyright (c) 2004 Fabrice Bellard
|
---|
24 | *
|
---|
25 | * Permission is hereby granted, free of charge, to any person obtaining a copy
|
---|
26 | * of this software and associated documentation files (the "Software"), to deal
|
---|
27 | * in the Software without restriction, including without limitation the rights
|
---|
28 | * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
---|
29 | * copies of the Software, and to permit persons to whom the Software is
|
---|
30 | * furnished to do so, subject to the following conditions:
|
---|
31 | *
|
---|
32 | * The above copyright notice and this permission notice shall be included in
|
---|
33 | * all copies or substantial portions of the Software.
|
---|
34 | *
|
---|
35 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
---|
36 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
---|
37 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
---|
38 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
---|
39 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
---|
40 | * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
---|
41 | * THE SOFTWARE.
|
---|
42 | */
|
---|
43 | #include <slirp.h>
|
---|
44 | #include <libslirp.h>
|
---|
45 |
|
---|
46 | /** Entry in the table of known DHCP clients. */
|
---|
47 | typedef struct
|
---|
48 | {
|
---|
49 | uint32_t xid;
|
---|
50 | bool allocated;
|
---|
51 | uint8_t macaddr[6];
|
---|
52 | struct in_addr addr;
|
---|
53 | int number;
|
---|
54 | } BOOTPClient;
|
---|
55 | /** Number of DHCP clients supported by NAT. */
|
---|
56 | #define NB_ADDR 16
|
---|
57 |
|
---|
58 | #define bootp_clients ((BOOTPClient *)pData->pbootp_clients)
|
---|
59 |
|
---|
60 | /* XXX: only DHCP is supported */
|
---|
61 | static const uint8_t rfc1533_cookie[] = { RFC1533_COOKIE };
|
---|
62 |
|
---|
63 | static void bootp_reply(PNATState pData, struct mbuf *m0, int offReply, uint16_t flags);
|
---|
64 |
|
---|
65 | static uint8_t *dhcp_find_option(uint8_t *vend, uint8_t tag)
|
---|
66 | {
|
---|
67 | uint8_t *q = vend;
|
---|
68 | uint8_t len;
|
---|
69 | /*@todo magic validation */
|
---|
70 | q += 4; /*magic*/
|
---|
71 | while(*q != RFC1533_END)
|
---|
72 | {
|
---|
73 | if (*q == RFC1533_PAD)
|
---|
74 | continue;
|
---|
75 | if (*q == tag)
|
---|
76 | return q;
|
---|
77 | q++;
|
---|
78 | len = *q;
|
---|
79 | q += 1 + len;
|
---|
80 | }
|
---|
81 | return NULL;
|
---|
82 | }
|
---|
83 |
|
---|
84 | static BOOTPClient *bc_alloc_client(PNATState pData)
|
---|
85 | {
|
---|
86 | int i;
|
---|
87 | LogFlowFuncEnter();
|
---|
88 | for (i = 0; i < NB_ADDR; i++)
|
---|
89 | {
|
---|
90 | if (!bootp_clients[i].allocated)
|
---|
91 | {
|
---|
92 | BOOTPClient *bc;
|
---|
93 |
|
---|
94 | bc = &bootp_clients[i];
|
---|
95 | memset(bc, 0, sizeof(BOOTPClient));
|
---|
96 | bc->allocated = 1;
|
---|
97 | bc->number = i;
|
---|
98 | LogFlowFunc(("LEAVE: bc:%d\n", bc->number));
|
---|
99 | return bc;
|
---|
100 | }
|
---|
101 | }
|
---|
102 | LogFlowFunc(("LEAVE: NULL\n"));
|
---|
103 | return NULL;
|
---|
104 | }
|
---|
105 |
|
---|
106 | static BOOTPClient *get_new_addr(PNATState pData, struct in_addr *paddr)
|
---|
107 | {
|
---|
108 | BOOTPClient *bc;
|
---|
109 | LogFlowFuncEnter();
|
---|
110 | bc = bc_alloc_client(pData);
|
---|
111 | if (!bc)
|
---|
112 | return NULL;
|
---|
113 |
|
---|
114 | paddr->s_addr = RT_H2N_U32(RT_N2H_U32(pData->special_addr.s_addr) | (bc->number + START_ADDR));
|
---|
115 | bc->addr.s_addr = paddr->s_addr;
|
---|
116 | LogFlowFunc(("LEAVE: paddr:%RTnaipv4, bc:%d\n", paddr->s_addr, bc->number));
|
---|
117 | return bc;
|
---|
118 | }
|
---|
119 |
|
---|
120 | static int release_addr(PNATState pData, struct in_addr *paddr)
|
---|
121 | {
|
---|
122 | unsigned i;
|
---|
123 | for (i = 0; i < NB_ADDR; i++)
|
---|
124 | {
|
---|
125 | if (paddr->s_addr == bootp_clients[i].addr.s_addr)
|
---|
126 | {
|
---|
127 | memset(&bootp_clients[i], 0, sizeof(BOOTPClient));
|
---|
128 | return VINF_SUCCESS;
|
---|
129 | }
|
---|
130 | }
|
---|
131 | return VERR_NOT_FOUND;
|
---|
132 | }
|
---|
133 |
|
---|
134 | /*
|
---|
135 | * from RFC 2131 4.3.1
|
---|
136 | * Field DHCPOFFER DHCPACK DHCPNAK
|
---|
137 | * ----- --------- ------- -------
|
---|
138 | * 'op' BOOTREPLY BOOTREPLY BOOTREPLY
|
---|
139 | * 'htype' (From "Assigned Numbers" RFC)
|
---|
140 | * 'hlen' (Hardware address length in octets)
|
---|
141 | * 'hops' 0 0 0
|
---|
142 | * 'xid' 'xid' from client 'xid' from client 'xid' from client
|
---|
143 | * DHCPDISCOVER DHCPREQUEST DHCPREQUEST
|
---|
144 | * message message message
|
---|
145 | * 'secs' 0 0 0
|
---|
146 | * 'ciaddr' 0 'ciaddr' from 0
|
---|
147 | * DHCPREQUEST or 0
|
---|
148 | * 'yiaddr' IP address offered IP address 0
|
---|
149 | * to client assigned to client
|
---|
150 | * 'siaddr' IP address of next IP address of next 0
|
---|
151 | * bootstrap server bootstrap server
|
---|
152 | * 'flags' 'flags' from 'flags' from 'flags' from
|
---|
153 | * client DHCPDISCOVER client DHCPREQUEST client DHCPREQUEST
|
---|
154 | * message message message
|
---|
155 | * 'giaddr' 'giaddr' from 'giaddr' from 'giaddr' from
|
---|
156 | * client DHCPDISCOVER client DHCPREQUEST client DHCPREQUEST
|
---|
157 | * message message message
|
---|
158 | * 'chaddr' 'chaddr' from 'chaddr' from 'chaddr' from
|
---|
159 | * client DHCPDISCOVER client DHCPREQUEST client DHCPREQUEST
|
---|
160 | * message message message
|
---|
161 | * 'sname' Server host name Server host name (unused)
|
---|
162 | * or options or options
|
---|
163 | * 'file' Client boot file Client boot file (unused)
|
---|
164 | * name or options name or options
|
---|
165 | * 'options' options options
|
---|
166 | *
|
---|
167 | * Option DHCPOFFER DHCPACK DHCPNAK
|
---|
168 | * ------ --------- ------- -------
|
---|
169 | * Requested IP address MUST NOT MUST NOT MUST NOT
|
---|
170 | * IP address lease time MUST MUST (DHCPREQUEST) MUST NOT
|
---|
171 | * MUST NOT (DHCPINFORM)
|
---|
172 | * Use 'file'/'sname' fields MAY MAY MUST NOT
|
---|
173 | * DHCP message type DHCPOFFER DHCPACK DHCPNAK
|
---|
174 | * Parameter request list MUST NOT MUST NOT MUST NOT
|
---|
175 | * Message SHOULD SHOULD SHOULD
|
---|
176 | * Client identifier MUST NOT MUST NOT MAY
|
---|
177 | * Vendor class identifier MAY MAY MAY
|
---|
178 | * Server identifier MUST MUST MUST
|
---|
179 | * Maximum message size MUST NOT MUST NOT MUST NOT
|
---|
180 | * All others MAY MAY MUST NOT
|
---|
181 | */
|
---|
182 | static BOOTPClient *find_addr(PNATState pData, struct in_addr *paddr, const uint8_t *macaddr)
|
---|
183 | {
|
---|
184 | int i;
|
---|
185 |
|
---|
186 | LogFlowFunc(("macaddr:%RTmac\n", macaddr));
|
---|
187 | for (i = 0; i < NB_ADDR; i++)
|
---|
188 | {
|
---|
189 | if ( memcmp(macaddr, bootp_clients[i].macaddr, ETH_ALEN) == 0
|
---|
190 | && bootp_clients[i].allocated != 0)
|
---|
191 | {
|
---|
192 | BOOTPClient *bc;
|
---|
193 |
|
---|
194 | bc = &bootp_clients[i];
|
---|
195 | bc->allocated = 1;
|
---|
196 | paddr->s_addr = RT_H2N_U32(RT_N2H_U32(pData->special_addr.s_addr) | (i + START_ADDR));
|
---|
197 | LogFlowFunc(("LEAVE: paddr:%RTnaipv4 bc:%d\n", paddr->s_addr, bc->number));
|
---|
198 | return bc;
|
---|
199 | }
|
---|
200 | }
|
---|
201 | LogFlowFunc(("LEAVE: NULL\n"));
|
---|
202 | return NULL;
|
---|
203 | }
|
---|
204 |
|
---|
205 | static struct mbuf *dhcp_create_msg(PNATState pData, struct bootp_t *bp, struct mbuf *m, uint8_t type)
|
---|
206 | {
|
---|
207 | struct bootp_t *rbp;
|
---|
208 | struct ethhdr *eh;
|
---|
209 | uint8_t *q;
|
---|
210 |
|
---|
211 | eh = mtod(m, struct ethhdr *);
|
---|
212 | memcpy(eh->h_source, bp->bp_hwaddr, ETH_ALEN); /* XXX: if_encap just swap source with dest */
|
---|
213 |
|
---|
214 | m->m_data += if_maxlinkhdr; /*reserve ether header */
|
---|
215 |
|
---|
216 | rbp = mtod(m, struct bootp_t *);
|
---|
217 | memset(rbp, 0, sizeof(struct bootp_t));
|
---|
218 | rbp->bp_op = BOOTP_REPLY;
|
---|
219 | rbp->bp_xid = bp->bp_xid; /* see table 3 of rfc2131*/
|
---|
220 | rbp->bp_flags = bp->bp_flags; /* figure 2 of rfc2131 */
|
---|
221 | rbp->bp_giaddr.s_addr = bp->bp_giaddr.s_addr;
|
---|
222 | #if 0 /*check flags*/
|
---|
223 | saddr.sin_port = RT_H2N_U16_C(BOOTP_SERVER);
|
---|
224 | daddr.sin_port = RT_H2N_U16_C(BOOTP_CLIENT);
|
---|
225 | #endif
|
---|
226 | rbp->bp_htype = 1;
|
---|
227 | rbp->bp_hlen = 6;
|
---|
228 | memcpy(rbp->bp_hwaddr, bp->bp_hwaddr, 6);
|
---|
229 |
|
---|
230 | memcpy(rbp->bp_vend, rfc1533_cookie, 4); /* cookie */
|
---|
231 | q = rbp->bp_vend;
|
---|
232 | q += 4;
|
---|
233 | *q++ = RFC2132_MSG_TYPE;
|
---|
234 | *q++ = 1;
|
---|
235 | *q++ = type;
|
---|
236 |
|
---|
237 | return m;
|
---|
238 | }
|
---|
239 |
|
---|
240 | static int dhcp_do_ack_offer(PNATState pData, struct mbuf *m, BOOTPClient *bc, int fDhcpRequest)
|
---|
241 | {
|
---|
242 | struct bootp_t *rbp = NULL;
|
---|
243 | uint8_t *q;
|
---|
244 | struct in_addr saddr;
|
---|
245 | int val;
|
---|
246 |
|
---|
247 | struct dns_entry *de = NULL;
|
---|
248 | struct dns_domain_entry *dd = NULL;
|
---|
249 | int added = 0;
|
---|
250 | uint8_t *q_dns_header = NULL;
|
---|
251 | uint32_t lease_time = RT_H2N_U32_C(LEASE_TIME);
|
---|
252 | uint32_t netmask = RT_H2N_U32(pData->netmask);
|
---|
253 |
|
---|
254 | rbp = mtod(m, struct bootp_t *);
|
---|
255 | q = &rbp->bp_vend[0];
|
---|
256 | q += 7; /* !cookie rfc 2132 + TYPE*/
|
---|
257 |
|
---|
258 | /*DHCP Offer specific*/
|
---|
259 | /*
|
---|
260 | * we're care in built-in tftp server about existence/validness of the boot file.
|
---|
261 | */
|
---|
262 | if (bootp_filename)
|
---|
263 | RTStrPrintf((char*)rbp->bp_file, sizeof(rbp->bp_file), "%s", bootp_filename);
|
---|
264 |
|
---|
265 | Log(("NAT: DHCP: bp_file:%s\n", &rbp->bp_file));
|
---|
266 | /* Address/port of the DHCP server. */
|
---|
267 | rbp->bp_yiaddr = bc->addr; /* Client IP address */
|
---|
268 | Log(("NAT: DHCP: bp_yiaddr:%RTnaipv4\n", rbp->bp_yiaddr));
|
---|
269 | rbp->bp_siaddr = pData->tftp_server; /* Next Server IP address, i.e. TFTP */
|
---|
270 | Log(("NAT: DHCP: bp_siaddr:%RTnaipv4\n", rbp->bp_siaddr));
|
---|
271 | if (fDhcpRequest)
|
---|
272 | {
|
---|
273 | rbp->bp_ciaddr.s_addr = bc->addr.s_addr; /* Client IP address */
|
---|
274 | }
|
---|
275 | saddr.s_addr = RT_H2N_U32(RT_N2H_U32(pData->special_addr.s_addr) | CTL_ALIAS);
|
---|
276 | Log(("NAT: DHCP: s_addr:%RTnaipv4\n", saddr));
|
---|
277 |
|
---|
278 | #define FILL_BOOTP_EXT(q, tag, len, pvalue) \
|
---|
279 | do { \
|
---|
280 | struct bootp_ext *be = (struct bootp_ext *)(q); \
|
---|
281 | be->bpe_tag = (tag); \
|
---|
282 | be->bpe_len = (len); \
|
---|
283 | memcpy(&be[1], (pvalue), (len)); \
|
---|
284 | (q) = (uint8_t *)(&be[1]) + (len); \
|
---|
285 | }while(0)
|
---|
286 | /* appending another value to tag, calculates len of whole block*/
|
---|
287 | #define FILL_BOOTP_APP(head, q, tag, len, pvalue) \
|
---|
288 | do { \
|
---|
289 | struct bootp_ext *be = (struct bootp_ext *)(head); \
|
---|
290 | memcpy(q, (pvalue), (len)); \
|
---|
291 | (q) += (len); \
|
---|
292 | Assert(be->bpe_tag == (tag)); \
|
---|
293 | be->bpe_len += (len); \
|
---|
294 | }while(0)
|
---|
295 |
|
---|
296 |
|
---|
297 | FILL_BOOTP_EXT(q, RFC1533_NETMASK, 4, &netmask);
|
---|
298 | FILL_BOOTP_EXT(q, RFC1533_GATEWAY, 4, &saddr);
|
---|
299 |
|
---|
300 | if (pData->fUseDnsProxy || pData->fUseHostResolver)
|
---|
301 | {
|
---|
302 | uint32_t addr = RT_H2N_U32(RT_N2H_U32(pData->special_addr.s_addr) | CTL_DNS);
|
---|
303 | FILL_BOOTP_EXT(q, RFC1533_DNS, 4, &addr);
|
---|
304 | }
|
---|
305 | else if (!TAILQ_EMPTY(&pData->pDnsList))
|
---|
306 | {
|
---|
307 | de = TAILQ_LAST(&pData->pDnsList, dns_list_head);
|
---|
308 | q_dns_header = q;
|
---|
309 | FILL_BOOTP_EXT(q, RFC1533_DNS, 4, &de->de_addr.s_addr);
|
---|
310 |
|
---|
311 | TAILQ_FOREACH_REVERSE(de, &pData->pDnsList, dns_list_head, de_list)
|
---|
312 | {
|
---|
313 | if (TAILQ_LAST(&pData->pDnsList, dns_list_head) == de)
|
---|
314 | continue; /* first value with head we've ingected before */
|
---|
315 | FILL_BOOTP_APP(q_dns_header, q, RFC1533_DNS, 4, &de->de_addr.s_addr);
|
---|
316 | }
|
---|
317 | }
|
---|
318 |
|
---|
319 | if (pData->fPassDomain && !pData->fUseHostResolver)
|
---|
320 | {
|
---|
321 | LIST_FOREACH(dd, &pData->pDomainList, dd_list)
|
---|
322 | {
|
---|
323 |
|
---|
324 | if (dd->dd_pszDomain == NULL)
|
---|
325 | continue;
|
---|
326 | /* never meet valid separator here in RFC1533*/
|
---|
327 | if (added != 0)
|
---|
328 | FILL_BOOTP_EXT(q, RFC1533_DOMAINNAME, 1, ",");
|
---|
329 | else
|
---|
330 | added = 1;
|
---|
331 | val = (int)strlen(dd->dd_pszDomain);
|
---|
332 | FILL_BOOTP_EXT(q, RFC1533_DOMAINNAME, val, dd->dd_pszDomain);
|
---|
333 | }
|
---|
334 | }
|
---|
335 |
|
---|
336 | FILL_BOOTP_EXT(q, RFC2132_LEASE_TIME, 4, &lease_time);
|
---|
337 |
|
---|
338 | if (*slirp_hostname)
|
---|
339 | {
|
---|
340 | val = (int)strlen(slirp_hostname);
|
---|
341 | FILL_BOOTP_EXT(q, RFC1533_HOSTNAME, val, slirp_hostname);
|
---|
342 | }
|
---|
343 | slirp_arp_cache_update_or_add(pData, rbp->bp_yiaddr.s_addr, bc->macaddr);
|
---|
344 | return q - rbp->bp_vend; /*return offset */
|
---|
345 | }
|
---|
346 |
|
---|
347 | static int dhcp_send_nack(PNATState pData, struct bootp_t *bp, BOOTPClient *bc, struct mbuf *m)
|
---|
348 | {
|
---|
349 | NOREF(bc);
|
---|
350 |
|
---|
351 | dhcp_create_msg(pData, bp, m, DHCPNAK);
|
---|
352 | return 7;
|
---|
353 | }
|
---|
354 |
|
---|
355 | static int dhcp_send_ack(PNATState pData, struct bootp_t *bp, BOOTPClient *bc, struct mbuf *m, int fDhcpRequest)
|
---|
356 | {
|
---|
357 | int offReply = 0; /* boot_reply will fill general options and add END before sending response */
|
---|
358 |
|
---|
359 | dhcp_create_msg(pData, bp, m, DHCPACK);
|
---|
360 | offReply = dhcp_do_ack_offer(pData, m, bc, fDhcpRequest);
|
---|
361 | return offReply;
|
---|
362 | }
|
---|
363 |
|
---|
364 | static int dhcp_send_offer(PNATState pData, struct bootp_t *bp, BOOTPClient *bc, struct mbuf *m)
|
---|
365 | {
|
---|
366 | int offReply = 0; /* boot_reply will fill general options and add END before sending response */
|
---|
367 |
|
---|
368 | dhcp_create_msg(pData, bp, m, DHCPOFFER);
|
---|
369 | offReply = dhcp_do_ack_offer(pData, m, bc, /* fDhcpRequest=*/ 0);
|
---|
370 | return offReply;
|
---|
371 | }
|
---|
372 |
|
---|
373 | /**
|
---|
374 | * decoding client messages RFC2131 (4.3.6)
|
---|
375 | * ---------------------------------------------------------------------
|
---|
376 | * | |INIT-REBOOT |SELECTING |RENEWING |REBINDING |
|
---|
377 | * ---------------------------------------------------------------------
|
---|
378 | * |broad/unicast |broadcast |broadcast |unicast |broadcast |
|
---|
379 | * |server-ip |MUST NOT |MUST |MUST NOT |MUST NOT |
|
---|
380 | * |requested-ip |MUST |MUST |MUST NOT |MUST NOT |
|
---|
381 | * |ciaddr |zero |zero |IP address |IP address|
|
---|
382 | * ---------------------------------------------------------------------
|
---|
383 | *
|
---|
384 | */
|
---|
385 |
|
---|
386 | enum DHCP_REQUEST_STATES
|
---|
387 | {
|
---|
388 | INIT_REBOOT,
|
---|
389 | SELECTING,
|
---|
390 | RENEWING,
|
---|
391 | REBINDING,
|
---|
392 | NONE
|
---|
393 | };
|
---|
394 |
|
---|
395 | static int dhcp_decode_request(PNATState pData, struct bootp_t *bp, struct mbuf *m)
|
---|
396 | {
|
---|
397 | BOOTPClient *bc = NULL;
|
---|
398 | struct in_addr daddr;
|
---|
399 | int offReply;
|
---|
400 | uint8_t *req_ip = NULL;
|
---|
401 | uint8_t *server_ip = NULL;
|
---|
402 | uint32_t ui32;
|
---|
403 | enum DHCP_REQUEST_STATES dhcp_stat = NONE;
|
---|
404 |
|
---|
405 | /* need to understand which type of request we get */
|
---|
406 | req_ip = dhcp_find_option(&bp->bp_vend[0], RFC2132_REQ_ADDR);
|
---|
407 | server_ip = dhcp_find_option(&bp->bp_vend[0], RFC2132_SRV_ID);
|
---|
408 |
|
---|
409 | bc = find_addr(pData, &daddr, bp->bp_hwaddr);
|
---|
410 |
|
---|
411 | if (server_ip != NULL)
|
---|
412 | {
|
---|
413 | /* selecting */
|
---|
414 | if (!bc)
|
---|
415 | {
|
---|
416 | LogRel(("NAT: DHCP no IP was allocated\n"));
|
---|
417 | return -1;
|
---|
418 | }
|
---|
419 |
|
---|
420 | if ( !req_ip
|
---|
421 | || bp->bp_ciaddr.s_addr != INADDR_ANY)
|
---|
422 | {
|
---|
423 | LogRel(("NAT: Invalid SELECTING request\n"));
|
---|
424 | return -1; /* silently ignored */
|
---|
425 | }
|
---|
426 | dhcp_stat = SELECTING;
|
---|
427 | Assert((bp->bp_ciaddr.s_addr == INADDR_ANY));
|
---|
428 | #if 0
|
---|
429 | /* DSL xid in request differ from offer */
|
---|
430 | Assert((bp->bp_xid == bc->xid));
|
---|
431 | #endif
|
---|
432 | }
|
---|
433 | else
|
---|
434 | {
|
---|
435 | if (req_ip != NULL)
|
---|
436 | {
|
---|
437 | /* init-reboot */
|
---|
438 | dhcp_stat = INIT_REBOOT;
|
---|
439 | }
|
---|
440 | else
|
---|
441 | {
|
---|
442 | /* table 4 of rfc2131 */
|
---|
443 | if (bp->bp_flags & RT_H2N_U16_C(DHCP_FLAGS_B))
|
---|
444 | dhcp_stat = REBINDING;
|
---|
445 | else
|
---|
446 | dhcp_stat = RENEWING;
|
---|
447 | }
|
---|
448 | }
|
---|
449 |
|
---|
450 | /*?? renewing ??*/
|
---|
451 | switch (dhcp_stat)
|
---|
452 | {
|
---|
453 | case RENEWING:
|
---|
454 | /**
|
---|
455 | * decoding client messages RFC2131 (4.3.6)
|
---|
456 | * ------------------------------
|
---|
457 | * | |RENEWING |
|
---|
458 | * ------------------------------
|
---|
459 | * |broad/unicast |unicast |
|
---|
460 | * |server-ip |MUST NOT |
|
---|
461 | * |requested-ip |MUST NOT |
|
---|
462 | * |ciaddr |IP address |
|
---|
463 | * ------------------------------
|
---|
464 | */
|
---|
465 | Assert((server_ip == NULL && req_ip == NULL && bp->bp_ciaddr.s_addr != INADDR_ANY));
|
---|
466 | if ( server_ip
|
---|
467 | || req_ip
|
---|
468 | || bp->bp_ciaddr.s_addr == INADDR_ANY)
|
---|
469 | {
|
---|
470 | LogRel(("NAT: invalid RENEWING dhcp request\n"));
|
---|
471 | return -1; /* silent ignorance */
|
---|
472 | }
|
---|
473 | if (bc != NULL)
|
---|
474 | {
|
---|
475 | Assert((bc->addr.s_addr == bp->bp_ciaddr.s_addr));
|
---|
476 | /*if it already here well just do ack, we aren't aware of dhcp time expiration*/
|
---|
477 | }
|
---|
478 | else
|
---|
479 | {
|
---|
480 | if ((bp->bp_ciaddr.s_addr & RT_H2N_U32(pData->netmask)) != pData->special_addr.s_addr)
|
---|
481 | {
|
---|
482 | LogRel(("NAT: Client %RTnaipv4 requested IP -- sending NAK\n", bp->bp_ciaddr));
|
---|
483 | offReply = dhcp_send_nack(pData, bp, bc, m);
|
---|
484 | return offReply;
|
---|
485 | }
|
---|
486 |
|
---|
487 | bc = bc_alloc_client(pData);
|
---|
488 | if (!bc)
|
---|
489 | {
|
---|
490 | LogRel(("NAT: can't alloc address. RENEW has been silently ignored.\n"));
|
---|
491 | return -1;
|
---|
492 | }
|
---|
493 |
|
---|
494 | Assert((bp->bp_hlen == ETH_ALEN));
|
---|
495 | memcpy(bc->macaddr, bp->bp_hwaddr, bp->bp_hlen);
|
---|
496 | bc->addr.s_addr = bp->bp_ciaddr.s_addr;
|
---|
497 | }
|
---|
498 | break;
|
---|
499 |
|
---|
500 | case INIT_REBOOT:
|
---|
501 | /**
|
---|
502 | * decoding client messages RFC2131 (4.3.6)
|
---|
503 | * ------------------------------
|
---|
504 | * | |INIT-REBOOT |
|
---|
505 | * ------------------------------
|
---|
506 | * |broad/unicast |broadcast |
|
---|
507 | * |server-ip |MUST NOT |
|
---|
508 | * |requested-ip |MUST |
|
---|
509 | * |ciaddr |zero |
|
---|
510 | * ------------------------------
|
---|
511 | *
|
---|
512 | */
|
---|
513 | Assert(server_ip == NULL);
|
---|
514 | Assert(req_ip != NULL);
|
---|
515 | if ( server_ip
|
---|
516 | || !req_ip
|
---|
517 | || bp->bp_ciaddr.s_addr != INADDR_ANY)
|
---|
518 | {
|
---|
519 | LogRel(("NAT: Invalid INIT-REBOOT dhcp request\n"));
|
---|
520 | return -1; /* silently ignored */
|
---|
521 | }
|
---|
522 | ui32 = *(uint32_t *)(req_ip + 2);
|
---|
523 | if ((ui32 & RT_H2N_U32(pData->netmask)) != pData->special_addr.s_addr)
|
---|
524 | {
|
---|
525 | LogRel(("NAT: address %RTnaipv4 has been requested -- sending NAK\n", ui32));
|
---|
526 | offReply = dhcp_send_nack(pData, bp, bc, m);
|
---|
527 | return offReply;
|
---|
528 | }
|
---|
529 |
|
---|
530 | /* find_addr() got some result? */
|
---|
531 | if (!bc)
|
---|
532 | {
|
---|
533 | bc = bc_alloc_client(pData);
|
---|
534 | if (!bc)
|
---|
535 | {
|
---|
536 | LogRel(("NAT: can't alloc address. RENEW has been silently ignored\n"));
|
---|
537 | return -1;
|
---|
538 | }
|
---|
539 | }
|
---|
540 | Assert((bp->bp_hlen == ETH_ALEN));
|
---|
541 | memcpy(bc->macaddr, bp->bp_hwaddr, bp->bp_hlen);
|
---|
542 | bc->addr.s_addr = ui32;
|
---|
543 | break;
|
---|
544 |
|
---|
545 | case NONE:
|
---|
546 | Assert((dhcp_stat != NONE));
|
---|
547 | if (dhcp_stat == REBINDING)
|
---|
548 | LogRel(("NAT: REBINDING state isn't impemented\n"));
|
---|
549 | else if (dhcp_stat == SELECTING)
|
---|
550 | LogRel(("NAT: SELECTING state isn't impemented\n"));
|
---|
551 | return -1;
|
---|
552 |
|
---|
553 | default:
|
---|
554 | break;
|
---|
555 | }
|
---|
556 |
|
---|
557 | LogRel(("NAT: DHCP offered IP address %RTnaipv4\n", bc->addr));
|
---|
558 | offReply = dhcp_send_ack(pData, bp, bc, m, /* fDhcpRequest=*/ 1);
|
---|
559 | return offReply;
|
---|
560 | }
|
---|
561 |
|
---|
562 | static int dhcp_decode_discover(PNATState pData, struct bootp_t *bp, int fDhcpDiscover, struct mbuf *m)
|
---|
563 | {
|
---|
564 | BOOTPClient *bc;
|
---|
565 | struct in_addr daddr;
|
---|
566 | int offReply;
|
---|
567 |
|
---|
568 | if (fDhcpDiscover)
|
---|
569 | {
|
---|
570 | bc = find_addr(pData, &daddr, bp->bp_hwaddr);
|
---|
571 | if (!bc)
|
---|
572 | {
|
---|
573 | bc = get_new_addr(pData, &daddr);
|
---|
574 | if (!bc)
|
---|
575 | {
|
---|
576 | LogRel(("NAT: DHCP no IP address left\n"));
|
---|
577 | Log(("no address left\n"));
|
---|
578 | return -1;
|
---|
579 | }
|
---|
580 | memcpy(bc->macaddr, bp->bp_hwaddr, 6);
|
---|
581 | }
|
---|
582 |
|
---|
583 | bc->xid = bp->bp_xid;
|
---|
584 | LogRel(("NAT: DHCP offered IP address %RTnaipv4\n", bc->addr));
|
---|
585 | offReply = dhcp_send_offer(pData, bp, bc, m);
|
---|
586 | return offReply;
|
---|
587 | }
|
---|
588 | else
|
---|
589 | {
|
---|
590 | bc = find_addr(pData, &daddr, bp->bp_hwaddr);
|
---|
591 | if (!bc)
|
---|
592 | {
|
---|
593 | LogRel(("NAT: DHCP Inform was ignored no boot client was found\n"));
|
---|
594 | return -1;
|
---|
595 | }
|
---|
596 |
|
---|
597 | LogRel(("NAT: DHCP offered IP address %RTnaipv4\n", bc->addr));
|
---|
598 | offReply = dhcp_send_ack(pData, bp, bc, m, /* fDhcpRequest=*/ 0);
|
---|
599 | return offReply;
|
---|
600 | }
|
---|
601 |
|
---|
602 | return -1;
|
---|
603 | }
|
---|
604 |
|
---|
605 | static int dhcp_decode_release(PNATState pData, struct bootp_t *bp)
|
---|
606 | {
|
---|
607 | int rc = release_addr(pData, &bp->bp_ciaddr);
|
---|
608 | LogRel(("NAT: %s %RTnaipv4\n",
|
---|
609 | RT_SUCCESS(rc) ? "DHCP released IP address" : "Ignored DHCP release for IP address",
|
---|
610 | &bp->bp_ciaddr));
|
---|
611 | return 0;
|
---|
612 | }
|
---|
613 | /**
|
---|
614 | * fields for discovering t
|
---|
615 | * Field DHCPDISCOVER DHCPREQUEST DHCPDECLINE,
|
---|
616 | * DHCPINFORM DHCPRELEASE
|
---|
617 | * ----- ------------ ----------- -----------
|
---|
618 | * 'op' BOOTREQUEST BOOTREQUEST BOOTREQUEST
|
---|
619 | * 'htype' (From "Assigned Numbers" RFC)
|
---|
620 | * 'hlen' (Hardware address length in octets)
|
---|
621 | * 'hops' 0 0 0
|
---|
622 | * 'xid' selected by client 'xid' from server selected by
|
---|
623 | * DHCPOFFER message client
|
---|
624 | * 'secs' 0 or seconds since 0 or seconds since 0
|
---|
625 | * DHCP process started DHCP process started
|
---|
626 | * 'flags' Set 'BROADCAST' Set 'BROADCAST' 0
|
---|
627 | * flag if client flag if client
|
---|
628 | * requires broadcast requires broadcast
|
---|
629 | * reply reply
|
---|
630 | * 'ciaddr' 0 (DHCPDISCOVER) 0 or client's 0 (DHCPDECLINE)
|
---|
631 | * client's network address client's network
|
---|
632 | * network address (BOUND/RENEW/REBIND) address
|
---|
633 | * (DHCPINFORM) (DHCPRELEASE)
|
---|
634 | * 'yiaddr' 0 0 0
|
---|
635 | * 'siaddr' 0 0 0
|
---|
636 | * 'giaddr' 0 0 0
|
---|
637 | * 'chaddr' client's hardware client's hardware client's hardware
|
---|
638 | * address address address
|
---|
639 | * 'sname' options, if options, if (unused)
|
---|
640 | * indicated in indicated in
|
---|
641 | * 'sname/file' 'sname/file'
|
---|
642 | * option; otherwise option; otherwise
|
---|
643 | * unused unused
|
---|
644 | * 'file' options, if options, if (unused)
|
---|
645 | * indicated in indicated in
|
---|
646 | * 'sname/file' 'sname/file'
|
---|
647 | * option; otherwise option; otherwise
|
---|
648 | * unused unused
|
---|
649 | * 'options' options options (unused)
|
---|
650 | * Requested IP address MAY MUST (in MUST
|
---|
651 | * (DISCOVER) SELECTING or (DHCPDECLINE),
|
---|
652 | * MUST NOT INIT-REBOOT) MUST NOT
|
---|
653 | * (INFORM) MUST NOT (in (DHCPRELEASE)
|
---|
654 | * BOUND or
|
---|
655 | * RENEWING)
|
---|
656 | * IP address lease time MAY MAY MUST NOT
|
---|
657 | * (DISCOVER)
|
---|
658 | * MUST NOT
|
---|
659 | * (INFORM)
|
---|
660 | * Use 'file'/'sname' fields MAY MAY MAY
|
---|
661 | * DHCP message type DHCPDISCOVER/ DHCPREQUEST DHCPDECLINE/
|
---|
662 | * DHCPINFORM DHCPRELEASE
|
---|
663 | * Client identifier MAY MAY MAY
|
---|
664 | * Vendor class identifier MAY MAY MUST NOT
|
---|
665 | * Server identifier MUST NOT MUST (after MUST
|
---|
666 | * SELECTING)
|
---|
667 | * MUST NOT (after
|
---|
668 | * INIT-REBOOT,
|
---|
669 | * BOUND, RENEWING
|
---|
670 | * or REBINDING)
|
---|
671 | * Parameter request list MAY MAY MUST NOT
|
---|
672 | * Maximum message size MAY MAY MUST NOT
|
---|
673 | * Message SHOULD NOT SHOULD NOT SHOULD
|
---|
674 | * Site-specific MAY MAY MUST NOT
|
---|
675 | * All others MAY MAY MUST NOT
|
---|
676 | *
|
---|
677 | */
|
---|
678 | static void dhcp_decode(PNATState pData, struct bootp_t *bp, const uint8_t *buf, int size)
|
---|
679 | {
|
---|
680 | const uint8_t *pu8RawDhcpObject;
|
---|
681 | int rc;
|
---|
682 | struct in_addr req_ip;
|
---|
683 | int fDhcpDiscover = 0;
|
---|
684 | uint8_t *parameter_list = NULL;
|
---|
685 | struct mbuf *m = NULL;
|
---|
686 |
|
---|
687 | pu8RawDhcpObject = buf;
|
---|
688 | if (size < 5)
|
---|
689 | return;
|
---|
690 |
|
---|
691 | if (memcmp(pu8RawDhcpObject, rfc1533_cookie, 4) != 0)
|
---|
692 | return;
|
---|
693 |
|
---|
694 | /* note: pu8RawDhcpObject doesn't point to parameter buf */
|
---|
695 | pu8RawDhcpObject = dhcp_find_option(bp->bp_vend, RFC2132_MSG_TYPE);
|
---|
696 | Assert(pu8RawDhcpObject);
|
---|
697 | if (!pu8RawDhcpObject)
|
---|
698 | return;
|
---|
699 | /**
|
---|
700 | * We're going update dns list at least once per DHCP transaction (!not on every operation
|
---|
701 | * within transaction), assuming that transaction can't be longer than 1 min.
|
---|
702 | *
|
---|
703 | * @note: if we have notification update (HAVE_NOTIFICATION_FOR_DNS_UPDATE)
|
---|
704 | * provided by host, we don't need implicitly re-initialize dns list.
|
---|
705 | *
|
---|
706 | * @note: NATState::fUseHostResolver became (r89055) the flag signalling that Slirp
|
---|
707 | * wasn't able to fetch fresh host DNS info and fall down to use host-resolver, on one
|
---|
708 | * of the previous attempts to proxy dns requests to Host's name-resolving API
|
---|
709 | *
|
---|
710 | * @note: Checking NATState::fUseHostResolver == true, we want to try restore behaviour initialy
|
---|
711 | * wanted by user ASAP (P here when host serialize its configuration in files parsed by Slirp).
|
---|
712 | */
|
---|
713 | if ( !HAVE_NOTIFICATION_FOR_DNS_UPDATE
|
---|
714 | && !pData->fUseHostResolverPermanent
|
---|
715 | && ( pData->dnsLastUpdate == 0
|
---|
716 | || curtime - pData->dnsLastUpdate > 60 * 1000 /* one minute */
|
---|
717 | || pData->fUseHostResolver))
|
---|
718 | {
|
---|
719 | uint8_t i = 2; /* i = 0 - tag, i == 1 - length */
|
---|
720 | parameter_list = dhcp_find_option(&bp->bp_vend[0], RFC2132_PARAM_LIST);
|
---|
721 | for (;parameter_list && i < parameter_list[1]; ++i)
|
---|
722 | {
|
---|
723 | if (parameter_list[i] == RFC1533_DNS)
|
---|
724 | {
|
---|
725 | /* XXX: How differs it from host Suspend/Resume? */
|
---|
726 | slirpReleaseDnsSettings(pData);
|
---|
727 | slirpInitializeDnsSettings(pData);
|
---|
728 | pData->dnsLastUpdate = curtime;
|
---|
729 | break;
|
---|
730 | }
|
---|
731 | }
|
---|
732 | }
|
---|
733 |
|
---|
734 | m = m_getcl(pData, M_DONTWAIT, MT_HEADER, M_PKTHDR);
|
---|
735 | if (!m)
|
---|
736 | {
|
---|
737 | LogRel(("NAT: can't alocate memory for response!\n"));
|
---|
738 | return;
|
---|
739 | }
|
---|
740 |
|
---|
741 | switch (*(pu8RawDhcpObject + 2))
|
---|
742 | {
|
---|
743 | case DHCPDISCOVER:
|
---|
744 | fDhcpDiscover = 1;
|
---|
745 | /* fall through */
|
---|
746 | case DHCPINFORM:
|
---|
747 | rc = dhcp_decode_discover(pData, bp, fDhcpDiscover, m);
|
---|
748 | if (rc > 0)
|
---|
749 | goto reply;
|
---|
750 | break;
|
---|
751 |
|
---|
752 | case DHCPREQUEST:
|
---|
753 | rc = dhcp_decode_request(pData, bp, m);
|
---|
754 | if (rc > 0)
|
---|
755 | goto reply;
|
---|
756 | break;
|
---|
757 |
|
---|
758 | case DHCPRELEASE:
|
---|
759 | dhcp_decode_release(pData, bp);
|
---|
760 | /* no reply required */
|
---|
761 | break;
|
---|
762 |
|
---|
763 | case DHCPDECLINE:
|
---|
764 | /* note: pu8RawDhcpObject doesn't point to DHCP header, now it's expected it points
|
---|
765 | * to Dhcp Option RFC2132_REQ_ADDR
|
---|
766 | */
|
---|
767 | pu8RawDhcpObject = dhcp_find_option(&bp->bp_vend[0], RFC2132_REQ_ADDR);
|
---|
768 | if (!pu8RawDhcpObject)
|
---|
769 | {
|
---|
770 | Log(("NAT: RFC2132_REQ_ADDR not found\n"));
|
---|
771 | break;
|
---|
772 | }
|
---|
773 | req_ip.s_addr = *(uint32_t *)(pu8RawDhcpObject + 2);
|
---|
774 | rc = bootp_cache_lookup_ether_by_ip(pData, req_ip.s_addr, NULL);
|
---|
775 | if (RT_FAILURE(rc))
|
---|
776 | {
|
---|
777 | /* Not registered */
|
---|
778 | BOOTPClient *bc;
|
---|
779 | bc = bc_alloc_client(pData);
|
---|
780 | Assert(bc);
|
---|
781 | if (!bc)
|
---|
782 | {
|
---|
783 | LogRel(("NAT: can't allocate bootp client object\n"));
|
---|
784 | break;
|
---|
785 | }
|
---|
786 | bc->addr.s_addr = req_ip.s_addr;
|
---|
787 | slirp_arp_who_has(pData, bc->addr.s_addr);
|
---|
788 | LogRel(("NAT: %RTnaipv4 has been already registered\n", req_ip));
|
---|
789 | }
|
---|
790 | /* no response required */
|
---|
791 | break;
|
---|
792 |
|
---|
793 | default:
|
---|
794 | AssertMsgFailed(("unsupported DHCP message type"));
|
---|
795 | }
|
---|
796 | /* silently ignore */
|
---|
797 | m_freem(pData, m);
|
---|
798 | return;
|
---|
799 |
|
---|
800 | reply:
|
---|
801 | bootp_reply(pData, m, rc, bp->bp_flags);
|
---|
802 | }
|
---|
803 |
|
---|
804 | static void bootp_reply(PNATState pData, struct mbuf *m, int offReply, uint16_t flags)
|
---|
805 | {
|
---|
806 | struct sockaddr_in saddr, daddr;
|
---|
807 | struct bootp_t *rbp = NULL;
|
---|
808 | uint8_t *q = NULL;
|
---|
809 | int nack;
|
---|
810 | rbp = mtod(m, struct bootp_t *);
|
---|
811 | Assert((m));
|
---|
812 | Assert((rbp));
|
---|
813 | q = rbp->bp_vend;
|
---|
814 | nack = (q[6] == DHCPNAK);
|
---|
815 | q += offReply;
|
---|
816 |
|
---|
817 | saddr.sin_addr.s_addr = RT_H2N_U32(RT_N2H_U32(pData->special_addr.s_addr) | CTL_ALIAS);
|
---|
818 |
|
---|
819 | FILL_BOOTP_EXT(q, RFC2132_SRV_ID, 4, &saddr.sin_addr);
|
---|
820 |
|
---|
821 | *q++ = RFC1533_END; /* end of message */
|
---|
822 |
|
---|
823 | m->m_pkthdr.header = mtod(m, void *);
|
---|
824 | m->m_len = sizeof(struct bootp_t)
|
---|
825 | - sizeof(struct ip)
|
---|
826 | - sizeof(struct udphdr);
|
---|
827 | m->m_data += sizeof(struct udphdr)
|
---|
828 | + sizeof(struct ip);
|
---|
829 | if ( (flags & RT_H2N_U16_C(DHCP_FLAGS_B))
|
---|
830 | || nack != 0)
|
---|
831 | daddr.sin_addr.s_addr = INADDR_BROADCAST;
|
---|
832 | else
|
---|
833 | daddr.sin_addr.s_addr = rbp->bp_yiaddr.s_addr; /*unicast requested by client*/
|
---|
834 | saddr.sin_port = RT_H2N_U16_C(BOOTP_SERVER);
|
---|
835 | daddr.sin_port = RT_H2N_U16_C(BOOTP_CLIENT);
|
---|
836 | udp_output2(pData, NULL, m, &saddr, &daddr, IPTOS_LOWDELAY);
|
---|
837 | }
|
---|
838 |
|
---|
839 | void bootp_input(PNATState pData, struct mbuf *m)
|
---|
840 | {
|
---|
841 | struct bootp_t *bp = mtod(m, struct bootp_t *);
|
---|
842 |
|
---|
843 | if (bp->bp_op == BOOTP_REQUEST)
|
---|
844 | dhcp_decode(pData, bp, bp->bp_vend, DHCP_OPT_LEN);
|
---|
845 | }
|
---|
846 |
|
---|
847 | int bootp_cache_lookup_ip_by_ether(PNATState pData,const uint8_t* ether, uint32_t *pip)
|
---|
848 | {
|
---|
849 | int i;
|
---|
850 |
|
---|
851 | if (!ether || !pip)
|
---|
852 | return VERR_INVALID_PARAMETER;
|
---|
853 |
|
---|
854 | for (i = 0; i < NB_ADDR; i++)
|
---|
855 | {
|
---|
856 | if ( bootp_clients[i].allocated
|
---|
857 | && memcmp(bootp_clients[i].macaddr, ether, ETH_ALEN) == 0)
|
---|
858 | {
|
---|
859 | *pip = bootp_clients[i].addr.s_addr;
|
---|
860 | return VINF_SUCCESS;
|
---|
861 | }
|
---|
862 | }
|
---|
863 |
|
---|
864 | *pip = INADDR_ANY;
|
---|
865 | return VERR_NOT_FOUND;
|
---|
866 | }
|
---|
867 |
|
---|
868 | int bootp_cache_lookup_ether_by_ip(PNATState pData, uint32_t ip, uint8_t *ether)
|
---|
869 | {
|
---|
870 | int i;
|
---|
871 | for (i = 0; i < NB_ADDR; i++)
|
---|
872 | {
|
---|
873 | if ( bootp_clients[i].allocated
|
---|
874 | && ip == bootp_clients[i].addr.s_addr)
|
---|
875 | {
|
---|
876 | if (ether != NULL)
|
---|
877 | memcpy(ether, bootp_clients[i].macaddr, ETH_ALEN);
|
---|
878 | return VINF_SUCCESS;
|
---|
879 | }
|
---|
880 | }
|
---|
881 |
|
---|
882 | return VERR_NOT_FOUND;
|
---|
883 | }
|
---|
884 |
|
---|
885 | /*
|
---|
886 | * Initialize dhcp server
|
---|
887 | * @returns 0 - if initialization is ok, non-zero otherwise
|
---|
888 | */
|
---|
889 | int bootp_dhcp_init(PNATState pData)
|
---|
890 | {
|
---|
891 | pData->pbootp_clients = RTMemAllocZ(sizeof(BOOTPClient) * NB_ADDR);
|
---|
892 | if (!pData->pbootp_clients)
|
---|
893 | return VERR_NO_MEMORY;
|
---|
894 |
|
---|
895 | return VINF_SUCCESS;
|
---|
896 | }
|
---|
897 |
|
---|
898 | int bootp_dhcp_fini(PNATState pData)
|
---|
899 | {
|
---|
900 | if (pData->pbootp_clients != NULL)
|
---|
901 | RTMemFree(pData->pbootp_clients);
|
---|
902 |
|
---|
903 | return VINF_SUCCESS;
|
---|
904 | }
|
---|