radare2/man/rasm2.1

.Dd Oct 30, 2018
.Dt RASM2 1
.Sh NAME
.Nm rasm2
.Nd radare2 assembler and disassembler tool
.Sh SYNOPSIS
.Nm rasm2
.Op Fl ABdDeEfCLvwrq
.Op Fl a Ar arch
.Op Fl b Ar bits
.Op Fl c Ar cpu
.Op Fl F Ar in:out
.Op Fl o Ar offset
.Op Fl @ Ar offset
.Op Fl O Ar ofile
.Op Fl s Ar syntax
.Op Fl i Ar int
.Op Fl l Ar int
.Op ARG
.Sh DESCRIPTION
This tool uses r_asm to assemble and disassemble files or hexpair strings. It supports a large list of architectures which can be listed using the \-L flag.
.Pp
.Bl -tag -width Fl
.It Fl a Ar arch
Set architecture plugin
.It Fl A
Show analysis information of given hexpair string
.It Fl b Ar bits
Set architecture bits
.It Fl B
Binary input/output (\-l is mandatory for binary input)
.It Fl c Ar cpu
Select specific CPU (depends on \-a arch)
.It Fl C
Output in C format
.It Fl d
Disassemble hexpair bytes. rasm2 \-d 9090
.It Fl D
Disassemble showing hexpair and opcode
.It Fl e
Use big endian (or swap endianness if used more than once)
.It Fl E
Output disassembled instructions in ESIL format.
.It Fl f
Read data from file instead of ARG.
.It Fl F Ar in:out
Specify input and/or output filters (att2intel, x86.pseudo, ...)
.It Fl h
Show usage help message.
.It Fl hh
Show long help message including supported assembler directives
.It Fl l Ar int
Input/Output length
.It Fl i Ar int
Ignore/skip N bytes from the beginning of the input buffer
.It Fl L
List supported asm plugins
.It Fl o Ar offset
Offset of the opcode to assemble (default is 0)
.It Fl @ Ar offset
Alias for -o
.It Fl O Ar ofile
output to file, for example 'rasm2 \-BF a a.asm'
.It Fl r
Show output in r2 script
.It Fl s Ar syntax
Select syntax output (intel, att)
.It Fl w
Describe opcode (whats op)
.It Fl q
Quiet output (handy for -L, -v, ...)
.El
.Sh different than filename
.Pp
.Bl -tag -width Fl
.It Fl .intel_syntax
Use intel syntax rather than att:w
.It Fl .att_syntax
Use ATT syntax rather than flu :w
dentify the region fof aslerrger
.It Fl string
dentify the region fof aslerrger
.It Fl .ascii
.It Fl .align
.It Fl .arm
.It Fl .thumb
.It Fl .arch
.It Fl .bits
.It Fl .fill
.It Fl .kernel
.It Fl .os
.It Fl .hex
.It Fl .int16
.It Fl .short
.It Fl .int32
.It Fl .int64
.It Fl .glob
.It Fl .equ
.It Fl .org
.It Fl .text
.It Fl .data
.El
.Sh EXAMPLES
.Pp
Assemble opcode:
.Pp
  $ rasm2 \-a x86 \-b 32 'mov eax, 33'
.Pp
Disassemble opcode:
.Pp
  $ rasm2 \-d 90
.Sh SEE ALSO
.Pp
.Xr radare2(1) ,
.Xr rafind2(1) ,
.Xr rahash2(1) ,
.Xr rabin2(1) ,
.Xr radiff2(1) ,
.Xr ragg2(1) ,
.Xr rarun2(1) ,
.Xr rax2(1) ,
.Sh AUTHORS
.Pp
pancake <pancake@nopcode.org>
Fix #11237 - Handle -@ in rasm2 as an alias for -o 2018-10-31 10:45:50 +00:00			`.Dd Oct 30, 2018`
More fixups for the manpages 2014-09-30 09:37:26 +00:00			`.Dt RASM2 1`
			`.Sh NAME`
			`.Nm rasm2`
			`.Nd radare2 assembler and disassembler tool`
* 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`
* 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			`.Nm rasm2`
Implement rasm2 -r 2017-05-05 09:13:42 +00:00			`.Op Fl ABdDeEfCLvwrq`
* Update manpages 2011-12-02 02:43:08 +00:00			`.Op Fl a Ar arch`
			`.Op Fl b Ar bits`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.Op Fl c Ar cpu`
