Workaround OpenCL runtimes that do not accept -I parameter in the OpenCL kernel build...
[hashcat.git] / docs / changes.txt
1 * changes v3.00 -> v3.xx:
2
3 ##
4 ## Improvements
5 ##
6
7 - Make Linux build POSIX compatible; Also allow it to actually compile on musl-libc systems
8 - Add support to compile on FreeBSD
9 - Make use of cl_context_properties[] to clCreateContext(), even if OpenCL specification allow the use of NULL, some runtimes fail without
10 - The Time.Estimated attribute in status display should also show --runtime limit if user set it
11 - Fix some strict aliasing rule violation on older compilers
12 - Fix some variable initializers on older compilers
13 - Replace DARWIN macro with compiler predefined macro __APPLE__
14 - Replace LINUX macro with compiler predefined macro __linux__
15 - Allow the use of enc_id == 0 in hash-mode 10600 and 10700 as it takes no part in the actual computation
16 - Get rid of exit() calls in OpenCL wrapper library with the goal to have a better control which error can be ignored under special circumstances
17 - Do not error and exit if an OpenCL platform has no devices, just print a warning and continue with the next platform
18 - Workaround OpenCL runtimes that do not accept -I parameter in the OpenCL kernel build options even if this is an OpenCL standard option
19
20 ##
21 ## Bugs
22 ##
23
24 - Fixed a bug where hashcat is suppressing --machine-readable output in the final status update
25 - Fixed a bug where hashcat did not check the return of realpath() and crashes uncontrolled if the path does not exist
26 - Fixed a bug where hashcat crashes for accessing deallocated buffer if user spams "s" shortly before hashcat shuts down
27 - Fixed a bug where hashcat crashes in case of a scrypt P setting > 1
28 - Fixed a bug where hashcat did not correctly use the newly cracked plains whenever --loopback or the induction folder was used
29 - Fixed a bug where hashcat did not correctly remove hashes of type WPA/WPA2 even if present in potfile
30
31 * changes v2.01 -> v3.00:
32
33 This release markes the fusion of "hashcat" and "oclHashcat" into "hashcat".
34 It combines all features of all hashcat projects in one project.
35
36 ##
37 ## Features
38 ##
39
40 - Support for Apple OpenCL runtime
41 - Support for NVidia OpenCL runtime (replaces CUDA)
42 - Support for Mesa (Gallium) OpenCL runtime
43 - Support for pocl OpenCL runtime
44 - Support for Khronos' OSS OpenCL reference implementation for building
45 - Support to utilize OpenCL devices-types other than GPU, ex: CPU and FPGA
46 - Support to utilize multiple different OpenCL platforms in parallel, ex: AMD + NV
47 - Support to utilize multiple different OpenCL device-types in parallel, ex: GPU + CPU
48 - Added option --opencl-platform to select a specific OpenCL platform
49 - Added option --opencl-device-types select specific OpenCL device types
50 - Added option --opencl-vector-width to override automatically selected vector-width size
51 - Added makefile native compilation target
52 - Added makefile install and uninstall targets
53 - Added autotuning engine and user-configurable tuning database
54 - Added current engine clock, current memory clock and pci-e lanes to the status display
55 - Added support for --gpu-temp-retain for NVidia GPU, both Linux and Windows
56 - Added execution timer of the running kernel to the status display
57 - Added command prompt to quit at next restore checkpoint
58 - Added human-readable error message for the OpenCL error codes
59 - Added option --potfile-path to override potfile path
60 - Added option --veracrypt-keyfile to set Keyfiles used, can be multiple
61 - Added option --veracrypt-pim to set the VeraCrypt personal iterations multiplier
62 - Added option --machine-readable for easier parsing of output
63 - Added option --powertune-enable to work with NVidia devices as well, not just AMD
64 - Added option --stdout to print candidates instead of trying to crack a hash
65
66 ##
67 ## Algorithms
68 ##
69
70 - Added new hash-mode   125 = ArubaOS
71 - Added new hash-mode 12900 = Android FDE (Samsung DEK)
72 - Added new hash-mode 13000 = RAR5
73 - Added new hash-mode 13100 = Kerberos 5 TGS-REP etype 23
74 - Added new hash-mode 13200 = AxCrypt
75 - Added new hash-mode 13300 = AxCrypt in memory SHA1
76 - Added new hash-mode 13400 = Keepass 1 (AES/Twofish) and Keepass 2 (AES)
77 - Added new hash-mode 13500 = PeopleSoft PS_TOKEN
78 - Added new hash-mode 13600 = WinZip
79 - Added new hash-mode 137** = VeraCrypt
80 - Added new hash-mode 13800 = Windows 8+ phone PIN/Password
81
82 ##
83 ## Performance
84 ##
85
86 - Full Table: https://docs.google.com/spreadsheets/d/1B1S_t1Z0KsqByH3pNkYUM-RCFMu860nlfSsYEqOoqco/edit#gid=0
87
88 ##
89 ## Improvements
90 ##
91
92 - Reordering of files to help integration into linux distributions ~/.hashcat etc
93 - Use a profile directory to write temporary files (session, potfile etc.)
94 - Workaround depencies on AMD APP-SDK AMD ADL, NV CUDA-SDK, NV ForceWare, NVML and NVAPI; they are no longer required
95 - Load external libraries dynamic at runtime instead of link them static at compile-time
96 - Benchmark accuracy improved; Is now on par to: singlehash -a 3 -w 3 ?b?b?b?b?b?b?b
97 - Benchmark no longer depends on a fixed time
98 - Removed option --benchmark-mode, therefore support --workload-profile in benchmark-mode
99 - Enabled support of --machine-readable in combination with --benchmark for automated benchmark processing
100 - Replaced --status-automat entirely with --machine-readable to make it more consistent among benchmark and non-benchmark mode
101 - Extended support from 14 to 255 functions calls per rule
102 - Extended password length up to 32 for 7zip
103 - Extended salt length up to 55 for raw hash types, eg: md5($pass.$salt)
104 - Extended version information
105 - Removed some duplicate rules in T0XlCv1, d3ad0ne and dive
106 - Redesigned changes.txt layout
107 - Redesigned --help menu layout
108
109 ##
110 ## Bugs
111 ##
112
113 - Fixed a bug in speed display: In some situation, especially with slow hashes or lots of salts, it showed a speed of 0H/s
114 - Fixed a bug in restore handling: user immediately aborting after restart broke the restore file
115 - Fixed a bug in line counter: conditional jump or move depends on an uninitialised value
116 - Fixed a bug in rule-engine for NVidia devices: code for left- and right-shift were switched
117 - Fixed a bug in dive.rule: rules were not updated after the function 'x' was renamed to 'O'
118 - Fixed a bug in memory allocation "OpenCL -4 error": used unitialized value in a special situation
119 - Fixed a bug in memory handling: heap buffer overflow
120 - Fixed a bug in memory handling: out of bounds access
121 - Fixed a bug in implementation of DCC2: forced default iteration count for hashes to 10240
122 - Fixed a bug in implementation of WPA/WPA2: MAC and nonce stay one their original position as in the hccap file
123 - Fixed a bug in implementation of GOST R 34.11-94: zero length passwords were not cracked
124
125 ##
126 ## Technical
127 ##
128
129 - Removed deprecated GCC version check requirement
130 - Removed NPROCS from Makefile, let make automatically detect the optimal number of parallel threads
131 - Dropped all C++ overloading functions to normal function which helps support more OpenCL platforms
132 - Renamed functions in common.h to emphasize their purpose
133 - Refactorized fast-hash kernels to enable SIMD on all OpenCL platforms
134 - Refactorized SIMD handling: SIMD the inner-loop not the outer-loop to save registers
135 - Workaround missing clEnqueueFillBuffer() support in certain OpenCL runtimes
136 - Added amd_bytealign() support in non-AMD OpenCL runtimes
137 - Added amd_bfe() support in non-AMD OpenCL runtimes
138 - Added several macros to allow writing optimized code for the different OpenCL platforms
139 - Replaced typedef for bool with stdbool.h
140 - Added special DEBUG environment variables to the makefile
141 - Hashcat now acquires an exclusive lock before writing to any file
142 - Changed buffers to not use same buffer for both input and output at the same time with snprintf()
143 - Check for allocatable device-memory depending on kernel_accel amplifier before trying to allocate
144 - Added additional check for max. ESSID length to prevent possible crashes
145 - Use a GCC equivalent for __stdcall where applicable
146 - Synchronize maximum output line size with input line size
147 - Increased maximum hash line size to 0x50000
148 - Run weak-hash checks only in straight-attack mode, this greatly reduces code complexity
149 - Restrict loopback option to straight attack-mode
150 - Moved rules_optimize to hashcat-utils
151 - Stick to older libOpenCL in binary package to avoid errors like this: version `OPENCL_2.0' not found
152 - Tightened hash parser for several algorithms
153 - Updated old RC4 code in Kerberos 5
154 - Limited the salt length of Juniper Netscreen/SSG (ScreenOS) hashes to 10
155 - Updated algorithm used to automatically select an ideal --scrypt-tmto value
156 - Renamed option --gpu-accel to --kernel-accel
157 - Renamed option --gpu-loops to --kernel-loops
158 - Renamed option --gpu-devices to --opencl-devices
159 - Added inline declaration to functions from simd.c, common.c, rp.c and types_ocl.c to increase performance
160 - Dropped static declaration from functions in all kernel to achieve OpenCL 1.1 compatibility
161 - Added -cl-std=CL1.1 to all kernel build options
162 - Created environment variable to inform NVidia OpenCL runtime to not create its own kernel cache
163 - Created environment variable to inform pocl OpenCL runtime to not create its own kernel cache
164 - Dropped special 64-bit rotate() handling for NV, it seems that they've added it to their OpenCL runtime
165 - Completely get rid of HAVE_ADL, HAVE_NVML and HAVE_NVAPI in sources
166 - Replaced NVAPI with NVML on windows