2004-06-18 10:01:59 +00:00
|
|
|
/* merge.h
|
2004-10-27 23:28:37 +00:00
|
|
|
* Definitions for routines for merging files.
|
2004-06-18 10:01:59 +00:00
|
|
|
*
|
2004-07-18 00:24:25 +00:00
|
|
|
* $Id$
|
2004-06-18 10:01:59 +00:00
|
|
|
*
|
2006-05-21 05:12:17 +00:00
|
|
|
* Wireshark - Network traffic analyzer
|
|
|
|
* By Gerald Combs <gerald@wireshark.org>
|
2004-06-18 10:01:59 +00:00
|
|
|
* 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.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __MERGE_H__
|
|
|
|
#define __MERGE_H__
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
2004-10-29 00:36:52 +00:00
|
|
|
typedef enum {
|
|
|
|
PACKET_PRESENT,
|
|
|
|
PACKET_NOT_PRESENT,
|
|
|
|
AT_EOF,
|
|
|
|
GOT_ERROR
|
|
|
|
} in_file_state_e;
|
|
|
|
|
2004-06-18 10:01:59 +00:00
|
|
|
/**
|
|
|
|
* Structures to manage our input files.
|
|
|
|
*/
|
|
|
|
typedef struct merge_in_file_s {
|
2004-10-29 00:36:52 +00:00
|
|
|
const char *filename;
|
|
|
|
wtap *wth;
|
2006-11-05 22:46:44 +00:00
|
|
|
gint64 data_offset;
|
2004-10-29 00:36:52 +00:00
|
|
|
in_file_state_e state;
|
When reporting "sorry, *this* packet can't be written to a file of that
type" when writing out a capture file (i.e., writing a
per-packet-encapsulation capture to a file type that supports it but
doesn't support one of the packet's encapsulations), report the packet
number and, when doing this in a merge operation, report the file from
which it came.
When reporting "sorry, that file can't be written to a file of that
type, period", show the file type rather than the input file link-layer
type that causes the problem. (We could show both. We could be
*really* ambitious and iterate through all possible file types and show
the ones that will or at least might work....)
file_write_error_message() is documented as handling only UNIX-style
errnos, and libwireshark should be usable without libwiretap, so leave
it up to its callers to handle Wiretap errors such as
WTAP_ERR_SHORT_WRITE.
Clean up indentation.
svn path=/trunk/; revision=39949
2011-11-19 20:18:01 +00:00
|
|
|
guint32 packet_num; /* current packet number */
|
2005-08-19 19:40:00 +00:00
|
|
|
gint64 size; /* file size */
|
2004-06-18 10:01:59 +00:00
|
|
|
} merge_in_file_t;
|
|
|
|
|
|
|
|
/** Open a number of input files to merge.
|
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_file_names and in_files
|
|
|
|
* @param in_file_names filenames of the input files
|
|
|
|
* @param in_files input file array to be filled (>= sizeof(merge_in_file_t) * in_file_count)
|
2004-10-28 01:06:11 +00:00
|
|
|
* @param err wiretap error, if failed
|
|
|
|
* @param err_info wiretap error string, if failed
|
|
|
|
* @param err_fileno file on which open failed, if failed
|
|
|
|
* @return TRUE if all files could be opened, FALSE otherwise
|
2004-06-18 10:01:59 +00:00
|
|
|
*/
|
2004-10-28 01:06:11 +00:00
|
|
|
extern gboolean
|
2004-10-27 23:28:37 +00:00
|
|
|
merge_open_in_files(int in_file_count, char *const *in_file_names,
|
|
|
|
merge_in_file_t **in_files, int *err, gchar **err_info,
|
|
|
|
int *err_fileno);
|
2004-06-18 10:01:59 +00:00
|
|
|
|
|
|
|
/** Close the input files again.
|
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_files
|
|
|
|
* @param in_files input file array to be closed
|
|
|
|
*/
|
|
|
|
extern void
|
|
|
|
merge_close_in_files(int in_file_count, merge_in_file_t in_files[]);
|
|
|
|
|
|
|
|
/** Try to get the frame type from the input files.
|
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_files
|
|
|
|
* @param in_files input file array
|
|
|
|
* @return the frame type
|
|
|
|
*/
|
|
|
|
extern int
|
|
|
|
merge_select_frame_type(int in_file_count, merge_in_file_t in_files[]);
|
|
|
|
|
|
|
|
/** Try to get the snapshot length from the input files.
|
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_files
|
|
|
|
* @param in_files input file array
|
|
|
|
* @return the snapshot length
|
|
|
|
*/
|
|
|
|
extern int
|
|
|
|
merge_max_snapshot_length(int in_file_count, merge_in_file_t in_files[]);
|
|
|
|
|
2004-10-29 00:36:52 +00:00
|
|
|
/** Read the next packet, in chronological order, from the set of files to
|
|
|
|
* be merged.
|
2004-06-18 10:01:59 +00:00
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_files
|
|
|
|
* @param in_files input file array
|
|
|
|
* @param err wiretap error, if failed
|
2004-10-29 00:36:52 +00:00
|
|
|
* @param err_info wiretap error string, if failed
|
When reporting "sorry, *this* packet can't be written to a file of that
type" when writing out a capture file (i.e., writing a
per-packet-encapsulation capture to a file type that supports it but
doesn't support one of the packet's encapsulations), report the packet
number and, when doing this in a merge operation, report the file from
which it came.
When reporting "sorry, that file can't be written to a file of that
type, period", show the file type rather than the input file link-layer
type that causes the problem. (We could show both. We could be
*really* ambitious and iterate through all possible file types and show
the ones that will or at least might work....)
file_write_error_message() is documented as handling only UNIX-style
errnos, and libwireshark should be usable without libwiretap, so leave
it up to its callers to handle Wiretap errors such as
WTAP_ERR_SHORT_WRITE.
Clean up indentation.
svn path=/trunk/; revision=39949
2011-11-19 20:18:01 +00:00
|
|
|
* @return pointer to merge_in_file_t for file from which that packet
|
|
|
|
* came, or NULL on error or EOF
|
2004-06-18 10:01:59 +00:00
|
|
|
*/
|
When reporting "sorry, *this* packet can't be written to a file of that
type" when writing out a capture file (i.e., writing a
per-packet-encapsulation capture to a file type that supports it but
doesn't support one of the packet's encapsulations), report the packet
number and, when doing this in a merge operation, report the file from
which it came.
When reporting "sorry, that file can't be written to a file of that
type, period", show the file type rather than the input file link-layer
type that causes the problem. (We could show both. We could be
*really* ambitious and iterate through all possible file types and show
the ones that will or at least might work....)
file_write_error_message() is documented as handling only UNIX-style
errnos, and libwireshark should be usable without libwiretap, so leave
it up to its callers to handle Wiretap errors such as
WTAP_ERR_SHORT_WRITE.
Clean up indentation.
svn path=/trunk/; revision=39949
2011-11-19 20:18:01 +00:00
|
|
|
extern merge_in_file_t *
|
2004-10-29 00:36:52 +00:00
|
|
|
merge_read_packet(int in_file_count, merge_in_file_t in_files[], int *err,
|
|
|
|
gchar **err_info);
|
2004-06-18 10:01:59 +00:00
|
|
|
|
2004-10-29 00:36:52 +00:00
|
|
|
|
|
|
|
/** Read the next packet, in file sequence order, from the set of files
|
|
|
|
* to be merged.
|
2004-06-18 10:01:59 +00:00
|
|
|
*
|
|
|
|
* @param in_file_count number of entries in in_files
|
|
|
|
* @param in_files input file array
|
|
|
|
* @param err wiretap error, if failed
|
2004-10-29 00:36:52 +00:00
|
|
|
* @param err_info wiretap error string, if failed
|
When reporting "sorry, *this* packet can't be written to a file of that
type" when writing out a capture file (i.e., writing a
per-packet-encapsulation capture to a file type that supports it but
doesn't support one of the packet's encapsulations), report the packet
number and, when doing this in a merge operation, report the file from
which it came.
When reporting "sorry, that file can't be written to a file of that
type, period", show the file type rather than the input file link-layer
type that causes the problem. (We could show both. We could be
*really* ambitious and iterate through all possible file types and show
the ones that will or at least might work....)
file_write_error_message() is documented as handling only UNIX-style
errnos, and libwireshark should be usable without libwiretap, so leave
it up to its callers to handle Wiretap errors such as
WTAP_ERR_SHORT_WRITE.
Clean up indentation.
svn path=/trunk/; revision=39949
2011-11-19 20:18:01 +00:00
|
|
|
* @return pointer to merge_in_file_t for file from which that packet
|
|
|
|
* came, or NULL on error or EOF
|
2004-06-18 10:01:59 +00:00
|
|
|
*/
|
When reporting "sorry, *this* packet can't be written to a file of that
type" when writing out a capture file (i.e., writing a
per-packet-encapsulation capture to a file type that supports it but
doesn't support one of the packet's encapsulations), report the packet
number and, when doing this in a merge operation, report the file from
which it came.
When reporting "sorry, that file can't be written to a file of that
type, period", show the file type rather than the input file link-layer
type that causes the problem. (We could show both. We could be
*really* ambitious and iterate through all possible file types and show
the ones that will or at least might work....)
file_write_error_message() is documented as handling only UNIX-style
errnos, and libwireshark should be usable without libwiretap, so leave
it up to its callers to handle Wiretap errors such as
WTAP_ERR_SHORT_WRITE.
Clean up indentation.
svn path=/trunk/; revision=39949
2011-11-19 20:18:01 +00:00
|
|
|
extern merge_in_file_t *
|
2004-10-29 00:36:52 +00:00
|
|
|
merge_append_read_packet(int in_file_count, merge_in_file_t in_files[],
|
|
|
|
int *err, gchar **err_info);
|
2004-06-18 10:01:59 +00:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif /* __cplusplus */
|
|
|
|
|
|
|
|
#endif /* __MERGE_H__ */
|
|
|
|
|