disassemble ( obj -- )
Factor handbook » Developer tools » Disassembling words

Vocabulary
tools.disassembler

Inputs

obj	a word or a pair of addresses

Outputs
None

Word description
Disassembles either a compiled word definition or an arbitrary memory range (in the case obj is a pair of integers).

Notes
In some cases the Factor compiler emits data inline with code, which can confuse the disassembler. This occurs in words which call dispatch, where the jump table addresses are compiled inline.

Definition

IN: tools.disassembler

GENERIC: disassemble ( obj -- )

Methods

USING: alien alien.data arrays byte-arrays destructors kernel
libc math sequences tools.disassembler ;

M: byte-array disassemble
    [
        [ malloc-byte-array &free alien-address dup ]
        [ length + ] bi 2array disassemble
    ] with-destructors ;


USING: compiler.units kernel quotations stack-checker
tools.disassembler words ;

M: callable disassemble
    [ dup infer define-temp ] with-compilation-unit disassemble
    ;


USING: arrays io kernel sequences sequences.private
tools.disassembler tools.disassembler.private ;

M: pair disassemble
    first2-unsafe [ (>address) ] bi@ disassemble*
    [ tabs>spaces print ] each ;


USING: tools.disassembler typed words ;

M: typed-word disassemble "typed-word" word-prop disassemble ;


USING: arrays tools.disassembler words ;

M: word disassemble word-code 2array disassemble ;