xref: /openbmc/linux/security/apparmor/match.c (revision 6d99a79c)
1 /*
2  * AppArmor security module
3  *
4  * This file contains AppArmor dfa based regular expression matching engine
5  *
6  * Copyright (C) 1998-2008 Novell/SUSE
7  * Copyright 2009-2012 Canonical Ltd.
8  *
9  * This program is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU General Public License as
11  * published by the Free Software Foundation, version 2 of the
12  * License.
13  */
14 
15 #include <linux/errno.h>
16 #include <linux/kernel.h>
17 #include <linux/mm.h>
18 #include <linux/slab.h>
19 #include <linux/vmalloc.h>
20 #include <linux/err.h>
21 #include <linux/kref.h>
22 
23 #include "include/lib.h"
24 #include "include/match.h"
25 
26 #define base_idx(X) ((X) & 0xffffff)
27 
28 static char nulldfa_src[] = {
29 	#include "nulldfa.in"
30 };
31 struct aa_dfa *nulldfa;
32 
33 static char stacksplitdfa_src[] = {
34 	#include "stacksplitdfa.in"
35 };
36 struct aa_dfa *stacksplitdfa;
37 
38 int aa_setup_dfa_engine(void)
39 {
40 	int error;
41 
42 	nulldfa = aa_dfa_unpack(nulldfa_src, sizeof(nulldfa_src),
43 				TO_ACCEPT1_FLAG(YYTD_DATA32) |
44 				TO_ACCEPT2_FLAG(YYTD_DATA32));
45 	if (IS_ERR(nulldfa)) {
46 		error = PTR_ERR(nulldfa);
47 		nulldfa = NULL;
48 		return error;
49 	}
50 
51 	stacksplitdfa = aa_dfa_unpack(stacksplitdfa_src,
52 				      sizeof(stacksplitdfa_src),
53 				      TO_ACCEPT1_FLAG(YYTD_DATA32) |
54 				      TO_ACCEPT2_FLAG(YYTD_DATA32));
55 	if (IS_ERR(stacksplitdfa)) {
56 		aa_put_dfa(nulldfa);
57 		nulldfa = NULL;
58 		error = PTR_ERR(stacksplitdfa);
59 		stacksplitdfa = NULL;
60 		return error;
61 	}
62 
63 	return 0;
64 }
65 
66 void aa_teardown_dfa_engine(void)
67 {
68 	aa_put_dfa(stacksplitdfa);
69 	aa_put_dfa(nulldfa);
70 }
71 
72 /**
73  * unpack_table - unpack a dfa table (one of accept, default, base, next check)
74  * @blob: data to unpack (NOT NULL)
75  * @bsize: size of blob
76  *
77  * Returns: pointer to table else NULL on failure
78  *
79  * NOTE: must be freed by kvfree (not kfree)
80  */
81 static struct table_header *unpack_table(char *blob, size_t bsize)
82 {
83 	struct table_header *table = NULL;
84 	struct table_header th;
85 	size_t tsize;
86 
87 	if (bsize < sizeof(struct table_header))
88 		goto out;
89 
90 	/* loaded td_id's start at 1, subtract 1 now to avoid doing
91 	 * it every time we use td_id as an index
92 	 */
93 	th.td_id = be16_to_cpu(*(__be16 *) (blob)) - 1;
94 	if (th.td_id > YYTD_ID_MAX)
95 		goto out;
96 	th.td_flags = be16_to_cpu(*(__be16 *) (blob + 2));
97 	th.td_lolen = be32_to_cpu(*(__be32 *) (blob + 8));
98 	blob += sizeof(struct table_header);
99 
100 	if (!(th.td_flags == YYTD_DATA16 || th.td_flags == YYTD_DATA32 ||
101 	      th.td_flags == YYTD_DATA8))
102 		goto out;
103 
104 	tsize = table_size(th.td_lolen, th.td_flags);
105 	if (bsize < tsize)
106 		goto out;
107 
108 	table = kvzalloc(tsize, GFP_KERNEL);
109 	if (table) {
110 		table->td_id = th.td_id;
111 		table->td_flags = th.td_flags;
112 		table->td_lolen = th.td_lolen;
113 		if (th.td_flags == YYTD_DATA8)
114 			UNPACK_ARRAY(table->td_data, blob, th.td_lolen,
115 				     u8, u8, byte_to_byte);
116 		else if (th.td_flags == YYTD_DATA16)
117 			UNPACK_ARRAY(table->td_data, blob, th.td_lolen,
118 				     u16, __be16, be16_to_cpu);
119 		else if (th.td_flags == YYTD_DATA32)
120 			UNPACK_ARRAY(table->td_data, blob, th.td_lolen,
121 				     u32, __be32, be32_to_cpu);
122 		else
123 			goto fail;
124 		/* if table was vmalloced make sure the page tables are synced
125 		 * before it is used, as it goes live to all cpus.
126 		 */
127 		if (is_vmalloc_addr(table))
128 			vm_unmap_aliases();
129 	}
130 
131 out:
132 	return table;
133 fail:
134 	kvfree(table);
135 	return NULL;
136 }
137 
138 /**
139  * verify_table_headers - verify that the tables headers are as expected
140  * @tables - array of dfa tables to check (NOT NULL)
141  * @flags: flags controlling what type of accept table are acceptable
142  *
143  * Assumes dfa has gone through the first pass verification done by unpacking
144  * NOTE: this does not valid accept table values
145  *
146  * Returns: %0 else error code on failure to verify
147  */
148 static int verify_table_headers(struct table_header **tables, int flags)
149 {
150 	size_t state_count, trans_count;
151 	int error = -EPROTO;
152 
153 	/* check that required tables exist */
154 	if (!(tables[YYTD_ID_DEF] && tables[YYTD_ID_BASE] &&
155 	      tables[YYTD_ID_NXT] && tables[YYTD_ID_CHK]))
156 		goto out;
157 
158 	/* accept.size == default.size == base.size */
159 	state_count = tables[YYTD_ID_BASE]->td_lolen;
160 	if (ACCEPT1_FLAGS(flags)) {
161 		if (!tables[YYTD_ID_ACCEPT])
162 			goto out;
163 		if (state_count != tables[YYTD_ID_ACCEPT]->td_lolen)
164 			goto out;
165 	}
166 	if (ACCEPT2_FLAGS(flags)) {
167 		if (!tables[YYTD_ID_ACCEPT2])
168 			goto out;
169 		if (state_count != tables[YYTD_ID_ACCEPT2]->td_lolen)
170 			goto out;
171 	}
172 	if (state_count != tables[YYTD_ID_DEF]->td_lolen)
173 		goto out;
174 
175 	/* next.size == chk.size */
176 	trans_count = tables[YYTD_ID_NXT]->td_lolen;
177 	if (trans_count != tables[YYTD_ID_CHK]->td_lolen)
178 		goto out;
179 
180 	/* if equivalence classes then its table size must be 256 */
181 	if (tables[YYTD_ID_EC] && tables[YYTD_ID_EC]->td_lolen != 256)
182 		goto out;
183 
184 	error = 0;
185 out:
186 	return error;
187 }
188 
189 /**
190  * verify_dfa - verify that transitions and states in the tables are in bounds.
191  * @dfa: dfa to test  (NOT NULL)
192  *
193  * Assumes dfa has gone through the first pass verification done by unpacking
194  * NOTE: this does not valid accept table values
195  *
196  * Returns: %0 else error code on failure to verify
197  */
198 static int verify_dfa(struct aa_dfa *dfa)
199 {
200 	size_t i, state_count, trans_count;
201 	int error = -EPROTO;
202 
203 	state_count = dfa->tables[YYTD_ID_BASE]->td_lolen;
204 	trans_count = dfa->tables[YYTD_ID_NXT]->td_lolen;
205 	for (i = 0; i < state_count; i++) {
206 		if (!(BASE_TABLE(dfa)[i] & MATCH_FLAG_DIFF_ENCODE) &&
207 		    (DEFAULT_TABLE(dfa)[i] >= state_count))
208 			goto out;
209 		if (base_idx(BASE_TABLE(dfa)[i]) + 255 >= trans_count) {
210 			pr_err("AppArmor DFA next/check upper bounds error\n");
211 			goto out;
212 		}
213 	}
214 
215 	for (i = 0; i < trans_count; i++) {
216 		if (NEXT_TABLE(dfa)[i] >= state_count)
217 			goto out;
218 		if (CHECK_TABLE(dfa)[i] >= state_count)
219 			goto out;
220 	}
221 
222 	/* Now that all the other tables are verified, verify diffencoding */
223 	for (i = 0; i < state_count; i++) {
224 		size_t j, k;
225 
226 		for (j = i;
227 		     (BASE_TABLE(dfa)[j] & MATCH_FLAG_DIFF_ENCODE) &&
228 		     !(BASE_TABLE(dfa)[j] & MARK_DIFF_ENCODE);
229 		     j = k) {
230 			k = DEFAULT_TABLE(dfa)[j];
231 			if (j == k)
232 				goto out;
233 			if (k < j)
234 				break;		/* already verified */
235 			BASE_TABLE(dfa)[j] |= MARK_DIFF_ENCODE;
236 		}
237 	}
238 	error = 0;
239 
240 out:
241 	return error;
242 }
243 
244 /**
245  * dfa_free - free a dfa allocated by aa_dfa_unpack
246  * @dfa: the dfa to free  (MAYBE NULL)
247  *
248  * Requires: reference count to dfa == 0
249  */
250 static void dfa_free(struct aa_dfa *dfa)
251 {
252 	if (dfa) {
253 		int i;
254 
255 		for (i = 0; i < ARRAY_SIZE(dfa->tables); i++) {
256 			kvfree(dfa->tables[i]);
257 			dfa->tables[i] = NULL;
258 		}
259 		kfree(dfa);
260 	}
261 }
262 
263 /**
264  * aa_dfa_free_kref - free aa_dfa by kref (called by aa_put_dfa)
265  * @kr: kref callback for freeing of a dfa  (NOT NULL)
266  */
267 void aa_dfa_free_kref(struct kref *kref)
268 {
269 	struct aa_dfa *dfa = container_of(kref, struct aa_dfa, count);
270 	dfa_free(dfa);
271 }
272 
273 /**
274  * aa_dfa_unpack - unpack the binary tables of a serialized dfa
275  * @blob: aligned serialized stream of data to unpack  (NOT NULL)
276  * @size: size of data to unpack
277  * @flags: flags controlling what type of accept tables are acceptable
278  *
279  * Unpack a dfa that has been serialized.  To find information on the dfa
280  * format look in Documentation/admin-guide/LSM/apparmor.rst
281  * Assumes the dfa @blob stream has been aligned on a 8 byte boundary
282  *
283  * Returns: an unpacked dfa ready for matching or ERR_PTR on failure
284  */
285 struct aa_dfa *aa_dfa_unpack(void *blob, size_t size, int flags)
286 {
287 	int hsize;
288 	int error = -ENOMEM;
289 	char *data = blob;
290 	struct table_header *table = NULL;
291 	struct aa_dfa *dfa = kzalloc(sizeof(struct aa_dfa), GFP_KERNEL);
292 	if (!dfa)
293 		goto fail;
294 
295 	kref_init(&dfa->count);
296 
297 	error = -EPROTO;
298 
299 	/* get dfa table set header */
300 	if (size < sizeof(struct table_set_header))
301 		goto fail;
302 
303 	if (ntohl(*(__be32 *) data) != YYTH_MAGIC)
304 		goto fail;
305 
306 	hsize = ntohl(*(__be32 *) (data + 4));
307 	if (size < hsize)
308 		goto fail;
309 
310 	dfa->flags = ntohs(*(__be16 *) (data + 12));
311 	if (dfa->flags != 0 && dfa->flags != YYTH_FLAG_DIFF_ENCODE)
312 		goto fail;
313 
314 	data += hsize;
315 	size -= hsize;
316 
317 	while (size > 0) {
318 		table = unpack_table(data, size);
319 		if (!table)
320 			goto fail;
321 
322 		switch (table->td_id) {
323 		case YYTD_ID_ACCEPT:
324 			if (!(table->td_flags & ACCEPT1_FLAGS(flags)))
325 				goto fail;
326 			break;
327 		case YYTD_ID_ACCEPT2:
328 			if (!(table->td_flags & ACCEPT2_FLAGS(flags)))
329 				goto fail;
330 			break;
331 		case YYTD_ID_BASE:
332 			if (table->td_flags != YYTD_DATA32)
333 				goto fail;
334 			break;
335 		case YYTD_ID_DEF:
336 		case YYTD_ID_NXT:
337 		case YYTD_ID_CHK:
338 			if (table->td_flags != YYTD_DATA16)
339 				goto fail;
340 			break;
341 		case YYTD_ID_EC:
342 			if (table->td_flags != YYTD_DATA8)
343 				goto fail;
344 			break;
345 		default:
346 			goto fail;
347 		}
348 		/* check for duplicate table entry */
349 		if (dfa->tables[table->td_id])
350 			goto fail;
351 		dfa->tables[table->td_id] = table;
352 		data += table_size(table->td_lolen, table->td_flags);
353 		size -= table_size(table->td_lolen, table->td_flags);
354 		table = NULL;
355 	}
356 	error = verify_table_headers(dfa->tables, flags);
357 	if (error)
358 		goto fail;
359 
360 	if (flags & DFA_FLAG_VERIFY_STATES) {
361 		error = verify_dfa(dfa);
362 		if (error)
363 			goto fail;
364 	}
365 
366 	return dfa;
367 
368 fail:
369 	kvfree(table);
370 	dfa_free(dfa);
371 	return ERR_PTR(error);
372 }
373 
374 #define match_char(state, def, base, next, check, C)	\
375 do {							\
376 	u32 b = (base)[(state)];			\
377 	unsigned int pos = base_idx(b) + (C);		\
378 	if ((check)[pos] != (state)) {			\
379 		(state) = (def)[(state)];		\
380 		if (b & MATCH_FLAG_DIFF_ENCODE)		\
381 			continue;			\
382 		break;					\
383 	}						\
384 	(state) = (next)[pos];				\
385 	break;						\
386 } while (1)
387 
388 /**
389  * aa_dfa_match_len - traverse @dfa to find state @str stops at
390  * @dfa: the dfa to match @str against  (NOT NULL)
391  * @start: the state of the dfa to start matching in
392  * @str: the string of bytes to match against the dfa  (NOT NULL)
393  * @len: length of the string of bytes to match
394  *
395  * aa_dfa_match_len will match @str against the dfa and return the state it
396  * finished matching in. The final state can be used to look up the accepting
397  * label, or as the start state of a continuing match.
398  *
399  * This function will happily match again the 0 byte and only finishes
400  * when @len input is consumed.
401  *
402  * Returns: final state reached after input is consumed
403  */
404 unsigned int aa_dfa_match_len(struct aa_dfa *dfa, unsigned int start,
405 			      const char *str, int len)
406 {
407 	u16 *def = DEFAULT_TABLE(dfa);
408 	u32 *base = BASE_TABLE(dfa);
409 	u16 *next = NEXT_TABLE(dfa);
410 	u16 *check = CHECK_TABLE(dfa);
411 	unsigned int state = start;
412 
413 	if (state == 0)
414 		return 0;
415 
416 	/* current state is <state>, matching character *str */
417 	if (dfa->tables[YYTD_ID_EC]) {
418 		/* Equivalence class table defined */
419 		u8 *equiv = EQUIV_TABLE(dfa);
420 		for (; len; len--)
421 			match_char(state, def, base, next, check,
422 				   equiv[(u8) *str++]);
423 	} else {
424 		/* default is direct to next state */
425 		for (; len; len--)
426 			match_char(state, def, base, next, check, (u8) *str++);
427 	}
428 
429 	return state;
430 }
431 
432 /**
433  * aa_dfa_match - traverse @dfa to find state @str stops at
434  * @dfa: the dfa to match @str against  (NOT NULL)
435  * @start: the state of the dfa to start matching in
436  * @str: the null terminated string of bytes to match against the dfa (NOT NULL)
437  *
438  * aa_dfa_match will match @str against the dfa and return the state it
439  * finished matching in. The final state can be used to look up the accepting
440  * label, or as the start state of a continuing match.
441  *
442  * Returns: final state reached after input is consumed
443  */
444 unsigned int aa_dfa_match(struct aa_dfa *dfa, unsigned int start,
445 			  const char *str)
446 {
447 	u16 *def = DEFAULT_TABLE(dfa);
448 	u32 *base = BASE_TABLE(dfa);
449 	u16 *next = NEXT_TABLE(dfa);
450 	u16 *check = CHECK_TABLE(dfa);
451 	unsigned int state = start;
452 
453 	if (state == 0)
454 		return 0;
455 
456 	/* current state is <state>, matching character *str */
457 	if (dfa->tables[YYTD_ID_EC]) {
458 		/* Equivalence class table defined */
459 		u8 *equiv = EQUIV_TABLE(dfa);
460 		/* default is direct to next state */
461 		while (*str)
462 			match_char(state, def, base, next, check,
463 				   equiv[(u8) *str++]);
464 	} else {
465 		/* default is direct to next state */
466 		while (*str)
467 			match_char(state, def, base, next, check, (u8) *str++);
468 	}
469 
470 	return state;
471 }
472 
473 /**
474  * aa_dfa_next - step one character to the next state in the dfa
475  * @dfa: the dfa to traverse (NOT NULL)
476  * @state: the state to start in
477  * @c: the input character to transition on
478  *
479  * aa_dfa_match will step through the dfa by one input character @c
480  *
481  * Returns: state reach after input @c
482  */
483 unsigned int aa_dfa_next(struct aa_dfa *dfa, unsigned int state,
484 			  const char c)
485 {
486 	u16 *def = DEFAULT_TABLE(dfa);
487 	u32 *base = BASE_TABLE(dfa);
488 	u16 *next = NEXT_TABLE(dfa);
489 	u16 *check = CHECK_TABLE(dfa);
490 
491 	/* current state is <state>, matching character *str */
492 	if (dfa->tables[YYTD_ID_EC]) {
493 		/* Equivalence class table defined */
494 		u8 *equiv = EQUIV_TABLE(dfa);
495 		match_char(state, def, base, next, check, equiv[(u8) c]);
496 	} else
497 		match_char(state, def, base, next, check, (u8) c);
498 
499 	return state;
500 }
501 
502 /**
503  * aa_dfa_match_until - traverse @dfa until accept state or end of input
504  * @dfa: the dfa to match @str against  (NOT NULL)
505  * @start: the state of the dfa to start matching in
506  * @str: the null terminated string of bytes to match against the dfa (NOT NULL)
507  * @retpos: first character in str after match OR end of string
508  *
509  * aa_dfa_match will match @str against the dfa and return the state it
510  * finished matching in. The final state can be used to look up the accepting
511  * label, or as the start state of a continuing match.
512  *
513  * Returns: final state reached after input is consumed
514  */
515 unsigned int aa_dfa_match_until(struct aa_dfa *dfa, unsigned int start,
516 				const char *str, const char **retpos)
517 {
518 	u16 *def = DEFAULT_TABLE(dfa);
519 	u32 *base = BASE_TABLE(dfa);
520 	u16 *next = NEXT_TABLE(dfa);
521 	u16 *check = CHECK_TABLE(dfa);
522 	u32 *accept = ACCEPT_TABLE(dfa);
523 	unsigned int state = start, pos;
524 
525 	if (state == 0)
526 		return 0;
527 
528 	/* current state is <state>, matching character *str */
529 	if (dfa->tables[YYTD_ID_EC]) {
530 		/* Equivalence class table defined */
531 		u8 *equiv = EQUIV_TABLE(dfa);
532 		/* default is direct to next state */
533 		while (*str) {
534 			pos = base_idx(base[state]) + equiv[(u8) *str++];
535 			if (check[pos] == state)
536 				state = next[pos];
537 			else
538 				state = def[state];
539 			if (accept[state])
540 				break;
541 		}
542 	} else {
543 		/* default is direct to next state */
544 		while (*str) {
545 			pos = base_idx(base[state]) + (u8) *str++;
546 			if (check[pos] == state)
547 				state = next[pos];
548 			else
549 				state = def[state];
550 			if (accept[state])
551 				break;
552 		}
553 	}
554 
555 	*retpos = str;
556 	return state;
557 }
558 
559 /**
560  * aa_dfa_matchn_until - traverse @dfa until accept or @n bytes consumed
561  * @dfa: the dfa to match @str against  (NOT NULL)
562  * @start: the state of the dfa to start matching in
563  * @str: the string of bytes to match against the dfa  (NOT NULL)
564  * @n: length of the string of bytes to match
565  * @retpos: first character in str after match OR str + n
566  *
567  * aa_dfa_match_len will match @str against the dfa and return the state it
568  * finished matching in. The final state can be used to look up the accepting
569  * label, or as the start state of a continuing match.
570  *
571  * This function will happily match again the 0 byte and only finishes
572  * when @n input is consumed.
573  *
574  * Returns: final state reached after input is consumed
575  */
576 unsigned int aa_dfa_matchn_until(struct aa_dfa *dfa, unsigned int start,
577 				 const char *str, int n, const char **retpos)
578 {
579 	u16 *def = DEFAULT_TABLE(dfa);
580 	u32 *base = BASE_TABLE(dfa);
581 	u16 *next = NEXT_TABLE(dfa);
582 	u16 *check = CHECK_TABLE(dfa);
583 	u32 *accept = ACCEPT_TABLE(dfa);
584 	unsigned int state = start, pos;
585 
586 	*retpos = NULL;
587 	if (state == 0)
588 		return 0;
589 
590 	/* current state is <state>, matching character *str */
591 	if (dfa->tables[YYTD_ID_EC]) {
592 		/* Equivalence class table defined */
593 		u8 *equiv = EQUIV_TABLE(dfa);
594 		/* default is direct to next state */
595 		for (; n; n--) {
596 			pos = base_idx(base[state]) + equiv[(u8) *str++];
597 			if (check[pos] == state)
598 				state = next[pos];
599 			else
600 				state = def[state];
601 			if (accept[state])
602 				break;
603 		}
604 	} else {
605 		/* default is direct to next state */
606 		for (; n; n--) {
607 			pos = base_idx(base[state]) + (u8) *str++;
608 			if (check[pos] == state)
609 				state = next[pos];
610 			else
611 				state = def[state];
612 			if (accept[state])
613 				break;
614 		}
615 	}
616 
617 	*retpos = str;
618 	return state;
619 }
620 
621 #define inc_wb_pos(wb)						\
622 do {								\
623 	wb->pos = (wb->pos + 1) & (wb->size - 1);		\
624 	wb->len = (wb->len + 1) & (wb->size - 1);		\
625 } while (0)
626 
627 /* For DFAs that don't support extended tagging of states */
628 static bool is_loop(struct match_workbuf *wb, unsigned int state,
629 		    unsigned int *adjust)
630 {
631 	unsigned int pos = wb->pos;
632 	unsigned int i;
633 
634 	if (wb->history[pos] < state)
635 		return false;
636 
637 	for (i = 0; i <= wb->len; i++) {
638 		if (wb->history[pos] == state) {
639 			*adjust = i;
640 			return true;
641 		}
642 		if (pos == 0)
643 			pos = wb->size;
644 		pos--;
645 	}
646 
647 	*adjust = i;
648 	return true;
649 }
650 
651 static unsigned int leftmatch_fb(struct aa_dfa *dfa, unsigned int start,
652 				 const char *str, struct match_workbuf *wb,
653 				 unsigned int *count)
654 {
655 	u16 *def = DEFAULT_TABLE(dfa);
656 	u32 *base = BASE_TABLE(dfa);
657 	u16 *next = NEXT_TABLE(dfa);
658 	u16 *check = CHECK_TABLE(dfa);
659 	unsigned int state = start, pos;
660 
661 	AA_BUG(!dfa);
662 	AA_BUG(!str);
663 	AA_BUG(!wb);
664 	AA_BUG(!count);
665 
666 	*count = 0;
667 	if (state == 0)
668 		return 0;
669 
670 	/* current state is <state>, matching character *str */
671 	if (dfa->tables[YYTD_ID_EC]) {
672 		/* Equivalence class table defined */
673 		u8 *equiv = EQUIV_TABLE(dfa);
674 		/* default is direct to next state */
675 		while (*str) {
676 			unsigned int adjust;
677 
678 			wb->history[wb->pos] = state;
679 			pos = base_idx(base[state]) + equiv[(u8) *str++];
680 			if (check[pos] == state)
681 				state = next[pos];
682 			else
683 				state = def[state];
684 			if (is_loop(wb, state, &adjust)) {
685 				state = aa_dfa_match(dfa, state, str);
686 				*count -= adjust;
687 				goto out;
688 			}
689 			inc_wb_pos(wb);
690 			(*count)++;
691 		}
692 	} else {
693 		/* default is direct to next state */
694 		while (*str) {
695 			unsigned int adjust;
696 
697 			wb->history[wb->pos] = state;
698 			pos = base_idx(base[state]) + (u8) *str++;
699 			if (check[pos] == state)
700 				state = next[pos];
701 			else
702 				state = def[state];
703 			if (is_loop(wb, state, &adjust)) {
704 				state = aa_dfa_match(dfa, state, str);
705 				*count -= adjust;
706 				goto out;
707 			}
708 			inc_wb_pos(wb);
709 			(*count)++;
710 		}
711 	}
712 
713 out:
714 	if (!state)
715 		*count = 0;
716 	return state;
717 }
718 
719 /**
720  * aa_dfa_leftmatch - traverse @dfa to find state @str stops at
721  * @dfa: the dfa to match @str against  (NOT NULL)
722  * @start: the state of the dfa to start matching in
723  * @str: the null terminated string of bytes to match against the dfa (NOT NULL)
724  * @count: current count of longest left.
725  *
726  * aa_dfa_match will match @str against the dfa and return the state it
727  * finished matching in. The final state can be used to look up the accepting
728  * label, or as the start state of a continuing match.
729  *
730  * Returns: final state reached after input is consumed
731  */
732 unsigned int aa_dfa_leftmatch(struct aa_dfa *dfa, unsigned int start,
733 			      const char *str, unsigned int *count)
734 {
735 	DEFINE_MATCH_WB(wb);
736 
737 	/* TODO: match for extended state dfas */
738 
739 	return leftmatch_fb(dfa, start, str, &wb, count);
740 }
741