radare2/man/radiff2.1

.Dd Sep 21, 2016
.Dt RADIFF2 1
.Sh NAME
.Nm RADIFF2
.Nd unified binary diffing utility
.Sh SYNOPSIS
.Nm radiff2
.Op Fl AabcCdDhOrspxvz
.Op Fl t Ar 0-100
.Op Fl g Ar sym
.Op Fl S Ar algo
.Ar file1
.Ar file2
.Sh DESCRIPTION
radiff2 implements many binary diffing algorithms for data and code.
.Pp
.Bl -tag -width Fl
.It Fl A
Analyze binary after loading it with RCore (see -C) and use -AA to run aaaa instead of aaa.
.It Fl a
Specify architecture (x86, arm, ..)
.It Fl b
Select register size bits for given arch
.It Fl c
Count number of differences.
.It Fl e [k=v]
Specify eval config vars for all RCore instances created.
.It Fl C
Code diffing using graphdiff algorithm. Output columns are: file-a-address, percentatge of most similar function in B file | file-b-address. (Use with -A to analyze the binaries to find more functions)
.It Fl d
Use delta diffing (slower).
.It Fl D
Show disasm instead of hexpairs (honors -a arch and -b bits)
.It Fl g Ar sym | off1,off2
Graph diff output of given symbol, or between two functions, at given offsets: one for each binary.
.It Fl h
Show usage help message.
.It Fl i
Compare the list of imports
.It Fl n
Suppress address names (show only addresses) when code diffing.
.It Fl O
Do code diffing with all bytes instead of just the fixed opcode bytes
.It Fl p
Use physical addressing (io.va=0)
.It Fl q
Quiet mode: disable colors and reduce output
.It Fl r
Output in radare commands as a binary patch.
.It Fl x
Show two column hexdump diffing.
.It Fl s
Calculate text distance from two files.
.It Fl ss
Same as before but using the Levenstein algorithm (faster but sometimes buggy)
.It Fl S Ar [name, namelen, dist, size, ...]
Specify which column of the code diffing algo use for diffing
.It Fl t Ar 0\-100
Choose matching threshold for binary code diffing
.It Fl u
Unified diff output
.It Fl U
Unified diff output using system\'s diff program
.It Fl v
Show version information.
.It Fl V
Be verbose sometimes
.It Fl z
Perform diff on extracted strings
.El
.Sh SEE ALSO
.Pp
.Xr radare2(1) ,
.Xr rafind2(1) ,
.Xr rahash2(1) ,
.Xr rabin2(1) ,
.Xr rasm2(1) ,
.Xr ragg2(1) ,
.Xr rarun2(1) ,
.Xr rax2(1) ,
.Sh AUTHORS
.Pp
pancake <pancake@nopcode.org>
Bring back the old buffer_distance algorithm, make levenstein optional 2016-09-21 12:07:44 +02:00			`.Dd Sep 21, 2016`
Fix manpages for Void/Net/OpenBSD 2014-09-30 11:01:45 +02:00			`.Dt RADIFF2 1`
More fixups for the manpages 2014-09-30 11:37:26 +02:00			`.Sh NAME`
			`.Nm RADIFF2`
			`.Nd unified binary diffing utility`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.Sh SYNOPSIS`
* Fix shellcodes.c.src (do not use literal strings) * Update vapis for r_asm, r_debug and r_fs * Use anal_diff_setup() in test-ragdiff * Sync radiff2 manpage 2011-10-20 15:05:30 +02:00			`.Nm radiff2`
Fix #6445 - Add -z option for radiff2 to diff strings of binaries 2017-01-09 01:03:42 +02:00			`.Op Fl AabcCdDhOrspxvz`
* Update manpages 2011-12-02 03:43:08 +01:00			`.Op Fl t Ar 0-100`
			`.Op Fl g Ar sym`
Add radiff2 -S to specify which column to sort for code diffing 2016-09-22 20:31:40 +02:00			`.Op Fl S Ar algo`
* Update manpages 2011-12-02 03:43:08 +01:00			`.Ar file1`
			`.Ar file2`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.Sh DESCRIPTION`
