Blame extensions/libxt_string.c

Packit 7b22a4
/* Shared library add-on to iptables to add string matching support. 
Packit 7b22a4
 * 
Packit 7b22a4
 * Copyright (C) 2000 Emmanuel Roger  <winfield@freegates.be>
Packit 7b22a4
 *
Packit 7b22a4
 * 2005-08-05 Pablo Neira Ayuso <pablo@eurodev.net>
Packit 7b22a4
 * 	- reimplemented to use new string matching iptables match
Packit 7b22a4
 * 	- add functionality to match packets by using window offsets
Packit 7b22a4
 * 	- add functionality to select the string matching algorithm
Packit 7b22a4
 *
Packit 7b22a4
 * ChangeLog
Packit 7b22a4
 *     29.12.2003: Michael Rash <mbr@cipherdyne.org>
Packit 7b22a4
 *             Fixed iptables save/restore for ascii strings
Packit 7b22a4
 *             that contain space chars, and hex strings that
Packit 7b22a4
 *             contain embedded NULL chars.  Updated to print
Packit 7b22a4
 *             strings in hex mode if any non-printable char
Packit 7b22a4
 *             is contained within the string.
Packit 7b22a4
 *
Packit 7b22a4
 *     27.01.2001: Gianni Tedesco <gianni@ecsc.co.uk>
Packit 7b22a4
 *             Changed --tos to --string in save(). Also
Packit 7b22a4
 *             updated to work with slightly modified
Packit 7b22a4
 *             ipt_string_info.
Packit 7b22a4
 */