Add rasm2 -E to show ESIL from bytes 2015-12-31 13:42:05 +00:00			`.Op Fl F Ar in:out`
			`.Op Fl o Ar offset`
Fix #11237 - Handle -@ in rasm2 as an alias for -o 2018-10-31 10:45:50 +00:00			`.Op Fl @ Ar offset`
Add rasm2 -E to show ESIL from bytes 2015-12-31 13:42:05 +00:00			`.Op Fl O Ar ofile`
* Update manpages 2011-12-02 02:43:08 +00:00			`.Op Fl s Ar syntax`
Fix #240 - rasm2 have -l but not -S to skip bytes from the beginning of the file 2013-10-14 23:54:37 +00:00			`.Op Fl i Ar int`
* Update manpages 2011-12-02 02:43:08 +00:00			`.Op Fl l Ar int`
* 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			`.Op ARG`
* 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 a round of typos and incorrect man macros. The macro Em. was present in all the manpages and it's incorrect, plus there's some typos here and there, some of them spotted by lintian. 2014-01-01 07:52:46 +00:00			`This tool uses r_asm to assemble and disassemble files or hexpair strings. It supports a large list of architectures which can be listed using the \-L flag.`
* 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 build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl a Ar arch`
			`Set architecture plugin`
Implement rasm2 -A to replace ranal2 2016-03-04 01:15:36 +00:00			`.It Fl A`
			`Show analysis information of given hexpair string`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl b Ar bits`
			`Set architecture bits`
			`.It Fl B`
			`Binary input/output (\-l is mandatory for binary input)`
			`.It Fl c Ar cpu`
Fix a round of typos and incorrect man macros. The macro Em. was present in all the manpages and it's incorrect, plus there's some typos here and there, some of them spotted by lintian. 2014-01-01 07:52:46 +00:00			`Select specific CPU (depends on \-a arch)`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl C`
			`Output in C format`
* 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 d`
* Update manpages 2011-12-02 02:43:08 +00:00			`Disassemble hexpair bytes. rasm2 \-d 9090`
			`.It Fl D`
			`Disassemble showing hexpair and opcode`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl e`
			`Use big endian (or swap endianness if used more than once)`
Add rasm2 -E to show ESIL from bytes 2015-12-31 13:42:05 +00:00			`.It Fl E`
			`Output disassembled instructions in ESIL format.`
* 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 f`
			`Read data from file instead of ARG.`
* Update manpages 2011-12-02 02:43:08 +00:00			`.It Fl F Ar in:out`
* Use r_num_math in malloc io plugin - Fix free when malloc fails * Fix rasm manpage typo 2011-12-07 23:23:16 +00:00			`Specify input and/or output filters (att2intel, x86.pseudo, ...)`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl h`
			`Show usage help message.`
Add asm directives help (-hh) and update manpage 2017-01-16 11:03:06 +00:00			`.It Fl hh`
			`Show long help message including supported assembler directives`
* Update manpages 2011-12-02 02:43:08 +00:00			`.It Fl l Ar int`
			`Input/Output length`
Fix #240 - rasm2 have -l but not -S to skip bytes from the beginning of the file 2013-10-14 23:54:37 +00:00			`.It Fl i Ar int`
Fix a round of typos and incorrect man macros. The macro Em. was present in all the manpages and it's incorrect, plus there's some typos here and there, some of them spotted by lintian. 2014-01-01 07:52:46 +00:00			`Ignore/skip N bytes from the beginning of the input buffer`
* Update manpages 2011-12-02 02:43:08 +00:00			`.It Fl L`
			`List supported asm plugins`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl o Ar offset`
			`Offset of the opcode to assemble (default is 0)`
Fix #11237 - Handle -@ in rasm2 as an alias for -o 2018-10-31 10:45:50 +00:00			`.It Fl @ Ar offset`
			`Alias for -o`
Implement 'wu' and add support for nocolor in 'cu' 2014-01-26 03:33:21 +00:00			`.It Fl O Ar ofile`
			`output to file, for example 'rasm2 \-BF a a.asm'`
Implement rasm2 -r 2017-05-05 09:13:42 +00:00			`.It Fl r`
			`Show output in r2 script`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 15:35:36 +00:00			`.It Fl s Ar syntax`
			`Select syntax output (intel, att)`
