radare2/man/radiff2.1

.Dd Feb 10, 2018
.Dt RADIFF2 1
.Sh NAME
.Nm radiff2
.Nd unified binary diffing utility
.Sh SYNOPSIS
.Nm radiff2
.Op Fl 1AabcCdDhOrspxXvzZ
.Op Fl B Ar baddr
.Op Fl G Ar cmd
.Op Fl S Ar algo
.Op Fl g Ar sym
.Op Fl i Ar i,s
.Op Fl m Ar graphmode
.Op Fl t Ar 0-100
.Ar file1
.Ar file2
.Sh DESCRIPTION
radiff2 implements many binary diffing algorithms for data and code.
.Pp
.Bl -tag -width Fl
.It Fl 1
Binary output (GDIFF format)
.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 B Ar baddr
Specify the base address to add to the offsets in the diff listings
.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, percentage 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 G Ar [cmd]
Run given command after creating each core instance
.It Fl h
Show usage help message.
.It Fl i Ar i, s, c, m, f
Compare (i)mports, (s)ymbols, (c)lassnames, (m)ethods, (f)ields from given files (radiff2 -ii /bin/ls /bin/cat)
.It Fl j
Use JSON for output
.It Fl n
Suppress address names (show only addresses) when code diffing.
.It Fl O
Do code diffing with opcode bytes only.
.It Fl m Ar [graphmode]
Specify the graph mode (i)nteractive, (k)ey-value, (j)son, (J)son2, (t)iny, (d)ot, (s)tar, (g)ml, (m)ermaid
.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 X
Show two column hexII diffing.
.It Fl s
Compute edit distance (no substitution, Eugene W. Myers' O(ND) diff algorithm) between two files.
.It Fl ss
Compute Levenshtein edit distance (substitution is allowed, O(N^2)) between two files.
.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
.It Fl Z
Perform diff using zignatures instead of function list (NEW)
.El
.Sh SEE ALSO
.Pp
.Xr radare2(1)
.Sh AUTHORS
.Pp
pancake <pancake@nopcode.org>
Fix radiff2 -B patch 2018-01-10 09:18:31 +00:00			`.Dd Feb 10, 2018`
Fix manpages for Void/Net/OpenBSD 2014-09-30 09:01:45 +00:00			`.Dt RADIFF2 1`
More fixups for the manpages 2014-09-30 09:37:26 +00:00			`.Sh NAME`
Fix some typos and inconsistencies in man pages 2022-10-11 21:21:08 +00:00			`.Nm radiff2`
More fixups for the manpages 2014-09-30 09:37:26 +00:00			`.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 13:05:30 +00:00			`.Nm radiff2`
Implement radiff2 -B to specify base address ##diff * The old -B is now -1 (gdiff output) 2022-09-06 19:50:35 +00:00			`.Op Fl 1AabcCdDhOrspxXvzZ`
			`.Op Fl B Ar baddr`
Fix #21333 - Update radiff2 manpage, add mermaid mode ##tools 2023-02-10 21:06:31 +00:00			`.Op Fl G Ar cmd`
Add radiff2 -S to specify which column to sort for code diffing 2016-09-22 18:31:40 +00:00			`.Op Fl S Ar algo`
Fix #21333 - Update radiff2 manpage, add mermaid mode ##tools 2023-02-10 21:06:31 +00:00			`.Op Fl g Ar sym`
			`.Op Fl i Ar i,s`
			`.Op Fl m Ar graphmode`
			`.Op Fl t Ar 0-100`
* Update manpages 2011-12-02 02:43:08 +00: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 13:05:30 +00: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`
Implement radiff2 -B to specify base address ##diff * The old -B is now -1 (gdiff output) 2022-09-06 19:50:35 +00:00			`.It Fl 1`
			`Binary output (GDIFF format)`
Fix #4335 - radiff2 -A 2016-03-19 01:57:53 +00: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 09:33:00 +00:00			`.It Fl a`
			`Specify architecture (x86, arm, ..)`
			`.It Fl b`
			`Select register size bits for given arch`
Implement radiff2 -B to specify base address ##diff * The old -B is now -1 (gdiff output) 2022-09-06 19:50:35 +00:00			`.It Fl B Ar baddr`
			`Specify the base address to add to the offsets in the diff listings`
* 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 17:46:11 +00:00			`.It Fl c`
			`Count number of differences.`
Implement radiff2 -e 2017-04-10 11:01:42 +00: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 13:05:30 +00:00			`.It Fl C`
Fix typo in radiff2 man page (#8619) 2017-09-30 09:56:38 +00:00			`Code diffing using graphdiff algorithm. Output columns are: file-a-address, percentage 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 02:43:08 +00:00			`.It Fl d`
			`Use delta diffing (slower).`
Add documentation for radiff2 -D 2016-02-15 22:52:12 +00:00			`.It Fl D`
			`Show disasm instead of hexpairs (honors -a arch and -b bits)`
Enable bindiff between two offsets 2014-08-19 00:47:41 +00: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.`
Fix #21333 - Update radiff2 manpage, add mermaid mode ##tools 2023-02-10 21:06:31 +00:00			`.It Fl G Ar [cmd]`
			`Run given command after creating each core instance`
Alphabetic order for radiff2's manpage. 2014-05-11 11:22:36 +00:00			`.It Fl h`
			`Show usage help message.`
Implement class, method and field diffing in radiff2 #diff 2022-10-09 09:09:20 +00:00			`.It Fl i Ar i, s, c, m, f`
			`Compare (i)mports, (s)ymbols, (c)lassnames, (m)ethods, (f)ields from given files (radiff2 -ii /bin/ls /bin/cat)`
Fix #21333 - Update radiff2 manpage, add mermaid mode ##tools 2023-02-10 21:06:31 +00:00			`.It Fl j`
			`Use JSON for output`
Use radiff -n for numeric addresses instead of function names 2014-12-26 18:28:55 +00:00			`.It Fl n`
			`Suppress address names (show only addresses) when code diffing.`
Alphabetic order for radiff2's manpage. 2014-05-11 11:22:36 +00:00			`.It Fl O`
Make description of -O match code and help output 2021-01-19 01:53:44 +00:00			`Do code diffing with opcode bytes only.`
Fix #21333 - Update radiff2 manpage, add mermaid mode ##tools 2023-02-10 21:06:31 +00:00			`.It Fl m Ar [graphmode]`
			`Specify the graph mode (i)nteractive, (k)ey-value, (j)son, (J)son2, (t)iny, (d)ot, (s)tar, (g)ml, (m)ermaid`
Alphabetic order for radiff2's manpage. 2014-05-11 11:22:36 +00:00			`.It Fl p`
			`Use physical addressing (io.va=0)`
Add radiff2 -q and add colors in -u 2017-01-09 02:26:07 +00: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 17:46:11 +00:00			`Output in radare commands as a binary patch.`
Add radiff2 -x in help 2016-04-20 23:29:57 +00:00			`.It Fl x`
			`Show two column hexdump diffing.`
Implement radiff2 -X for hexII diffing ##diff 2019-10-24 16:23:03 +00:00			`.It Fl X`
			`Show two column hexII diffing.`
* Update manpages 2011-12-02 02:43:08 +00:00			`.It Fl s`
radiff2: drop MODE_DIST (#16986) MODE_DIST (-s) is the same as MODE_DIST_LENVENSTEIN (-ss) but much slower. Drop it. Make MODE_DIST_MYERS (-sss, faster than MODE_DIST_LENVENSTEIN) take its place (-s). The original comment was incorrect (-s is not Eugene W. Myer's algorithm). It is correct now. * drop buggy Levenshtein and rename the original * fix tests Co-authored-by: eagleoflqj and Maskray 2021-01-24 21:17:25 +00:00			`Compute edit distance (no substitution, Eugene W. Myers' O(ND) diff algorithm) between two files.`
Bring back the old buffer_distance algorithm, make levenstein optional 2016-09-21 10:07:44 +00:00			`.It Fl ss`
radiff2: drop MODE_DIST (#16986) MODE_DIST (-s) is the same as MODE_DIST_LENVENSTEIN (-ss) but much slower. Drop it. Make MODE_DIST_MYERS (-sss, faster than MODE_DIST_LENVENSTEIN) take its place (-s). The original comment was incorrect (-s is not Eugene W. Myer's algorithm). It is correct now. * drop buggy Levenshtein and rename the original * fix tests Co-authored-by: eagleoflqj and Maskray 2021-01-24 21:17:25 +00:00			`Compute Levenshtein edit distance (substitution is allowed, O(N^2)) between two files.`
Add radiff2 -S to specify which column to sort for code diffing 2016-09-22 18:31:40 +00: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 11:22:36 +00: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 02:18:14 +00:00			`.It Fl u`
			`Unified diff output`
			`.It Fl U`
			`Unified diff output using system\'s diff program`
* Update manpages 2011-12-02 02:43:08 +00: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 17:46:11 +00: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 07:07:23 +00:00			`.It Fl V`
			`Be verbose sometimes`
Fix #6445 - Add -z option for radiff2 to diff strings of binaries 2017-01-08 23:03:42 +00:00			`.It Fl z`
			`Perform diff on extracted strings`
Initial import of the WIP zdiff algorithm ##diff 2019-04-05 13:34:43 +00:00			`.It Fl Z`
			`Perform diff using zignatures instead of function list (NEW)`
* 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 16:15:48 +00: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`
Add initial rvc2 command ##shell (#18716) 2021-05-20 01:34:23 +00:00			`.Xr radare2(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 11:00:39 +00:00			`pancake <pancake@nopcode.org>`