This shows you the differences between two versions of the page.
|
john:how-to-extract-tarballs-and-apply-patches [2008/05/02 02:28] solar created |
john:how-to-extract-tarballs-and-apply-patches [2023/12/15 17:15] (current) ukasz old revision restored (2023/12/15 17:08) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== How to extract John the Ripper source code from tarballs ====== | ====== How to extract John the Ripper source code from tarballs ====== | ||
| - | John the Ripper source code is distributed in the form of tarballs ([[http://en.wikipedia.org/wiki/Tar_%28file_format%29|tar]] archives) compressed with either gzip or bzip2. On a Unix-like system with GNU tar (or on [[http://www.cygwin.com|Cygwin]] if you use Windows), please use the following command for gzip-compressed tarballs: | + | John the Ripper source code is distributed in the form of tarballs ([[wp>Tar_(file_format)|tar]] archives) compressed with [[http://www.gzip.org|gzip]], [[http://tukaani.org/xz/|xz]], or (for older versions) [[http://www.bzip.org|bzip2]]. On a [[wp>Unix-like|Unix-like]] system with [[http://www.gnu.org/software/tar/|GNU tar]] (or on [[http://www.cygwin.com|Cygwin]] if you use Windows), please use the following command for gzip-compressed tarballs: |
| - | ''tar xzvf john-VERSION.tar.gz'' | + | tar xzvf john-VERSION.tar.gz |
| + | |||
| + | (where ''VERSION'' is a John the Ripper version number, such as 1.8.0). For xz-compressed tarballs use (note the uppercase "J"): | ||
| + | |||
| + | tar xJvf john-VERSION.tar.xz | ||
| + | |||
| + | For bzip2-compressed tarballs use (note the lowercase "j"): | ||
| + | |||
| + | tar xjvf john-VERSION.tar.bz2 | ||
| + | |||
| + | On some commercial Unices, you might need to download and install gzip or xz or bzip2 on your own (perhaps from a pre-compiled freeware archive for your flavor of Unix) and/or to use more complicated command-line syntax, such as: | ||
| + | |||
| + | gzip -dc john-VERSION.tar.gz | tar xvf - | ||
| + | |||
| + | Please refer to man (manual) pages, [[http://www.gnu.org/software/texinfo/|texinfo]] documentation, and/or web pages on [[http://www.gnu.org/software/tar/manual/|tar]], [[http://www.gnu.org/software/gzip/manual/|gzip]], [[http://tukaani.org/xz/|xz]], and [[http://www.bzip.org/docs.html|bzip2]] for information on the command-line options. | ||
| + | |||
| + | ====== How to apply John the Ripper source code patches ====== | ||
| + | |||
| + | To apply a contributed patch that was generated in accordance with [[:how-to-make-patches|our conventions]] and compressed with gzip, on a Unix-like system with GNU software (or on Cygwin), please use the following commands (assuming that you have just extracted the source code from a tarball as shown above): | ||
| + | |||
| + | <code> | ||
| + | cd john-VERSION | ||
| + | gzip -dc ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1 | ||
| + | </code> | ||
| + | |||
| + | (where ''VERSION'', ''WHAT'', and ''REVISION'' are parts of the patch file name). | ||
| + | |||
| + | Please note that you **must not enter the ''src'' subdirectory** prior to applying patches generated in accordance with [[:how-to-make-patches|our conventions]]. | ||
| + | |||
| + | To apply an uncompressed patch, use: | ||
| + | |||
| + | patch -p1 < ../john-VERSION-WHAT-REVISION.diff | ||
| + | |||
| + | The option is letter ''p'' followed by digit ''1'' (one), meaning to strip one leading directory name (the top-level directory for our source tree) from pathnames specified in the patch file. | ||
| + | |||
| + | Please refer to the man (manual) page and/or texinfo documentation on your version of the ''patch'' program for information on the command-line options. | ||
| + | |||
| + | Back to [[:john]]. | ||
| - | (where VERSION is a John the Ripper version number, such as 1.7.2). For bzip2-compressed tarballs use: | ||
| - | ''tar xjvf john-VERSION.tar.bz2'' | ||