--
-- CRAX v0.8.1 - commandline wordlist based md5/sha1 decoder
-- warl0k ( egrous3 )
-- http://psilocyb1n.net ( https://egrouse.com )
--

NOTES ADDED 2025:
	This is a project that, as far as I can determine, I wrote
	way back in 2008, when I was around 17 years old. I recently
	re-discovered the source was still available and decided - for
	no good reason whatsoever - to get it compile on modern machines
	and bang it onto github.

	Of course - the application is almost entirely useless in 2025,
	being that salted hashes are the, rainbow tables are completely
	irrelevant, and furthermore md5 and sha1 have both been long 
	broken and deprecated for years.

	However, as a form of nostalgia and novelty (primary for myself),
	here it is - in all of it's ancient glory. As far as I can remember
	this is the first (and only) application I wrote in C++ when I
	was first exploring things that weren't web development.

	Mad times, mad times indeed - egrouse

CHANGELOG:

	v0.8.1 (2025-02-03):
		- Added support for arm64 architecture
		- NOTE: this probably won't compile on anything else at the moment
		- Updated README file 
		- Incremented version number (this is my favourite bit)
	
	v0.8b (2008-08-08):
		- Added interactive mode
		- I have no idea
	
	v0.7b (2008-08-08):
		- ??????
		- Everything prior to this may as well be legend

TO INSTALL:

	1. cd to the directory containing the source files
	2. run 'make' to compile the program
	3. as root, run 'make install' to install the program.
		The program will be installed to /usr/bin

	NOTE: If make install errors saying that directory already exists,
	      running 'make install -i' will install it anyway.

TO USE:

	crax:

	Run crax using the 'crax' command in the terminal.
	The command syntax is like this:
		 crax [-i|hash] [md5/sha1] [wordlist]
	example: crax ae2b1fca515949e5d54fb22b8ed95575 md5 word.lst
	example: crax file=hashes.txt sha1 /etc/worldlists/bigs.lst

	Since crax 0.7b, some new features have been added.
	Files containing lists of hashes, with 1 on each line, can
	noe be specified with the file= command instead of [hash]
	to crack the hashes 1 after the other.
	crax also now logs to /tmp/crax-md5 and /tmp/crax-sha1

	NOTE: If no wordlist is specified, crax will use the default
	      that is saved at /etc/wordlists/word.lst

	crax v0.8b brought in basic interactive mode for cracking
	which can be started by running that command `crax -i'

	hashgen:

	The crax package also includes hashgen, a simple utility to
	generate md5 and sha1 hashes. It is installed automatically.
	The command syntax is like this:
		 hashgen [data] [md5/sha1]
	example: hashgen testing md5
	example: hashgen "This is a multiword hash" sha1


OTHER STUFF:

	This program is intended for the purposes of network security.
	I do not condone using it to crack hashes that do not belong to
	you. Using this for illegal or otherwise illicit gains may
	result in a fine or imprisonment. You have been warned D:

ACKNOWLEDGEMENTS:

	!! hashlib++ library !!

	Copyright (c) 2007,2008 Benjamin Grudelbach

	Redistribution and use in source and binary forms, with or without modification,
	are permitted provided that the following conditions are met:

	        1)     Redistributions of source code must retain the above copyright
	               notice, this list of conditions and the following disclaimer.

	        2)     Redistributions in binary form must reproduce the above copyright
	               notice, this list of conditions and the following disclaimer in
	               the documentation and/or other materials provided with the
	               distribution.
            
	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
	ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
	WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
	DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
	ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
	(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
	LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
	ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
	SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

	!! Other !!
	
	* MD5 implementation

          The hashlib++ MD5 implementation is derivative from the sourcecode
          published in RFC 1321 which contains the following copyright:

          Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights
          reserved.

          License to copy and use this software is granted provided that it is
          identified as the "RSA Data Security, Inc. MD5 Message-Digest
          Algorithm" in all material mentioning or referencing this software or
          this function.

          License is also granted to make and use derivative works provided that
          such works are identified as "derived from the RSA Data Security, Inc.
          MD5 Message-Digest Algorithm" in all material mentioning or
          referencing the derived work.

          RSA Data Security, Inc. makes no representations concerning either the
          merchantability of this software or the suitability of this software
          for any particular purpose. It is provided "as is" without express or
          implied warranty of any kind.

          These notices must be retained in any copies of any part of this
          documentation and/or software.

        * SHA1 implementation

          The hashlib++ SHA1 implementation is derivative from the sourcecode
          published in RFC 3174 which contains the following copyright:

          Copyright (C) The Internet Society (2001).  All Rights Reserved.

          This document and translations of it may be copied and furnished to
          others, and derivative works that comment on or otherwise explain it
          or assist in its implementation may be prepared, copied, published and
          distributed, in whole or in part, without restriction of any kind,
          provided that the above copyright notice and this paragraph are
          included on all such copies and derivative works.  However, this
          document itself may not be modified in any way, such as by removing
          the copyright notice or references to the Internet Society or other
          Internet organizations, except as needed for the purpose of developing
          Internet standards in which case the procedures for copyrights defined
          in the Internet Standards process must be followed, or as required to
          translate it into languages other than English.

          The limited permissions granted above are perpetual and will not be
          revoked by the Internet Society or its successors or assigns.

          This document and the information contained herein is provided on an
          "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
          TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
          NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN
          WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
          MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.