* Fix shellcodes.c.src (do not use literal strings) * Update vapis for r_asm, r_debug and r_fs * Use anal_diff_setup() in test-ragdiff * Sync radiff2 manpage 2011-10-20 15:05:30 +02:00			`radiff2 implements many binary diffing algorithms for data and code.`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.Pp`
			`.Bl -tag -width Fl`
Fix #4335 - radiff2 -A 2016-03-19 02:57:53 +01:00			`.It Fl A`
			`Analyze binary after loading it with RCore (see -C) and use -AA to run aaaa instead of aaa.`
Add radiff2 -a and -b flags 2014-03-19 10:33:00 +01:00			`.It Fl a`
			`Specify architecture (x86, arm, ..)`
			`.It Fl b`
			`Select register size bits for given arch`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`.It Fl c`
			`Count number of differences.`
Implement radiff2 -e 2017-04-10 13:01:42 +02:00			`.It Fl e [k=v]`
			`Specify eval config vars for all RCore instances created.`
* Fix shellcodes.c.src (do not use literal strings) * Update vapis for r_asm, r_debug and r_fs * Use anal_diff_setup() in test-ragdiff * Sync radiff2 manpage 2011-10-20 15:05:30 +02:00			`.It Fl C`
Hint -A in -C for radiff2 2016-05-17 21:48:36 +02:00			`Code diffing using graphdiff algorithm. Output columns are: file-a-address, percentatge of most similar function in B file \| file-b-address. (Use with -A to analyze the binaries to find more functions)`
* Update manpages 2011-12-02 03:43:08 +01:00			`.It Fl d`
			`Use delta diffing (slower).`
Add documentation for radiff2 -D 2016-02-15 23:52:12 +01:00			`.It Fl D`
			`Show disasm instead of hexpairs (honors -a arch and -b bits)`
Enable bindiff between two offsets 2014-08-19 02:47:41 +02:00			`.It Fl g Ar sym \| off1,off2`
			`Graph diff output of given symbol, or between two functions, at given offsets: one for each binary.`
Alphabetic order for radiff2's manpage. 2014-05-11 13:22:36 +02:00			`.It Fl h`
			`Show usage help message.`
Implement radiff2 -i, fix -z and add -u/-U * Unified support using: - internal bindiffer - using system's diff program * Compare list of imports or strings of given files * Add proper apis to handle all this * Automatic hexdump when comparing binary buffers (-U) * Update documentation 2017-01-09 03:18:14 +01:00			`.It Fl i`
			`Compare the list of imports`
Use radiff -n for numeric addresses instead of function names 2014-12-26 19:28:55 +01:00			`.It Fl n`
			`Suppress address names (show only addresses) when code diffing.`
Alphabetic order for radiff2's manpage. 2014-05-11 13:22:36 +02:00			`.It Fl O`
			`Do code diffing with all bytes instead of just the fixed opcode bytes`
			`.It Fl p`
			`Use physical addressing (io.va=0)`
Add radiff2 -q and add colors in -u 2017-01-09 03:26:07 +01:00			`.It Fl q`
			`Quiet mode: disable colors and reduce output`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.It Fl r`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`Output in radare commands as a binary patch.`
Add radiff2 -x in help 2016-04-21 01:29:57 +02:00			`.It Fl x`
			`Show two column hexdump diffing.`
* Update manpages 2011-12-02 03:43:08 +01:00			`.It Fl s`
			`Calculate text distance from two files.`
Bring back the old buffer_distance algorithm, make levenstein optional 2016-09-21 12:07:44 +02:00			`.It Fl ss`
			`Same as before but using the Levenstein algorithm (faster but sometimes buggy)`
Add radiff2 -S to specify which column to sort for code diffing 2016-09-22 20:31:40 +02:00			`.It Fl S Ar [name, namelen, dist, size, ...]`
			`Specify which column of the code diffing algo use for diffing`
