👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for dis (opensolaris section 1)

dis(1)					  User Commands 				   dis(1)

NAME
       dis - object code disassembler

SYNOPSIS
       dis [-onqCLV] [-d sec] [-D sec] [-F function]
	    [-l string] [-t sec] file...

DESCRIPTION
       The dis command produces an assembly language listing of file, which can be an object file
       or an archive of object files. The listing includes assembly statements and  an	octal  or
       hexadecimal representation of the binary that produced those statements.

OPTIONS
       Options are interpreted by the disassembler and can be specified in any order.

       The following options are supported:

       -C	      Displays demangled C++ symbol names in the disassembly.

       -d sec	      Disassembles  the  named	section  as data, printing the offset of the data
		      from the beginning of the section.

       -D sec	      Disassembles the named section as data, printing the actual address of  the
		      data.

       -F function    Disassembles  only  the named function in each object file specified on the
		      command line. The -F option can be specified multiple times on the  command
		      line.

       -l string      Disassembles  the  archive file specified by string. For example, one would
		      issue the command dis -l x -l z to disassemble libx.a and libz.a, which are
		      assumed to be in LIBDIR.

		      This  option  is	obsolete  and  might  be  removed  in a future release of
		      Solaris.

       -L	      Invokes a lookup of C-language source labels in the symbol table for subse-
		      quent writing to standard output.

		      This  option  is	obsolete  and  might  be  removed  in a future release of
		      Solaris.

       -n	      Displays all addresses numerically. Addresses are displayed using  symbolic
		      names by default.

       -o	      Prints numbers in octal. The default is hexadecimal.

       -q	      Quiet mode.  Does not print any headers or function entry labels.

       -t sec	      Disassembles the named section as text.

       -V	      Prints,  on  standard  error,  the version number of the disassembler being
		      executed.

		      This option is obsolete and  might  be  removed  in  a  future  release  of
		      Solaris.

       If  the -d, -D, or -t options are specified, only those named sections from each user-sup-
       plied file is disassembled. Otherwise, all sections containing text is disassembled.

       On output, a number enclosed in brackets at the beginning of a line, such  as  [5],  indi-
       cates  that  the  break-pointable line number starts with the following instruction. These
       line numbers is printed only if the file was compiled with additional  debugging  informa-
       tion,  for  example,  the  -g  option of cc(1B). An expression such as <40> in the operand
       field or in the symbolic disassembly, following a relative displacement for control trans-
       fer  instructions,  is  the computed address within the section to which control is trans-
       ferred. A function name appears in the first column, followed by ()  if	the  object  file
       contains a symbol table.

OPERANDS
       The following operand is supported:

       file    A path name of an object file or an archive (see ar(1)) of object files.

ENVIRONMENT VARIABLES
       See  environ(5)	for  descriptions  of the following environment variables that affect the
       execution of dis: LC_CTYPE, LC_MESSAGES, and NLSPATH.

       LIBDIR	 If this environment variable contains a value, use this as the  path  to  search
		 for  the  library.  If  the  variable	contains  a null value, or is not set, it
		 defaults to searching for the library under /usr/lib.

EXIT STATUS
       The following exit values are returned:

       0     Successful completion.

       >0    An error occurred.

FILES
       /usr/lib    default LIBDIR

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWbtool 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |See below.		   |
       +-----------------------------+-----------------------------+

       The human readable output is Unstable. The command line options are Evolving.

SEE ALSO
       ar(1), as(1), cc(1B), ld(1), a.out(4), attributes(5), environ(5)

DIAGNOSTICS
       The self-explanatory diagnostics indicate errors in the command line or	problems  encoun-
       tered with the specified files.

SunOS 5.11				   28 Jun 2007					   dis(1)


All times are GMT -4. The time now is 01:55 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password