Add rasm2 -w to describe opcodes, fix massemble Add rasm2 -w to get opcode description Fix multiopcode/multiline comments parsing Avoid multiple load when there are no sub-bins Fix r_str_replace_char 2013-02-24 20:12:30 +00:00			`.It Fl w`
			`Describe opcode (whats op)`
Add support for quiet and json listing of rasm2 -L and e asm.arch=? 2016-05-18 22:38:33 +00:00			`.It Fl q`
			`Quiet output (handy for -L, -v, ...)`
Add new code analysis vars and update manpages rasm2 defaults -o to 0 instead of 0x8048000 fixes in rarun2 to make it more userfriendly update some manpages with examples enhace output of 'afi' command fix 'pi' bug setting blocksize fix 'pdi' bug ignoring user defined len add $C $J $X and $F $I code analysis variables run r2irc.js in sandbox mode 2012-10-22 00:28:42 +00:00			`.El`
Add directives in rasm2 manpage 2016-02-16 03:52:12 +00:00			`.Sh different than filename`
			`.Pp`
			`.Bl -tag -width Fl`
			`.It Fl .intel_syntax`
			`Use intel syntax rather than att:w`
			`.It Fl .att_syntax`
			`Use ATT syntax rather than flu :w`
			`dentify the region fof aslerrger`
			`.It Fl string`
			`dentify the region fof aslerrger`
			`.It Fl .ascii`
			`.It Fl .align`
			`.It Fl .arm`
			`.It Fl .thumb`
			`.It Fl .arch`
			`.It Fl .bits`
			`.It Fl .fill`
			`.It Fl .kernel`
			`.It Fl .os`
			`.It Fl .hex`
			`.It Fl .int16`
			`.It Fl .short`
			`.It Fl .int32`
			`.It Fl .int64`
			`.It Fl .glob`
			`.It Fl .equ`
			`.It Fl .org`
			`.It Fl .text`
			`.It Fl .data`
			`.El`
Add new code analysis vars and update manpages rasm2 defaults -o to 0 instead of 0x8048000 fixes in rarun2 to make it more userfriendly update some manpages with examples enhace output of 'afi' command fix 'pi' bug setting blocksize fix 'pdi' bug ignoring user defined len add $C $J $X and $F $I code analysis variables run r2irc.js in sandbox mode 2012-10-22 00:28:42 +00:00			`.Sh EXAMPLES`
			`.Pp`
			`Assemble opcode:`
			`.Pp`
Fixes in manpages 2013-04-16 17:54:26 +00:00			`$ rasm2 \-a x86 \-b 32 'mov eax, 33'`
Add new code analysis vars and update manpages rasm2 defaults -o to 0 instead of 0x8048000 fixes in rarun2 to make it more userfriendly update some manpages with examples enhace output of 'afi' command fix 'pi' bug setting blocksize fix 'pdi' bug ignoring user defined len add $C $J $X and $F $I code analysis variables run r2irc.js in sandbox mode 2012-10-22 00:28:42 +00:00			`.Pp`
Fix a round of typos and incorrect man macros. The macro Em. was present in all the manpages and it's incorrect, plus there's some typos here and there, some of them spotted by lintian. 2014-01-01 07:52:46 +00:00			`Disassemble opcode:`
Add new code analysis vars and update manpages rasm2 defaults -o to 0 instead of 0x8048000 fixes in rarun2 to make it more userfriendly update some manpages with examples enhace output of 'afi' command fix 'pi' bug setting blocksize fix 'pdi' bug ignoring user defined len add $C $J $X and $F $I code analysis variables run r2irc.js in sandbox mode 2012-10-22 00:28:42 +00:00			`.Pp`
Fixes in manpages 2013-04-16 17:54:26 +00:00			`$ rasm2 \-d 90`
* 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 17:46:11 +00:00			`.Xr radare2(1) ,`
* Add rafind2.1 manpage * Many cleanups in the TODO files 2010-06-18 15:52:30 +00: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 17:46:11 +00:00			`.Xr rahash2(1) ,`
			`.Xr rabin2(1) ,`
			`.Xr radiff2(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 01:24:19 +00: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 17:46:11 +00: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 11:00:39 +00:00			`pancake <pancake@nopcode.org>`