source: lib/trace.c @ 83445f0

4.0.1-hotfixescachetimestampsdevelopdpdk-ndagetsilivegetfragoffhelplibtrace4ndag_formatpfringrc-4.0.1rc-4.0.2rc-4.0.3rc-4.0.4ringdecrementfixringperformanceringtimestampfixes
Last change on this file since 83445f0 was 83445f0, checked in by Shane Alcock <salcock@…>, 15 years ago

Tidied up some of the documentation
Removed the out-dated trace_get_output_format function

  • Property mode set to 100644
File size: 36.8 KB
Line 
1/*
2 * This file is part of libtrace
3 *
4 * Copyright (c) 2004 The University of Waikato, Hamilton, New Zealand.
5 * Authors: Daniel Lawson
6 *          Perry Lorier
7 *         
8 * All rights reserved.
9 *
10 * This code has been developed by the University of Waikato WAND
11 * research group. For further information please see http://www.wand.net.nz/
12 *
13 * libtrace is free software; you can redistribute it and/or modify
14 * it under the terms of the GNU General Public License as published by
15 * the Free Software Foundation; either version 2 of the License, or
16 * (at your option) any later version.
17 *
18 * libtrace is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21 * GNU General Public License for more details.
22 *
23 * You should have received a copy of the GNU General Public License
24 * along with libtrace; if not, write to the Free Software
25 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
26 *
27 * $Id$
28 *
29 */
30
31
32/* @file
33 *
34 * @brief Trace file processing library
35 *
36 * @author Daniel Lawson
37 * @author Perry Lorier
38 *
39 * @internal
40 */
41#define _GNU_SOURCE
42#include "common.h"
43#include "config.h"
44#include <assert.h>
45#include <errno.h>
46#include <fcntl.h>
47#include <stdio.h>
48#include <stdlib.h>
49#include <string.h>
50#include <sys/stat.h>
51#include <sys/types.h>
52#include <sys/socket.h>
53#include <stdarg.h>
54
55#ifdef HAVE_LIMITS_H
56#  include <limits.h>
57#endif
58
59#ifdef HAVE_SYS_LIMITS_H
60#  include <sys/limits.h>
61#endif
62
63#ifdef HAVE_NET_IF_ARP_H
64#  include <net/if_arp.h>
65#endif
66
67#ifdef HAVE_NET_IF_H
68#  include <net/if.h>
69#endif
70
71#ifdef HAVE_NETINET_IN_H
72#  include <netinet/in.h>
73#endif
74
75#ifdef HAVE_NET_ETHERNET_H
76#  include <net/ethernet.h>
77#endif
78
79#ifdef HAVE_NETINET_IF_ETHER_H
80#  include <netinet/if_ether.h>
81#endif
82
83#include <time.h>
84
85#include "libtrace.h"
86#include "fifo.h"
87#include "libtrace_int.h"
88#include "parse_cmd.h"
89
90#if HAVE_PCAP_BPF_H
91#  include <pcap-bpf.h>
92#else
93#  ifdef HAVE_NET_BPF_H
94#    include <net/bpf.h>
95#  endif
96#endif
97
98#include "libtrace_int.h"
99#include "format_helper.h"
100#include "rt_protocol.h"
101
102#define MAXOPTS 1024
103
104
105static struct libtrace_format_t *formats_list = 0;
106
107/* strncpy is not assured to copy the final \0, so we
108 * will use our own one that does
109 */
110static void xstrncpy(char *dest, const char *src, size_t n)
111{
112        strncpy(dest,src,n);
113        dest[n]='\0';
114}
115 
116static char *xstrndup(const char *src,size_t n)
117{       
118        char *ret=(char*)malloc(n+1);
119        xstrncpy(ret,src,n);
120        return ret;
121}
122
123void register_format(struct libtrace_format_t *f) {
124        assert(f->next==NULL);
125        f->next=formats_list;
126        formats_list=f;
127        /* Now, verify things
128         * This #if can be changed to a 1 to output warnings about inconsistant
129         * functions being provided by format modules.  This generally is very
130         * noisy, as almost all modules don't implement one or more functions
131         * for various reasons.  This is very useful when checking a new
132         * format module is sane.
133         */ 
134#if 0
135        if (f->init_input) {
136#define REQUIRE(x) \
137                if (!f->x) \
138                        fprintf(stderr,"%s: Input format should provide " #x "\n",f->name)
139                REQUIRE(read_packet);
140                REQUIRE(start_input);
141                REQUIRE(fin_input);
142                REQUIRE(get_link_type);
143                REQUIRE(get_capture_length);
144                REQUIRE(get_wire_length);
145                REQUIRE(get_framing_length);
146                REQUIRE(trace_event);
147                if (!f->get_erf_timestamp
148                        && !f->get_seconds
149                        && !f->get_timeval) {
150                        fprintf(stderr,"%s: A trace format capable of input, should provide at least one of\n"
151"get_erf_timestamp, get_seconds or trace_timeval\n",f->name);
152                }
153                if (f->trace_event!=trace_event_trace) {
154                        /* Theres nothing that a trace file could optimise with
155                         * config_input
156                         */
157                        REQUIRE(pause_input);
158                        REQUIRE(config_input);
159                        REQUIRE(get_fd);
160                }
161                else {
162                        if (f->get_fd) {
163                                fprintf(stderr,"%s: Unnecessary get_fd\n",
164                                                f->name);
165                        }
166                }
167#undef REQUIRE
168        }
169        else {
170#define REQUIRE(x) \
171                if (f->x) \
172                        fprintf(stderr,"%s: Non Input format shouldn't need " #x "\n",f->name)
173                REQUIRE(read_packet);
174                REQUIRE(start_input);
175                REQUIRE(pause_input);
176                REQUIRE(fin_input);
177                REQUIRE(get_link_type);
178                REQUIRE(get_capture_length);
179                REQUIRE(get_wire_length);
180                REQUIRE(get_framing_length);
181                REQUIRE(trace_event);
182                REQUIRE(get_seconds);
183                REQUIRE(get_timeval);
184                REQUIRE(get_erf_timestamp);
185#undef REQUIRE
186        }
187        if (f->init_output) {
188#define REQUIRE(x) \
189                if (!f->x) \
190                        fprintf(stderr,"%s: Output format should provide " #x "\n",f->name)
191                REQUIRE(write_packet);
192                REQUIRE(start_output);
193                REQUIRE(config_output);
194                REQUIRE(fin_output);
195#undef REQUIRE
196        }
197        else {
198#define REQUIRE(x) \
199                if (f->x) \
200                        fprintf(stderr,"%s: Non Output format shouldn't need " #x "\n",f->name)
201                REQUIRE(write_packet);
202                REQUIRE(start_output);
203                REQUIRE(config_output);
204                REQUIRE(fin_output);
205#undef REQUIRE
206        }
207#endif
208}
209
210void erf_constructor();
211void legacy_constructor();
212void linuxnative_constructor();
213void pcap_constructor();
214void pcapfile_constructor();
215void rt_constructor();
216void wag_constructor();
217
218/* call all the constructors if they haven't yet all been called */
219void trace_init(void)
220{
221        if (!formats_list) {
222                erf_constructor();
223                legacy_constructor();
224#ifdef HAVE_NETPACKET_PACKET_H
225                linuxnative_constructor();
226#endif
227#ifdef HAVE_PCAP
228                pcap_constructor();
229#endif
230                pcapfile_constructor();
231                rt_constructor();
232                wag_constructor();
233        }
234}
235
236/* Prints help information for libtrace
237 *
238 * Function prints out some basic help information regarding libtrace,
239 * and then prints out the help() function registered with each input module
240 */
241DLLEXPORT void trace_help() {
242        struct libtrace_format_t *tmp;
243        trace_init();
244        printf("libtrace %s\n",PACKAGE_VERSION);
245        for(tmp=formats_list;tmp;tmp=tmp->next) {
246                if (tmp->help)
247                        tmp->help();
248        }
249}
250
251#define RP_BUFSIZE 65536
252#define URI_PROTO_LINE 16
253
254
255/* Create a trace file from a URI
256 *
257 * @params char * containing a valid libtrace URI
258 * @returns opaque pointer to a libtrace_t
259 *
260 * Valid URI's are:
261 *  erf:/path/to/erf/file
262 *  erf:/path/to/erf/file.gz
263 *  erf:/path/to/rtclient/socket
264 *  erf:-                       (stdin)
265 *  dag:/dev/dagcard
266 *  pcapint:pcapinterface               (eg: pcapint:eth0)
267 *  pcap:/path/to/pcap/file
268 *  pcap:-
269 *  rtclient:hostname
270 *  rtclient:hostname:port
271 *  wag:-
272 *  wag:/path/to/wag/file
273 *  wag:/path/to/wag/file.gz
274 *  wag:/path/to/wag/socket
275 *
276 * If an error occured when attempting to open a trace, NULL is returned
277 * and an error is output to stdout.
278 */
279DLLEXPORT libtrace_t *trace_create(const char *uri) {
280        libtrace_t *libtrace = 
281                        (libtrace_t *)malloc(sizeof(libtrace_t));
282        char *scan = 0;
283        const char *uridata = 0;                 
284        struct libtrace_format_t *tmp;
285
286        trace_init();
287
288        assert(uri && "Passing NULL to trace_create makes me a very sad program");
289       
290        libtrace->err.err_num = TRACE_ERR_NOERROR;
291        libtrace->format=NULL;
292       
293        /* parse the URI to determine what sort of event we are dealing with */
294        if ((uridata = trace_parse_uri(uri, &scan)) == 0) {
295                trace_set_err(libtrace,TRACE_ERR_BAD_FORMAT,"Bad uri format (%s)",uri);
296                return libtrace;
297        }
298       
299        libtrace->event.tdelta = 0.0;
300        libtrace->filter = NULL;
301        libtrace->snaplen = 0;
302        libtrace->started=false;
303
304        for (tmp=formats_list;tmp;tmp=tmp->next) {
305                if (strlen(scan) == strlen(tmp->name) &&
306                                strncasecmp(scan, tmp->name, strlen(scan)) == 0
307                                ) {
308                        libtrace->format=tmp;
309                        break;
310                }
311        }
312        if (libtrace->format == 0) {
313                trace_set_err(libtrace, TRACE_ERR_BAD_FORMAT,
314                                "Unknown format (%s)",scan);
315                return libtrace;
316        }
317
318        libtrace->uridata = strdup(uridata);
319        /* libtrace->format now contains the type of uri
320         * libtrace->uridata contains the appropriate data for this
321         */
322       
323        if (libtrace->format->init_input) {
324                int err=libtrace->format->init_input(libtrace);
325                assert (err==-1 || err==0);
326                if (err==-1) {
327                        /* init_input should call trace_set_err to set
328                         * the error message
329                         */
330                        return libtrace;
331                }
332        } else {
333                trace_set_err(libtrace,TRACE_ERR_UNSUPPORTED,
334                                "Format does not support input (%s)",scan);
335                return libtrace;
336        }
337       
338
339        libtrace->fifo = create_tracefifo(1048576);
340        if (!libtrace->fifo) {
341                trace_set_err(libtrace,ENOMEM,"Could not allocate memory for fifo");
342                free(scan);
343                return libtrace;
344        }
345        assert(libtrace->fifo);
346        free(scan);
347        libtrace->err.err_num=TRACE_ERR_NOERROR;
348        libtrace->err.problem[0]='\0';
349        return libtrace;
350}
351
352/* Creates a "dummy" trace file that has only the format type set.
353 *
354 * @returns opaque pointer to a (sparsely initialised) libtrace_t
355 *
356 * IMPORTANT: Do not attempt to call trace_read_packet or other such functions
357 * with the dummy trace. Its intended purpose is to act as a packet->trace for
358 * libtrace_packet_t's that are not associated with a libtrace_t structure.
359 */
360DLLEXPORT libtrace_t * trace_create_dead (const char *uri) {
361        libtrace_t *libtrace = (libtrace_t *) malloc(sizeof(libtrace_t));
362        char *scan = (char *)calloc(sizeof(char),URI_PROTO_LINE);
363        char *uridata;
364        struct libtrace_format_t *tmp;
365       
366        libtrace->err.err_num = TRACE_ERR_NOERROR;
367
368        if((uridata = strchr(uri,':')) == NULL) {
369                xstrncpy(scan, uri, strlen(uri));
370        } else {
371                xstrncpy(scan,uri, (uridata - uri));
372        }
373       
374        libtrace->format = 0;   
375       
376        for(tmp=formats_list;tmp;tmp=tmp->next) {
377                if (strlen(scan) == strlen(tmp->name) &&
378                                !strncasecmp(scan,
379                                        tmp->name,
380                                        strlen(scan))) {
381                                libtrace->format=tmp;
382                                break;
383                                }
384        }
385        if (libtrace->format == 0) {
386                trace_set_err(libtrace,TRACE_ERR_BAD_FORMAT,
387                                "Unknown format (%s)",scan);
388                return 0;
389        }
390
391        libtrace->format_data = NULL;
392        free(scan);
393        return libtrace;
394
395}
396
397/* Creates a trace output file from a URI.
398 *
399 * @param uri   the uri string describing the output format and destination
400 * @returns opaque pointer to a libtrace_output_t
401 *
402 *  If an error occured when attempting to open the output trace, NULL is
403 *  returned and trace_errno is set.
404 */
405       
406DLLEXPORT libtrace_out_t *trace_create_output(const char *uri) {
407        libtrace_out_t *libtrace = 
408                        (libtrace_out_t*)malloc(sizeof(libtrace_out_t));
409       
410        char *scan = 0;
411        const char *uridata = 0;
412        struct libtrace_format_t *tmp;
413
414        trace_init();
415
416        libtrace->err.err_num = TRACE_ERR_NOERROR;
417        strcpy(libtrace->err.problem,"Error message set\n");
418       
419        /* parse the URI to determine what sort of event we are dealing with */
420
421        if ((uridata = trace_parse_uri(uri, &scan)) == 0) {
422                trace_set_err_out(libtrace,TRACE_ERR_BAD_FORMAT,
423                                "Bad uri format (%s)",uri);
424                return libtrace;
425        }
426       
427        libtrace->format = NULL;
428        for(tmp=formats_list;tmp;tmp=tmp->next) {
429                if (strlen(scan) == strlen(tmp->name) &&
430                                !strncasecmp(scan,
431                                        tmp->name,
432                                        strlen(scan))) {
433                                libtrace->format=tmp;
434                                break;
435                                }
436        }
437        if (libtrace->format == NULL) {
438                trace_set_err_out(libtrace,TRACE_ERR_BAD_FORMAT,
439                                "Unknown output format (%s)",scan);
440                return libtrace;
441        }
442        libtrace->uridata = strdup(uridata);
443
444
445        /* libtrace->format now contains the type of uri
446         * libtrace->uridata contains the appropriate data for this
447         */
448
449        if (libtrace->format->init_output) {
450                /* 0 on success, -1 on failure */
451                switch(libtrace->format->init_output(libtrace)) {
452                        case -1: /* failure */
453                                free(libtrace);
454                                return libtrace;
455                        case 0: /* success */
456                                break;
457                        default:
458                                assert(!"init_output() should return -1 for failure, or 0 for success");
459                }
460        } else {
461                trace_set_err_out(libtrace,TRACE_ERR_UNSUPPORTED,
462                                "Format does not support writing (%s)",scan);
463                return libtrace;
464        }
465
466
467        free(scan);
468        libtrace->started=false;
469        return libtrace;
470}
471
472/* Start a trace
473 * @param libtrace      the input trace to start
474 * @returns 0 on success
475 *
476 * This does the work associated with actually starting up
477 * the trace.  it may fail.
478 */
479DLLEXPORT int trace_start(libtrace_t *libtrace)
480{
481        assert(libtrace);
482        if (libtrace->format->start_input) {
483                int ret=libtrace->format->start_input(libtrace);
484                if (ret < 0) {
485                        return ret;
486                }
487        }
488
489        libtrace->started=true;
490        return 0;
491}
492
493DLLEXPORT int trace_start_output(libtrace_out_t *libtrace) 
494{
495        assert(libtrace);
496        if (libtrace->format->start_output) {
497                int ret=libtrace->format->start_output(libtrace);
498                if (ret < 0) {
499                        return ret;
500                }
501        }
502
503        libtrace->started=true;
504        return 0;
505}
506
507DLLEXPORT int trace_pause(libtrace_t *libtrace)
508{
509        assert(libtrace);
510        assert(libtrace->started && "BUG: Called trace_pause without calling trace_start first");
511        if (libtrace->format->pause_input)
512                libtrace->format->pause_input(libtrace);
513        libtrace->started=false;
514        return 0;
515}
516
517DLLEXPORT int trace_config(libtrace_t *libtrace,
518                trace_option_t option,
519                void *value)
520{
521        int ret;
522        if (libtrace->format->config_input) {
523                ret=libtrace->format->config_input(libtrace,option,value);
524                if (ret==0)
525                        return 0;
526        }
527        switch(option) {
528                case TRACE_OPTION_SNAPLEN:
529                        libtrace->snaplen=*(int*)value;
530                        return 0;
531                case TRACE_OPTION_FILTER:
532                        libtrace->filter=(libtrace_filter_t *)value;
533                        return 0;
534                case TRACE_OPTION_PROMISC:
535                        trace_set_err(libtrace,TRACE_ERR_OPTION_UNAVAIL,
536                                "Promisc mode is not supported by this format module");
537                        return -1;
538        }
539        trace_set_err(libtrace,TRACE_ERR_UNKNOWN_OPTION,
540                "Unknown option %i", option);
541        return -1;
542}
543
544/* Parses an output options string and calls the appropriate function to deal with output options.
545 *
546 * @param libtrace      the output trace object to apply the options to
547 * @param options       the options string
548 * @returns -1 if option configuration failed, 0 otherwise
549 *
550 * @author Shane Alcock
551 */
552DLLEXPORT int trace_config_output(libtrace_out_t *libtrace, 
553                trace_option_output_t option,
554                void *value) {
555        if (libtrace->format->config_output) {
556                return libtrace->format->config_output(libtrace, option, value);
557        }
558        return -1;
559}
560
561/* Close a trace file, freeing up any resources it may have been using
562 *
563 */
564DLLEXPORT void trace_destroy(libtrace_t *libtrace) {
565        assert(libtrace);
566        if (libtrace->format) {
567                if (libtrace->started && libtrace->format->pause_input)
568                        libtrace->format->pause_input(libtrace);
569                libtrace->format->fin_input(libtrace);
570        }
571        /* need to free things! */
572        if (libtrace->uridata)
573                free(libtrace->uridata);
574        if (libtrace->fifo)
575                destroy_tracefifo(libtrace->fifo);
576        free(libtrace);
577}
578
579
580DLLEXPORT void trace_destroy_dead(libtrace_t *libtrace) {
581        assert(libtrace);
582        free(libtrace);
583}
584/* Close an output trace file, freeing up any resources it may have been using
585 *
586 * @param libtrace      the output trace file to be destroyed
587 *
588 * @author Shane Alcock
589 * */
590DLLEXPORT void trace_destroy_output(libtrace_out_t *libtrace) {
591        assert(libtrace);
592        libtrace->format->fin_output(libtrace);
593        free(libtrace->uridata);
594        free(libtrace);
595}
596
597DLLEXPORT libtrace_packet_t *trace_create_packet() {
598        libtrace_packet_t *packet = 
599                (libtrace_packet_t*)calloc(1,sizeof(libtrace_packet_t));
600        packet->buf_control=TRACE_CTRL_PACKET;
601        return packet;
602}
603
604DLLEXPORT libtrace_packet_t *trace_copy_packet(const libtrace_packet_t *packet) {
605        libtrace_packet_t *dest = 
606                (libtrace_packet_t *)malloc(sizeof(libtrace_packet_t));
607        dest->trace=packet->trace;
608        dest->buffer=malloc(
609                        trace_get_framing_length(packet)
610                        +trace_get_capture_length(packet));
611        dest->header=dest->buffer;
612        dest->payload=(void*)
613                ((char*)dest->buffer+trace_get_framing_length(packet));
614        dest->size=packet->size;
615        dest->type=packet->type;
616        dest->buf_control=TRACE_CTRL_PACKET;
617        memcpy(dest->header,packet->header,trace_get_framing_length(packet));
618        memcpy(dest->payload,packet->payload,trace_get_capture_length(packet));
619
620        return dest;
621}
622
623/** Destroy a packet object
624 *
625 * sideeffect: sets packet to NULL
626 */
627DLLEXPORT void trace_destroy_packet(libtrace_packet_t **packet) {
628        if ((*packet)->buf_control == TRACE_CTRL_PACKET) {
629                free((*packet)->buffer);
630        }
631        free((*packet));
632        *packet = NULL;
633}       
634
635/* Read one packet from the trace into buffer
636 *
637 * @param libtrace      the libtrace opaque pointer
638 * @param packet        the packet opaque pointer
639 * @returns 0 on EOF, negative value on error
640 *
641 */
642DLLEXPORT int trace_read_packet(libtrace_t *libtrace, libtrace_packet_t *packet) {
643
644        assert(libtrace && "You called trace_read_packet() with a NULL libtrace parameter!\n");
645        assert(libtrace->started && "BUG: You must call libtrace_start() before trace_read_packet()\n");
646        assert(packet);
647        assert((packet->buf_control==TRACE_CTRL_PACKET || packet->buf_control==TRACE_CTRL_EXTERNAL)&&
648                "BUG: You must allocate a packet using packet_create()");
649     
650        /* Store the trace we are reading from into the packet opaque
651         * structure */
652        packet->trace = libtrace;
653
654        if (libtrace->format->read_packet) {
655                do {
656                        packet->size=libtrace->format->read_packet(libtrace,packet);
657                        if (packet->size==(size_t)-1 || packet->size==0) {
658                                return packet->size;
659                        }
660                        if (libtrace->filter) {
661                                /* If the filter doesn't match, read another
662                                 * packet
663                                 */
664                                if (!trace_bpf_filter(libtrace->filter,packet)){
665                                        continue;
666                                }
667                        }
668                        if (libtrace->snaplen>0) {
669                                /* Snap the packet */
670                                trace_set_capture_length(packet,
671                                                libtrace->snaplen);
672                        }
673                        return packet->size;
674                } while(1);
675        }
676        trace_set_err(libtrace,TRACE_ERR_UNSUPPORTED,"This format does not support reading packets\n");
677        packet->size=-1;
678        return -1;
679}
680
681/* Writes a packet to the specified output
682 *
683 * @param libtrace      describes the output format, destination, etc.
684 * @param packet        the packet to be written out
685 * @returns the number of bytes written, -1 if write failed
686 *
687 * @author Shane Alcock
688 * */
689DLLEXPORT int trace_write_packet(libtrace_out_t *libtrace, const libtrace_packet_t *packet) {
690        assert(libtrace);
691        assert(packet); 
692        /* Verify the packet is valid */
693        assert(packet->size<65536);
694        assert(packet->size>0);
695        assert(libtrace->started);
696
697        if (libtrace->format->write_packet) {
698                return libtrace->format->write_packet(libtrace, packet);
699        }
700        return -1;
701}
702
703DLLEXPORT void *trace_get_link(const libtrace_packet_t *packet) {
704        return (void *)packet->payload;
705}
706
707/*
708typedef struct legacy_framing {
709        uint64_t        ts;
710        uint32_t        crc;
711        uint32_t        header;
712        uint32_t        data[12]; // pad to 64 bytes
713} legacy_framing_t;
714*/
715
716
717/* Get the current time in DAG time format
718 * @param packet        a pointer to a libtrace_packet structure
719 * @returns a 64 bit timestamp in DAG ERF format (upper 32 bits are the seconds
720 * past 1970-01-01, the lower 32bits are partial seconds)
721 * @author Daniel Lawson
722 */ 
723DLLEXPORT uint64_t trace_get_erf_timestamp(const libtrace_packet_t *packet) {
724        uint64_t timestamp = 0;
725        double seconds = 0.0;
726        struct timeval ts;
727
728        assert(packet->size>0 && packet->size<65536);
729
730        if (packet->trace->format->get_erf_timestamp) {
731                /* timestamp -> timestamp */
732                timestamp = packet->trace->format->get_erf_timestamp(packet);
733        } else if (packet->trace->format->get_timeval) {
734                /* timeval -> timestamp */
735                ts = packet->trace->format->get_timeval(packet);
736                timestamp = ((((uint64_t)ts.tv_sec) << 32) + \
737                                (((uint64_t)ts.tv_usec * UINT_MAX)/1000000));
738        } else if (packet->trace->format->get_seconds) {
739                /* seconds -> timestamp */
740                seconds = packet->trace->format->get_seconds(packet);
741                timestamp = ((uint64_t)((uint32_t)seconds) << 32) + \
742                      (uint64_t)(( seconds - (uint32_t)seconds   ) * UINT_MAX);
743        }
744        return timestamp;
745}
746
747/* Get the current time in struct timeval
748 * @param packet        a pointer to a libtrace_packet structure
749 *
750 * @returns time that this packet was seen in a struct timeval
751 * @author Daniel Lawson
752 * @author Perry Lorier
753 */ 
754DLLEXPORT struct timeval trace_get_timeval(const libtrace_packet_t *packet) {
755        struct timeval tv;
756        uint64_t ts = 0;
757        double seconds = 0.0;
758        assert(packet->size>0 && packet->size<65536);
759        if (packet->trace->format->get_timeval) {
760                /* timeval -> timeval */
761                tv = packet->trace->format->get_timeval(packet);
762        } else if (packet->trace->format->get_erf_timestamp) {
763                /* timestamp -> timeval */
764                ts = packet->trace->format->get_erf_timestamp(packet);
765#if __BYTE_ORDER == __BIG_ENDIAN
766                tv.tv_sec = ts & 0xFFFFFFFF;
767#elif __BYTE_ORDER == __LITTLE_ENDIAN
768                tv.tv_sec = ts >> 32;
769#else
770#error "What on earth are you running this on?"
771#endif
772                tv.tv_usec = ((ts&0xFFFFFFFF)*1000000)>>32;
773                if (tv.tv_usec >= 1000000) {
774                        tv.tv_usec -= 1000000;
775                        tv.tv_sec += 1;
776                }
777        } else if (packet->trace->format->get_seconds) {
778                /* seconds -> timeval */
779                seconds = packet->trace->format->get_seconds(packet);
780                tv.tv_sec = (uint32_t)seconds;
781                tv.tv_usec = (uint32_t)(((seconds - tv.tv_sec) * 1000000)/UINT_MAX);
782        }
783
784        return tv;
785}
786
787/* Get the current time in floating point seconds
788 * @param packet        a pointer to a libtrace_packet structure
789 * @returns time that this packet was seen in 64bit floating point seconds
790 * @author Perry Lorier
791 */ 
792DLLEXPORT double trace_get_seconds(const libtrace_packet_t *packet) {
793        double seconds = 0.0;
794        uint64_t ts = 0;
795        struct timeval tv;
796
797        assert(packet->size>0 && packet->size<65536);
798       
799        if (packet->trace->format->get_seconds) {
800                /* seconds->seconds */
801                seconds = packet->trace->format->get_seconds(packet);
802        } else if (packet->trace->format->get_erf_timestamp) {
803                /* timestamp -> seconds */
804                ts = packet->trace->format->get_erf_timestamp(packet);
805                seconds =  (ts>>32) + ((ts & UINT_MAX)*1.0 / UINT_MAX);
806        } else if (packet->trace->format->get_timeval) {
807                /* timeval -> seconds */
808                tv = packet->trace->format->get_timeval(packet);
809                seconds = tv.tv_sec + ((tv.tv_usec * 1.0) / 1000000);
810        }
811
812        return seconds;
813}
814
815DLLEXPORT size_t trace_get_capture_length(const libtrace_packet_t *packet) {
816
817        assert(packet->size<65536);
818
819        if (packet->trace->format->get_capture_length) {
820                return packet->trace->format->get_capture_length(packet);
821        }
822        return -1;
823}
824       
825/* Get the size of the packet as it was seen on the wire.
826 * @param packet        a pointer to a libtrace_packet structure
827 *
828 * @returns the size of the packet as it was on the wire.
829 * @author Perry Lorier
830 * @author Daniel Lawson
831 * @note Due to the trace being a header capture, or anonymisation this may
832 * not be the same as the Capture Len.
833 */ 
834DLLEXPORT size_t trace_get_wire_length(const libtrace_packet_t *packet){
835        assert(packet->size>0 && packet->size<65536);
836
837        if (packet->trace->format->get_wire_length) {
838                return packet->trace->format->get_wire_length(packet);
839        }
840        return -1;
841
842}
843
844/* Get the length of the capture framing headers.
845 * @param packet        the packet opaque pointer
846 * @returns the size of the packet as it was on the wire.
847 * @author Perry Lorier
848 * @author Daniel Lawson
849 * @note this length corresponds to the difference between the size of a
850 * captured packet in memory, and the captured length of the packet
851 */ 
852DLLEXPORT SIMPLE_FUNCTION
853size_t trace_get_framing_length(const libtrace_packet_t *packet) {
854        if (packet->trace->format->get_framing_length) {
855                return packet->trace->format->get_framing_length(packet);
856        }
857        return -1;
858}
859
860
861/* Get the type of the link layer
862 * @param packet        a pointer to a libtrace_packet structure
863 * @returns libtrace_linktype_t
864 * @author Perry Lorier
865 * @author Daniel Lawson
866 */
867DLLEXPORT libtrace_linktype_t trace_get_link_type(const libtrace_packet_t *packet ) {
868        if (packet->trace->format->get_link_type) {
869                return packet->trace->format->get_link_type(packet);
870        }
871        return (libtrace_linktype_t)-1;
872}
873
874/* process a libtrace event
875 * @param trace the libtrace opaque pointer
876 * @param packet the libtrace_packet opaque pointer
877 * @returns
878 *  TRACE_EVENT_IOWAIT  Waiting on I/O on fd
879 *  TRACE_EVENT_SLEEP   Next event in seconds
880 *  TRACE_EVENT_PACKET  Packet arrived in buffer with size size
881 *  TRACE_EVENT_TERMINATE Trace terminated (perhaps with an error condition)
882 * FIXME currently keeps a copy of the packet inside the trace pointer,
883 * which in turn is stored inside the new packet object...
884 * @author Perry Lorier
885 */
886DLLEXPORT libtrace_eventobj_t trace_event(libtrace_t *trace, 
887                libtrace_packet_t *packet) {
888        libtrace_eventobj_t event = {TRACE_EVENT_IOWAIT,0,0.0,0};
889
890        if (!trace) {
891                fprintf(stderr,"You called trace_event() with a NULL trace object!\n");
892        }
893        assert(trace);
894        assert(packet);
895
896        /* Store the trace we are reading from into the packet opaque
897         * structure */
898        packet->trace = trace;
899
900        if (packet->trace->format->trace_event) {
901                return packet->trace->format->trace_event(trace,packet);
902        } else {
903                return event;
904        }
905
906}
907
908/* setup a BPF filter
909 * @param filterstring a char * containing the bpf filter string
910 * @returns opaque pointer pointer to a libtrace_filter_t object
911 * @author Daniel Lawson
912 */
913DLLEXPORT libtrace_filter_t *trace_bpf_setfilter(const char *filterstring) {
914#if HAVE_BPF
915        libtrace_filter_t *filter = (libtrace_filter_t*)
916                                malloc(sizeof(libtrace_filter_t));
917        filter->filterstring = strdup(filterstring);
918        filter->flag = 0;
919        return filter;
920#else
921        fprintf(stderr,"This version of libtrace does not have bpf filter support\n");
922        return NULL;
923#endif
924}
925
926DLLEXPORT void trace_destroy_bpf(libtrace_filter_t *filter)
927{
928#if HAVE_BPF
929        free(filter->filterstring);
930        if (filter->flag)
931                pcap_freecode(&filter->filter);
932        free(filter);
933#else
934
935#endif
936}
937
938/* compile a bpf filter, now we know what trace it's on
939 * @internal
940 *
941 * @returns -1 on error, 0 on success
942 */
943int trace_bpf_compile(libtrace_filter_t *filter,
944                const libtrace_packet_t *packet ) {
945#if HAVE_BPF
946        void *linkptr = 0;
947        assert(filter);
948
949        /* If this isn't a real packet, then fail */
950        linkptr = trace_get_link(packet);
951        if (!linkptr) {
952                trace_set_err(packet->trace,
953                                TRACE_ERR_BAD_PACKET,"Packet has no payload");
954                return -1;
955        }
956       
957        if (filter->filterstring && ! filter->flag) {
958                pcap_t *pcap;
959                libtrace_linktype_t linktype=trace_get_link_type(packet);
960                if (linktype==(libtrace_linktype_t)-1) {
961                        trace_set_err(packet->trace,TRACE_ERR_BAD_PACKET,
962                                        "Packet has an unknown linktype");
963                        return -1;
964                }
965                if (libtrace_to_pcap_dlt(linktype) == -1) {
966                        trace_set_err(packet->trace,TRACE_ERR_BAD_PACKET,
967                                        "Unknown pcap equivilent linktype");
968                        return -1;
969                }
970                pcap=(pcap_t *)pcap_open_dead(
971                                libtrace_to_pcap_dlt(linktype),
972                                1500);
973                /* build filter */
974                if (pcap_compile( pcap, &filter->filter, filter->filterstring, 
975                                        1, 0)) {
976                        pcap_close(pcap);
977                        trace_set_err(packet->trace,TRACE_ERR_BAD_PACKET,
978                                        "Packet has no payload");
979                        return -1;
980                }
981                pcap_close(pcap);
982                filter->flag=1;
983        }
984        return 0;
985#else
986        assert(!"This should never be called when BPF not enabled");
987        trace_set_err(packet->trace,TRACE_ERR_OPTION_UNAVAIL,
988                                "Feature unavailable");
989        return -1;
990#endif
991}
992
993DLLEXPORT int trace_bpf_filter(libtrace_filter_t *filter,
994                        const libtrace_packet_t *packet) {
995#if HAVE_BPF
996        void *linkptr = 0;
997        int clen = 0;
998        assert(filter);
999        assert(packet);
1000        linkptr = trace_get_link(packet);
1001        if (!linkptr) {
1002                return 0;
1003        }
1004
1005        /* We need to compile it now, because before we didn't know what the
1006         * link type was
1007         */
1008        if (trace_bpf_compile(filter,packet)==-1)
1009                return -1;
1010       
1011        clen = trace_get_capture_length(packet);
1012
1013        assert(filter->flag);
1014        return bpf_filter(filter->filter.bf_insns, linkptr, clen, clen);
1015#else
1016        fprintf(stderr,"This version of libtrace does not have bpf filter support\n");
1017        return 0;
1018#endif
1019}
1020
1021/* Set the direction flag, if it has one
1022 * @param packet the packet opaque pointer
1023 * @param direction the new direction (0,1,2,3)
1024 * @returns a signed value containing the direction flag, or -1 if this is not supported
1025 */
1026DLLEXPORT libtrace_direction_t trace_set_direction(libtrace_packet_t *packet, 
1027                libtrace_direction_t direction) 
1028{
1029        assert(packet);
1030        assert(packet->size>0 && packet->size<65536);
1031        if (packet->trace->format->set_direction) {
1032                return packet->trace->format->set_direction(packet,direction);
1033        }
1034        return -1;
1035}
1036
1037/* Get the direction flag, if it has one
1038 * @param packet a pointer to a libtrace_packet structure
1039 * @returns a signed value containing the direction flag, or -1 if this is not supported
1040 * The direction is defined as 0 for packets originating locally (ie, outbound)
1041 * and 1 for packets originating remotely (ie, inbound).
1042 * Other values are possible, which might be overloaded to mean special things
1043 * for a special trace.
1044 * @author Daniel Lawson
1045 */
1046DLLEXPORT libtrace_direction_t trace_get_direction(const libtrace_packet_t *packet) 
1047{
1048        assert(packet);
1049        assert(packet->size>0 && packet->size<65536);
1050        if (packet->trace->format->get_direction) {
1051                return packet->trace->format->get_direction(packet);
1052        }
1053        return -1;
1054}
1055
1056#define ROOT_SERVER(x) ((x) < 512)
1057#define ROOT_CLIENT(x) ((512 <= (x)) && ((x) < 1024))
1058#define NONROOT_SERVER(x) ((x) >= 5000)
1059#define NONROOT_CLIENT(x) ((1024 <= (x)) && ((x) < 5000))
1060#define DYNAMIC(x) ((49152 < (x)) && ((x) < 65535))
1061#define SERVER(x) ROOT_SERVER(x) || NONROOT_SERVER(x)
1062#define CLIENT(x) ROOT_CLIENT(x) || NONROOT_CLIENT(x)
1063
1064/* Attempt to deduce the 'server' port
1065 * @param protocol the IP protocol (eg, 6 or 17 for TCP or UDP)
1066 * @param source the TCP or UDP source port
1067 * @param dest the TCP or UDP destination port
1068 * @returns a hint as to which port is the server port
1069 * @author Daniel Lawson
1070 */
1071DLLEXPORT int8_t trace_get_server_port(uint8_t protocol UNUSED, uint16_t source, uint16_t dest) {
1072        /*
1073         * * If the ports are equal, return DEST
1074         * * Check for well-known ports in the given protocol
1075         * * Root server ports: 0 - 511
1076         * * Root client ports: 512 - 1023
1077         * * non-root client ports: 1024 - 4999
1078         * * non-root server ports: 5000+
1079         * * Check for static ranges: 1024 - 49151
1080         * * Check for dynamic ranges: 49152 - 65535
1081         * * flip a coin.
1082         */
1083       
1084        /* equal */
1085        if (source == dest)
1086                return USE_DEST;
1087
1088        /* root server port, 0 - 511 */
1089        if (ROOT_SERVER(source) && ROOT_SERVER(dest)) {
1090                if (source < dest)
1091                        return USE_SOURCE;
1092                return USE_DEST;
1093        }
1094
1095        if (ROOT_SERVER(source) && !ROOT_SERVER(dest))
1096                return USE_SOURCE;
1097        if (!ROOT_SERVER(source) && ROOT_SERVER(dest))
1098                return USE_DEST;
1099
1100        /* non-root server */
1101        if (NONROOT_SERVER(source) && NONROOT_SERVER(dest)) {
1102                if (source < dest)
1103                        return USE_SOURCE;
1104                return USE_DEST;
1105        }
1106        if (NONROOT_SERVER(source) && !NONROOT_SERVER(dest))
1107                return USE_SOURCE;
1108        if (!NONROOT_SERVER(source) && NONROOT_SERVER(dest))
1109                return USE_DEST;
1110
1111        /* root client */
1112        if (ROOT_CLIENT(source) && ROOT_CLIENT(dest)) {
1113                if (source < dest)
1114                        return USE_SOURCE;
1115                return USE_DEST;
1116        }
1117        if (ROOT_CLIENT(source) && !ROOT_CLIENT(dest)) {
1118                /* prefer root-client over nonroot-client */
1119                if (NONROOT_CLIENT(dest))
1120                        return USE_SOURCE;
1121                return USE_DEST;
1122        }
1123        if (!ROOT_CLIENT(source) && ROOT_CLIENT(dest)) {
1124                /* prefer root-client over nonroot-client */
1125                if (NONROOT_CLIENT(source))
1126                        return USE_DEST;
1127                return USE_SOURCE;
1128        }
1129       
1130        /* nonroot client */
1131        if (NONROOT_CLIENT(source) && NONROOT_CLIENT(dest)) {
1132                if (source < dest) 
1133                        return USE_SOURCE;
1134                return USE_DEST;
1135        }
1136        if (NONROOT_CLIENT(source) && !NONROOT_CLIENT(dest))
1137                return USE_DEST;
1138        if (!NONROOT_CLIENT(source) && NONROOT_CLIENT(dest))
1139                return USE_SOURCE;
1140
1141        /* dynamic range */
1142        if (DYNAMIC(source) && DYNAMIC(dest))
1143                if (source < dest)
1144                        return USE_SOURCE;
1145                return USE_DEST;
1146        if (DYNAMIC(source) && !DYNAMIC(dest))
1147                return USE_DEST;
1148        if (!DYNAMIC(source) && DYNAMIC(dest))
1149                return USE_SOURCE;
1150        /*
1151        if (SERVER(source) && CLIENT(dest))
1152                return USE_SOURCE;
1153       
1154        if (SERVER(dest) && CLIENT(source))
1155                return USE_DEST;
1156        if (ROOT_SERVER(source) && !ROOT_SERVER(dest))
1157                return USE_SOURCE;
1158        if (ROOT_SERVER(dest) && !ROOT_SERVER(source))
1159                return USE_DEST;
1160        */
1161        /* failing that test... */
1162        if (source < dest) {
1163                return USE_SOURCE;
1164        } 
1165        return USE_DEST;
1166       
1167}
1168
1169/* Truncate the packet at the suggested length
1170 * @param packet        the packet opaque pointer
1171 * @param size          the new length of the packet
1172 * @returns the new size of the packet
1173 * @note size and the return size refer to the network-level payload of the
1174 * packet, and do not include any capture headers. For example, to truncate a
1175 * packet after the IP header, set size to sizeof(ethernet_header) +
1176 * sizeof(ip_header)
1177 * @note If the original network-level payload is smaller than size, then the
1178 * original size is returned and the packet is left unchanged.
1179 * @author Daniel Lawson
1180 */
1181DLLEXPORT size_t trace_set_capture_length(libtrace_packet_t *packet, size_t size) {
1182        assert(packet);
1183        assert(packet->size>0 && packet->size<65536);
1184
1185        if (packet->trace->format->set_capture_length) {
1186                int caplen=packet->trace->format->set_capture_length(packet,size);
1187                if (caplen!=-1) {
1188                        packet->size=trace_get_framing_length(packet)+caplen;
1189                }
1190                return caplen;
1191        }
1192
1193        return -1;
1194}
1195
1196DLLEXPORT const char * trace_parse_uri(const char *uri, char **format) {
1197        const char *uridata = 0;
1198       
1199        if((uridata = strchr(uri,':')) == NULL) {
1200                /* badly formed URI - needs a : */
1201                return 0;
1202        }
1203
1204        if ((uridata - uri) > URI_PROTO_LINE) {
1205                /* badly formed URI - uri type is too long */
1206                return 0;
1207        }
1208
1209        *format=xstrndup(uri, (uridata - uri));
1210
1211        /* push uridata past the delimiter */
1212        uridata++;
1213       
1214        return uridata;
1215}
1216
1217enum base_format_t trace_get_format(libtrace_packet_t *packet) 
1218{
1219        assert(packet);
1220
1221        return packet->trace->format->type;
1222}
1223       
1224DLLEXPORT libtrace_err_t trace_get_err(libtrace_t *trace)
1225{
1226        libtrace_err_t err = trace->err;
1227        trace->err.err_num = 0; /* "OK" */
1228        trace->err.problem[0]='\0';
1229        return err;
1230}
1231
1232DLLEXPORT bool trace_is_err(libtrace_t *trace)
1233{
1234        return trace->err.err_num != 0;
1235}
1236
1237DLLEXPORT void trace_perror(libtrace_t *trace,const char *msg,...)
1238{
1239        char buf[256];
1240        va_list va;
1241        va_start(va,msg);
1242        vsnprintf(buf,sizeof(buf),msg,va);
1243        va_end(va);
1244        if(trace->err.err_num) {
1245                fprintf(stderr,"%s(%s): %s\n",
1246                                buf,trace->uridata,trace->err.problem);
1247        } else {
1248                fprintf(stderr,"%s(%s): No error\n",
1249                                buf,trace->uridata);
1250        }
1251        trace->err.err_num = 0; /* "OK" */
1252        trace->err.problem[0]='\0';
1253}
1254
1255DLLEXPORT libtrace_err_t trace_get_err_output(libtrace_out_t *trace)
1256{
1257        libtrace_err_t err = trace->err;
1258        trace->err.err_num = TRACE_ERR_NOERROR; /* "OK" */
1259        trace->err.problem[0]='\0';
1260        return err;
1261}
1262
1263DLLEXPORT bool trace_is_err_output(libtrace_out_t *trace)
1264{
1265        return trace->err.err_num != 0;
1266}
1267
1268DLLEXPORT void trace_perror_output(libtrace_out_t *trace,const char *msg,...)
1269{
1270        char buf[256];
1271        va_list va;
1272        va_start(va,msg);
1273        vsnprintf(buf,sizeof(buf),msg,va);
1274        va_end(va);
1275        if(trace->err.err_num) {
1276                fprintf(stderr,"%s(%s): %s\n",
1277                                buf,trace->uridata,trace->err.problem);
1278        } else {
1279                fprintf(stderr,"%s(%s): No error\n",buf,trace->uridata);
1280        }
1281}
1282
1283DLLEXPORT int trace_seek_erf_timestamp(libtrace_t *trace, uint64_t ts)
1284{
1285        if (trace->format->seek_erf) {
1286                return trace->format->seek_erf(trace,ts);
1287        }
1288        else {
1289                if (trace->format->seek_timeval) {
1290                        struct timeval tv;
1291#if __BYTE_ORDER == __BIG_ENDIAN
1292                        tv.tv_sec = ts & 0xFFFFFFFF;
1293#elif __BYTE_ORDER == __LITTLE_ENDIAN
1294                        tv.tv_sec = ts >> 32;
1295#else
1296#error "What on earth are you running this on?"
1297#endif
1298                        tv.tv_usec = ((ts&0xFFFFFFFF)*1000000)>>32;
1299                        if (tv.tv_usec >= 1000000) {
1300                                tv.tv_usec -= 1000000;
1301                                tv.tv_sec += 1;
1302                        }
1303                        return trace->format->seek_timeval(trace,tv);
1304                }
1305                if (trace->format->seek_seconds) {
1306                        double seconds = 
1307                                (ts>>32) + ((ts & UINT_MAX)*1.0 / UINT_MAX);
1308                        return trace->format->seek_seconds(trace,seconds);
1309                }
1310                trace_set_err(trace,
1311                                TRACE_ERR_OPTION_UNAVAIL,
1312                                "Feature unimplemented");
1313                return -1;
1314        }
1315}
1316
1317DLLEXPORT int trace_seek_seconds(libtrace_t *trace, double seconds)
1318{
1319        if (trace->format->seek_seconds) {
1320                return trace->format->seek_seconds(trace,seconds);
1321        }
1322        else {
1323                if (trace->format->seek_timeval) {
1324                        struct timeval tv;
1325                        tv.tv_sec = (uint32_t)seconds;
1326                        tv.tv_usec = (uint32_t)(((seconds - tv.tv_sec) * 1000000)/UINT_MAX);
1327                        return trace->format->seek_timeval(trace,tv);
1328                }
1329                if (trace->format->seek_erf) {
1330                        uint64_t timestamp = 
1331                                ((uint64_t)((uint32_t)seconds) << 32) + \
1332                            (uint64_t)(( seconds - (uint32_t)seconds   ) * UINT_MAX);
1333                        return trace->format->seek_erf(trace,timestamp);
1334                }
1335                trace_set_err(trace,
1336                                TRACE_ERR_OPTION_UNAVAIL,
1337                                "Feature unimplemented");
1338                return -1;
1339        }
1340}
1341
1342DLLEXPORT int trace_seek_timeval(libtrace_t *trace, struct timeval tv)
1343{
1344        if (trace->format->seek_timeval) {
1345                return trace->format->seek_timeval(trace,tv);
1346        }
1347        else {
1348                if (trace->format->seek_erf) {
1349                        uint64_t timestamp = ((((uint64_t)tv.tv_sec) << 32) + \
1350                                (((uint64_t)tv.tv_usec * UINT_MAX)/1000000));
1351                        return trace->format->seek_erf(trace,timestamp);
1352                }
1353                if (trace->format->seek_seconds) {
1354                        double seconds = tv.tv_sec + ((tv.tv_usec * 1.0)/1000000);
1355                        return trace->format->seek_seconds(trace,seconds);
1356                }
1357                trace_set_err(trace,
1358                                TRACE_ERR_OPTION_UNAVAIL,
1359                                "Feature unimplemented");
1360                return -1;
1361        }
1362}
1363
1364DLLEXPORT char *trace_ether_ntoa(const uint8_t *addr, char *buf)
1365{
1366        char *buf2 = buf;
1367        char staticbuf[18]={0,};
1368        if (!buf2)
1369                buf2=staticbuf;
1370        snprintf(buf2,18,"%02x:%02x:%02x:%02x:%02x:%02x",
1371                        addr[0],addr[1],addr[2],
1372                        addr[3],addr[4],addr[5]);
1373        return buf2;
1374}
1375
1376DLLEXPORT uint8_t *trace_ether_aton(const char *buf, uint8_t *addr)
1377{
1378        uint8_t *buf2 = addr;
1379        unsigned int tmp[6];
1380        static uint8_t staticaddr[6];
1381        if (!buf2)
1382                buf2=staticaddr;
1383        sscanf(buf,"%x:%x:%x:%x:%x:%x",
1384                        &tmp[0],&tmp[1],&tmp[2],
1385                        &tmp[3],&tmp[4],&tmp[5]);
1386        buf2[0]=tmp[0]; buf2[1]=tmp[1]; buf2[2]=tmp[2];
1387        buf2[3]=tmp[3]; buf2[4]=tmp[4]; buf2[5]=tmp[5];
1388        return buf2;
1389}
1390
Note: See TracBrowser for help on using the repository browser.