Packit 7b22a4
#define _GNU_SOURCE 1 /* strnlen for older glibcs */
Packit 7b22a4
#include <stdio.h>
Packit 7b22a4
#include <string.h>
Packit 7b22a4
#include <stdlib.h>
Packit 7b22a4
#include <ctype.h>
Packit 7b22a4
#include <xtables.h>
Packit 7b22a4
#include <linux/netfilter/xt_string.h>
Packit 7b22a4
Packit 7b22a4
enum {
Packit 7b22a4
	O_FROM = 0,
Packit 7b22a4
	O_TO,
Packit 7b22a4
	O_ALGO,
Packit 7b22a4
	O_ICASE,
Packit 7b22a4
	O_STRING,
Packit 7b22a4
	O_HEX_STRING,
Packit 7b22a4
	F_STRING     = 1 << O_STRING,
Packit 7b22a4
	F_HEX_STRING = 1 << O_HEX_STRING,
Packit 7b22a4
	F_OP_ANY     = F_STRING | F_HEX_STRING,
Packit 7b22a4
};
Packit 7b22a4
Packit 7b22a4
static void string_help(void)
Packit 7b22a4
{
Packit 7b22a4
	printf(
Packit 7b22a4
"string match options:\n"
Packit 7b22a4
"--from                       Offset to start searching from\n"
Packit 7b22a4
"--to                         Offset to stop searching\n"
Packit 7b22a4
"--algo                       Algorithm\n"
Packit 7b22a4
"--icase                      Ignore case (default: 0)\n"
Packit 7b22a4
"[!] --string string          Match a string in a packet\n"
Packit 7b22a4
"[!] --hex-string string      Match a hex string in a packet\n");
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
#define s struct xt_string_info
Packit 7b22a4
static const struct xt_option_entry string_opts[] = {
Packit 7b22a4
	{.name = "from", .id = O_FROM, .type = XTTYPE_UINT16,
Packit 7b22a4
	 .flags = XTOPT_PUT, XTOPT_POINTER(s, from_offset)},
Packit 7b22a4
	{.name = "to", .id = O_TO, .type = XTTYPE_UINT16,
Packit 7b22a4
	 .flags = XTOPT_PUT, XTOPT_POINTER(s, to_offset)},
Packit 7b22a4
	{.name = "algo", .id = O_ALGO, .type = XTTYPE_STRING,
Packit 7b22a4
	 .flags = XTOPT_MAND | XTOPT_PUT, XTOPT_POINTER(s, algo)},
Packit 7b22a4
	{.name = "string", .id = O_STRING, .type = XTTYPE_STRING,
Packit 7b22a4
	 .flags = XTOPT_INVERT, .excl = F_HEX_STRING},
Packit 7b22a4
	{.name = "hex-string", .id = O_HEX_STRING, .type = XTTYPE_STRING,
Packit 7b22a4
	 .flags = XTOPT_INVERT, .excl = F_STRING},
Packit 7b22a4
	{.name = "icase", .id = O_ICASE, .type = XTTYPE_NONE},
Packit 7b22a4
	XTOPT_TABLEEND,
Packit 7b22a4
};
Packit 7b22a4
#undef s
Packit 7b22a4
Packit 7b22a4
static void string_init(struct xt_entry_match *m)
Packit 7b22a4
{
Packit 7b22a4
	struct xt_string_info *i = (struct xt_string_info *) m->data;
Packit 7b22a4
Packit 7b22a4
	i->to_offset = UINT16_MAX;
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void
Packit 7b22a4
parse_string(const char *s, struct xt_string_info *info)
Packit 7b22a4
{	
Packit 7b22a4
	/* xt_string does not need \0 at the end of the pattern */
Packit 7b22a4
	if (strlen(s) <= XT_STRING_MAX_PATTERN_SIZE) {
Packit 7b22a4
		strncpy(info->pattern, s, XT_STRING_MAX_PATTERN_SIZE);
Packit 7b22a4
		info->patlen = strnlen(s, XT_STRING_MAX_PATTERN_SIZE);
Packit 7b22a4
		return;
Packit 7b22a4
	}
Packit 7b22a4
	xtables_error(PARAMETER_PROBLEM, "STRING too long \"%s\"", s);
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void
Packit 7b22a4
parse_hex_string(const char *s, struct xt_string_info *info)
Packit 7b22a4
{
Packit 7b22a4
	int i=0, slen, sindex=0, schar;
Packit 7b22a4
	short hex_f = 0, literal_f = 0;
Packit 7b22a4
	char hextmp[3];
Packit 7b22a4
Packit 7b22a4
	slen = strlen(s);
Packit 7b22a4
Packit 7b22a4
	if (slen == 0) {
Packit 7b22a4
		xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
			"STRING must contain at least one char");
Packit 7b22a4
	}
Packit 7b22a4
Packit 7b22a4
	while (i < slen) {
Packit 7b22a4
		if (sindex >= XT_STRING_MAX_PATTERN_SIZE)
Packit 7b22a4
			xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
				      "STRING too long \"%s\"", s);
Packit 7b22a4
		if (s[i] == '\\' && !hex_f) {
Packit 7b22a4
			literal_f = 1;
Packit 7b22a4
		} else if (s[i] == '\\') {
Packit 7b22a4
			xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
				"Cannot include literals in hex data");
Packit 7b22a4
		} else if (s[i] == '|') {
Packit 7b22a4
			if (hex_f)
Packit 7b22a4
				hex_f = 0;
Packit 7b22a4
			else {
Packit 7b22a4
				hex_f = 1;
Packit 7b22a4
				/* get past any initial whitespace just after the '|' */
Packit 7b22a4
				while (s[i+1] == ' ')
Packit 7b22a4
					i++;
Packit 7b22a4
			}
Packit 7b22a4
			if (i+1 >= slen)
Packit 7b22a4
				break;
Packit 7b22a4
			else
Packit 7b22a4
				i++;  /* advance to the next character */
Packit 7b22a4
		}
Packit 7b22a4
Packit 7b22a4
		if (literal_f) {
Packit 7b22a4
			if (i+1 >= slen) {
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
					"Bad literal placement at end of string");
Packit 7b22a4
			}
Packit 7b22a4
			info->pattern[sindex] = s[i+1];
Packit 7b22a4
			i += 2;  /* skip over literal char */
Packit 7b22a4
			literal_f = 0;
Packit 7b22a4
		} else if (hex_f) {
Packit 7b22a4
			if (i+1 >= slen) {
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
					"Odd number of hex digits");
Packit 7b22a4
			}
Packit 7b22a4
			if (i+2 >= slen) {
Packit 7b22a4
				/* must end with a "|" */
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM, "Invalid hex block");
Packit 7b22a4
			}
Packit 7b22a4
			if (! isxdigit(s[i])) /* check for valid hex char */
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM, "Invalid hex char '%c'", s[i]);
Packit 7b22a4
			if (! isxdigit(s[i+1])) /* check for valid hex char */
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM, "Invalid hex char '%c'", s[i+1]);
Packit 7b22a4
			hextmp[0] = s[i];
Packit 7b22a4
			hextmp[1] = s[i+1];
Packit 7b22a4
			hextmp[2] = '\0';
Packit 7b22a4
			if (! sscanf(hextmp, "%x", &schar))
Packit 7b22a4
				xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
					"Invalid hex char `%c'", s[i]);
Packit 7b22a4
			info->pattern[sindex] = (char) schar;
Packit 7b22a4
			if (s[i+2] == ' ')
Packit 7b22a4
				i += 3;  /* spaces included in the hex block */
Packit 7b22a4
			else
Packit 7b22a4
				i += 2;
Packit 7b22a4
		} else {  /* the char is not part of hex data, so just copy */
Packit 7b22a4
			info->pattern[sindex] = s[i];
Packit 7b22a4
			i++;
Packit 7b22a4
		}