Alphabetic order for radiff2's manpage. 2014-05-11 13:22:36 +02:00			`.It Fl t Ar 0\-100`
			`Choose matching threshold for binary code diffing`
Implement radiff2 -i, fix -z and add -u/-U * Unified support using: - internal bindiffer - using system's diff program * Compare list of imports or strings of given files * Add proper apis to handle all this * Automatic hexdump when comparing binary buffers (-U) * Update documentation 2017-01-09 03:18:14 +01:00			`.It Fl u`
			`Unified diff output`
			`.It Fl U`
			`Unified diff output using system\'s diff program`
* Update manpages 2011-12-02 03:43:08 +01:00			`.It Fl v`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`Show version information.`
Memory efficient implemenation of Levenshtein Distance for radiff2 (add -V) Implemented the iterative two matrix row version from here: https://en.wikipedia.org/wiki/Levenshtein_distance and here: http://www.codeproject.com/Articles/13525/Fast-memory-efficient-Levenshtein-algorithm Memory usage was originally 200Gig for a couple of 100K files ~(sizeAsizeB), now about ~(sizeB2)... 2016-05-25 17:07:23 +10:00			`.It Fl V`
			`Be verbose sometimes`
Fix #6445 - Add -z option for radiff2 to diff strings of binaries 2017-01-09 01:03:42 +02:00			`.It Fl z`
			`Perform diff on extracted strings`
* Apply some fixes of packaging bugs notified by debian - Fix warnings in manpages - Fix install path of perl5 and python2.5 and 2.6 bindings - Fix make uninstall in r2-swig - Add -soname to libr2.so - Do not build/install swig from r2 2010-03-15 17:15:48 +01:00			`.El`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.Sh SEE ALSO`
			`.Pp`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`.Xr radare2(1) ,`
* Add rafind2.1 manpage * Many cleanups in the TODO files 2010-06-18 17:52:30 +02:00			`.Xr rafind2(1) ,`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`.Xr rahash2(1) ,`
			`.Xr rabin2(1) ,`
			`.Xr rasm2(1) ,`
* Fix make w32dist * Update manpages * Added r2 -H for env and files help * Add rarun2 -h * Show assembler/disassembler features in rasm2 -L * Add opcode 'mov dword [ebp-12],4' to x86.nz - Make t/test.nz work with x86.olly (32bit only atm) * Fix unknown os issue with tiny-pe files in r_bin * Fix some plugin names build fails in mingw32 * MAGICPATH renamed to R_MAGIC_PATH * Add another experimental way to generate gir files - Added dummy test.js for nodejs * Build python-dist in farm --HG-- rename : man/rarc2-tool.1 => binr/old.rarc2/rarc2-tool.1 rename : man/rarc2.1 => binr/old.rarc2/rarc2.1 2011-10-12 03:24:19 +02:00			`.Xr ragg2(1) ,`
			`.Xr rarun2(1) ,`
* Write and install manpages * Merge r_trace into r_debug (RDebugTrace) - Implement 'dt' command to manage debugging traces - TODO: Track register values and memory changes - Added dbg.trace and dbg.trace.tag * Added r_sys_now() to retrieve ut64 value of current time - Must check endianness issues * Initial work trying to implement RPATH support to ELF * Less flat command tree - 'dt' is now 'dbt' - 'dk' is now 'dpk' * Some more random syntax cleanup fixes * Say 'yes/no' instead of 'ok/fail' in check-langs script 2010-03-12 18:46:11 +01:00			`.Xr rax2(1) ,`
* Initial work on the register API for r_debug - r_debug_reg and r_debug_regset - Handles dbg->newstate to force register sync - Only dbg.reg.read() for x86-32 and 64 * Added dummy copy of manpages (from old radare1) 2009-04-15 11:09:36 +00:00			`.Sh AUTHORS`
			`.Pp`
Use latest ACR for triplet fixes and update manpage dates 2013-11-11 12:00:39 +01:00			`pancake <pancake@nopcode.org>`