aboutsummaryrefslogtreecommitdiffstats
path: root/sync_pipe.h
diff options
context:
space:
mode:
Diffstat (limited to 'sync_pipe.h')
-rw-r--r--sync_pipe.h79
1 files changed, 79 insertions, 0 deletions
diff --git a/sync_pipe.h b/sync_pipe.h
new file mode 100644
index 0000000000..6be873c197
--- /dev/null
+++ b/sync_pipe.h
@@ -0,0 +1,79 @@
+/* sync_pipe.h
+ * Low-level synchronization pipe routines for use by Ethereal and dumpcap
+ *
+ * $Id$
+ *
+ * Ethereal - Network traffic analyzer
+ * By Gerald Combs <gerald@ethereal.com>
+ * Copyright 1998 Gerald Combs
+ *
+ * This program 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.
+ *
+ * This program 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 this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+ */
+
+
+/** @file
+ *
+ * Low-level sync pipe interfaces.
+ */
+
+#ifndef __SYNC_PIPE_H__
+#define __SYNC_PIPE_H__
+
+
+/*
+ * Maximum length of sync pipe message data. Must be < 2^24, as the
+ * message length is 3 bytes.
+ * XXX - this must be large enough to handle a Really Big Filter
+ * Expression, as the error message for an incorrect filter expression
+ * is a bit larger than the filter expression.
+ */
+#define SP_MAX_MSG_LEN 4096
+
+
+/* Size of buffer to hold decimal representation of
+ signed/unsigned 64-bit int */
+#define SP_DECISIZE 20
+
+/*
+ * Indications sent out on the sync pipe (from child to parent).
+ */
+#define SP_FILE 'F' /* the name of the recently opened file */
+#define SP_ERROR_MSG 'E' /* error message */
+#define SP_BAD_FILTER 'B' /* error message for bad capture filter */
+#define SP_PACKET_COUNT 'P' /* count of packets captured since last message */
+#define SP_DROPS 'D' /* count of packets dropped in capture */
+/*
+ * Win32 only: Indications sent out on the signal pipe (from parent to child)
+ * (UNIX-like sends signals for this)
+ */
+#define SP_QUIT 'Q' /* "gracefully" capture quit message (SIGUSR1) */
+
+/* write a single message header to the recipient pipe */
+extern int
+pipe_write_header(int pipe, char indicator, int length);
+
+/* write a message to the recipient pipe in the standard format
+ (3 digit message length (excluding length and indicator field),
+ 1 byte message indicator and the rest is the message).
+ If msg is NULL, the message has only a length and indicator. */
+extern void
+pipe_write_block(int pipe, char indicator, const char *msg);
+
+/** the child encountered an error, notify the parent */
+extern void
+sync_pipe_errmsg_to_parent(const char *error_msg,
+ const char *secondary_error_msg);
+
+#endif /* sync_pipe.h */