This shows you the differences between two versions of the page.
|
john:how-to-extract-tarballs-and-apply-patches [2008/05/02 03:00] solar made some references into external links |
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 [[http://www.gzip.org|gzip]] or [[http://www.bzip.org|bzip2]]. On a 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: | + | 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.7.2). For bzip2-compressed tarballs use: | + | (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.bz2'' | + | tar xJvf john-VERSION.tar.xz |
| - | On some commercial Unices, you might need to download and install gzip 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: | + | For bzip2-compressed tarballs use (note the lowercase "j"): |
| - | ''gzip -dc john-VERSION.tar.gz | tar xvf -'' | + | tar xjvf john-VERSION.tar.bz2 |
| - | Please refer to man (manual) pages and texinfo documentation on [[http://www.gnu.org/software/tar/manual/|tar]], [[http://www.gnu.org/software/gzip/manual/|gzip]], and [[http://www.bzip.org/docs.html|bzip2]] for information on the command-line options. | + | 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 ====== | ====== How to apply John the Ripper source code patches ====== | ||
| Line 21: | Line 25: | ||
| <code> | <code> | ||
| cd john-VERSION | cd john-VERSION | ||
| - | zcat ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1 -Z | + | gzip -dc ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1 |
| </code> | </code> | ||
| - | (where VERSION, WHAT, and REVISION are parts of the patch file name). | + | (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]]. | + | Please note that you **must not enter the ''src'' subdirectory** prior to applying patches generated in accordance with [[:how-to-make-patches|our conventions]]. |
| - | You may omit the ''-Z'' option to ''patch'' if you don't intend to make source code changes of your own and to regenerate the patch for others to use, as well as if you use a non-GNU ''patch'' program. Also, if the ''zcat'' shortcut is missing, replace it with ''gzip -dc''. The resulting command might be: | + | To apply an uncompressed patch, use: |
| - | ''gzip -dc ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1'' | + | patch -p1 < ../john-VERSION-WHAT-REVISION.diff |
| - | To apply an uncompressed patch, use: | + | 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. | ||
| - | ''patch -p1 -Z < ../john-VERSION-WHAT-REVISION.diff'' | + | Back to [[:john]]. |
| - | or without the ''-Z'' option (that is, not setting timestamps): | ||
| - | ''patch -p1 < ../john-VERSION-WHAT-REVISION.diff'' | ||