Changeset 1523

Timestamp:

02/09/10 13:46:08 (3 years ago)

Author:

salcock

Message:

• Updated licensing and documentation for another set of source files

Location:

trunk/lib

Files:

• link_wireless.c (modified) (2 diffs)
• linktypes.c (modified) (4 diffs, 1 prop)
• pcap_dump_flush.c (modified) (2 diffs, 1 prop)
• pcap_next_ex.c (modified) (2 diffs, 1 prop)
• pcap_open_dead.c (modified) (2 diffs, 1 prop)
• strndup.c (modified) (2 diffs, 1 prop)

trunk/lib/link_wireless.c

@@ -2 +2 @@
  * This file is part of libtrace
  *
- * link_wireless.c
- * Implements the trace_get_wireless_* methods defined in libtrace.h
- *
- * Copyright (c) 2007,2008 The University of Waikato, Hamilton, New Zealand.
- * Authors: Scott Raynel 
- *          Perry Lorier 
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Scott Raynel
+ *          Perry Lorier
  *          
  * All rights reserved.
@@ -28 +27 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  *
+ * $Id$
+ *
  */
 
 #include "libtrace.h"
 #include "libtrace_int.h" 
+
+/* The file contains all the functions necessary to access various measurement
+ * values that are specific to wireless MACs ( RadioTap in particular ).
+ *
+ * Credit for all this code goes to Scott Raynel.
+ */
 
 /* Used for Radiotap fields which must be naturally aligned */

trunk/lib/linktypes.c

@@ +1 @@
+/*
+ * This file is part of libtrace
+ *
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Daniel Lawson 
+ *          Perry Lorier
+ *          Shane Alcock 
+ *          
+ * All rights reserved.
+ *
+ * This code has been developed by the University of Waikato WAND 
+ * research group. For further information please see http://www.wand.net.nz/
+ *
+ * libtrace is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * libtrace is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with libtrace; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * $Id$
+ *
+ */
+
 #include "libtrace.h"
 #include "config.h"
@@ -84 +117 @@
 
                 /* Below here are unsupported conversions */
-                /* Dispite hints to the contrary, there is no DLT
+                /* Despite hints to the contrary, there is no DLT
                  * for 'raw atm packets that happen to be missing
                  * the HEC' or even 'raw atm packets that have a hec'.
@@ -190 +223 @@
 }
 
-/** Tinker with a packet
- * packets that don't support direction tagging are annoying, especially
+/** Prepends a Linux SLL header to the packet.
+ * 
+ * Packets that don't support direction tagging are annoying, especially
  * when we have direction tagging information!  So this converts the packet
  * to TRACE_TYPE_LINUX_SLL which does support direction tagging.  This is a
@@ -262 +296 @@
 }
 
-/* Try and simplify the packet one step, kinda the opposite to promote_packet
- *
- * returns true if demotion was possible, false if not.
+/* Try and remove any extraneous encapsulation that may have been added to
+ * a packet. Effectively the opposite to promote_packet.
+ *
+ * Returns true if demotion was possible, false if not.
  */
 bool demote_packet(libtrace_packet_t *packet)

trunk/lib/pcap_dump_flush.c

@@ +1 @@
+/*
+ * This file is part of libtrace
+ *
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Daniel Lawson 
+ *          Perry Lorier
+ *          Shane Alcock 
+ *          
+ * All rights reserved.
+ *
+ * This code has been developed by the University of Waikato WAND 
+ * research group. For further information please see http://www.wand.net.nz/
+ *
+ * libtrace is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * libtrace is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with libtrace; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * $Id$
+ *
+ */
+
 #ifdef HAVE_PCAP
 #include "config.h"
@@ -10 +43 @@
 #include <string.h>
 
+/* Custom implementation of pcap_dump_flush, as some versions of PCAP do not
+ * have it */
+
 int pcap_dump_flush(pcap_dumper_t *p) {
         if (fflush((FILE *)p) == EOF)

trunk/lib/pcap_next_ex.c

@@ +1 @@
+/*
+ * This file is part of libtrace
+ *
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Daniel Lawson 
+ *          Perry Lorier
+ *          Shane Alcock 
+ *          
+ * All rights reserved.
+ *
+ * This code has been developed by the University of Waikato WAND 
+ * research group. For further information please see http://www.wand.net.nz/
+ *
+ * libtrace is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * libtrace is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with libtrace; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * $Id$
+ *
+ */
+
+
 #ifdef HAVE_PCAP
 #include "config.h"
@@ -11 +45 @@
 #include <libtrace.h>
 #include <stdlib.h>
+
+/* Custom implementation of pcap_next_ex as some versions of PCAP do not have
+ * it */
 
 struct pcap_data_t {

trunk/lib/pcap_open_dead.c

@@ +1 @@
+/*
+ * This file is part of libtrace
+ *
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Daniel Lawson 
+ *          Perry Lorier
+ *          Shane Alcock 
+ *          
+ * All rights reserved.
+ *
+ * This code has been developed by the University of Waikato WAND 
+ * research group. For further information please see http://www.wand.net.nz/
+ *
+ * libtrace is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * libtrace is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with libtrace; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * $Id$
+ *
+ */
+
+
 #ifdef HAVE_PCAP
 #include "config.h"
@@ -12 +46 @@
 #include <string.h>
 
+/* Custom implementation of pcap_open_dead as some versions of PCAP do not
+ * have it */
+
 pcap_t *pcap_open_dead(int linktype, int snaplen) {
     pcap_t *p = NULL;

trunk/lib/strndup.c

@@ -1 +1 @@
 /*
- * Written by mjl. Needs attributation?
+ * This file is part of libtrace
+ *
+ * Copyright (c) 2007,2008,2009,2010 The University of Waikato, Hamilton, 
+ * New Zealand.
+ *
+ * Authors: Matthew Luckie 
+ *          
+ * All rights reserved.
+ *
+ * This code has been developed by the University of Waikato WAND 
+ * research group. For further information please see http://www.wand.net.nz/
+ *
+ * libtrace is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * libtrace is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with libtrace; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ * $Id$
+ *
  */
+
 #include "config.h"
 
@@ -9 +37 @@
 #include <errno.h>
 #include <string.h>
+
+/* Some systems don't include strndup as part of their standard C library, so
+ * we need to provide our own version.
+ *
+ * Full credit to Matthew Luckie, who wrote this particular version and allowed
+ * us to borrow it.
+ */
 
 char *strndup(const char *s, size_t size)