Index for Section 3

Alphabetical listing for D

Bottom of page

disassembler(3)
NAME
  disassembler - Disassemble a machine instruction and print the results

SYNOPSIS
  int disassembler (
      unsigned long iadr,
      int regstyle,
      char *(*get_symname)(unsigned long address),
      unsigned long (*get_regvalue)(unsigned regnum),
      unsigned (*get_bytes)(void),
      void (*print_header)
	   (unsigned long iadr, unsigned instruction) );

PARAMETERS
  iadr	    Specifies the instruction address to be disassembled.

  regstyle  Specifies how registers are named in the disassembly; if the
	    value is 0, compiler names are used; otherwise, hardware names
	    are used.

  The next four arguments are function pointers, most of which give the
  caller some flexibility in the appearance of the disassembly.	 The only
  function that must be provided is get_bytes.	All other functions are
  optional; pass a NULL for each that is not needed.

  get_bytes Is called with no arguments and returns the next byte or bytes to
	    disassemble.

  get_symname
	    Is passed an address, which is the target of a jmp, jsr, or bsr
	    instruction.  If NULL is returned or if get_symname is NULL, the
	    disassembler prints the address; otherwise, the string name is
	    printed as returned from get_symname.

  get_regvalue
	    If not NULL, is passed a register number and returns the current
	    contents of the specified register.	 The disassembler prints this
	    information along with the instruction disassembly.

  print_header
	    If not NULL, is passed the instruction address iadr and the
	    current instruction to be disassembled, which is the return value
	    from get_bytes.  Print_header can use these parameters to print
	    any desired information before the actual instruction disassembly
	    is printed.

DESCRIPTION
  The disassembler disassembles and prints a machine instruction on stdout.


  The program must be linked with the object file access routine library
  libmld.a.




RETURN VALUES
  If get_bytes is NULL, the disassembler returns -1 and errno is set to
  EINVAL; otherwise, the number of bytes that were disassembled is returned.

RELATED INFORMATION
  ldfcn(4).

Index for Section 3

Alphabetical listing for D

Top of page