2011-06-09 21:21:06 +00:00
|
|
|
/* mime_file.c
|
|
|
|
*
|
|
|
|
* MIME file format decoder for the Wiretap library.
|
|
|
|
*
|
2011-07-04 01:39:13 +00:00
|
|
|
* This is for use with Wireshark dissectors that handle file
|
|
|
|
* formats (e.g., because they handle a particular MIME media type).
|
|
|
|
* It breaks the file into chunks of at most WTAP_MAX_PACKET_SIZE,
|
|
|
|
* each of which is reported as a packet, so that files larger than
|
|
|
|
* WTAP_MAX_PACKET_SIZE can be handled by reassembly.
|
|
|
|
*
|
|
|
|
* The "MIME file" dissector does the reassembly, and hands the result
|
|
|
|
* off to heuristic dissectors to try to identify the file's contents.
|
|
|
|
*
|
2011-06-09 21:21:06 +00:00
|
|
|
* $Id$
|
|
|
|
*
|
|
|
|
* Wiretap Library
|
|
|
|
* 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
|
2012-06-28 22:56:06 +00:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
2011-06-09 21:21:06 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
#include "config.h"
|
|
|
|
|
|
|
|
#ifdef HAVE_SYS_TYPES_H
|
|
|
|
#include <sys/types.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef HAVE_UNISTD_H
|
|
|
|
#include <unistd.h>
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#include <errno.h>
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <time.h>
|
|
|
|
|
|
|
|
#include "wtap-int.h"
|
|
|
|
#include "file_wrappers.h"
|
|
|
|
#include "buffer.h"
|
|
|
|
#include "mime_file.h"
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
gboolean last_packet;
|
|
|
|
|
|
|
|
} mime_file_private_t;
|
|
|
|
|
|
|
|
typedef struct {
|
2011-09-01 09:43:10 +00:00
|
|
|
const guint8 *magic;
|
2011-06-09 22:01:57 +00:00
|
|
|
guint magic_len;
|
2011-06-09 21:21:06 +00:00
|
|
|
} mime_files_t;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Written by Marton Nemeth <nm127@freemail.hu>
|
|
|
|
* Copyright 2009 Marton Nemeth
|
|
|
|
* The JPEG and JFIF specification can be found at:
|
|
|
|
*
|
|
|
|
* http://www.jpeg.org/public/jfif.pdf
|
|
|
|
* http://www.w3.org/Graphics/JPEG/itu-t81.pdf
|
|
|
|
*/
|
2011-09-01 09:43:10 +00:00
|
|
|
static const guint8 jpeg_jfif_magic[] = { 0xFF, 0xD8, /* SOF */
|
2011-06-09 21:21:06 +00:00
|
|
|
0xFF /* start of the next marker */
|
|
|
|
};
|
|
|
|
|
2012-04-04 20:52:52 +00:00
|
|
|
/* <?xml */
|
|
|
|
static const guint8 xml_magic[] = { '<', '?', 'x', 'm', 'l' };
|
|
|
|
|
2011-06-09 21:21:06 +00:00
|
|
|
static const mime_files_t magic_files[] = {
|
2012-04-04 20:52:52 +00:00
|
|
|
{ jpeg_jfif_magic, sizeof(jpeg_jfif_magic) },
|
|
|
|
{ xml_magic, sizeof(xml_magic) }
|
2011-06-09 21:21:06 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#define N_MAGIC_TYPES (sizeof(magic_files) / sizeof(magic_files[0]))
|
|
|
|
|
|
|
|
static gboolean
|
|
|
|
mime_read(wtap *wth, int *err, gchar **err_info, gint64 *data_offset)
|
|
|
|
{
|
|
|
|
mime_file_private_t *priv = (mime_file_private_t *) wth->priv;
|
|
|
|
|
|
|
|
char _buf[WTAP_MAX_PACKET_SIZE];
|
|
|
|
guint8 *buf;
|
|
|
|
int packet_size;
|
|
|
|
|
|
|
|
if (priv->last_packet) {
|
|
|
|
*err = file_error(wth->fh, err_info);
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
2012-02-25 23:24:34 +00:00
|
|
|
wth->phdr.presence_flags = 0;
|
|
|
|
|
|
|
|
wth->phdr.ts.secs = 0;
|
2011-06-09 21:21:06 +00:00
|
|
|
wth->phdr.ts.nsecs = 0;
|
|
|
|
|
2012-05-04 16:56:18 +00:00
|
|
|
*data_offset = file_tell(wth->fh);
|
2011-06-09 21:21:06 +00:00
|
|
|
|
|
|
|
/* try to read max WTAP_MAX_PACKET_SIZE bytes */
|
|
|
|
packet_size = file_read(_buf, sizeof(_buf), wth->fh);
|
|
|
|
|
|
|
|
if (packet_size <= 0) {
|
|
|
|
priv->last_packet = TRUE;
|
|
|
|
/* signal error for packet-mime-encap */
|
|
|
|
if (packet_size < 0)
|
|
|
|
wth->phdr.ts.nsecs = 1000000000;
|
|
|
|
|
|
|
|
wth->phdr.caplen = 0;
|
|
|
|
wth->phdr.len = 0;
|
|
|
|
return TRUE;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* copy to wth frame buffer */
|
|
|
|
buffer_assure_space(wth->frame_buffer, packet_size);
|
|
|
|
buf = buffer_start_ptr(wth->frame_buffer);
|
|
|
|
memcpy(buf, _buf, packet_size);
|
|
|
|
|
|
|
|
wth->phdr.caplen = packet_size;
|
|
|
|
wth->phdr.len = packet_size;
|
|
|
|
return TRUE;
|
|
|
|
}
|
|
|
|
|
|
|
|
static gboolean
|
2012-10-16 21:50:57 +00:00
|
|
|
mime_seek_read(wtap *wth, gint64 seek_off, struct wtap_pkthdr *phdr _U_, guint8 *pd, int length, int *err, gchar **err_info)
|
2011-06-09 21:21:06 +00:00
|
|
|
{
|
|
|
|
if (file_seek(wth->random_fh, seek_off, SEEK_SET, err) == -1) {
|
|
|
|
*err_info = NULL;
|
|
|
|
return FALSE;
|
|
|
|
}
|
|
|
|
|
|
|
|
wtap_file_read_expected_bytes(pd, length, wth->random_fh, err, err_info);
|
|
|
|
|
|
|
|
*err = 0;
|
|
|
|
*err_info = NULL;
|
|
|
|
return TRUE;
|
|
|
|
}
|
|
|
|
|
|
|
|
int
|
|
|
|
mime_file_open(wtap *wth, int *err, gchar **err_info)
|
|
|
|
{
|
2011-06-09 22:01:57 +00:00
|
|
|
char magic_buf[128]; /* increase buffer size when needed */
|
2011-06-09 21:21:06 +00:00
|
|
|
int bytes_read;
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
gboolean found_file;
|
|
|
|
/* guint file_ok; */
|
2011-06-09 21:21:06 +00:00
|
|
|
guint i;
|
|
|
|
|
2011-06-09 22:01:57 +00:00
|
|
|
guint read_bytes = 0;
|
2011-06-09 21:21:06 +00:00
|
|
|
|
|
|
|
for (i = 0; i < N_MAGIC_TYPES; i++)
|
|
|
|
read_bytes = MAX(read_bytes, magic_files[i].magic_len);
|
|
|
|
|
2012-12-21 03:32:16 +00:00
|
|
|
read_bytes = (guint)MIN(read_bytes, sizeof(magic_buf));
|
2011-06-09 21:21:06 +00:00
|
|
|
bytes_read = file_read(magic_buf, read_bytes, wth->fh);
|
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
if (bytes_read < 0) {
|
|
|
|
*err = file_error(wth->fh, err_info);
|
|
|
|
return -1;
|
|
|
|
}
|
|
|
|
if (bytes_read == 0)
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
found_file = FALSE;
|
|
|
|
for (i = 0; i < N_MAGIC_TYPES; i++) {
|
|
|
|
if ((guint) bytes_read >= magic_files[i].magic_len && !memcmp(magic_buf, magic_files[i].magic, MIN(magic_files[i].magic_len, (guint) bytes_read))) {
|
|
|
|
if (!found_file) {
|
|
|
|
found_file = TRUE;
|
|
|
|
/* file_ok = i; */
|
|
|
|
} else
|
|
|
|
return 0; /* many files matched, bad file */
|
2011-06-09 21:21:06 +00:00
|
|
|
}
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
}
|
2011-06-09 21:21:06 +00:00
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
if (!found_file)
|
|
|
|
return 0;
|
2011-06-09 21:21:06 +00:00
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
if (file_seek(wth->fh, 0, SEEK_SET, err) == -1)
|
|
|
|
return -1;
|
2011-06-09 21:21:06 +00:00
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
wth->file_type = WTAP_FILE_MIME;
|
|
|
|
wth->file_encap = WTAP_ENCAP_MIME;
|
|
|
|
wth->tsprecision = WTAP_FILE_TSPREC_SEC;
|
|
|
|
wth->subtype_read = mime_read;
|
|
|
|
wth->subtype_seek_read = mime_seek_read;
|
|
|
|
wth->snapshot_length = 0;
|
2011-06-09 21:21:06 +00:00
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
wth->priv = g_malloc0(sizeof(mime_file_private_t));
|
2011-06-09 21:21:06 +00:00
|
|
|
|
Do not call wtap_file_read_unknown_bytes() or
wtap_file_read_expected_bytes() from an open routine - open routines are
supposed to return -1 on error, 0 if the file doesn't appear to be a
file of the specified type, or 1 if the file does appear to be a file of
the specified type, but those macros will cause the caller to return
FALSE on errors (so that, even if there's an I/O error, it reports "the
file isn't a file of the specified type" rather than "we got an error
trying to read the file").
When doing reads in an open routine before we've concluded that the file
is probably of the right type, return 0, rather than -1, if we get
WTAP_ERR_SHORT_READ - if we don't have enough data to check whether a
file is of a given type, we should keep trying other types, not give up.
For reads done *after* we've concluded the file is probably of the right
type, if a read doesn't return the number of bytes we asked for, but
returns an error of 0, return WTAP_ERR_SHORT_READ - the file is
apparently cut short.
For NetMon and NetXRay/Windows Sniffer files, use a #define for the
magic number size, and use that for both magic numbers.
svn path=/trunk/; revision=46803
2012-12-27 12:19:25 +00:00
|
|
|
return 1;
|
2011-06-09 21:21:06 +00:00
|
|
|
}
|
2011-06-09 22:01:57 +00:00
|
|
|
|