Differences

This shows you the differences between two versions of the page.

--- john:how-to-extract-tarballs-and-apply-patches [2008/05/02 02:34]
solar added info on non-GNU tar
+++ 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 ======
-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.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"):
+  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]].
-''gzip -dc john-VERSION.tar.gz | tar xzvf -''
-Please refer to man (manual) pages on tar, gzip, and bzip2 for information on the command-line options.