radare2/man/rasm2.1

.Dd Mar 27, 2023
.Dt RASM2 1
.Sh NAME
.Nm rasm2
.Nd radare2 assembler and disassembler tool
.Sh SYNOPSIS
.Nm rasm2
.Op Fl ABdDeEfCLvwrNqx
.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 loaded asm plugins
.It Fl LL
List loaded anal plugins
.It Fl LLL
List loaded arch plugins
.It Fl o Ar offset
Offset of the opcode to assemble (default is 0)
.It Fl @ Ar offset
Alias for -o
.It Fl N
Dont load any plugin, same as R2_NOPLUGINS=1 or r2 -NN
.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 x
Use hex dwords instead of hexpairs in the assembler output
.It Fl q
Quiet output (handy for -L, -v, ...)
.El
.Sh DIRECTIVES
.Pp
List the supported assembler and preprocessor directives with:
.Pp
 $rasm2 -hh
.Pp
.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)
.Sh AUTHORS
.Pp
pancake <pancake@nopcode.org>
Add rasm2 -N to mimmic the r2 -N flag ##shell 2023-03-27 13:40:25 +02:00			`.Dd Mar 27, 2023`
More fixups for the manpages 2014-09-30 11:37:26 +02: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 18:46:11 +01:00			`.Nm rasm2`
Add rasm2 -N to mimmic the r2 -N flag ##shell 2023-03-27 13:40:25 +02:00			`.Op Fl ABdDeEfCLvwrNqx`
* Update manpages 2011-12-02 03:43:08 +01: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 17:35:36 +02:00			`.Op Fl c Ar cpu`
Add rasm2 -E to show ESIL from bytes 2015-12-31 14:42:05 +01: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 11:45:50 +01:00			`.Op Fl @ Ar offset`
Add rasm2 -E to show ESIL from bytes 2015-12-31 14:42:05 +01:00			`.Op Fl O Ar ofile`
* Update manpages 2011-12-02 03:43:08 +01: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-15 01:54:37 +02:00			`.Op Fl i Ar int`
* Update manpages 2011-12-02 03:43:08 +01: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 18:46:11 +01: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. 2013-12-31 23:52:46 -08: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 17:35:36 +02:00			`.It Fl a Ar arch`
			`Set architecture plugin`
Implement rasm2 -A to replace ranal2 2016-03-04 02:15:36 +01: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 17:35:36 +02: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. 2013-12-31 23:52:46 -08:00			`Select specific CPU (depends on \-a arch)`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 17:35:36 +02: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 18:46:11 +01:00			`.It Fl d`
* Update manpages 2011-12-02 03:43:08 +01: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 17:35:36 +02: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 14:42:05 +01: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 18:46:11 +01:00			`.It Fl f`
			`Read data from file instead of ARG.`
* Update manpages 2011-12-02 03:43:08 +01: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-08 00:23:16 +01: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 17:35:36 +02: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 03:43:08 +01: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-15 01:54:37 +02: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. 2013-12-31 23:52:46 -08:00			`Ignore/skip N bytes from the beginning of the input buffer`
* Update manpages 2011-12-02 03:43:08 +01:00			`.It Fl L`
Add rasm2 -LL to list anal plugins loaded ##tools 2021-07-25 22:45:41 +02:00			`List loaded asm plugins`
			`.It Fl LL`
			`List loaded anal plugins`
Implement rasm2 -LLL to list arch plugins ##tools 2022-11-03 08:01:11 +01:00			`.It Fl LLL`
			`List loaded arch plugins`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 17:35:36 +02: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 11:45:50 +01:00			`.It Fl @ Ar offset`
			`Alias for -o`
Add rasm2 -N to mimmic the r2 -N flag ##shell 2023-03-27 13:40:25 +02:00			`.It Fl N`
Merge all R2_NOPLUGINS as R2_NOPLUGINS ##shell This way r2 -NN will tell the childs to not load any plugin * Update help messages and man pages 2023-05-28 00:58:20 +02:00			`Dont load any plugin, same as R2_NOPLUGINS=1 or r2 -NN`
Implement 'wu' and add support for nocolor in 'cu' 2014-01-26 04:33:21 +01:00			`.It Fl O Ar ofile`
			`output to file, for example 'rasm2 \-BF a a.asm'`
Implement rasm2 -r 2017-05-05 11:13:42 +02:00			`.It Fl r`
			`Show output in r2 script`
Fix build order issue, r2agent -s (sandbox mode), update rasm2.1 manpage 2013-06-25 17:35:36 +02: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 21:12:30 +01:00			`.It Fl w`
			`Describe opcode (whats op)`
Implement rasm2 -x to output in hex dwords ##asm $ rasm2 -x 'nop;nop;mov eax, 33;push ebx;int 0x80;nop;mov rbx,48484;nop' 0x21b89090 0x53000000 0x489080cd 0xbd64c3c7 0x00900000 As suggested in https://twitter.com/travisgoodspeed/status/1101966927688318978 2019-03-03 02:51:55 +01:00			`.It Fl x`
			`Use hex dwords instead of hexpairs in the assembler output`
Add support for quiet and json listing of rasm2 -L and e asm.arch=? 2016-05-19 00:38:33 +02: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 02:28:42 +02:00			`.El`
Improve .fill and rasm2 -hh with documented directives ##asm 2021-02-04 00:51:53 +01:00			`.Sh DIRECTIVES`
			`.Pp`
			`List the supported assembler and preprocessor directives with:`
			`.Pp`
			`$rasm2 -hh`
Add directives in rasm2 manpage 2016-02-16 04:52:12 +01:00			`.Pp`
			`.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 02:28:42 +02:00			`.Sh EXAMPLES`
			`.Pp`
			`Assemble opcode:`
			`.Pp`
Fixes in manpages 2013-04-16 19:54:26 +02: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 02:28:42 +02: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. 2013-12-31 23:52:46 -08: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 02:28:42 +02:00			`.Pp`
Fixes in manpages 2013-04-16 19:54:26 +02: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`
Add initial rvc2 command ##shell (#18716) 2021-05-20 03:34:23 +02: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 12:00:39 +01:00			`pancake <pancake@nopcode.org>`