rizin/binrz/man/rz-asm.1
Riccardo Schirone 6f40dfe493
Move remaining things from shlr/ to meson subprojects (#2126)
* Move binrz meson directives to binrz/ dir

* Move rizin-shell-parser to a subproject

* Move bochs to a meson subproject

* Move rzqnx to meson subproject

* Move winkd to a meson subproject

* Move rzar to a meson subproject

* Move rzw32dbg_wrap to a meson subproject

* Move ptrace-wrap to a meson subproject

* Move rzgdb to a meson subproject

* Rename w32dbg_wrap to rzw32dbg_wrap

* Update CODEOWNERS

* Remove old references to shlr

* Move shlr/heap stuff in core and remove shlr/arm

* Move spp to a meson subproject

* Remove last references to shlr

* Remove use_webui option

* Move include files directives to librz/include/meson.build

* Move librz meson directives into librz/meson.build

* Handle d/ directories inside the specific module meson.build

* Move plugins listing to specific module meson.build

* Move rzheap to its own subproject

* Fix js linter and licenses

* Use meson.override_dependency for all rz_ modules
2021-12-22 09:20:39 +08:00

127 lines
2.6 KiB
Groff

.Dd Oct 30, 2018
.Dt RZ_ASM 1
.Sh NAME
.Nm rz-asm
.Nd rizin assembler and disassembler tool
.Sh SYNOPSIS
.Nm rz-asm
.Op Fl ABdDeEfCLvwrqx
.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. rz-asm \-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 'rz-asm \-BF a a.asm'
.It Fl r
Show output in rizin 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 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 .align
.It Fl .arch
.It Fl .arm
.It Fl .ascii
.It Fl .bits
.It Fl .data
.It Fl .equ
.It Fl .fill
.It Fl .glob
.It Fl .hex
.It Fl .int16
.It Fl .int32
.It Fl .int64
.It Fl .kernel
.It Fl .offset
.It Fl .org
.It Fl .os
.It Fl .short
.It Fl .text
.It Fl .thumb
.El
.Sh EXAMPLES
.Pp
Assemble opcode:
.Pp
$ rz-asm \-a x86 \-b 32 'mov eax, 33'
.Pp
Disassemble opcode:
.Pp
$ rz-asm \-d 90
.Sh SEE ALSO
.Pp
.Xr rizin(1) ,
.Xr rz-find(1) ,
.Xr rz-hash(1) ,
.Xr rz-bin(1) ,
.Xr rz-diff(1) ,
.Xr rz-gg(1) ,
.Xr rz-run(1) ,
.Xr rz-ax(1) ,
.Sh AUTHORS
.Pp
pancake <pancake@nopcode.org>