Packit 7b22a4
		sindex++;
Packit 7b22a4
	}
Packit 7b22a4
	info->patlen = sindex;
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void string_parse(struct xt_option_call *cb)
Packit 7b22a4
{
Packit 7b22a4
	struct xt_string_info *stringinfo = cb->data;
Packit 7b22a4
	const unsigned int revision = (*cb->match)->u.user.revision;
Packit 7b22a4
Packit 7b22a4
	xtables_option_parse(cb);
Packit 7b22a4
	switch (cb->entry->id) {
Packit 7b22a4
	case O_STRING:
Packit 7b22a4
		parse_string(cb->arg, stringinfo);
Packit 7b22a4
		if (cb->invert) {
Packit 7b22a4
			if (revision == 0)
Packit 7b22a4
				stringinfo->u.v0.invert = 1;
Packit 7b22a4
			else
Packit 7b22a4
				stringinfo->u.v1.flags |= XT_STRING_FLAG_INVERT;
Packit 7b22a4
		}
Packit 7b22a4
		break;
Packit 7b22a4
	case O_HEX_STRING:
Packit 7b22a4
		parse_hex_string(cb->arg, stringinfo);  /* sets length */
Packit 7b22a4
		if (cb->invert) {
Packit 7b22a4
			if (revision == 0)
Packit 7b22a4
				stringinfo->u.v0.invert = 1;
Packit 7b22a4
			else
Packit 7b22a4
				stringinfo->u.v1.flags |= XT_STRING_FLAG_INVERT;
Packit 7b22a4
		}
Packit 7b22a4
		break;
Packit 7b22a4
	case O_ICASE:
Packit 7b22a4
		if (revision == 0)
Packit 7b22a4
			xtables_error(VERSION_PROBLEM,
Packit 7b22a4
				   "Kernel doesn't support --icase");
Packit 7b22a4
Packit 7b22a4
		stringinfo->u.v1.flags |= XT_STRING_FLAG_IGNORECASE;
Packit 7b22a4
		break;
Packit 7b22a4
	}
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void string_check(struct xt_fcheck_call *cb)
Packit 7b22a4
{
Packit 7b22a4
	if (!(cb->xflags & F_OP_ANY))
Packit 7b22a4
		xtables_error(PARAMETER_PROBLEM,
Packit 7b22a4
			   "STRING match: You must specify `--string' or "
Packit 7b22a4
			   "`--hex-string'");
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
/* Test to see if the string contains non-printable chars or quotes */
Packit 7b22a4
static unsigned short int
Packit 7b22a4
is_hex_string(const char *str, const unsigned short int len)
Packit 7b22a4
{
Packit 7b22a4
	unsigned int i;
Packit 7b22a4
	for (i=0; i < len; i++)
Packit 7b22a4
		if (! isprint(str[i]))
Packit 7b22a4
			return 1;  /* string contains at least one non-printable char */
Packit 7b22a4
	/* use hex output if the last char is a "\" */
Packit 7b22a4
	if (str[len-1] == '\\')
Packit 7b22a4
		return 1;
Packit 7b22a4
	return 0;
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
/* Print string with "|" chars included as one would pass to --hex-string */
Packit 7b22a4
static void
Packit 7b22a4
print_hex_string(const char *str, const unsigned short int len)
Packit 7b22a4
{
Packit 7b22a4
	unsigned int i;
Packit 7b22a4
	/* start hex block */
Packit 7b22a4
	printf(" \"|");
Packit 7b22a4
	for (i=0; i < len; i++)
Packit 7b22a4
		printf("%02x", (unsigned char)str[i]);
Packit 7b22a4
	/* close hex block */
Packit 7b22a4
	printf("|\"");
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void
Packit 7b22a4
print_string(const char *str, const unsigned short int len)
Packit 7b22a4
{
Packit 7b22a4
	unsigned int i;
Packit 7b22a4
	printf(" \"");
Packit 7b22a4
	for (i=0; i < len; i++) {
Packit 7b22a4
		if (str[i] == '\"' || str[i] == '\\')
Packit 7b22a4
			putchar('\\');
Packit 7b22a4
		printf("%c", (unsigned char) str[i]);
Packit 7b22a4
	}
Packit 7b22a4
	printf("\"");  /* closing quote */
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void
Packit 7b22a4
string_print(const void *ip, const struct xt_entry_match *match, int numeric)
Packit 7b22a4
{
Packit 7b22a4
	const struct xt_string_info *info =
Packit 7b22a4
	    (const struct xt_string_info*) match->data;
Packit 7b22a4
	const int revision = match->u.user.revision;
Packit 7b22a4
	int invert = (revision == 0 ? info->u.v0.invert :
Packit 7b22a4
				    info->u.v1.flags & XT_STRING_FLAG_INVERT);
Packit 7b22a4
Packit 7b22a4
	if (is_hex_string(info->pattern, info->patlen)) {
Packit 7b22a4
		printf(" STRING match %s", invert ? "!" : "");
Packit 7b22a4
		print_hex_string(info->pattern, info->patlen);
Packit 7b22a4
	} else {
Packit 7b22a4
		printf(" STRING match %s", invert ? "!" : "");
Packit 7b22a4
		print_string(info->pattern, info->patlen);
Packit 7b22a4
	}
Packit 7b22a4
	printf(" ALGO name %s", info->algo);
Packit 7b22a4
	if (info->from_offset != 0)
Packit 7b22a4
		printf(" FROM %u", info->from_offset);
Packit 7b22a4
	if (info->to_offset != 0)
Packit 7b22a4
		printf(" TO %u", info->to_offset);
Packit 7b22a4
	if (revision > 0 && info->u.v1.flags & XT_STRING_FLAG_IGNORECASE)
Packit 7b22a4
		printf(" ICASE");
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
static void string_save(const void *ip, const struct xt_entry_match *match)
Packit 7b22a4
{
Packit 7b22a4
	const struct xt_string_info *info =
Packit 7b22a4
	    (const struct xt_string_info*) match->data;
Packit 7b22a4
	const int revision = match->u.user.revision;
Packit 7b22a4
	int invert = (revision == 0 ? info->u.v0.invert :
Packit 7b22a4
				    info->u.v1.flags & XT_STRING_FLAG_INVERT);
Packit 7b22a4
Packit 7b22a4
	if (is_hex_string(info->pattern, info->patlen)) {
Packit 7b22a4
		printf("%s --hex-string", (invert) ? " !" : "");
Packit 7b22a4
		print_hex_string(info->pattern, info->patlen);
Packit 7b22a4
	} else {
Packit 7b22a4
		printf("%s --string", (invert) ? " !": "");
Packit 7b22a4
		print_string(info->pattern, info->patlen);
Packit 7b22a4
	}
Packit 7b22a4
	printf(" --algo %s", info->algo);
Packit 7b22a4
	if (info->from_offset != 0)
Packit 7b22a4
		printf(" --from %u", info->from_offset);
Packit 7b22a4
	if (info->to_offset != 0)
Packit 7b22a4
		printf(" --to %u", info->to_offset);
Packit 7b22a4
	if (revision > 0 && info->u.v1.flags & XT_STRING_FLAG_IGNORECASE)
Packit 7b22a4
		printf(" --icase");
Packit 7b22a4
}
Packit 7b22a4
Packit 7b22a4
Packit 7b22a4
static struct xtables_match string_mt_reg[] = {
Packit 7b22a4
	{
Packit 7b22a4
		.name          = "string",
Packit 7b22a4
		.revision      = 0,
Packit 7b22a4
		.family        = NFPROTO_UNSPEC,
Packit 7b22a4
		.version       = XTABLES_VERSION,
Packit 7b22a4
		.size          = XT_ALIGN(sizeof(struct xt_string_info)),
Packit 7b22a4
		.userspacesize = offsetof(struct xt_string_info, config),
Packit 7b22a4
		.help          = string_help,
Packit 7b22a4
		.init          = string_init,
Packit 7b22a4
		.print         = string_print,
Packit 7b22a4
		.save          = string_save,
Packit 7b22a4
		.x6_parse      = string_parse,
Packit 7b22a4
		.x6_fcheck     = string_check,
Packit 7b22a4
		.x6_options    = string_opts,
Packit 7b22a4
	},
Packit 7b22a4
	{
Packit 7b22a4
		.name          = "string",
Packit 7b22a4
		.revision      = 1,
Packit 7b22a4
		.family        = NFPROTO_UNSPEC,
Packit 7b22a4
		.version       = XTABLES_VERSION,
Packit 7b22a4
		.size          = XT_ALIGN(sizeof(struct xt_string_info)),
Packit 7b22a4
		.userspacesize = offsetof(struct xt_string_info, config),
Packit 7b22a4
		.help          = string_help,
Packit 7b22a4
		.init          = string_init,
Packit 7b22a4
		.print         = string_print,
Packit 7b22a4
		.save          = string_save,
Packit 7b22a4
		.x6_parse      = string_parse,
Packit 7b22a4
		.x6_fcheck     = string_check,
Packit 7b22a4
		.x6_options    = string_opts,
Packit 7b22a4
	},
Packit 7b22a4
};
Packit 7b22a4
Packit 7b22a4
void _init(void)
Packit 7b22a4
{
Packit 7b22a4
	xtables_register_matches(string_mt_reg, ARRAY_SIZE(string_mt_reg));
Packit 7b22a4
}