source: lib/trace.c @ 29bbef0

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivelibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 29bbef0 was 29bbef0, checked in by Richard Sanger <rsangerarj@…>, 7 years ago

My work from over summer, with a few things tidied up and updated to include recent commits/patches to bring this up to date. Still very much work in progress.

  • Property mode set to 100644
File size: 57.6 KB
Line 
1/*
2 * This file is part of libtrace
3 *
4 * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton,
5 * New Zealand.
6 *
7 * Authors: Daniel Lawson
8 *          Perry Lorier
9 *          Shane Alcock
10 *         
11 * All rights reserved.
12 *
13 * This code has been developed by the University of Waikato WAND
14 * research group. For further information please see http://www.wand.net.nz/
15 *
16 * libtrace is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation; either version 2 of the License, or
19 * (at your option) any later version.
20 *
21 * libtrace is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24 * GNU General Public License for more details.
25 *
26 * You should have received a copy of the GNU General Public License
27 * along with libtrace; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
29 *
30 * $Id$
31 *
32 */
33
34
35#define _GNU_SOURCE
36#include "common.h"
37#include "config.h"
38#include <assert.h>
39#include <errno.h>
40#include <fcntl.h>
41#include <stdio.h>
42#include <stdlib.h>
43#include <string.h>
44#include <sys/stat.h>
45#include <sys/types.h>
46#ifndef WIN32
47#include <sys/socket.h>
48#endif
49#include <stdarg.h>
50#include <sys/param.h>
51
52#ifdef HAVE_LIMITS_H
53#  include <limits.h>
54#endif
55
56#ifdef HAVE_SYS_LIMITS_H
57#  include <sys/limits.h>
58#endif
59
60#ifdef HAVE_NET_IF_ARP_H
61#  include <net/if_arp.h>
62#endif
63
64#ifdef HAVE_NET_IF_H
65#  include <net/if.h>
66#endif
67
68#ifdef HAVE_NETINET_IN_H
69#  include <netinet/in.h>
70#endif
71
72#ifdef HAVE_NET_ETHERNET_H
73#  include <net/ethernet.h>
74#endif
75
76#ifdef HAVE_NETINET_IF_ETHER_H
77#  include <netinet/if_ether.h>
78#endif
79
80#include <time.h>
81#ifdef WIN32
82#include <sys/timeb.h>
83#endif
84
85#include "libtrace.h"
86#include "libtrace_int.h"
87
88#ifdef HAVE_PCAP_BPF_H
89#  include <pcap-bpf.h>
90#else
91#  ifdef HAVE_NET_BPF_H
92#    include <net/bpf.h>
93#  endif
94#endif
95
96
97#include "libtrace_int.h"
98#include "format_helper.h"
99#include "rt_protocol.h"
100
101#include <pthread.h>
102#include <signal.h>
103
104#define MAXOPTS 1024
105
106/* This file contains much of the implementation of the libtrace API itself. */
107
108static struct libtrace_format_t *formats_list = NULL;
109
110int libtrace_halt = 0;
111
112/* strncpy is not assured to copy the final \0, so we
113 * will use our own one that does
114 */
115static void xstrncpy(char *dest, const char *src, size_t n)
116{
117        strncpy(dest,src,n);
118        dest[n]='\0';
119}
120 
121static char *xstrndup(const char *src,size_t n)
122{       
123        char *ret=(char*)malloc(n+1);
124        if (ret==NULL) {
125                fprintf(stderr,"Out of memory");
126                exit(EXIT_FAILURE);
127        }
128        xstrncpy(ret,src,n);
129        return ret;
130}
131
132
133/* call all the constructors if they haven't yet all been called */
134static void trace_init(void)
135{
136        if (!formats_list) {
137                duck_constructor();
138                erf_constructor();
139                tsh_constructor();
140                legacy_constructor();
141                atmhdr_constructor();
142                linuxnative_constructor();
143#ifdef HAVE_LIBPCAP
144                pcap_constructor();
145#endif
146                bpf_constructor();
147                pcapfile_constructor();
148                rt_constructor();
149#ifdef HAVE_DAG
150                dag_constructor();
151#endif
152#ifdef HAVE_DPDK
153        dpdk_constructor();
154#endif
155        }
156}
157
158/* Prints help information for libtrace
159 *
160 * Function prints out some basic help information regarding libtrace,
161 * and then prints out the help() function registered with each input module
162 */
163DLLEXPORT void trace_help(void) {
164        struct libtrace_format_t *tmp;
165        trace_init();
166        printf("libtrace %s\n\n",PACKAGE_VERSION);
167        printf("Following this are a list of the format modules supported in this build of libtrace\n\n");
168        for(tmp=formats_list;tmp;tmp=tmp->next) {
169                if (tmp->help)
170                        tmp->help();
171        }
172}
173
174#define URI_PROTO_LINE 16U
175
176/* Try to guess which format module is appropriate for a given trace file or
177 * device */
178static void guess_format(libtrace_t *libtrace, const char *filename)
179{
180        struct libtrace_format_t *tmp;
181       
182        /* Try and guess based on filename */
183        for(tmp = formats_list; tmp; tmp=tmp->next) {
184                if (tmp->probe_filename && tmp->probe_filename(filename)) {
185                        libtrace->format = tmp;
186                        libtrace->uridata = strdup(filename);
187                        return;
188                }
189        }
190
191        libtrace->io = wandio_create(filename);
192        if (!libtrace->io)
193                return;
194
195        /* Try and guess based on file magic */
196        for(tmp = formats_list; tmp; tmp=tmp->next) {
197                if (tmp->probe_magic && tmp->probe_magic(libtrace->io)) {
198                        libtrace->format = tmp;
199                        libtrace->uridata = strdup(filename);
200                        return;
201                }
202        }
203       
204        /* Oh well */
205        return;
206}
207
208/* Creates an input trace from a URI
209 *
210 * @params char * containing a valid libtrace URI
211 * @returns opaque pointer to a libtrace_t
212 *
213 * Some valid URI's are:
214 *  erf:/path/to/erf/file
215 *  erf:/path/to/erf/file.gz
216 *  erf:-                       (stdin)
217 *  dag:/dev/dagcard
218 *  pcapint:pcapinterface               (eg: pcapint:eth0)
219 *  pcapfile:/path/to/pcap/file
220 *  pcapfile:-
221 *  int:interface                       (eg: int:eth0) only on Linux
222 *  rt:hostname
223 *  rt:hostname:port
224 *
225 * If an error occured when attempting to open a trace, NULL is returned
226 * and an error is output to stdout.
227 */
228DLLEXPORT libtrace_t *trace_create(const char *uri) {
229        libtrace_t *libtrace = 
230                        (libtrace_t *)malloc(sizeof(libtrace_t));
231        char *scan = 0;
232        const char *uridata = 0;                 
233
234        trace_init();
235
236        assert(uri && "Passing NULL to trace_create makes me a very sad program");
237
238        if (!libtrace) {
239                /* Out of memory */
240                return NULL;
241        }
242       
243        libtrace->err.err_num = TRACE_ERR_NOERROR;
244        libtrace->format=NULL;
245       
246        libtrace->event.tdelta = 0.0;
247        libtrace->event.packet = NULL;
248        libtrace->event.psize = 0;
249        libtrace->event.trace_last_ts = 0.0;
250        libtrace->event.waiting = false;
251        libtrace->filter = NULL;
252        libtrace->snaplen = 0;
253        libtrace->started=false;
254        libtrace->uridata = NULL;
255        libtrace->io = NULL;
256        libtrace->filtered_packets = 0;
257        libtrace->accepted_packets = 0;
258       
259        /* Parallel inits */
260        // libtrace->libtrace_lock
261        // libtrace->perpkt_cond;
262        libtrace->perpkt_pausing = 0;
263        libtrace->mapper_queue_full = false;
264        libtrace->mappers_finishing = -1;
265        libtrace->reducer_flags = 0;
266        libtrace->joined = false;
267        libtrace->global_blob = NULL;
268        libtrace->per_pkt = NULL;
269        libtrace->reducer = NULL;
270        libtrace->hasher = NULL;
271        libtrace->packet_freelist_size = 0;
272        libtrace->mapper_buffer_size = 0;
273        libtrace->expected_key = 0;
274        libtrace_zero_ringbuffer(&libtrace->packet_freelist);
275        libtrace_zero_thread(&libtrace->hasher_thread);
276        libtrace_zero_thread(&libtrace->reducer_thread);
277        libtrace_zero_slidingwindow(&libtrace->sliding_window);
278        libtrace->reducer_thread.type = THREAD_EMPTY;
279        libtrace->mapper_thread_count = 0;
280        libtrace->mapper_threads = NULL;
281
282        /* Parse the URI to determine what sort of trace we are dealing with */
283        if ((uridata = trace_parse_uri(uri, &scan)) == 0) {
284                /* Could not parse the URI nicely */
285                guess_format(libtrace,uri);
286                if (!libtrace->format) {
287                        trace_set_err(libtrace,TRACE_ERR_BAD_FORMAT,"Unable to guess format (%s)",uri);
288                        return libtrace;
289                }
290        }
291        else {
292                struct libtrace_format_t *tmp;
293
294                /* Find a format that matches the first part of the URI */
295                for (tmp=formats_list;tmp;tmp=tmp->next) {
296                        if (strlen(scan) == strlen(tmp->name) &&
297                                        strncasecmp(scan, tmp->name, strlen(scan)) == 0
298                                        ) {
299                                libtrace->format=tmp;
300                                break;
301                        }
302                }
303
304                if (libtrace->format == 0) {
305                        trace_set_err(libtrace, TRACE_ERR_BAD_FORMAT,
306                                        "Unknown format (%s)",scan);
307                        return libtrace;
308                }
309
310                libtrace->uridata = strdup(uridata);
311        }
312        /* libtrace->format now contains the type of uri
313         * libtrace->uridata contains the appropriate data for this
314         */
315       
316        /* Call the init_input function for the matching capture format */ 
317        if (libtrace->format->init_input) {
318                int err=libtrace->format->init_input(libtrace);
319                assert (err==-1 || err==0);
320                if (err==-1) {
321                        /* init_input should call trace_set_err to set
322                         * the error message
323                         */
324                        return libtrace;
325                }
326        } else {
327                trace_set_err(libtrace,TRACE_ERR_UNSUPPORTED,
328                                "Format does not support input (%s)",scan);
329                return libtrace;
330        }
331       
332        if (scan)
333                free(scan);
334        libtrace->err.err_num=TRACE_ERR_NOERROR;
335        libtrace->err.problem[0]='\0';
336        return libtrace;
337}
338
339/* Creates a "dummy" trace file that has only the format type set.
340 *
341 * @returns opaque pointer to a (sparsely initialised) libtrace_t
342 *
343 * IMPORTANT: Do not attempt to call trace_read_packet or other such functions
344 * with the dummy trace. Its intended purpose is to act as a packet->trace for
345 * libtrace_packet_t's that are not associated with a libtrace_t structure.
346 */
347DLLEXPORT libtrace_t * trace_create_dead (const char *uri) {
348        libtrace_t *libtrace = (libtrace_t *) malloc(sizeof(libtrace_t));
349        char *scan = (char *)calloc(sizeof(char),URI_PROTO_LINE);
350        char *uridata;
351        struct libtrace_format_t *tmp;
352
353        trace_init();
354       
355        libtrace->err.err_num = TRACE_ERR_NOERROR;
356
357        if((uridata = strchr(uri,':')) == NULL) {
358                xstrncpy(scan, uri, strlen(uri));
359        } else {
360                xstrncpy(scan,uri, (size_t)(uridata - uri));
361        }
362       
363        libtrace->err.err_num = TRACE_ERR_NOERROR;
364        libtrace->format=NULL;
365       
366        libtrace->event.tdelta = 0.0;
367        libtrace->event.packet = NULL;
368        libtrace->event.psize = 0;
369        libtrace->event.trace_last_ts = 0.0;
370        libtrace->filter = NULL;
371        libtrace->snaplen = 0;
372        libtrace->started=false;
373        libtrace->uridata = NULL;
374        libtrace->io = NULL;
375        libtrace->filtered_packets = 0;
376       
377        /* Parallel inits */
378        // libtrace->libtrace_lock
379        // libtrace->perpkt_cond;
380        libtrace->perpkt_pausing = 0;
381        libtrace->mapper_queue_full = false;
382        libtrace->mappers_finishing = -1;
383        libtrace->reducer_flags = 0;
384        libtrace->joined = false;
385        libtrace->global_blob = NULL;
386        libtrace->per_pkt = NULL;
387        libtrace->reducer = NULL;
388        libtrace->hasher = NULL;
389        libtrace->expected_key = 0;
390        libtrace->packet_freelist_size = 0;
391        libtrace->mapper_buffer_size = 0;
392        libtrace_zero_ringbuffer(&libtrace->packet_freelist);
393        libtrace_zero_thread(&libtrace->hasher_thread);
394        libtrace_zero_thread(&libtrace->reducer_thread);
395        libtrace_zero_slidingwindow(&libtrace->sliding_window);
396        libtrace->reducer_thread.type = THREAD_EMPTY;
397        libtrace->mapper_thread_count = 0;
398        libtrace->mapper_threads = NULL;
399       
400        for(tmp=formats_list;tmp;tmp=tmp->next) {
401                if (strlen(scan) == strlen(tmp->name) &&
402                                !strncasecmp(scan,
403                                        tmp->name,
404                                        strlen(scan))) {
405                                libtrace->format=tmp;
406                                break;
407                                }
408        }
409        if (libtrace->format == 0) {
410                trace_set_err(libtrace,TRACE_ERR_BAD_FORMAT,
411                                "Unknown format (%s)",scan);
412        }
413
414        libtrace->format_data = NULL;
415        free(scan);
416        return libtrace;
417
418}
419
420/* Creates an output trace from a URI.
421 *
422 * @param uri   the uri string describing the output format and destination
423 * @returns opaque pointer to a libtrace_output_t
424 *
425 *  If an error occured when attempting to open the output trace, NULL is
426 *  returned and trace_errno is set.
427 */
428       
429DLLEXPORT libtrace_out_t *trace_create_output(const char *uri) {
430        libtrace_out_t *libtrace = 
431                        (libtrace_out_t*)malloc(sizeof(libtrace_out_t));
432       
433        char *scan = 0;
434        const char *uridata = 0;
435        struct libtrace_format_t *tmp;
436
437        trace_init();
438
439        libtrace->err.err_num = TRACE_ERR_NOERROR;
440        strcpy(libtrace->err.problem,"Error message set\n");
441        libtrace->format = NULL;
442        libtrace->uridata = NULL;
443       
444        /* Parse the URI to determine what capture format we want to write */
445
446        if ((uridata = trace_parse_uri(uri, &scan)) == 0) {
447                trace_set_err_out(libtrace,TRACE_ERR_BAD_FORMAT,
448                                "Bad uri format (%s)",uri);
449                return libtrace;
450        }
451       
452        /* Attempt to find the format in the list of supported formats */
453        for(tmp=formats_list;tmp;tmp=tmp->next) {
454                if (strlen(scan) == strlen(tmp->name) &&
455                                !strncasecmp(scan,
456                                        tmp->name,
457                                        strlen(scan))) {
458                                libtrace->format=tmp;
459                                break;
460                                }
461        }
462        free(scan);
463
464        if (libtrace->format == NULL) {
465                trace_set_err_out(libtrace,TRACE_ERR_BAD_FORMAT,
466                                "Unknown output format (%s)",scan);
467                return libtrace;
468        }
469        libtrace->uridata = strdup(uridata);
470
471        /* libtrace->format now contains the type of uri
472         * libtrace->uridata contains the appropriate data for this
473         */
474
475        if (libtrace->format->init_output) {
476                /* 0 on success, -1 on failure */
477                switch(libtrace->format->init_output(libtrace)) {
478                        case -1: /* failure */
479                                return libtrace;
480                        case 0: /* success */
481                                break;
482                        default:
483                                assert(!"Internal error: init_output() should return -1 for failure, or 0 for success");
484                }
485        } else {
486                trace_set_err_out(libtrace,TRACE_ERR_UNSUPPORTED,
487                                "Format does not support writing (%s)",scan);
488                return libtrace;
489        }
490
491
492        libtrace->started=false;
493        return libtrace;
494}
495
496/* Start an input trace
497 * @param libtrace      the input trace to start
498 * @returns 0 on success
499 *
500 * This does the work associated with actually starting up
501 * the trace.  it may fail.
502 */
503DLLEXPORT int trace_start(libtrace_t *libtrace)
504{
505        assert(libtrace);
506        if (trace_is_err(libtrace))
507                return -1;
508        if (libtrace->format->start_input) {
509                int ret=libtrace->format->start_input(libtrace);
510                if (ret < 0) {
511                        return ret;
512                }
513        }
514
515        libtrace->started=true;
516        return 0;
517}
518
519/* Start an output trace */
520DLLEXPORT int trace_start_output(libtrace_out_t *libtrace) 
521{
522        assert(libtrace);
523        if (libtrace->format->start_output) {
524                int ret=libtrace->format->start_output(libtrace);
525                if (ret < 0) {
526                        return ret;
527                }
528        }
529
530        libtrace->started=true;
531        return 0;
532}
533
534DLLEXPORT int trace_pause(libtrace_t *libtrace)
535{
536        assert(libtrace);
537        if (!libtrace->started) {
538                trace_set_err(libtrace,TRACE_ERR_BAD_STATE, "You must call trace_start() before calling trace_pause()");
539                return -1;
540        }
541        if (libtrace->format->pause_input)
542                libtrace->format->pause_input(libtrace);
543        libtrace->started=false;
544        return 0;
545}
546
547DLLEXPORT int trace_config(libtrace_t *libtrace,
548                trace_option_t option,
549                void *value)
550{
551        int ret;
552
553        if (trace_is_err(libtrace)) {
554                return -1;
555        }
556       
557        /* If the capture format supports configuration, try using their
558         * native configuration first */
559        if (libtrace->format->config_input) {
560                ret=libtrace->format->config_input(libtrace,option,value);
561                if (ret==0)
562                        return 0;
563        }
564
565        /* If we get here, either the native configuration failed or the
566         * format did not support configuration. However, libtrace can
567         * deal with some options itself, so give that a go */
568        switch(option) {
569                case TRACE_OPTION_SNAPLEN:
570                        /* Clear the error if there was one */
571                        if (trace_is_err(libtrace)) {
572                                trace_get_err(libtrace);
573                        }
574                        if (*(int*)value<0 
575                                || *(int*)value>LIBTRACE_PACKET_BUFSIZE) {
576                                trace_set_err(libtrace,TRACE_ERR_BAD_STATE,
577                                        "Invalid snap length");
578                        }
579                        libtrace->snaplen=*(int*)value;
580                        return 0;
581                case TRACE_OPTION_FILTER:
582                        /* Clear the error if there was one */
583                        if (trace_is_err(libtrace)) {
584                                trace_get_err(libtrace);
585                        }
586                        libtrace->filter=(libtrace_filter_t *)value;
587                        return 0;
588                case TRACE_OPTION_PROMISC:
589                        if (!trace_is_err(libtrace)) {
590                                trace_set_err(libtrace,TRACE_ERR_OPTION_UNAVAIL,
591                                                "Promisc mode is not supported by this format module");
592                        }
593                        return -1;
594                case TRACE_OPTION_META_FREQ:
595                        if (!trace_is_err(libtrace)) {
596                                trace_set_err(libtrace, 
597                                                TRACE_ERR_OPTION_UNAVAIL,
598                                                "This format does not support meta-data gathering");
599                        }
600                        return -1;
601                case TRACE_OPTION_EVENT_REALTIME:
602                        if (!trace_is_err(libtrace)) {
603                                trace_set_err(libtrace, 
604                                                TRACE_ERR_OPTION_UNAVAIL,
605                                                "This format does not support realtime events");
606                        }
607                        return -1;
608                       
609        }
610        if (!trace_is_err(libtrace)) {
611                trace_set_err(libtrace,TRACE_ERR_UNKNOWN_OPTION,
612                        "Unknown option %i", option);
613        }
614        return -1;
615}
616
617DLLEXPORT int trace_config_output(libtrace_out_t *libtrace, 
618                trace_option_output_t option,
619                void *value) {
620       
621        /* Unlike the input options, libtrace does not natively support any of
622         * the output options - the format module must be able to deal with
623         * them. */
624        if (libtrace->format->config_output) {
625                return libtrace->format->config_output(libtrace, option, value);
626        }
627        return -1;
628}
629
630/* Close an input trace file, freeing up any resources it may have been using
631 *
632 */
633DLLEXPORT void trace_destroy(libtrace_t *libtrace) {
634    int i;
635        assert(libtrace);
636        if (libtrace->format) {
637                if (libtrace->started && libtrace->format->pause_input)
638                        libtrace->format->pause_input(libtrace);
639                if (libtrace->format->fin_input)
640                        libtrace->format->fin_input(libtrace);
641        }
642        /* Need to free things! */
643        if (libtrace->uridata)
644                free(libtrace->uridata);
645       
646        /* Empty any packet memory */
647
648        libtrace_packet_t * packet;
649        while (libtrace_ringbuffer_try_read(&libtrace->packet_freelist,(void **) &packet))
650                trace_destroy_packet(packet);
651       
652        libtrace_ringbuffer_destroy(&libtrace->packet_freelist);
653       
654        for (i = 0; i < libtrace->mapper_thread_count; ++i) {
655                        assert (libtrace_vector_get_size(&libtrace->mapper_threads[i].vector) == 0);
656                        libtrace_vector_destroy(&libtrace->mapper_threads[i].vector);
657        }
658        free(libtrace->mapper_threads);
659        libtrace->mapper_threads = NULL;
660        libtrace->mapper_thread_count = 0;
661       
662        if (libtrace->event.packet) {
663                /* Don't use trace_destroy_packet here - there is almost
664                 * certainly going to be another libtrace_packet_t that is
665                 * pointing to the buffer for this packet, so we don't want
666                 * to free it. Rather, it will get freed when the user calls
667                 * trace_destroy_packet on the libtrace_packet_t that they
668                 * own.
669                 *
670                 * All we need to do then is free our packet structure itself.
671                 */
672                 free(libtrace->event.packet);
673        }
674        free(libtrace);
675}
676
677
678DLLEXPORT void trace_destroy_dead(libtrace_t *libtrace) {
679        assert(libtrace);
680
681        /* Don't call pause_input or fin_input, because we should never have
682         * used this trace to do any reading anyway. Do make sure we free
683         * any format_data that has been created, though. */
684        if (libtrace->format_data)
685                free(libtrace->format_data);
686        free(libtrace);
687}
688/* Close an output trace file, freeing up any resources it may have been using
689 *
690 * @param libtrace      the output trace file to be destroyed
691 */
692DLLEXPORT void trace_destroy_output(libtrace_out_t *libtrace) 
693{
694        assert(libtrace);
695        if (libtrace->format && libtrace->format->fin_output)
696                libtrace->format->fin_output(libtrace);
697        if (libtrace->uridata)
698                free(libtrace->uridata);
699        free(libtrace);
700}
701
702DLLEXPORT libtrace_packet_t *trace_create_packet(void) 
703{
704        libtrace_packet_t *packet = 
705                (libtrace_packet_t*)calloc((size_t)1,sizeof(libtrace_packet_t));
706
707        packet->buf_control=TRACE_CTRL_PACKET;
708        trace_clear_cache(packet);
709        return packet;
710}
711
712DLLEXPORT libtrace_packet_t *trace_copy_packet(const libtrace_packet_t *packet) {
713        libtrace_packet_t *dest = 
714                (libtrace_packet_t *)malloc(sizeof(libtrace_packet_t));
715        if (!dest) {
716                printf("Out of memory constructing packet\n");
717                abort();
718        }
719        dest->trace=packet->trace;
720        dest->buffer=malloc(65536);
721        if (!dest->buffer) {
722                printf("Out of memory allocating buffer memory\n");
723                abort();
724        }
725        dest->header=dest->buffer;
726        dest->payload=(void*)
727                ((char*)dest->buffer+trace_get_framing_length(packet));
728        dest->type=packet->type;
729        dest->buf_control=TRACE_CTRL_PACKET;
730        dest->order = packet->order;
731        /* Reset the cache - better to recalculate than try to convert
732         * the values over to the new packet */
733        trace_clear_cache(dest);       
734        /* Ooooh nasty memcpys! This is why we want to avoid copying packets
735         * as much as possible */
736        memcpy(dest->header,packet->header,trace_get_framing_length(packet));
737        memcpy(dest->payload,packet->payload,trace_get_capture_length(packet));
738
739        return dest;
740}
741
742/** Destroy a packet object
743 */
744DLLEXPORT void trace_destroy_packet(libtrace_packet_t *packet) {
745        /* Free any resources possibly associated with the packet */
746        if (packet->trace && packet->trace->format->fin_packet) {
747                packet->trace->format->fin_packet(packet);
748        }
749       
750        if (packet->buf_control == TRACE_CTRL_PACKET && packet->buffer) {
751                free(packet->buffer);
752        }
753        packet->buf_control=(buf_control_t)'\0'; 
754                                /* A "bad" value to force an assert
755                                 * if this packet is ever reused
756                                 */
757        free(packet);
758}       
759
760/**
761 * Removes any possible data stored againt the trace and releases any data.
762 * This will not destroy a reusable good malloc'd buffer (TRACE_CTRL_PACKET)
763 * use trace_destroy_packet() for those diabolical purposes.
764 */
765void trace_fin_packet(libtrace_packet_t *packet);
766void trace_fin_packet(libtrace_packet_t *packet) {
767        if (packet)
768        {
769                if (packet->trace && packet->trace->format->fin_packet) {
770                        packet->trace->format->fin_packet(packet);
771                        //gettimeofday(&tv, NULL);
772                        //printf ("%d.%06d DESTROYED #%"PRIu64"\n", tv.tv_sec, tv.tv_usec, trace_packet_get(packet));
773                }
774
775                // No matter what we remove the header and link pointers
776                packet->trace = NULL;
777                packet->header = NULL;
778                packet->payload = NULL;
779
780                if (packet->buf_control != TRACE_CTRL_PACKET)
781                {
782                        //packet->buf_control = 0; // Invalid value this should be fixed
783                        packet->buffer = NULL;
784                }
785
786                packet->trace = NULL;
787                packet->hash = 0;
788                packet->order = 0;
789                trace_clear_cache(packet);
790        }
791}
792
793/* Read one packet from the trace into buffer. Note that this function will
794 * block until a packet is read (or EOF is reached).
795 *
796 * @param libtrace      the libtrace opaque pointer
797 * @param packet        the packet opaque pointer
798 * @returns 0 on EOF, negative value on error
799 *
800 */
801DLLEXPORT int trace_read_packet(libtrace_t *libtrace, libtrace_packet_t *packet) {
802
803        assert(libtrace && "You called trace_read_packet() with a NULL libtrace parameter!\n");
804        if (trace_is_err(libtrace))
805                return -1;
806        if (!libtrace->started) {
807                trace_set_err(libtrace,TRACE_ERR_BAD_STATE,"You must call libtrace_start() before trace_read_packet()\n");
808                return -1;
809        }
810        if (!(packet->buf_control==TRACE_CTRL_PACKET || packet->buf_control==TRACE_CTRL_EXTERNAL)) {
811                trace_set_err(libtrace,TRACE_ERR_BAD_STATE,"Packet passed to trace_read_packet() is invalid\n");
812                return -1;
813        }
814        assert(packet);
815
816        if (libtrace->format->read_packet) {
817                do {
818                        size_t ret;
819                        /* Finalise the packet, freeing any resources the format module
820                         * may have allocated it and zeroing all data associated with it.
821                         */
822                        trace_fin_packet(packet);
823                        /* Store the trace we are reading from into the packet opaque
824                         * structure */
825                        packet->trace = libtrace;
826                        ret=libtrace->format->read_packet(libtrace,packet);
827                        if (ret==(size_t)-1 || ret==0) {
828                                return ret;
829                        }
830                        if (libtrace->filter) {
831                                /* If the filter doesn't match, read another
832                                 * packet
833                                 */
834                                if (!trace_apply_filter(libtrace->filter,packet)){
835                                        ++libtrace->filtered_packets;
836                                        continue;
837                                }
838                        }
839                        if (libtrace->snaplen>0) {
840                                /* Snap the packet */
841                                trace_set_capture_length(packet,
842                                                libtrace->snaplen);
843                        }
844                        trace_packet_set_order(packet, libtrace->accepted_packets);
845                        ++libtrace->accepted_packets;
846                        return ret;
847                } while(1);
848        }
849        trace_set_err(libtrace,TRACE_ERR_UNSUPPORTED,"This format does not support reading packets\n");
850        return ~0U;
851}
852
853/* Converts the provided buffer into a libtrace packet of the given type.
854 *
855 * Unlike trace_construct_packet, the buffer is expected to begin with the
856 * appropriate capture format header for the format type that the packet is
857 * being converted to. This also allows for a packet to be converted into
858 * just about capture format that is supported by libtrace, provided the
859 * format header is present in the buffer.
860 *
861 * This function is primarily used to convert packets received via the RT
862 * protocol back into their original capture format. The RT header encapsulates
863 * the original capture format header, so after removing it the packet must
864 * have it's header and payload pointers updated and the packet format and type
865 * changed, amongst other things.
866 *
867 * Intended only for internal use at this point - this function is not
868 * available through the external libtrace API.
869 */
870int trace_prepare_packet(libtrace_t *trace, libtrace_packet_t *packet,
871                void *buffer, libtrace_rt_types_t rt_type, uint32_t flags) {
872
873        assert(packet);
874        assert(trace);
875       
876        /* XXX Proper error handling?? */
877        if (buffer == NULL)
878                return -1;
879
880        if (!(packet->buf_control==TRACE_CTRL_PACKET || packet->buf_control==TRACE_CTRL_EXTERNAL)) {
881                trace_set_err(trace,TRACE_ERR_BAD_STATE,"Packet passed to trace_read_packet() is invalid\n");
882                return -1;
883        }
884       
885        packet->trace = trace;
886       
887        /* Clear packet cache */
888        trace_clear_cache(packet);
889
890        if (trace->format->prepare_packet) {
891                return trace->format->prepare_packet(trace, packet,
892                                buffer, rt_type, flags);
893        }
894        trace_set_err(trace, TRACE_ERR_UNSUPPORTED, 
895                        "This format does not support preparing packets\n");
896        return -1;
897
898}
899
900/* Writes a packet to the specified output trace
901 *
902 * @param libtrace      describes the output format, destination, etc.
903 * @param packet        the packet to be written out
904 * @returns the number of bytes written, -1 if write failed
905 */
906DLLEXPORT int trace_write_packet(libtrace_out_t *libtrace, libtrace_packet_t *packet) {
907        assert(libtrace);
908        assert(packet); 
909        /* Verify the packet is valid */
910        if (!libtrace->started) {
911                trace_set_err_out(libtrace,TRACE_ERR_BAD_STATE,
912                        "Trace is not started before trace_write_packet");
913                return -1;
914        }
915
916        if (libtrace->format->write_packet) {
917                return libtrace->format->write_packet(libtrace, packet);
918        }
919        trace_set_err_out(libtrace,TRACE_ERR_UNSUPPORTED,
920                "This format does not support writing packets");
921        return -1;
922}
923
924/* Get a pointer to the first byte of the packet payload */
925DLLEXPORT void *trace_get_packet_buffer(const libtrace_packet_t *packet,
926                libtrace_linktype_t *linktype, uint32_t *remaining) {
927        int cap_len;
928        int wire_len;
929
930        assert(packet != NULL);
931        if (linktype) *linktype = trace_get_link_type(packet);
932        if (remaining) {
933                /* I think we should choose the minimum of the capture and
934                 * wire lengths to be the "remaining" value. If the packet has
935                 * been padded to increase the capture length, we don't want
936                 * to allow subsequent protocol decoders to consider the
937                 * padding as part of the packet.
938                 *
939                 * For example, in Auck 4 there is a trace where the IP header
940                 * length is incorrect (24 bytes) followed by a 20 byte TCP
941                 * header. Total IP length is 40 bytes. As a result, the
942                 * legacyatm padding gets treated as the "missing" bytes of
943                 * the TCP header, which isn't the greatest. We're probably
944                 * better off returning an incomplete TCP header in that case.
945                 */
946               
947                cap_len = trace_get_capture_length(packet);
948                wire_len = trace_get_wire_length(packet);
949
950                assert(cap_len >= 0);
951
952                /* There is the odd corrupt packet, e.g. in IPLS II, that have
953                 * massively negative wire lens. We could assert fail here on
954                 * them, but we could at least try the capture length instead.
955                 *
956                 * You may still run into problems if you try to write that
957                 * packet, but at least reading should work OK.
958                 */
959                if (wire_len < 0)
960                        *remaining = cap_len;
961                else if (wire_len < cap_len)
962                        *remaining = wire_len;
963                else
964                        *remaining = cap_len;
965                /* *remaining = trace_get_capture_length(packet); */
966        }
967        return (void *) packet->payload;
968}
969
970
971/* Get a pointer to the first byte of the packet payload
972 *
973 * DEPRECATED - use trace_get_packet_buffer() instead */
974DLLEXPORT void *trace_get_link(const libtrace_packet_t *packet) {
975        return (void *)packet->payload;
976}
977
978/* Get the current time in DAG time format
979 * @param packet        a pointer to a libtrace_packet structure
980 * @returns a 64 bit timestamp in DAG ERF format (upper 32 bits are the seconds
981 * past 1970-01-01, the lower 32bits are partial seconds)
982 */ 
983DLLEXPORT uint64_t trace_get_erf_timestamp(const libtrace_packet_t *packet) {
984        if (packet->trace->format->get_erf_timestamp) {
985                /* timestamp -> timestamp */
986                return packet->trace->format->get_erf_timestamp(packet);
987        } else if (packet->trace->format->get_timespec) {
988                /* timespec -> timestamp */
989                struct timespec ts;
990                ts = packet->trace->format->get_timespec(packet);
991                return ((((uint64_t)ts.tv_sec) << 32) +
992                                (((uint64_t)ts.tv_nsec << 32)/1000000000));
993        } else if (packet->trace->format->get_timeval) {
994                /* timeval -> timestamp */
995                struct timeval tv;
996                tv = packet->trace->format->get_timeval(packet);
997                return ((((uint64_t)tv.tv_sec) << 32) +
998                                (((uint64_t)tv.tv_usec << 32)/1000000));
999        } else if (packet->trace->format->get_seconds) {
1000                /* seconds -> timestamp */
1001                double seconds = packet->trace->format->get_seconds(packet);
1002                return (((uint64_t)seconds)<<32)
1003                          + (uint64_t)((seconds-(uint64_t)seconds)*UINT_MAX);
1004        }
1005        else {
1006                return (uint64_t)0;
1007        }
1008                     
1009}
1010
1011/* Get the current time in struct timeval
1012 * @param packet        a pointer to a libtrace_packet structure
1013 *
1014 * @returns time that this packet was seen in a struct timeval
1015 * @author Daniel Lawson
1016 * @author Perry Lorier
1017 */ 
1018DLLEXPORT struct timeval trace_get_timeval(const libtrace_packet_t *packet) {
1019        struct timeval tv;
1020        uint64_t ts = 0;
1021        if (packet->trace->format->get_timeval) {
1022                /* timeval -> timeval */
1023                tv = packet->trace->format->get_timeval(packet);
1024        } else if (packet->trace->format->get_erf_timestamp) {
1025                /* timestamp -> timeval */
1026                ts = packet->trace->format->get_erf_timestamp(packet);
1027                tv.tv_sec = ts >> 32;
1028                tv.tv_usec = ((ts&0xFFFFFFFF)*1000000)>>32;
1029                if (tv.tv_usec >= 1000000) {
1030                        tv.tv_usec -= 1000000;
1031                        tv.tv_sec += 1;
1032                }
1033        } else if (packet->trace->format->get_timespec) {
1034                struct timespec ts = packet->trace->format->get_timespec(packet);
1035                tv.tv_sec = ts.tv_sec;
1036                tv.tv_usec = ts.tv_nsec/1000;
1037        } else if (packet->trace->format->get_seconds) {
1038                /* seconds -> timeval */
1039                double seconds = packet->trace->format->get_seconds(packet);
1040                tv.tv_sec = (uint32_t)seconds;
1041                tv.tv_usec = (uint32_t)(((seconds - tv.tv_sec) * 1000000)/UINT_MAX);
1042        }
1043        else {
1044                tv.tv_sec=-1;
1045                tv.tv_usec=-1;
1046        }
1047
1048    return tv;
1049}
1050
1051DLLEXPORT struct timespec trace_get_timespec(const libtrace_packet_t *packet) {
1052        struct timespec ts;
1053
1054        if (packet->trace->format->get_timespec) {
1055                return packet->trace->format->get_timespec(packet);
1056        } else if (packet->trace->format->get_erf_timestamp) {
1057                /* timestamp -> timeval */
1058                uint64_t erfts = packet->trace->format->get_erf_timestamp(packet);
1059                ts.tv_sec = erfts >> 32;
1060                ts.tv_nsec = ((erfts&0xFFFFFFFF)*1000000000)>>32;
1061                if (ts.tv_nsec >= 1000000000) {
1062                        ts.tv_nsec -= 1000000000;
1063                        ts.tv_sec += 1;
1064                }
1065                return ts;
1066        } else if (packet->trace->format->get_timeval) {
1067                /* timeval -> timespec */
1068                struct timeval tv = packet->trace->format->get_timeval(packet);
1069                ts.tv_sec = tv.tv_sec;
1070                ts.tv_nsec = tv.tv_usec*1000;
1071                return ts;
1072        } else if (packet->trace->format->get_seconds) {
1073                /* seconds -> timespec */
1074                double seconds = packet->trace->format->get_seconds(packet);
1075                ts.tv_sec = (uint32_t)seconds;
1076                ts.tv_nsec = (long)(((seconds - ts.tv_sec) * 1000000000)/UINT_MAX);
1077                return ts;
1078        }
1079        else {
1080                ts.tv_sec=-1;
1081                ts.tv_nsec=-1;
1082                return ts;
1083        }
1084}
1085
1086
1087/* Get the current time in floating point seconds
1088 * @param packet        a pointer to a libtrace_packet structure
1089 * @returns time that this packet was seen in 64bit floating point seconds
1090 */ 
1091DLLEXPORT double trace_get_seconds(const libtrace_packet_t *packet) {
1092        double seconds = 0.0;
1093
1094        if (packet->trace->format->get_seconds) {
1095                /* seconds->seconds */
1096                seconds = packet->trace->format->get_seconds(packet);
1097        } else if (packet->trace->format->get_erf_timestamp) {
1098                /* timestamp -> seconds */
1099                uint64_t ts = 0;
1100                ts = packet->trace->format->get_erf_timestamp(packet);
1101                seconds =  (ts>>32) + ((ts & UINT_MAX)*1.0 / UINT_MAX);
1102        } else if (packet->trace->format->get_timespec) {
1103                /* timespec -> seconds */
1104                struct timespec ts;
1105                ts = packet->trace->format->get_timespec(packet);
1106                seconds = ts.tv_sec + ((ts.tv_nsec * 1.0) / 1000000000);
1107        } else if (packet->trace->format->get_timeval) {
1108                /* timeval -> seconds */
1109                struct timeval tv;
1110                tv = packet->trace->format->get_timeval(packet);
1111                seconds = tv.tv_sec + ((tv.tv_usec * 1.0) / 1000000);
1112        }
1113
1114        return seconds;
1115}
1116
1117DLLEXPORT size_t trace_get_capture_length(const libtrace_packet_t *packet) 
1118{
1119        /* Cache the capture length */
1120        if (packet->capture_length == -1) {
1121                if (!packet->trace->format->get_capture_length)
1122                        return ~0U;
1123                /* Cast away constness because this is "just" a cache */
1124                ((libtrace_packet_t*)packet)->capture_length = 
1125                        packet->trace->format->get_capture_length(packet);
1126        }
1127
1128        assert(packet->capture_length < LIBTRACE_PACKET_BUFSIZE);
1129
1130        return packet->capture_length;
1131}
1132       
1133/* Get the size of the packet as it was seen on the wire.
1134 * @param packet        a pointer to a libtrace_packet structure
1135 *
1136 * @returns the size of the packet as it was on the wire.
1137 * @note Due to the trace being a header capture, or anonymisation this may
1138 * not be the same as the Capture Len.
1139 */ 
1140DLLEXPORT size_t trace_get_wire_length(const libtrace_packet_t *packet){
1141       
1142        if (packet->wire_length == -1) {
1143                if (!packet->trace->format->get_wire_length) 
1144                        return ~0U;
1145                ((libtrace_packet_t *)packet)->wire_length = 
1146                        packet->trace->format->get_wire_length(packet);
1147        }
1148
1149        assert(packet->wire_length < LIBTRACE_PACKET_BUFSIZE);
1150        return packet->wire_length;
1151
1152}
1153
1154/* Get the length of the capture framing headers.
1155 * @param packet        the packet opaque pointer
1156 * @returns the size of the packet as it was on the wire.
1157 * @note this length corresponds to the difference between the size of a
1158 * captured packet in memory, and the captured length of the packet
1159 */ 
1160DLLEXPORT SIMPLE_FUNCTION
1161size_t trace_get_framing_length(const libtrace_packet_t *packet) {
1162        if (packet->trace->format->get_framing_length) {
1163                return packet->trace->format->get_framing_length(packet);
1164        }
1165        return ~0U;
1166}
1167
1168
1169/* Get the type of the link layer
1170 * @param packet        a pointer to a libtrace_packet structure
1171 * @returns libtrace_linktype_t
1172 */
1173DLLEXPORT libtrace_linktype_t trace_get_link_type(const libtrace_packet_t *packet ) {
1174
1175        if (packet->link_type == 0) {
1176                if (!packet->trace->format->get_link_type)
1177                        return TRACE_TYPE_UNKNOWN;
1178                ((libtrace_packet_t *)packet)->link_type =
1179                        packet->trace->format->get_link_type(packet);
1180        }
1181
1182        return packet->link_type;
1183}
1184
1185/* process a libtrace event
1186 * @param trace the libtrace opaque pointer
1187 * @param packet the libtrace_packet opaque pointer
1188 * @returns
1189 *  TRACE_EVENT_IOWAIT  Waiting on I/O on fd
1190 *  TRACE_EVENT_SLEEP   Next event in seconds
1191 *  TRACE_EVENT_PACKET  Packet arrived in buffer with size size
1192 *  TRACE_EVENT_TERMINATE Trace terminated (perhaps with an error condition)
1193 * FIXME currently keeps a copy of the packet inside the trace pointer,
1194 * which in turn is stored inside the new packet object...
1195 */
1196DLLEXPORT libtrace_eventobj_t trace_event(libtrace_t *trace, 
1197                libtrace_packet_t *packet) {
1198        libtrace_eventobj_t event = {TRACE_EVENT_IOWAIT,0,0.0,0};
1199
1200        if (!trace) {
1201                fprintf(stderr,"You called trace_event() with a NULL trace object!\n");
1202        }
1203        assert(trace);
1204        assert(packet);
1205
1206        /* Clear the packet cache */
1207        trace_clear_cache(packet);
1208       
1209        /* Store the trace we are reading from into the packet opaque
1210         * structure */
1211        packet->trace = trace;
1212
1213        if (packet->trace->format->trace_event) {
1214                event=packet->trace->format->trace_event(trace,packet);
1215                if (event.type == TRACE_EVENT_PACKET) {
1216                        ++trace->accepted_packets;
1217                }
1218        }
1219        return event;
1220
1221}
1222
1223/** Setup a BPF filter based on pre-compiled byte-code.
1224 * @param bf_insns      A pointer to the start of the byte-code
1225 * @param bf_len        The number of BPF instructions
1226 * @returns             an opaque pointer to a libtrace_filter_t object
1227 * @note                The supplied byte-code is not checked for correctness.
1228 * @author              Scott Raynel
1229 */
1230DLLEXPORT libtrace_filter_t *
1231trace_create_filter_from_bytecode(void *bf_insns, unsigned int bf_len)
1232{
1233#ifndef HAVE_BPF_FILTER
1234        fprintf(stderr, "This version of libtrace does not have BPF support\n");
1235        return NULL;
1236#else
1237        struct libtrace_filter_t *filter = (struct libtrace_filter_t *)
1238                malloc(sizeof(struct libtrace_filter_t));
1239        filter->filter.bf_insns = (struct bpf_insn *)
1240                malloc(sizeof(struct bpf_insn) * bf_len);
1241       
1242        memcpy(filter->filter.bf_insns, bf_insns,
1243                        bf_len * sizeof(struct bpf_insn));
1244       
1245        filter->filter.bf_len = bf_len;
1246        filter->filterstring = NULL;
1247        filter->jitfilter = NULL;
1248        /* "flag" indicates that the filter member is valid */
1249        filter->flag = 1; 
1250       
1251        return filter;
1252#endif
1253}
1254
1255/* Create a BPF filter
1256 * @param filterstring a char * containing the bpf filter string
1257 * @returns opaque pointer pointer to a libtrace_filter_t object
1258 */
1259DLLEXPORT libtrace_filter_t *trace_create_filter(const char *filterstring) {
1260#ifdef HAVE_BPF_FILTER
1261        libtrace_filter_t *filter = (libtrace_filter_t*)
1262                                malloc(sizeof(libtrace_filter_t));
1263        filter->filterstring = strdup(filterstring);
1264        filter->jitfilter = NULL;
1265        filter->flag = 0;
1266        return filter;
1267#else
1268        fprintf(stderr,"This version of libtrace does not have bpf filter support\n");
1269        return NULL;
1270#endif
1271}
1272
1273DLLEXPORT void trace_destroy_filter(libtrace_filter_t *filter)
1274{
1275#ifdef HAVE_BPF_FILTER
1276        free(filter->filterstring);
1277        if (filter->flag)
1278                pcap_freecode(&filter->filter);
1279#ifdef HAVE_LLVM
1280        if (filter->jitfilter) 
1281                destroy_program(filter->jitfilter);
1282#endif
1283        free(filter);
1284#else
1285
1286#endif
1287}
1288
1289/* Compile a bpf filter, now we know the link type for the trace that we're
1290 * applying it to.
1291 *
1292 * @internal
1293 *
1294 * @returns -1 on error, 0 on success
1295 */
1296static int trace_bpf_compile(libtrace_filter_t *filter,
1297                const libtrace_packet_t *packet,
1298                void *linkptr, 
1299                libtrace_linktype_t linktype    ) {
1300#ifdef HAVE_BPF_FILTER
1301        /* It just so happens that the underlying libs used by pthread arn't
1302         * thread safe, namely lex/flex thingys, so single threaded compile
1303         * multi threaded running should be safe.
1304         */
1305        static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
1306        assert(filter);
1307
1308        /* If this isn't a real packet, then fail */
1309        if (!linkptr) {
1310                trace_set_err(packet->trace,
1311                                TRACE_ERR_BAD_FILTER,"Packet has no payload");
1312                return -1;
1313        }
1314       
1315        if (filter->filterstring && ! filter->flag) {
1316                pcap_t *pcap = NULL;
1317                if (linktype==(libtrace_linktype_t)-1) {
1318                        trace_set_err(packet->trace,
1319                                        TRACE_ERR_BAD_FILTER,
1320                                        "Packet has an unknown linktype");
1321                        return -1;
1322                }
1323                if (libtrace_to_pcap_dlt(linktype) == TRACE_DLT_ERROR) {
1324                        trace_set_err(packet->trace,TRACE_ERR_BAD_FILTER,
1325                                        "Unknown pcap equivalent linktype");
1326                        return -1;
1327                }
1328                assert (pthread_mutex_lock(&mutex) == 0);
1329                /* Make sure not one bet us to this */
1330                if (filter->flag) {
1331                        printf("Someone bet us to compile the filter\n");
1332                        assert (pthread_mutex_unlock(&mutex) == 0);
1333                        return 1;
1334                }
1335                pcap=(pcap_t *)pcap_open_dead(
1336                                (int)libtrace_to_pcap_dlt(linktype),
1337                                1500U);
1338                /* build filter */
1339                assert(pcap);
1340                if (pcap_compile( pcap, &filter->filter, filter->filterstring, 
1341                                        1, 0)) {
1342                        trace_set_err(packet->trace,TRACE_ERR_BAD_FILTER,
1343                                        "Unable to compile the filter \"%s\": %s", 
1344                                        filter->filterstring,
1345                                        pcap_geterr(pcap));
1346                        pcap_close(pcap);
1347                        assert (pthread_mutex_unlock(&mutex) == 0);
1348                        return -1;
1349                }
1350                pcap_close(pcap);
1351                filter->flag=1;
1352                assert (pthread_mutex_unlock(&mutex) == 0);
1353        }
1354        return 0;
1355#else
1356        assert(!"Internal bug: This should never be called when BPF not enabled");
1357        trace_set_err(packet->trace,TRACE_ERR_OPTION_UNAVAIL,
1358                                "Feature unavailable");
1359        return -1;
1360#endif
1361}
1362
1363DLLEXPORT int trace_apply_filter(libtrace_filter_t *filter,
1364                        const libtrace_packet_t *packet) {
1365#ifdef HAVE_BPF_FILTER
1366        void *linkptr = 0;
1367        uint32_t clen = 0;
1368        bool free_packet_needed = false;
1369        int ret;
1370        libtrace_linktype_t linktype;
1371        libtrace_packet_t *packet_copy = (libtrace_packet_t*)packet;
1372#ifdef HAVE_LLVM
1373        static pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;
1374#endif
1375
1376        assert(filter);
1377        assert(packet);
1378
1379        /* Match all non-data packets as we probably want them to pass
1380         * through to the caller */
1381        linktype = trace_get_link_type(packet);
1382
1383        if (linktype == TRACE_TYPE_NONDATA)
1384                return 1;       
1385
1386        if (libtrace_to_pcap_dlt(linktype)==TRACE_DLT_ERROR) {
1387               
1388                /* If we cannot get a suitable DLT for the packet, it may
1389                 * be because the packet is encapsulated in a link type that
1390                 * does not correspond to a DLT. Therefore, we should try
1391                 * popping off headers until we either can find a suitable
1392                 * link type or we can't do any more sensible decapsulation. */
1393               
1394                /* Copy the packet, as we don't want to trash the one we
1395                 * were passed in */
1396                packet_copy=trace_copy_packet(packet);
1397                free_packet_needed=true;
1398
1399                while (libtrace_to_pcap_dlt(linktype) == TRACE_DLT_ERROR) {
1400                        if (!demote_packet(packet_copy)) {
1401                                trace_set_err(packet->trace, 
1402                                                TRACE_ERR_NO_CONVERSION,
1403                                                "pcap does not support this format");
1404                                if (free_packet_needed) {
1405                                        trace_destroy_packet(packet_copy);
1406                                }
1407                                return -1;
1408                        }
1409                        linktype = trace_get_link_type(packet_copy);
1410                }
1411
1412        }
1413       
1414        linkptr = trace_get_packet_buffer(packet_copy,NULL,&clen);
1415        if (!linkptr) {
1416                if (free_packet_needed) {
1417                        trace_destroy_packet(packet_copy);
1418                }
1419                return 0;
1420        }
1421
1422        /* We need to compile the filter now, because before we didn't know
1423         * what the link type was
1424         */
1425        // Note internal mutex locking used here
1426        if (trace_bpf_compile(filter,packet_copy,linkptr,linktype)==-1) {
1427                if (free_packet_needed) {
1428                        trace_destroy_packet(packet_copy);
1429                }
1430                return -1;
1431        }
1432
1433        /* If we're jitting, we may need to JIT the BPF code now too */
1434#if HAVE_LLVM
1435        if (!filter->jitfilter) {
1436                assert(pthread_mutex_lock(&mutex) == 0);
1437                /* Again double check here like the bpf filter */
1438                if(filter->jitfilter) 
1439                        printf("Someone bet us to compile the JIT thingy\n");
1440                else
1441                /* Looking at compile_program source this appears to be thread safe
1442                 * however if this gets called twice we will leak this memory :(
1443                 * as such lock here anyways */
1444                        filter->jitfilter = compile_program(filter->filter.bf_insns, filter->filter.bf_len);
1445                assert(pthread_mutex_unlock(&mutex) == 0);
1446        }
1447#endif
1448
1449        assert(filter->flag);
1450        /* Now execute the filter */
1451#if HAVE_LLVM
1452        ret=filter->jitfilter->bpf_run((unsigned char *)linkptr, clen);
1453#else
1454        ret=bpf_filter(filter->filter.bf_insns,(u_char*)linkptr,(unsigned int)clen,(unsigned int)clen);
1455#endif
1456
1457        /* If we copied the packet earlier, make sure that we free it */
1458        if (free_packet_needed) {
1459                trace_destroy_packet(packet_copy);
1460        }
1461        return ret;
1462#else
1463        fprintf(stderr,"This version of libtrace does not have bpf filter support\n");
1464        return 0;
1465#endif
1466}
1467
1468/* Set the direction flag, if it has one
1469 * @param packet the packet opaque pointer
1470 * @param direction the new direction (0,1,2,3)
1471 * @returns a signed value containing the direction flag, or -1 if this is not supported
1472 */
1473DLLEXPORT libtrace_direction_t trace_set_direction(libtrace_packet_t *packet, 
1474                libtrace_direction_t direction) 
1475{
1476        assert(packet);
1477        if (packet->trace->format->set_direction) {
1478                return packet->trace->format->set_direction(packet,direction);
1479        }
1480        return (libtrace_direction_t)~0U;
1481}
1482
1483/* Get the direction flag, if it has one
1484 * @param packet a pointer to a libtrace_packet structure
1485 * @returns a signed value containing the direction flag, or -1 if this is not supported
1486 * The direction is defined as 0 for packets originating locally (ie, outbound)
1487 * and 1 for packets originating remotely (ie, inbound).
1488 * Other values are possible, which might be overloaded to mean special things
1489 * for a special trace.
1490 */
1491DLLEXPORT libtrace_direction_t trace_get_direction(const libtrace_packet_t *packet) 
1492{
1493        assert(packet);
1494        if (packet->trace->format->get_direction) {
1495                return packet->trace->format->get_direction(packet);
1496        }
1497        return (libtrace_direction_t)~0U;
1498}
1499
1500#define ROOT_SERVER(x) ((x) < 512)
1501#define ROOT_CLIENT(x) ((512 <= (x)) && ((x) < 1024))
1502#define NONROOT_SERVER(x) ((x) >= 5000)
1503#define NONROOT_CLIENT(x) ((1024 <= (x)) && ((x) < 5000))
1504#define DYNAMIC(x) ((49152 < (x)) && ((x) < 65535))
1505#define SERVER(x) ROOT_SERVER(x) || NONROOT_SERVER(x)
1506#define CLIENT(x) ROOT_CLIENT(x) || NONROOT_CLIENT(x)
1507
1508/* Attempt to deduce the 'server' port
1509 * @param protocol the IP protocol (eg, 6 or 17 for TCP or UDP)
1510 * @param source the TCP or UDP source port
1511 * @param dest the TCP or UDP destination port
1512 * @returns a hint as to which port is the server port
1513 */
1514DLLEXPORT int8_t trace_get_server_port(UNUSED uint8_t protocol, 
1515                uint16_t source, uint16_t dest) 
1516{
1517        /*
1518         * * If the ports are equal, return DEST
1519         * * Check for well-known ports in the given protocol
1520         * * Root server ports: 0 - 511
1521         * * Root client ports: 512 - 1023
1522         * * non-root client ports: 1024 - 4999
1523         * * non-root server ports: 5000+
1524         * * Check for static ranges: 1024 - 49151
1525         * * Check for dynamic ranges: 49152 - 65535
1526         * * flip a coin.
1527         */
1528       
1529        /* equal */
1530        if (source == dest)
1531                return USE_DEST;
1532
1533        /* root server port, 0 - 511 */
1534        if (ROOT_SERVER(source) && ROOT_SERVER(dest)) {
1535                if (source < dest)
1536                        return USE_SOURCE;
1537                return USE_DEST;
1538        }
1539
1540        if (ROOT_SERVER(source) && !ROOT_SERVER(dest))
1541                return USE_SOURCE;
1542        if (!ROOT_SERVER(source) && ROOT_SERVER(dest))
1543                return USE_DEST;
1544
1545        /* non-root server */
1546        if (NONROOT_SERVER(source) && NONROOT_SERVER(dest)) {
1547                if (source < dest)
1548                        return USE_SOURCE;
1549                return USE_DEST;
1550        }
1551        if (NONROOT_SERVER(source) && !NONROOT_SERVER(dest))
1552                return USE_SOURCE;
1553        if (!NONROOT_SERVER(source) && NONROOT_SERVER(dest))
1554                return USE_DEST;
1555
1556        /* root client */
1557        if (ROOT_CLIENT(source) && ROOT_CLIENT(dest)) {
1558                if (source < dest)
1559                        return USE_SOURCE;
1560                return USE_DEST;
1561        }
1562        if (ROOT_CLIENT(source) && !ROOT_CLIENT(dest)) {
1563                /* prefer root-client over nonroot-client */
1564                if (NONROOT_CLIENT(dest))
1565                        return USE_SOURCE;
1566                return USE_DEST;
1567        }
1568        if (!ROOT_CLIENT(source) && ROOT_CLIENT(dest)) {
1569                /* prefer root-client over nonroot-client */
1570                if (NONROOT_CLIENT(source))
1571                        return USE_DEST;
1572                return USE_SOURCE;
1573        }
1574       
1575        /* nonroot client */
1576        if (NONROOT_CLIENT(source) && NONROOT_CLIENT(dest)) {
1577                if (source < dest) 
1578                        return USE_SOURCE;
1579                return USE_DEST;
1580        }
1581        if (NONROOT_CLIENT(source) && !NONROOT_CLIENT(dest))
1582                return USE_DEST;
1583        if (!NONROOT_CLIENT(source) && NONROOT_CLIENT(dest))
1584                return USE_SOURCE;
1585
1586        /* dynamic range */
1587        if (DYNAMIC(source) && DYNAMIC(dest)) {
1588                if (source < dest)
1589                        return USE_SOURCE;
1590                return USE_DEST;
1591        }
1592        if (DYNAMIC(source) && !DYNAMIC(dest))
1593                return USE_DEST;
1594        if (!DYNAMIC(source) && DYNAMIC(dest))
1595                return USE_SOURCE;
1596        /*
1597        if (SERVER(source) && CLIENT(dest))
1598                return USE_SOURCE;
1599       
1600        if (SERVER(dest) && CLIENT(source))
1601                return USE_DEST;
1602        if (ROOT_SERVER(source) && !ROOT_SERVER(dest))
1603                return USE_SOURCE;
1604        if (ROOT_SERVER(dest) && !ROOT_SERVER(source))
1605                return USE_DEST;
1606        */
1607        /* failing that test... */
1608        if (source < dest) {
1609                return USE_SOURCE;
1610        } 
1611        return USE_DEST;
1612       
1613}
1614
1615/* Truncate the packet at the suggested length
1616 * @param packet        the packet opaque pointer
1617 * @param size          the new length of the packet
1618 * @returns the new size of the packet
1619 * @note size and the return size refer to the network-level payload of the
1620 * packet, and do not include any capture headers. For example, to truncate a
1621 * packet after the IP header, set size to sizeof(ethernet_header) +
1622 * sizeof(ip_header)
1623 * @note If the original network-level payload is smaller than size, then the
1624 * original size is returned and the packet is left unchanged.
1625 */
1626DLLEXPORT size_t trace_set_capture_length(libtrace_packet_t *packet, size_t size) {
1627        assert(packet);
1628
1629        if (packet->trace->format->set_capture_length) {
1630                packet->capture_length = packet->trace->format->set_capture_length(packet,size);
1631                return packet->capture_length;
1632        }
1633
1634        return ~0U;
1635}
1636
1637/* Splits a URI into two components - the format component which is seen before
1638 * the ':', and the uridata which follows the ':'.
1639 *
1640 * Returns a pointer to the URI data, but updates the format parameter to
1641 * point to a copy of the format component.
1642 */
1643
1644DLLEXPORT const char * trace_parse_uri(const char *uri, char **format) {
1645        const char *uridata = 0;
1646       
1647        if((uridata = strchr(uri,':')) == NULL) {
1648                /* Badly formed URI - needs a : */
1649                return 0;
1650        }
1651
1652        if ((unsigned)(uridata - uri) > URI_PROTO_LINE) {
1653                /* Badly formed URI - uri type is too long */
1654                return 0;
1655        }
1656
1657        /* NOTE: this is allocated memory - it should be freed by the caller
1658         * once they are done with it */
1659        *format=xstrndup(uri, (size_t)(uridata - uri));
1660
1661        /* Push uridata past the delimiter */
1662        uridata++;
1663       
1664        return uridata;
1665}
1666
1667enum base_format_t trace_get_format(libtrace_packet_t *packet) 
1668{
1669        assert(packet);
1670
1671        return packet->trace->format->type;
1672}
1673       
1674DLLEXPORT libtrace_err_t trace_get_err(libtrace_t *trace)
1675{
1676        libtrace_err_t err = trace->err;
1677        trace->err.err_num = 0; /* "OK" */
1678        trace->err.problem[0]='\0';
1679        return err;
1680}
1681
1682DLLEXPORT bool trace_is_err(libtrace_t *trace)
1683{
1684        return trace->err.err_num != 0;
1685}
1686
1687/* Prints the input error status to standard error and clears the error state */
1688DLLEXPORT void trace_perror(libtrace_t *trace,const char *msg,...)
1689{
1690        char buf[256];
1691        va_list va;
1692        va_start(va,msg);
1693        vsnprintf(buf,sizeof(buf),msg,va);
1694        va_end(va);
1695        if(trace->err.err_num) {
1696                if (trace->uridata) {
1697                        fprintf(stderr,"%s(%s): %s\n",
1698                                        buf,trace->uridata,trace->err.problem);
1699                } else {
1700                        fprintf(stderr,"%s: %s\n", buf, trace->err.problem);
1701                }
1702        } else {
1703                if (trace->uridata) {
1704                        fprintf(stderr,"%s(%s): No error\n",buf,trace->uridata);
1705                } else {
1706                        fprintf(stderr,"%s: No error\n", buf);
1707                }
1708        }
1709        trace->err.err_num = 0; /* "OK" */
1710        trace->err.problem[0]='\0';
1711}
1712
1713DLLEXPORT libtrace_err_t trace_get_err_output(libtrace_out_t *trace)
1714{
1715        libtrace_err_t err = trace->err;
1716        trace->err.err_num = TRACE_ERR_NOERROR; /* "OK" */
1717        trace->err.problem[0]='\0';
1718        return err;
1719}
1720
1721DLLEXPORT bool trace_is_err_output(libtrace_out_t *trace)
1722{
1723        return trace->err.err_num != 0;
1724}
1725
1726/* Prints the output error status to standard error and clears the error state
1727 */
1728DLLEXPORT void trace_perror_output(libtrace_out_t *trace,const char *msg,...)
1729{
1730        char buf[256];
1731        va_list va;
1732        va_start(va,msg);
1733        vsnprintf(buf,sizeof(buf),msg,va);
1734        va_end(va);
1735        if(trace->err.err_num) {
1736                fprintf(stderr,"%s(%s): %s\n",
1737                                buf,
1738                                trace->uridata?trace->uridata:"no uri",
1739                                trace->err.problem);
1740        } else {
1741                fprintf(stderr,"%s(%s): No error\n",buf,trace->uridata);
1742        }
1743        trace->err.err_num = TRACE_ERR_NOERROR; /* "OK" */
1744        trace->err.problem[0]='\0';
1745}
1746
1747DLLEXPORT int trace_seek_erf_timestamp(libtrace_t *trace, uint64_t ts)
1748{
1749        if (trace->format->seek_erf) {
1750                return trace->format->seek_erf(trace,ts);
1751        }
1752        else {
1753                if (trace->format->seek_timeval) {
1754                        struct timeval tv;
1755#if __BYTE_ORDER == __BIG_ENDIAN
1756                        tv.tv_sec = ts & 0xFFFFFFFF;
1757                        tv.tv_usec = ((ts >> 32) * 1000000) & 0xFFFFFFFF;
1758#elif __BYTE_ORDER == __LITTLE_ENDIAN
1759                        tv.tv_sec = ts >> 32;
1760                        tv.tv_usec = ((ts&0xFFFFFFFF)*1000000)>>32;
1761#else
1762#error "What on earth are you running this on?"
1763#endif
1764                        if (tv.tv_usec >= 1000000) {
1765                                tv.tv_usec -= 1000000;
1766                                tv.tv_sec += 1;
1767                        }
1768                        return trace->format->seek_timeval(trace,tv);
1769                }
1770                if (trace->format->seek_seconds) {
1771                        double seconds = 
1772                                (ts>>32) + ((ts & UINT_MAX)*1.0 / UINT_MAX);
1773                        return trace->format->seek_seconds(trace,seconds);
1774                }
1775                trace_set_err(trace,
1776                                TRACE_ERR_OPTION_UNAVAIL,
1777                                "Feature unimplemented");
1778                return -1;
1779        }
1780}
1781
1782DLLEXPORT int trace_seek_seconds(libtrace_t *trace, double seconds)
1783{
1784        if (trace->format->seek_seconds) {
1785                return trace->format->seek_seconds(trace,seconds);
1786        }
1787        else {
1788                if (trace->format->seek_timeval) {
1789                        struct timeval tv;
1790                        tv.tv_sec = (uint32_t)seconds;
1791                        tv.tv_usec = (uint32_t)(((seconds - tv.tv_sec) * 1000000)/UINT_MAX);
1792                        return trace->format->seek_timeval(trace,tv);
1793                }
1794                if (trace->format->seek_erf) {
1795                        uint64_t timestamp = 
1796                                ((uint64_t)((uint32_t)seconds) << 32) + \
1797                            (uint64_t)(( seconds - (uint32_t)seconds   ) * UINT_MAX);
1798                        return trace->format->seek_erf(trace,timestamp);
1799                }
1800                trace_set_err(trace,
1801                                TRACE_ERR_OPTION_UNAVAIL,
1802                                "Feature unimplemented");
1803                return -1;
1804        }
1805}
1806
1807DLLEXPORT int trace_seek_timeval(libtrace_t *trace, struct timeval tv)
1808{
1809        if (trace->format->seek_timeval) {
1810                return trace->format->seek_timeval(trace,tv);
1811        }
1812        else {
1813                if (trace->format->seek_erf) {
1814                        uint64_t timestamp = ((((uint64_t)tv.tv_sec) << 32) + \
1815                                (((uint64_t)tv.tv_usec * UINT_MAX)/1000000));
1816                        return trace->format->seek_erf(trace,timestamp);
1817                }
1818                if (trace->format->seek_seconds) {
1819                        double seconds = tv.tv_sec + ((tv.tv_usec * 1.0)/1000000);
1820                        return trace->format->seek_seconds(trace,seconds);
1821                }
1822                trace_set_err(trace,
1823                                TRACE_ERR_OPTION_UNAVAIL,
1824                                "Feature unimplemented");
1825                return -1;
1826        }
1827}
1828
1829/* Converts a binary ethernet MAC address into a printable string */
1830DLLEXPORT char *trace_ether_ntoa(const uint8_t *addr, char *buf)
1831{
1832        static char staticbuf[18]={0,};
1833        if (!buf)
1834                buf=staticbuf;
1835        snprintf(buf,(size_t)18,"%02x:%02x:%02x:%02x:%02x:%02x",
1836                        addr[0],addr[1],addr[2],
1837                        addr[3],addr[4],addr[5]);
1838        return buf;
1839}
1840
1841/* Converts a printable ethernet MAC address into a binary format */
1842DLLEXPORT uint8_t *trace_ether_aton(const char *buf, uint8_t *addr)
1843{
1844        uint8_t *buf2 = addr;
1845        unsigned int tmp[6];
1846        static uint8_t staticaddr[6];
1847        if (!buf2)
1848                buf2=staticaddr;
1849        sscanf(buf,"%x:%x:%x:%x:%x:%x",
1850                        &tmp[0],&tmp[1],&tmp[2],
1851                        &tmp[3],&tmp[4],&tmp[5]);
1852        buf2[0]=tmp[0]; buf2[1]=tmp[1]; buf2[2]=tmp[2];
1853        buf2[3]=tmp[3]; buf2[4]=tmp[4]; buf2[5]=tmp[5];
1854        return buf2;
1855}
1856
1857
1858/* Creates a libtrace packet from scratch using the contents of the provided
1859 * buffer as the packet payload.
1860 *
1861 * Unlike trace_prepare_packet(), the buffer should not contain any capture
1862 * format headers; instead this function will add the PCAP header to the
1863 * packet record. This also means only PCAP packets can be constructed using
1864 * this function.
1865 *
1866 */
1867DLLEXPORT
1868void trace_construct_packet(libtrace_packet_t *packet,
1869                libtrace_linktype_t linktype,
1870                const void *data,
1871                uint16_t len)
1872{
1873        size_t size;
1874        static libtrace_t *deadtrace=NULL;
1875        libtrace_pcapfile_pkt_hdr_t hdr;
1876#ifdef WIN32
1877        struct _timeb tstruct;
1878#else
1879        struct timeval tv;
1880#endif
1881
1882        /* We need a trace to attach the constructed packet to (and it needs
1883         * to be PCAP) */
1884        if (NULL == deadtrace) 
1885                deadtrace=trace_create_dead("pcapfile");
1886
1887        /* Fill in the new PCAP header */
1888#ifdef WIN32
1889        _ftime(&tstruct);
1890        hdr.ts_sec=tstruct.time;
1891        hdr.ts_usec=tstruct.millitm * 1000;
1892#else
1893        gettimeofday(&tv,NULL);
1894        hdr.ts_sec=tv.tv_sec;
1895        hdr.ts_usec=tv.tv_usec;
1896#endif
1897
1898        hdr.caplen=len;
1899        hdr.wirelen=len;
1900
1901        /* Now fill in the libtrace packet itself */
1902        packet->trace=deadtrace;
1903        size=len+sizeof(hdr);
1904        if (packet->buf_control==TRACE_CTRL_PACKET) {
1905                packet->buffer=realloc(packet->buffer,size);
1906        }
1907        else {
1908                packet->buffer=malloc(size);
1909        }
1910        packet->buf_control=TRACE_CTRL_PACKET;
1911        packet->header=packet->buffer;
1912        packet->payload=(void*)((char*)packet->buffer+sizeof(hdr));
1913       
1914        /* Ugh, memcpy - sadly necessary */
1915        memcpy(packet->header,&hdr,sizeof(hdr));
1916        memcpy(packet->payload,data,(size_t)len);
1917        packet->type=pcap_linktype_to_rt(libtrace_to_pcap_linktype(linktype));
1918
1919        trace_clear_cache(packet);
1920}
1921
1922
1923uint64_t trace_get_received_packets(libtrace_t *trace)
1924{
1925        assert(trace);
1926        if (trace->format->get_received_packets) {
1927                return trace->format->get_received_packets(trace);
1928        }
1929        return (uint64_t)-1;
1930}
1931
1932uint64_t trace_get_filtered_packets(libtrace_t *trace)
1933{
1934        assert(trace);
1935        if (trace->format->get_filtered_packets) {
1936                return trace->format->get_filtered_packets(trace)+
1937                        trace->filtered_packets;
1938        }
1939        if (trace->format->get_received_packets
1940                && trace->format->get_dropped_packets) {
1941                return 
1942                        ((trace_get_received_packets(trace)
1943                        -trace_get_accepted_packets(trace))
1944                        -trace_get_dropped_packets(trace))
1945                        +trace->filtered_packets;
1946        }
1947        return trace->filtered_packets;
1948}
1949
1950uint64_t trace_get_dropped_packets(libtrace_t *trace)
1951{
1952        assert(trace);
1953        if (trace->format->get_dropped_packets) {
1954                return trace->format->get_dropped_packets(trace);
1955        }
1956        return (uint64_t)-1;
1957}
1958
1959uint64_t trace_get_accepted_packets(libtrace_t *trace)
1960{
1961        assert(trace);
1962        return trace->accepted_packets;
1963}
1964
1965void trace_clear_cache(libtrace_packet_t *packet) {
1966
1967        packet->l2_header = NULL;
1968        packet->l3_header = NULL;
1969        packet->l4_header = NULL;
1970        packet->link_type = 0;
1971        packet->l3_ethertype = 0;
1972        packet->transport_proto = 0;
1973        packet->capture_length = -1;
1974        packet->wire_length = -1;
1975        packet->payload_length = -1;
1976        packet->l2_remaining = 0;
1977        packet->l3_remaining = 0;
1978        packet->l4_remaining = 0;
1979
1980}
1981
1982void trace_interrupt(void) {
1983        libtrace_halt = 1;
1984}
1985
1986void register_format(struct libtrace_format_t *f) {
1987        assert(f->next==NULL); /* Can't register a format twice */
1988        f->next=formats_list;
1989        formats_list=f;
1990
1991        /* Now, verify that the format has at least the minimum functionality.
1992         *
1993         * This #if can be changed to a 1 to output warnings about inconsistent
1994         * functions being provided by format modules.  This generally is very
1995         * noisy, as almost all modules don't implement one or more functions
1996         * for various reasons.  This is very useful when checking a new
1997         * format module is sane.
1998         */ 
1999#if 0
2000        if (f->init_input) {
2001#define REQUIRE(x) \
2002                if (!f->x) \
2003                        fprintf(stderr,"%s: Input format should provide " #x "\n",f->name)
2004                REQUIRE(read_packet);
2005                REQUIRE(start_input);
2006                REQUIRE(fin_input);
2007                REQUIRE(get_link_type);
2008                REQUIRE(get_capture_length);
2009                REQUIRE(get_wire_length);
2010                REQUIRE(get_framing_length);
2011                REQUIRE(trace_event);
2012                if (!f->get_erf_timestamp
2013                        && !f->get_seconds
2014                        && !f->get_timeval) {
2015                        fprintf(stderr,"%s: A trace format capable of input, should provide at least one of\n"
2016"get_erf_timestamp, get_seconds or trace_timeval\n",f->name);
2017                }
2018                if (f->trace_event!=trace_event_trace) {
2019                        /* Theres nothing that a trace file could optimise with
2020                         * config_input
2021                         */
2022                        REQUIRE(pause_input);
2023                        REQUIRE(config_input);
2024                        REQUIRE(get_fd);
2025                }
2026                else {
2027                        if (f->get_fd) {
2028                                fprintf(stderr,"%s: Unnecessary get_fd\n",
2029                                                f->name);
2030                        }
2031                }
2032#undef REQUIRE
2033        }
2034        else {
2035#define REQUIRE(x) \
2036                if (f->x) \
2037                        fprintf(stderr,"%s: Non Input format shouldn't need " #x "\n",f->name)
2038                REQUIRE(read_packet);
2039                REQUIRE(start_input);
2040                REQUIRE(pause_input);
2041                REQUIRE(fin_input);
2042                REQUIRE(get_link_type);
2043                REQUIRE(get_capture_length);
2044                REQUIRE(get_wire_length);
2045                REQUIRE(get_framing_length);
2046                REQUIRE(trace_event);
2047                REQUIRE(get_seconds);
2048                REQUIRE(get_timeval);
2049                REQUIRE(get_erf_timestamp);
2050#undef REQUIRE
2051        }
2052        if (f->init_output) {
2053#define REQUIRE(x) \
2054                if (!f->x) \
2055                        fprintf(stderr,"%s: Output format should provide " #x "\n",f->name)
2056                REQUIRE(write_packet);
2057                REQUIRE(start_output);
2058                REQUIRE(config_output);
2059                REQUIRE(fin_output);
2060#undef REQUIRE
2061        }
2062        else {
2063#define REQUIRE(x) \
2064                if (f->x) \
2065                        fprintf(stderr,"%s: Non Output format shouldn't need " #x "\n",f->name)
2066                REQUIRE(write_packet);
2067                REQUIRE(start_output);
2068                REQUIRE(config_output);
2069                REQUIRE(fin_output);
2070#undef REQUIRE
2071        }
2072#endif
2073}
2074
Note: See TracBrowser for help on using the repository browser.