Trace-related definitions and prototypes.

diff --git a/includes/omapip/trace.h b/includes/omapip/trace.h
new file mode 100644 (file)
index 0000000..815aaca
--- /dev/null
+++ b/includes/omapip/trace.h
@@ -0,0 +1,122 @@
+/* trace.h
+
+   Definitions for omapi tracing facility... */
+
+/*
+ * Copyright (c) 2001 Internet Software Consortium.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of The Internet Software Consortium nor the names
+ *    of its contributors may be used to endorse or promote products derived
+ *    from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE INTERNET SOFTWARE CONSORTIUM AND
+ * CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+ * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED.  IN NO EVENT SHALL THE INTERNET SOFTWARE CONSORTIUM OR
+ * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+ * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * This software has been written for the Internet Software Consortium
+ * by Ted Lemon, as part of a project for Nominum, Inc.   To learn more
+ * about the Internet Software Consortium, see http://www.isc.org/.  To
+ * learn more about Nominum, Inc., see ``http://www.nominum.com''.
+ */
+
+#define TRACEFILE_MAGIC                0x64484370UL    /* dHCp */
+#define TRACEFILE_VERSION      1
+
+/* The first thing in a trace file is the header, which basically just 
+   defines the version of the file. */
+typedef struct {
+       u_int32_t magic;        /* Magic number for trace file. */
+       u_int32_t version;      /* Version of file. */
+       u_int32_t hlen;         /* Length of this header. */
+       u_int32_t phlen;        /* Length of packet headers. */
+} tracefile_header_t;
+
+/* The trace file is composed of a bunch of trace packets.   Each such packet
+   has a type, followed by a length, followed by a timestamp, followed by
+   the actual contents of the packet.   The type indexes are not fixed -
+   they are allocated either on readback or when writing a trace file.
+   One index type is reserved - type zero means that this record is a type
+   name to index mapping. */
+typedef struct {
+       u_int32_t type_index;   /* Index to the type of handler that this
+                                  packet needs. */
+       u_int32_t length;       /* Length of the packet.  This includes
+                                  everything except the fixed header. */
+       u_int32_t when;         /* When the packet was written. */
+       u_int32_t pad;          /* Round this out to a quad boundary. */
+} tracepacket_t;
+
+#define TRACE_INDEX_MAPPING_SIZE 4     /* trace_index_mapping_t less name. */
+typedef struct {
+       u_int32_t index;
+       char name [1];
+} trace_index_mapping_t;
+
+struct trace_type; /* forward */
+typedef struct trace_type trace_type_t;
+
+struct trace_type {
+       trace_type_t *next;
+       int index;
+       char *name;
+       void *baggage;
+       void (*have_packet) (trace_type_t *, unsigned, char *);
+       void (*stop_tracing) (trace_type_t *);
+};
+
+typedef struct trace_iov {
+       const char *buf;
+       unsigned len;
+} trace_iov_t;
+
+typedef struct {
+       u_int16_t addrtype;
+       u_int16_t addrlen;
+       u_int8_t address [16];
+       u_int16_t port;
+} trace_addr_t;
+
+int trace_playback (void);
+int trace_record (void);
+isc_result_t trace_init (void (*set_time) (u_int32_t), const char *, int);
+isc_result_t trace_begin (const char *, const char *, int);
+isc_result_t trace_write_packet (trace_type_t *, unsigned, const char *,
+                                const char *, int);
+isc_result_t trace_write_packet_iov (trace_type_t *, int, trace_iov_t *,
+                                    const char *, int);
+void trace_type_stash (trace_type_t *);
+trace_type_t *trace_type_register (const char *, void *,
+                                  void (*) (trace_type_t *,
+                                            unsigned, char *),
+                                  void (*) (trace_type_t *),
+                                  const char *, int);
+void trace_stop (void);
+void trace_index_map_input (trace_type_t *, unsigned, char *);
+void trace_index_stop_tracing (trace_type_t *);
+void trace_replay_init (void);
+void trace_file_replay (const char *);
+isc_result_t trace_get_next_packet (trace_type_t **, tracepacket_t *,
+                                   char **, unsigned *, unsigned *);
+isc_result_t trace_get_file (trace_type_t *,
+                            const char *, unsigned *, char **);
+isc_result_t trace_get_packet (trace_type_t **, unsigned *, char **);