Differences

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

--- john:how-to-extract-tarballs-and-apply-patches [2008/05/02 03:08]
solar more links and minor cleanups
+++ 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 [[http://www.gzip.org|gzip]] or [[http://www.bzip.org|bzip2]].  On a [[http://en.wikipedia.org/wiki/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:
+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, texinfo documentation, and/or web pages 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 ======
@@ Line 21: / Line 25: @@
 <code>
 cd john-VERSION
-zcat ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1 -Z
+gzip -dc ../john-VERSION-WHAT-REVISION.diff.gz | patch -p1
 </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 re-generate 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.
-''patch -p1 -Z < ../john-VERSION-WHAT-REVISION.diff''
+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.
-or without the ''-Z'' option (that is, not setting timestamps):
+Back to [[:john]].
-''patch -p1 < ../john-VERSION-WHAT-REVISION.diff''
-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.