1dis(1)                           User Commands                          dis(1)
2
3
4

NAME

6       dis - object code disassembler
7

SYNOPSIS

9       dis [-onqCLV] [-d sec] [-D sec] [-F function]
10            [-l string] [-t sec] file...
11
12

DESCRIPTION

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

OPTIONS

20       Options are interpreted by the disassembler and can be specified in any
21       order.
22
23
24       The following options are supported:
25
26       -C             Displays demangled C++ symbol names in the disassembly.
27
28
29       -d sec         Disassembles  the  named  section  as data, printing the
30                      offset of the data from the beginning of the section.
31
32
33       -D sec         Disassembles the named section  as  data,  printing  the
34                      actual address of the data.
35
36
37       -F function    Disassembles only the named function in each object file
38                      specified on the command line.  The  -F  option  can  be
39                      specified multiple times on the command line.
40
41
42       -l string      Disassembles  the  archive file specified by string. For
43                      example, one would issue the command dis -l x  -l  z  to
44                      disassemble  libx.a  and libz.a, which are assumed to be
45                      in LIBDIR.
46
47                      This option is obsolete and might be removed in a future
48                      release of Solaris.
49
50
51       -L             Invokes a lookup of C-language source labels in the sym‐
52                      bol table for subsequent writing to standard output.
53
54                      This option is obsolete and might be removed in a future
55                      release of Solaris.
56
57
58       -n             Displays  all  addresses numerically. Addresses are dis‐
59                      played using symbolic names by default.
60
61
62       -o             Prints numbers in octal. The default is hexadecimal.
63
64
65       -q             Quiet mode.  Does not  print  any  headers  or  function
66                      entry labels.
67
68
69       -t sec         Disassembles the named section as text.
70
71
72       -V             Prints,  on  standard  error,  the version number of the
73                      disassembler being executed.
74
75                      This option is obsolete and might be removed in a future
76                      release of Solaris.
77
78
79
80       If  the  -d, -D, or -t options are specified, only those named sections
81       from each user-supplied file is disassembled. Otherwise,  all  sections
82       containing text is disassembled.
83
84
85       On  output,  a  number enclosed in brackets at the beginning of a line,
86       such as [5], indicates that the break-pointable line number starts with
87       the  following  instruction.  These line numbers is printed only if the
88       file was compiled with additional debugging information.
89

OPERANDS

91       The following operand is supported:
92
93       file    A path name of an object file or  an  archive  (see  ar(1))  of
94               object files.
95
96

ENVIRONMENT VARIABLES

98       See  environ(5) for descriptions of the following environment variables
99       that affect the execution of dis: LC_CTYPE, LC_MESSAGES, and NLSPATH.
100
101       LIBDIR    If this environment variable contains a value,  use  this  as
102                 the  path to search for the library. If the variable contains
103                 a null value, or is not set, it defaults to searching for the
104                 library under /usr/lib.
105
106

EXIT STATUS

108       The following exit values are returned:
109
110       0     Successful completion.
111
112
113       >0    An error occurred.
114
115

FILES

117       /usr/lib    default LIBDIR
118
119

ATTRIBUTES

121       See attributes(5) for descriptions of the following attributes:
122
123
124
125
126       ┌─────────────────────────────┬─────────────────────────────┐
127       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
128       ├─────────────────────────────┼─────────────────────────────┤
129       │Availability                 │SUNWbtool                    │
130       ├─────────────────────────────┼─────────────────────────────┤
131       │Interface Stability          │See below.                   │
132       └─────────────────────────────┴─────────────────────────────┘
133
134
135       The  human readable output is Uncommitted. The command line options are
136       Committed.
137

SEE ALSO

139       ar(1), as(1), ld(1), a.out(4), attributes(5), environ(5)
140

DIAGNOSTICS

142       The self-explanatory diagnostics indicate errors in the command line or
143       problems encountered with the specified files.
144
145
146
147SunOS 5.11                        24 Aug 2009                           dis(1)
Impressum