home *** CD-ROM | disk | FTP | other *** search
/ Underground / Underground CD1.iso / hack / progsy / hasla / johnr15 / DOC / CONFIG next >
Encoding:
Text File  |  1998-05-15  |  3.1 KB  |  76 lines
  1.  
  2.  Customizing John the Ripper
  3. =============================
  4.  
  5. John the Ripper's behavior can be customized by editing its configuration
  6. file, ~/john.ini. You can set defaults for command line options, define
  7. wordlist and "single crack" mode rules, define parameters for incremental
  8. modes, or even define a new cracking mode.
  9.  
  10. The configuration file consists of several sections. Each section starts
  11. with a line containing its name, in brackets. Sections consist of either
  12. value assignments to some variables (in form 'variable = value'), or some
  13. other text specific to particular section's type (names of such sections
  14. start with a 'list.'). Section and variable names are not case sensitive.
  15. Lines starting with '#' or ';' and empty lines are ignored, you can use
  16. them for comments, or to comment out lines that you don't want to delete
  17. completely.
  18.  
  19.  General Options
  20. -----------------
  21.  
  22. Defaults for some command line options can be defined in the [Defaults]
  23. section. Currently you can only define one variable:
  24.  
  25. Wordfile    Set to your wordlist file name. This will assume wordlist
  26.         mode by default -- no need to use the '-wordfile' command
  27.         line option unless you want to override this default value.
  28.  
  29.  Defining Wordlist Rules
  30. -------------------------
  31.  
  32. The rules for wordlist and "single crack" modes are defined in separate
  33. sections, [List.Rules:Wordlist] and [List.Rules:Single] respectively. I
  34. used an extended Crack (by Alec Muffett) syntax, since many of you are
  35. already familiar with it. I added some more rules, and (most important)
  36. a preprocessor, which generates multiple rules from a single source line.
  37.  
  38. When defining rules, simply place one rule (which may include preprocessor
  39. commands) per line. See doc/RULES for information on rules syntax and the
  40. preprocessor.
  41.  
  42.  Incremental Mode Parameters
  43. -----------------------------
  44.  
  45. To define the incremental mode parameters you need to create a section
  46. called [Incremental:MODE], where MODE is any identifier that you assign
  47. to the mode. There're some pre-defined incremental modes in the default
  48. configuration file supplied with John, you can use them as templates.
  49.  
  50. The following parameters are supported:
  51.  
  52. File        Set to your charset file name. See doc/EXAMPLES for an
  53.         example on how to generate one.
  54.  
  55. MinLen        Minimum password length, in characters (0 by default).
  56.  
  57. MaxLen        Maximum password length, in characters (CHARSET_LENGTH as
  58.         defined in src/params.h, normally 8, by default).
  59.  
  60. CharCount    Allows you to limit the number of different characters
  61.         used, to make John start trying longer passwords earlier.
  62.         This can also be used to make John print a warning if the
  63.         charset only defines less than CharCount characters. By
  64.         default (when this parameter is not used) all the defined
  65.         characters will be used.
  66.  
  67. Extra        This can be used to make John try some extra characters,
  68.         that don't appear in the charset file. Just list all these
  69.         characters here, they will then be added, but considered
  70.         the least probable.
  71.  
  72.  Defining an External Mode
  73. ---------------------------
  74.  
  75. See doc/EXTERNAL.
  76.