home *** CD-ROM | disk | FTP | other *** search
/ Steganos Hacker Tools / SHT151.iso / programme / pw_system / john-16w / doc / CONFIG next >
Encoding:
Text File  |  1998-12-02  |  3.9 KB  |  94 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 global options, define wordlist and "single
  7. crack" mode rules, define parameters for incremental modes, or even define
  8. 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. Some global options can be defined in the [Options] section. Currently you
  23. can set the following:
  24.  
  25. Wordfile    Set to your wordlist file name, to be used in batch mode.
  26.         (That is, when you run John with password files, but not
  27.         specifying a cracking mode.)
  28.  
  29. Idle        If set to 'Y', John will use idle cycles only. Currently
  30.         this is only supported on Linux, if you apply the kernel
  31.         patch found in src/idle.diff. (Note: even though the patch
  32.         is trivial, it is to be considered experimental. You have
  33.         been warned.) When running on Linux without the patch, a
  34.         less efficient implementation, based on sched_yield(), is
  35.         used. On all the other systems this option is equivalent
  36.         to nice(20). By the way, this doesn't affect the startup
  37.         time and non-cracking John runs, as the priority is only
  38.         set before going into the cracking loop.
  39.  
  40. Save        Crash recovery file saving delay in seconds. Adjust this
  41.         when using power-saving, say, on a notebook computer.
  42.  
  43. Beep        If set to 'Y', John will beep when a password is found.
  44.         Why would someone need this, anyway? Still, some people
  45.         requested that I put this feature back in, so it's here.
  46.  
  47.  Defining Wordlist Rules
  48. -------------------------
  49.  
  50. The rules for wordlist and "single crack" modes are defined in separate
  51. sections, [List.Rules:Wordlist] and [List.Rules:Single] respectively. I
  52. used an extended Crack (by Alec Muffett) syntax, since many of you are
  53. already familiar with it. I added some more rules, and (most important)
  54. a preprocessor, which generates multiple rules from a single source line.
  55.  
  56. When defining rules, simply place one rule (which may include preprocessor
  57. commands) per line. See doc/RULES for information on rules syntax and the
  58. preprocessor.
  59.  
  60.  Incremental Mode Parameters
  61. -----------------------------
  62.  
  63. To define the incremental mode parameters you need to create a section
  64. called [Incremental:MODE], where MODE is any identifier that you assign
  65. to the mode. There're some pre-defined incremental modes in the default
  66. configuration file supplied with John, you can use them as templates.
  67.  
  68. The following parameters are supported:
  69.  
  70. File        Set to your charset file name. See doc/EXAMPLES for an
  71.         example on how to generate one.
  72.  
  73. MinLen        Minimum password length, in characters (0 by default).
  74.  
  75. MaxLen        Maximum password length, in characters (CHARSET_LENGTH as
  76.         defined in src/params.h, normally 8, by default).
  77.  
  78. CharCount    Allows you to limit the number of different characters
  79.         used, to make John start trying longer passwords earlier.
  80.         This can also be used to make John print a warning if the
  81.         charset only defines less than CharCount characters. By
  82.         default (when this parameter is not used) all the defined
  83.         characters will be used.
  84.  
  85. Extra        This can be used to make John try some extra characters,
  86.         that don't appear in the charset file. Just list all these
  87.         characters here, they will then be added, but considered
  88.         the least probable.
  89.  
  90.  Defining an External Mode
  91. ---------------------------
  92.  
  93. See doc/EXTERNAL.
  94.