2 * lib/ts_bm.c Boyer-Moore text search implementation
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
7 * 2 of the License, or (at your option) any later version.
9 * Authors: Pablo Neira Ayuso <pablo@eurodev.net>
11 * ==========================================================================
13 * Implements Boyer-Moore string matching algorithm:
15 * [1] A Fast String Searching Algorithm, R.S. Boyer and Moore.
16 * Communications of the Association for Computing Machinery,
17 * 20(10), 1977, pp. 762-772.
18 * http://www.cs.utexas.edu/users/moore/publications/fstrpos.pdf
20 * [2] Handbook of Exact String Matching Algorithms, Thierry Lecroq, 2004
21 * http://www-igm.univ-mlv.fr/~lecroq/string/string.pdf
23 * Note: Since Boyer-Moore (BM) performs searches for matchings from right
24 * to left, it's still possible that a matching could be spread over
25 * multiple blocks, in that case this algorithm won't find any coincidence.
27 * If you're willing to ensure that such thing won't ever happen, use the
28 * Knuth-Pratt-Morris (KMP) implementation instead. In conclusion, choose
29 * the proper string search algorithm depending on your setting.
31 * Say you're using the textsearch infrastructure for filtering, NIDS or
32 * any similar security focused purpose, then go KMP. Otherwise, if you
33 * really care about performance, say you're classifying packets to apply
34 * Quality of Service (QoS) policies, and you don't mind about possible
35 * matchings spread over multiple fragments, then go BM.
38 #include <linux/config.h>
39 #include <linux/kernel.h>
40 #include <linux/module.h>
41 #include <linux/types.h>
42 #include <linux/string.h>
43 #include <linux/textsearch.h>
45 /* Alphabet size, use ASCII */
51 #define DEBUGP(args, format...)
58 unsigned int bad_shift[ASIZE];
59 unsigned int good_shift[0];
62 static unsigned int bm_find(struct ts_config *conf, struct ts_state *state)
64 struct ts_bm *bm = ts_config_priv(conf);
65 unsigned int i, text_len, consumed = state->offset;
67 int shift = bm->patlen, bs;
70 text_len = conf->get_next_block(consumed, &text, conf, state);
72 if (unlikely(text_len == 0))
75 while (shift < text_len) {
76 DEBUGP("Searching in position %d (%c)\n",
78 for (i = 0; i < bm->patlen; i++)
79 if (text[shift-i] != bm->pattern[bm->patlen-1-i])
82 /* London calling... */
84 return consumed += (shift-(bm->patlen-1));
86 next: bs = bm->bad_shift[text[shift-i]];
88 /* Now jumping to... */
89 shift = max_t(int, shift-i+bs, shift+bm->good_shift[i]);
97 static void compute_prefix_tbl(struct ts_bm *bm, const u8 *pattern,
100 int i, j, ended, l[ASIZE];
102 for (i = 0; i < ASIZE; i++)
103 bm->bad_shift[i] = len;
104 for (i = 0; i < len - 1; i++)
105 bm->bad_shift[pattern[i]] = len - 1 - i;
107 /* Compute the good shift array, used to match reocurrences
109 for (i = 1; i < bm->patlen; i++) {
110 for (j = 0; j < bm->patlen && bm->pattern[bm->patlen - 1 - j]
111 == bm->pattern[bm->patlen - 1 - i - j]; j++);
115 bm->good_shift[0] = 1;
116 for (i = 1; i < bm->patlen; i++)
117 bm->good_shift[i] = bm->patlen;
118 for (i = bm->patlen - 1; i > 0; i--)
119 bm->good_shift[l[i]] = i;
121 for (i = 0; i < bm->patlen; i++) {
122 if (l[i] == bm->patlen - 1 - i)
125 bm->good_shift[i] = ended;
129 static struct ts_config *bm_init(const void *pattern, unsigned int len,
130 unsigned int __nocast gfp_mask)
132 struct ts_config *conf;
134 unsigned int prefix_tbl_len = len * sizeof(unsigned int);
135 size_t priv_size = sizeof(*bm) + len + prefix_tbl_len;
137 conf = alloc_ts_config(priv_size, gfp_mask);
141 bm = ts_config_priv(conf);
143 bm->pattern = (u8 *) bm->good_shift + prefix_tbl_len;
144 compute_prefix_tbl(bm, pattern, len);
145 memcpy(bm->pattern, pattern, len);
150 static void *bm_get_pattern(struct ts_config *conf)
152 struct ts_bm *bm = ts_config_priv(conf);
156 static unsigned int bm_get_pattern_len(struct ts_config *conf)
158 struct ts_bm *bm = ts_config_priv(conf);
162 static struct ts_ops bm_ops = {
166 .get_pattern = bm_get_pattern,
167 .get_pattern_len = bm_get_pattern_len,
168 .owner = THIS_MODULE,
169 .list = LIST_HEAD_INIT(bm_ops.list)
172 static int __init init_bm(void)
174 return textsearch_register(&bm_ops);
177 static void __exit exit_bm(void)
179 textsearch_unregister(&bm_ops);
182 MODULE_LICENSE("GPL");
184 module_init(init_bm);
185 module_exit(exit_bm);