Revise what pydisassemble is about

This commit is contained in:
rocky
2022-04-26 18:09:16 -04:00
parent c25fa61e33
commit 1c49eb5989

View File

@@ -1,7 +1,7 @@
#!/usr/bin/env python #!/usr/bin/env python
# Mode: -*- python -*- # Mode: -*- python -*-
# #
# Copyright (c) 2015-2016, 2018, 2020 by Rocky Bernstein <rb@dustyfeet.com> # Copyright (c) 2015-2016, 2018, 2020, 2022 by Rocky Bernstein <rb@dustyfeet.com>
# #
from __future__ import print_function from __future__ import print_function
import sys, os, getopt import sys, os, getopt
@@ -16,11 +16,18 @@ Usage:
{0} [OPTIONS]... FILE {0} [OPTIONS]... FILE
{0} [--help | -h | -V | --version] {0} [--help | -h | -V | --version]
Disassemble FILE with the instruction mangling that is done to Disassemble/Tokenize FILE with in the way that is done to
assist uncompyle6 in parsing the instruction stream. For example assist uncompyle6 in parsing the instruction stream. For example
instructions with variable-length arguments like CALL_FUNCTION and instructions with variable-length arguments like CALL_FUNCTION and
BUILD_LIST have argument counts appended to the instruction name, and BUILD_LIST have argument counts appended to the instruction name, and
COME_FROM instructions are inserted into the instruction stream. COME_FROM psuedo instructions are inserted into the instruction stream.
Bit flag values encoded in an operand are expanding, EXTENDED_ARG
value are folded into the following instruction operand.
Like the parser, you may find this more high-level and or helpful.
However if you want a true disassembler see the Standard built-in
Python library moudle module "dis", or pydisasm from the cross-version
Python bytecode package "xdis".
Examples: Examples:
{0} foo.pyc {0} foo.pyc