/*
 * This file is part of John the Ripper password cracker,
 * Copyright (c) 1996-98,2009 by Solar Designer
 */

/*
 * Rules support routines.
 */

#ifndef _JOHN_RULES_H
#define _JOHN_RULES_H

#include "loader.h"
#include "rpp.h"

/*
 * Initializes the rules support.
 */
extern void rules_init(int max_length);

/*
 * Processes rule reject flags, based on information from the database.
 * Returns a pointer to the first command in the rule if it's accepted,
 * or NULL if rejected or an error occurred. Also sets rules_errno on
 * error. If the database is NULL, almost all rules are accepted (to be
 * used for syntax checking).
 *
 * split == 0	"single crack" mode rules allowed
 * split < 0	"single crack" mode rules are invalid
 *
 * last may specify which internal buffer must not be touched.
 */
extern char *rules_reject(char *rule, int split, char *last,
	struct db_main *db);

/*
 * Applies rule to a word. Returns the updated word, or NULL if rejected or
 * an error occurred. Also sets rules_errno on error.
 *
 * split > 0	"single crack" mode, split is the second word's position
 * split == 0	"single crack" mode, only one word
 * split < 0	other cracking modes, "single crack" mode rules are invalid
 *
 * If last is non-NULL, it should be the previous mangled word and it is
 * assumed to be properly aligned for ARCH_WORD accesses (pointers returned by
 * rules_apply() are properly aligned).  If the new mangled word matches the
 * previous one, it will be rejected (rules_apply() will return NULL).
 */
extern char *rules_apply(char *word, char *rule, int split, char *last);

/*
 * Similar to rules_check(), but displays a message and does not return on
 * error.  Also performs 'dupe' rule removal, and lists if any rules were removed.
 */
extern int rules_count(struct rpp_context *start, int split);

/*
 * The data lines (linked list), of rules are passed in, and any duplicate
 * rules are removed. The rules are first copied to a temp array, and there
 * they get 'reduced', by dropping the no-op information (calling rules_reject
 * with split==-1 and the db==NULL).  If log is true then any rules that are
 * removed get logged.  The return count is the number of rules removed.
 * 0 return means no dupes found.  NOTE the pLines list can be modified by this
 * function, simply by manipulating the linked list pointers.
 */
extern int rules_remove_dups(struct cfg_line *pLines, int log);

#endif
