b0146eb972e9f3424ae0b7a2d240afaa3ed71875
[strongswan.git] / Source / charon / message.c
1 /**
2 * @file message.c
3 *
4 * @brief Class message_t. Object of this type represents an IKEv2-Message.
5 *
6 */
7
8 /*
9 * Copyright (C) 2005 Jan Hutter, Martin Willi
10 * Hochschule fuer Technik Rapperswil
11 *
12 * This program is free software; you can redistribute it and/or modify it
13 * under the terms of the GNU General Public License as published by the
14 * Free Software Foundation; either version 2 of the License, or (at your
15 * option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
16 *
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
19 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
20 * for more details.
21 */
22
23 #include <stdlib.h>
24
25 #include "message.h"
26
27 #include "types.h"
28 #include "globals.h"
29 #include "ike_sa_id.h"
30 #include "generator.h"
31 #include "utils/linked_list.h"
32 #include "utils/allocator.h"
33 #include "utils/logger_manager.h"
34 #include "payloads/encodings.h"
35 #include "payloads/payload.h"
36 #include "parser.h"
37
38
39 /**
40 * Supported payload entry used in message_rule_t
41 *
42 */
43 typedef struct supported_payload_entry_s supported_payload_entry_t;
44
45 struct supported_payload_entry_s {
46 /**
47 * Payload type
48 */
49 payload_type_t payload_type;
50
51 /**
52 * Minimal occurence of this payload
53 */
54 size_t min_occurence;
55
56 /**
57 * Max occurence of this payload
58 */
59 size_t max_occurence;
60 };
61
62 /**
63 * Message Rule used to find out which payloads are supported by each message type
64 *
65 */
66 typedef struct message_rule_s message_rule_t;
67
68 struct message_rule_s {
69 /**
70 * Type of message
71 */
72 exchange_type_t exchange_type;
73
74 /**
75 * Is message a request or response
76 */
77 bool is_request;
78 /**
79 * Number of supported payloads
80 */
81 size_t supported_payloads_count;
82 /**
83 * Pointer to first supported payload entry
84 */
85 supported_payload_entry_t *supported_payloads;
86 };
87
88
89 static supported_payload_entry_t supported_ike_sa_init_i_payloads[] =
90 {
91 {SECURITY_ASSOCIATION,1,1},
92 {KEY_EXCHANGE,1,1},
93 {NONCE,1,1},
94 };
95
96 static supported_payload_entry_t supported_ike_sa_init_r_payloads[] =
97 {
98 {SECURITY_ASSOCIATION,1,1},
99 {KEY_EXCHANGE,1,1},
100 {NONCE,1,1},
101 };
102
103 static message_rule_t message_rules[] = {
104 {IKE_SA_INIT,TRUE,(sizeof(supported_ike_sa_init_i_payloads)/sizeof(supported_payload_entry_t)),supported_ike_sa_init_i_payloads},
105 {IKE_SA_INIT,FALSE,(sizeof(supported_ike_sa_init_r_payloads)/sizeof(supported_payload_entry_t)),supported_ike_sa_init_r_payloads}
106 };
107
108 /**
109 * Entry for a payload in the internal used linked list
110 *
111 */
112 typedef struct payload_entry_s payload_entry_t;
113
114 struct payload_entry_s {
115 /**
116 * Type of payload
117 */
118 payload_type_t payload_type;
119 /**
120 * Data struct holding the data of given payload
121 */
122 void *data_struct;
123 };
124
125
126 /**
127 * Private data of an message_t object
128 */
129 typedef struct private_message_s private_message_t;
130
131 struct private_message_s {
132
133 /**
134 * Public part of a message_t object
135 */
136 message_t public;
137
138
139 /**
140 * Minor version of message
141 */
142 u_int8_t major_version;
143
144 /**
145 * Major version of message
146 */
147 u_int8_t minor_version;
148
149 /**
150 * First Payload in message
151 */
152 payload_type_t first_payload;
153
154 /**
155 * Assigned exchange type
156 */
157 exchange_type_t exchange_type;
158
159 /**
160 * TRUE if message is from original initiator, FALSE otherwise.
161 */
162 bool original_initiator;
163
164 /**
165 * TRUE if message is request.
166 * FALSE if message is reply.
167 */
168 bool is_request;
169
170 /**
171 * Message ID of this message
172 */
173 u_int32_t message_id;
174
175 /**
176 * ID of assigned IKE_SA
177 */
178 ike_sa_id_t *ike_sa_id;
179
180 /**
181 * Assigned UDP packet.
182 *
183 * Stores incoming packet or last generated one.
184 */
185 packet_t *packet;
186
187 /**
188 * Linked List where payload data are stored in
189 */
190 linked_list_t *payloads;
191
192 /**
193 * Assigned parser to parse Header and Body of this message
194 */
195 parser_t *parser;
196
197 /**
198 * logger for this message
199 */
200 logger_t *logger;
201
202 /**
203 * Gets a list of supported payloads of this message type
204 *
205 * @param this calling object
206 * @param[out] supported_payloads first entry of supported payloads
207 * @param[out] supported_payloads_count number of supported payload entries
208 *
209 * @return SUCCESS
210 * NOT_FOUND if no supported payload definition could be found
211 */
212 status_t (*get_supported_payloads) (private_message_t *this, supported_payload_entry_t **supported_payloads,size_t *supported_payloads_count);
213
214 };
215
216 /**
217 * Implements private_message_t's get_supported_payloads function.
218 * See #private_message_t.get_supported_payloads.
219 */
220 status_t get_supported_payloads (private_message_t *this, supported_payload_entry_t **supported_payloads,size_t *supported_payloads_count)
221 {
222 int i;
223 exchange_type_t exchange_type = this->public.get_exchange_type(&(this->public));
224 bool is_request = this->public.get_request(&(this->public));
225
226
227 for (i = 0; i < (sizeof(message_rules) / sizeof(message_rule_t)); i++)
228 {
229 if ((exchange_type == message_rules[i].exchange_type) &&
230 (is_request == message_rules[i].is_request))
231 {
232 /* found rule for given exchange_type*/
233 *supported_payloads = message_rules[i].supported_payloads;
234 *supported_payloads_count = message_rules[i].supported_payloads_count;
235
236 return SUCCESS;
237 }
238
239
240 }
241 *supported_payloads = NULL;
242 *supported_payloads_count = 0;
243 return NOT_FOUND;
244 }
245
246 /**
247 * Implements message_t's set_ike_sa_id function.
248 * See #message_s.set_ike_sa_id.
249 */
250 static status_t set_ike_sa_id (private_message_t *this,ike_sa_id_t *ike_sa_id)
251 {
252 status_t status;
253 status = ike_sa_id->clone(ike_sa_id,&(this->ike_sa_id));
254 return status;
255 }
256
257 /**
258 * Implements message_t's get_ike_sa_id function.
259 * See #message_s.get_ike_sa_id.
260 */
261 static status_t get_ike_sa_id (private_message_t *this,ike_sa_id_t **ike_sa_id)
262 {
263 status_t status;
264 if (this->ike_sa_id == NULL)
265 {
266 return FAILED;
267 }
268 status = this->ike_sa_id->clone(this->ike_sa_id,ike_sa_id);
269 return status;
270 }
271
272
273 /**
274 * Implements message_t's set_message_id function.
275 * See #message_s.set_message_id.
276 */
277 static status_t set_message_id (private_message_t *this,u_int32_t message_id)
278 {
279 this->message_id = message_id;
280 return SUCCESS;
281 }
282
283
284 /**
285 * Implements message_t's set_message_id function.
286 * See #message_s.set_message_id.
287 */
288 static u_int32_t get_message_id (private_message_t *this)
289 {
290 return this->message_id;
291 }
292
293 /**
294 * Implements message_t's set_major_version function.
295 * See #message_s.set_major_version.
296 */
297 static status_t set_major_version (private_message_t *this,u_int8_t major_version)
298 {
299 this->major_version = major_version;
300 return SUCCESS;
301 }
302
303
304 /**
305 * Implements message_t's get_major_version function.
306 * See #message_s.get_major_version.
307 */
308 static u_int8_t get_major_version (private_message_t *this)
309 {
310 return this->major_version;
311 }
312
313 /**
314 * Implements message_t's set_minor_version function.
315 * See #message_s.set_minor_version.
316 */
317 static status_t set_minor_version (private_message_t *this,u_int8_t minor_version)
318 {
319 this->minor_version = minor_version;
320 return SUCCESS;
321 }
322
323
324 /**
325 * Implements message_t's get_minor_version function.
326 * See #message_s.get_minor_version.
327 */
328 static u_int8_t get_minor_version (private_message_t *this)
329 {
330 return this->minor_version;
331 }
332
333 /**
334 * Implements message_t's set_exchange_type function.
335 * See #message_s.set_exchange_type.
336 */
337 static status_t set_exchange_type (private_message_t *this,exchange_type_t exchange_type)
338 {
339 this->exchange_type = exchange_type;
340 return SUCCESS;
341 }
342
343
344 /**
345 * Implements message_t's get_exchange_type function.
346 * See #message_s.get_exchange_type.
347 */
348 static exchange_type_t get_exchange_type (private_message_t *this)
349 {
350 return this->exchange_type;
351 }
352
353 /**
354 * Implements message_t's set_original_initiator function.
355 * See #message_s.set_original_initiator.
356 */
357 static status_t set_original_initiator (private_message_t *this,bool original_initiator)
358 {
359 this->original_initiator = original_initiator;
360 return SUCCESS;
361 }
362
363 /**
364 * Implements message_t's get_original_initiator function.
365 * See #message_s.get_original_initiator.
366 */
367 static exchange_type_t get_original_initiator (private_message_t *this)
368 {
369 return this->original_initiator;
370 }
371
372 /**
373 * Implements message_t's set_request function.
374 * See #message_s.set_request.
375 */
376 static status_t set_request (private_message_t *this,bool request)
377 {
378 this->is_request = request;
379 return SUCCESS;
380 }
381
382 /**
383 * Implements message_t's get_request function.
384 * See #message_s.get_request.
385 */
386 static exchange_type_t get_request (private_message_t *this)
387 {
388 return this->is_request;
389 }
390
391 static status_t add_payload(private_message_t *this, payload_t *payload)
392 {
393 if (this->payloads->insert_last(this->payloads, payload) != SUCCESS)
394 {
395 return OUT_OF_RES;
396 }
397 return SUCCESS;
398 }
399
400 static status_t set_source(private_message_t *this, host_t *host)
401 {
402 if (this->packet->source != NULL)
403 {
404 this->packet->source->destroy(this->packet->source);
405 }
406 this->packet->source = host;
407 return SUCCESS;
408 }
409
410 static status_t set_destination(private_message_t *this, host_t *host)
411 {
412 if (this->packet->destination != NULL)
413 {
414 this->packet->destination->destroy(this->packet->destination);
415 }
416 this->packet->destination = host;
417 return SUCCESS;
418 }
419
420 static status_t get_source(private_message_t *this, host_t **host)
421 {
422 *host = this->packet->source;
423 return SUCCESS;
424 }
425
426 static status_t get_destination(private_message_t *this, host_t **host)
427 {
428 *host = this->packet->destination;
429 return SUCCESS;
430 }
431
432
433 /**
434 * Implements message_t's generate function.
435 * See #message_s.generate.
436 */
437 static status_t generate(private_message_t *this, packet_t **packet)
438 {
439 generator_t *generator;
440 ike_header_t *ike_header;
441 payload_t *payload, *next_payload;
442 linked_list_iterator_t *iterator;
443 u_int64_t initiator_spi, responder_spi;
444 bool is_initiator;
445 status_t status;
446
447 if (this->exchange_type == EXCHANGE_TYPE_UNDEFINED)
448 {
449 return INVALID_STATE;
450 }
451
452 if (this->packet->source == NULL ||
453 this->packet->destination == NULL)
454 {
455 return INVALID_STATE;
456 }
457
458 ike_header = ike_header_create();
459 if (ike_header == NULL)
460 {
461 return OUT_OF_RES;
462 }
463
464 this->ike_sa_id->get_values(this->ike_sa_id, &initiator_spi, &responder_spi, &is_initiator);
465
466 ike_header->set_exchange_type(ike_header, this->exchange_type);
467 ike_header->set_initiator_flag(ike_header, this->original_initiator);
468 ike_header->set_message_id(ike_header, this->message_id);
469 ike_header->set_response_flag(ike_header, !this->is_request);
470 ike_header->set_initiator_flag(ike_header, is_initiator);
471 ike_header->set_initiator_spi(ike_header, initiator_spi);
472 ike_header->set_responder_spi(ike_header, responder_spi);
473
474 generator = generator_create();
475 if (generator == NULL)
476 {
477 return OUT_OF_RES;
478 }
479
480 payload = (payload_t*)ike_header;
481
482 if (this->payloads->create_iterator(this->payloads, &iterator, TRUE) != SUCCESS)
483 {
484 generator->destroy(generator);
485 ike_header->destroy(ike_header);
486 return OUT_OF_RES;
487 }
488 while(iterator->has_next(iterator))
489 {
490 iterator->current(iterator, (void**)&next_payload);
491 payload->set_next_type(payload, next_payload->get_type(next_payload));
492 status = generator->generate_payload(generator, payload);
493 if (status != SUCCESS)
494 {
495 generator->destroy(generator);
496 ike_header->destroy(ike_header);
497 return status;
498 }
499 payload = next_payload;
500 }
501 iterator->destroy(iterator);
502
503 payload->set_next_type(payload, NO_PAYLOAD);
504 status = generator->generate_payload(generator, payload);
505 if (status != SUCCESS)
506 {
507 generator->destroy(generator);
508 ike_header->destroy(ike_header);
509 return status;
510 }
511
512 ike_header->destroy(ike_header);
513
514
515
516 if (this->packet->data.ptr != NULL)
517 {
518 allocator_free(this->packet->data.ptr);
519 }
520
521 status = generator->write_to_chunk(generator, &(this->packet->data));
522 if (status != SUCCESS)
523 {
524 generator->destroy(generator);
525 return status;
526 }
527
528 this->packet->clone(this->packet, packet);
529
530 generator->destroy(generator);
531 return SUCCESS;
532 }
533
534 /**
535 * Implements message_t's parse_header function.
536 * See #message_s.parse_header.
537 */
538 static status_t parse_header (private_message_t *this)
539 {
540 ike_header_t *ike_header;
541 status_t status;
542
543 this->parser->reset_context(this->parser);
544 status = this->parser->parse_payload(this->parser,HEADER,(payload_t **) &ike_header);
545 if (status != SUCCESS)
546 {
547 this->logger->log(this->logger, ERROR, "Header could not be parsed");
548 return status;
549
550 }
551
552 /* verify payload */
553 status = ike_header->payload_interface.verify(&(ike_header->payload_interface));
554 if (status != SUCCESS)
555 {
556 this->logger->log(this->logger, ERROR, "Header could not be verified");
557 return status;
558 }
559
560 if (this->ike_sa_id != NULL)
561 {
562 this->ike_sa_id->destroy(this->ike_sa_id);
563 }
564 this->original_initiator = (!ike_header->get_initiator_flag(ike_header));
565
566 this->ike_sa_id = ike_sa_id_create(ike_header->get_initiator_spi(ike_header),ike_header->get_responder_spi(ike_header),this->original_initiator);
567 if (this->ike_sa_id == NULL)
568 {
569 this->logger->log(this->logger, ERROR, "Could not creaee ike_sa_id object");
570 ike_header->destroy(ike_header);
571 return OUT_OF_RES;
572 }
573 this->exchange_type = ike_header->get_exchange_type(ike_header);
574 this->message_id = ike_header->get_message_id(ike_header);
575 this->is_request = (!(ike_header->get_response_flag(ike_header)));
576 this->major_version = ike_header->get_maj_version(ike_header);
577 this->minor_version = ike_header->get_min_version(ike_header);
578 this->first_payload = ike_header->payload_interface.get_next_type(&(ike_header->payload_interface));
579
580 ike_header->destroy(ike_header);
581 return SUCCESS;
582 }
583
584 /**
585 * Implements message_t's parse_body function.
586 * See #message_s.parse_body.
587 */
588 static status_t parse_body (private_message_t *this)
589 {
590 status_t status;
591 int i;
592 payload_type_t current_payload_type = this->first_payload;
593 supported_payload_entry_t *supported_payloads;
594 size_t supported_payloads_count;
595
596 if (this->get_supported_payloads (this,&supported_payloads,&supported_payloads_count) != SUCCESS)
597 {
598 /* message type is not supported */
599 return FAILED;
600 }
601
602 while (current_payload_type != NO_PAYLOAD)
603 {
604 payload_t *current_payload;
605
606 bool supported = FALSE;
607 for (i = 0; i < supported_payloads_count;i++)
608 {
609 if (supported_payloads[i].payload_type == current_payload_type)
610 {
611 supported = TRUE;
612 break;
613 }
614 }
615 if (!supported && (current_payload_type != NO_PAYLOAD))
616 {
617 /* type not supported */
618 status = NOT_SUPPORTED;
619 this->logger->log(this->logger, ERROR, "Payload type %s not supported",mapping_find(payload_type_m,current_payload_type));
620 break;
621 }
622
623 status = this->parser->parse_payload(this->parser,current_payload_type,(payload_t **) &current_payload);
624 if (status != SUCCESS)
625 {
626 this->logger->log(this->logger, ERROR, "Payload type %s could not be parsed",mapping_find(payload_type_m,current_payload_type));
627 break;
628 }
629
630 current_payload_type = current_payload->get_next_type(current_payload);
631
632 status = current_payload->verify(current_payload);
633 if (status != SUCCESS)
634 {
635 this->logger->log(this->logger, ERROR, "Payload type %s could not be verified",mapping_find(payload_type_m,current_payload_type));
636 status = VERIFY_ERROR;
637 break;
638 }
639
640 status = this->payloads->insert_last(this->payloads,current_payload);
641 if (status != SUCCESS)
642 {
643 this->logger->log(this->logger, ERROR, "Could not insert current payload to internal list cause of ressource exhausting");
644 break;
645 }
646
647 }
648 if (status != SUCCESS)
649 {
650 /* already parsed payload is destroyed later in destroy call from outside this object */
651 }
652 else
653 {
654 linked_list_iterator_t *iterator;
655
656 status = this->payloads->create_iterator(this->payloads,&iterator,TRUE);
657 if (status != SUCCESS)
658 {
659 this->logger->log(this->logger, ERROR, "Could not create iterator to check supported payloads");
660 return status;
661 }
662
663
664 /* check for payloads with wrong count*/
665 for (i = 0; i < supported_payloads_count;i++)
666 {
667 size_t min_occurence = supported_payloads[i].min_occurence;
668 size_t max_occurence = supported_payloads[i].max_occurence;
669 payload_type_t payload_type = supported_payloads[i].payload_type;
670 size_t found_payloads = 0;
671
672 iterator->reset(iterator);
673
674 while(iterator->has_next(iterator))
675 {
676 payload_t *current_payload;
677 status = iterator->current(iterator,(void **)&current_payload);
678 if (status != SUCCESS)
679 {
680 this->logger->log(this->logger, CONTROL_MORE, "Could not get payload from internal list");
681 iterator->destroy(iterator);
682 return status;
683 }
684 if (current_payload->get_type(current_payload) == payload_type)
685 {
686 found_payloads++;
687 if (found_payloads > max_occurence)
688 {
689 this->logger->log(this->logger, CONTROL_MORE, "Payload of type %s more than %d times (%d) occured in current message",
690 mapping_find(payload_type_m,current_payload->get_type(current_payload)),max_occurence,found_payloads);
691 iterator->destroy(iterator);
692 return NOT_SUPPORTED;
693 }
694 }
695
696 }
697 if (found_payloads < min_occurence)
698 {
699 this->logger->log(this->logger, CONTROL_MORE, "Payload of type %s not occured %d times",
700 mapping_find(payload_type_m,payload_type),min_occurence);
701 iterator->destroy(iterator);
702 return NOT_SUPPORTED;
703 }
704
705 }
706 iterator->destroy(iterator);
707 }
708 return status;
709 }
710
711
712
713 /**
714 * Implements message_t's destroy function.
715 * See #message_s.destroy.
716 */
717 static status_t destroy (private_message_t *this)
718 {
719 linked_list_iterator_t *iterator;
720
721 if (this->packet != NULL)
722 {
723 this->packet->destroy(this->packet);
724 }
725 if (this->ike_sa_id != NULL)
726 {
727 this->ike_sa_id->destroy(this->ike_sa_id);
728 }
729
730 this->payloads->create_iterator(this->payloads, &iterator, TRUE);
731 while (iterator->has_next(iterator))
732 {
733 payload_t *payload;
734 iterator->current(iterator, (void**)&payload);
735 this->logger->log(this->logger, CONTROL_MORE, "Destroying payload of type %s",
736 mapping_find(payload_type_m, payload->get_type(payload)));
737 payload->destroy(payload);
738 }
739 iterator->destroy(iterator);
740 this->payloads->destroy(this->payloads);
741 this->parser->destroy(this->parser);
742
743 allocator_free(this);
744 return SUCCESS;
745 }
746
747 /*
748 * Described in Header-File
749 */
750 message_t *message_create_from_packet(packet_t *packet)
751 {
752 private_message_t *this = allocator_alloc_thing(private_message_t);
753 if (this == NULL)
754 {
755 return NULL;
756 }
757
758 /* public functions */
759 this->public.set_major_version = (status_t(*)(message_t*, u_int8_t))set_major_version;
760 this->public.get_major_version = (u_int8_t(*)(message_t*))get_major_version;
761 this->public.set_minor_version = (status_t(*)(message_t*, u_int8_t))set_minor_version;
762 this->public.get_minor_version = (u_int8_t(*)(message_t*))get_minor_version;
763 this->public.set_message_id = (status_t(*)(message_t*, u_int32_t))set_message_id;
764 this->public.get_message_id = (u_int32_t(*)(message_t*))get_message_id;
765 this->public.set_ike_sa_id = (status_t(*)(message_t*, ike_sa_id_t *))set_ike_sa_id;
766 this->public.get_ike_sa_id = (status_t(*)(message_t*, ike_sa_id_t **))get_ike_sa_id;
767 this->public.set_exchange_type = (status_t(*)(message_t*, exchange_type_t))set_exchange_type;
768 this->public.get_exchange_type = (exchange_type_t(*)(message_t*))get_exchange_type;
769 this->public.set_original_initiator = (status_t(*)(message_t*, bool))set_original_initiator;
770 this->public.get_original_initiator = (bool(*)(message_t*))get_original_initiator;
771 this->public.set_request = (status_t(*)(message_t*, bool))set_request;
772 this->public.get_request = (bool(*)(message_t*))get_request;
773 this->public.add_payload = (status_t(*)(message_t*,payload_t*))add_payload;
774 this->public.generate = (status_t (*) (message_t *, packet_t**)) generate;
775 this->public.set_source = (status_t (*) (message_t*,host_t*)) set_source;
776 this->public.get_source = (status_t (*) (message_t*,host_t**)) get_source;
777 this->public.set_destination = (status_t (*) (message_t*,host_t*)) set_destination;
778 this->public.get_destination = (status_t (*) (message_t*,host_t**)) get_destination;
779 this->public.parse_header = (status_t (*) (message_t *)) parse_header;
780 this->public.parse_body = (status_t (*) (message_t *)) parse_body;
781 this->public.destroy = (status_t(*)(message_t*))destroy;
782
783 /* public values */
784 this->exchange_type = EXCHANGE_TYPE_UNDEFINED;
785 this->original_initiator = TRUE;
786 this->is_request = TRUE;
787 this->ike_sa_id = NULL;
788 this->first_payload = NO_PAYLOAD;
789 this->message_id = 0;
790
791 /* private functions */
792 this->get_supported_payloads = get_supported_payloads;
793
794 /* private values */
795 if (packet == NULL)
796 {
797 packet = packet_create();
798 }
799 if (packet == NULL)
800 {
801 allocator_free(this);
802 return NULL;
803 }
804 this->packet = packet;
805 this->payloads = linked_list_create();
806 if (this->payloads == NULL)
807 {
808 allocator_free(this);
809 return NULL;
810 }
811
812 /* parser is created from data of packet */
813 this->parser = parser_create(this->packet->data);
814 if (this->parser == NULL)
815 {
816 this->payloads->destroy(this->payloads);
817 allocator_free(this);
818 return NULL;
819 }
820
821 this->logger = global_logger_manager->create_logger(global_logger_manager, MESSAGE, NULL);
822 if (this->logger == NULL)
823 {
824 this->parser->destroy(this->parser);
825 this->payloads->destroy(this->payloads);
826 allocator_free(this);
827 return NULL;
828 }
829
830 return (&this->public);
831 }
832
833 /*
834 * Described in Header-File
835 */
836 message_t *message_create()
837 {
838 return message_create_from_packet(NULL);
839 }