blob: f04c9baa143f11c50f5b157860f0a1151022f305 [file] [log] [blame]
<head>
<title>acid(1) - Plan 9 from User Space</title>
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
</head>
<body bgcolor=#ffffff>
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=10><td>
<tr><td width=20><td>
<tr><td width=20><td><b>ACID(1)</b><td align=right><b>ACID(1)</b>
<tr><td width=20><td colspan=2>
<br>
<p><font size=+1><b>NAME </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
acid, acidtypes &ndash; debugger<br>
</table>
<p><font size=+1><b>SYNOPSIS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>acid</font></tt> [ <tt><font size=+1>&#8722;l</font></tt> <i>library</i> ] [ <tt><font size=+1>&#8722;wq</font></tt> ] [ <tt><font size=+1>&#8722;m</font></tt> <i>machine</i> ] [ <i>pid</i> | <i>core</i> ] [ <i>textfile</i>
]
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
<tt><font size=+1>acidtypes</font></tt> [ <tt><font size=+1>&#8722;p</font></tt> <i>prefix</i> ] <i>file</i> ...<br>
</table>
<p><font size=+1><b>DESCRIPTION </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<i>Acid</i> is a programmable symbolic debugger. It can inspect one or
more processes that share an address space. A program to be debugged
may be specified by the process id of a running or defunct process,
or by the name of the program&#8217;s text file (<tt><font size=+1>a.out</font></tt> by default).
At the prompt, <i>acid</i> will store function definitions
or print the value of expressions. Options are<br>
<tt><font size=+1>&#8722;w</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Allow the textfile to be modified.<br>
<tt><font size=+1>&#8722;q</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print variable renamings at startup.<br>
<tt><font size=+1>&#8722;l</font></tt> <i>library</i>&nbsp;&nbsp;&nbsp;&nbsp;Load from <i>library</i> at startup; see below.<br>
<tt><font size=+1>&#8722;m</font></tt> <i>machine</i>&nbsp;&nbsp;&nbsp;Assume instructions are for the given CPU type (see
<a href="../man3/mach.html"><i>mach</i>(3)</a>) instead of using the executable header to select the
CPU type.<br>
<tt><font size=+1>&#8722;k</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Debug the kernel state for the process, rather than the user
state.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
At startup, <i>acid</i> obtains standard function definitions from the
library file <tt><font size=+1>/usr/local/plan9/acid/port</font></tt>, architecture-dependent
functions from <tt><font size=+1>/usr/local/plan9/acid/$objtype</font></tt>, user-specified
functions from <tt><font size=+1>$home/lib/acid</font></tt>, and further functions from <tt><font size=+1>&#8722;l</font></tt> files.
Definitions in any file may
override previously defined functions. If the function <i>acidinit</i>()
is defined, it will be invoked after all modules have been loaded.
Then the function <i>acidmap</i>() will be invoked if defined. <tt><font size=+1>/usr/local/plan9/acid/port</font></tt>
provides a definition of <i>acidmap</i> that attaches all the shared
libraries being used by the target
process and then runs <i>acidtypes</i> (<i>q.v.</i>) to create <i>acid</i> functions
for examining data structures.<br>
<p><font size=+1><b>Language </b></font><br>
Symbols of the program being debugged become integer variables
whose values are addresses. Contents of addresses are obtained
by indirection. Local variables are qualified by function name,
for example <tt><font size=+1>main:argv</font></tt>. When program symbols conflict with <i>acid</i>
words, distinguishing <tt><font size=+1>$</font></tt> signs are prefixed. Such
renamings are reported at startup; option <tt><font size=+1>&#8722;q</font></tt> suppresses them.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Variable types (<i>integer, float, list, string</i>) and formats are
inferred from assignments. Truth values false/true are attributed
to zero/nonzero integers or floats and to empty/nonempty lists
or strings. Lists are sequences of expressions surrounded by <tt><font size=+1>{}</font></tt>
and separated by commas.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Expressions are much as in C, but yield both a value and a format.
Casts to complex types are allowed. Lists admit the following
operators, with subscripts counted from 0.<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>head</font></tt> <i>list<br>
</i><tt><font size=+1>tail</font></tt> <i>list<br>
</i><tt><font size=+1>append</font></tt> <i>list</i><tt><font size=+1>,</font></tt> <i>element<br>
</i><tt><font size=+1>delete</font></tt> <i>list</i><tt><font size=+1>,</font></tt> <i>subscript
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</i>
</table>
Format codes are the same as in <a href="../man1/db.html"><i>db</i>(1)</a>. Formats may be attached
to (unary) expressions with <tt><font size=+1>\</font></tt>, e.g. <tt><font size=+1>(32*7)\D</font></tt>. There are two indirection
operators, <tt><font size=+1>*</font></tt> to address a core image, <tt><font size=+1>@</font></tt> to address a text file.
The type and format of the result are determined by the format
of the operand, whose type must be integer.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Statements are<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>if</font></tt> <i>expr</i> <tt><font size=+1>then</font></tt> <i>statement</i> [ <tt><font size=+1>else</font></tt> <i>statement</i> ]<br>
<tt><font size=+1>while</font></tt> <i>expr</i> <tt><font size=+1>do</font></tt> <i>statement<br>
</i><tt><font size=+1>loop</font></tt> <i>expr</i><tt><font size=+1>,</font></tt> <i>expr</i> <tt><font size=+1>do</font></tt> <i>statement<br>
</i><tt><font size=+1>defn</font></tt> <i>name</i><tt><font size=+1>(</font></tt><i>args</i><tt><font size=+1>) {</font></tt> <i>statement</i> <tt><font size=+1>}<br>
defn</font></tt> <i>name<br>
name</i><tt><font size=+1>(</font></tt><i>args</i><tt><font size=+1>)<br>
builtin</font></tt> <i>name</i><tt><font size=+1>(</font></tt><i>args</i><tt><font size=+1>)<br>
local</font></tt> <i>name<br>
</i><tt><font size=+1>return</font></tt> <i>expr<br>
</i><tt><font size=+1>whatis</font></tt> [ <i>name</i> ]
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</table>
The statement <tt><font size=+1>defn</font></tt> <i>name</i> clears the definition for <i>name</i>. A <tt><font size=+1>defn</font></tt>
may override a built-in function; prefixing a function call with
<tt><font size=+1>builtin</font></tt> ignores any overriding <tt><font size=+1>defn</font></tt>, forcing the use of the built-in
function.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Here is a partial list of functions; see the manual for a complete
list.<br>
<tt><font size=+1>stk()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print a stack trace for current process.<br>
<tt><font size=+1>lstk()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print a stack trace with values of local variables.<br>
<tt><font size=+1>gpr()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print general registers. Registers can also be accessed by
name, for example <tt><font size=+1>*R0</font></tt>.<br>
<tt><font size=+1>spr()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print special registers such as program counter and stack
pointer.<br>
<tt><font size=+1>fpr()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print floating-point registers.<br>
<tt><font size=+1>regs()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Same as <tt><font size=+1>spr();gpr()</font></tt>.<br>
<tt><font size=+1>fmt(</font></tt><i>expr</i><tt><font size=+1>,</font></tt><i>format</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Expression <i>expr</i> with format given by the character value of expression
<i>format</i>.<br>
</table>
</table>
<tt><font size=+1>src(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Print 10 lines of source around the program address.<br>
<tt><font size=+1>Bsrc(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;Get the source line for the program address into
a window of a running <a href="../man1/sam.html"><i>sam</i>(1)</a> and select it.<br>
<tt><font size=+1>line(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;Print source line nearest to the program address.<br>
<tt><font size=+1>source()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;List current source directories.<br>
<tt><font size=+1>addsrcdir(</font></tt><i>string</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Add a source directory to the list.<br>
</table>
</table>
<tt><font size=+1>filepc(</font></tt><i>where</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;Convert a string of the form <i>sourcefile</i><tt><font size=+1>:</font></tt><i>linenumber</i>
to a machine address.<br>
<tt><font size=+1>pcfile(</font></tt><i>address</i><tt><font size=+1>)</font></tt>Convert a machine address to a source file name.<br>
<tt><font size=+1>pcline(</font></tt><i>address</i><tt><font size=+1>)</font></tt>Convert a machine address to a source line number.<br>
<tt><font size=+1>bptab()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;List breakpoints set in the current process.<br>
<tt><font size=+1>bpset(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;Set a breakpoint in the current process at the given
address. (Doesn&#8217;t work on Unix yet.)<br>
<tt><font size=+1>bpdel(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;Delete a breakpoint from the current process.<br>
<tt><font size=+1>cont()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Continue execution of current process and wait for it to
stop.<br>
<tt><font size=+1>step()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Execute a single machine instruction in the current process.
(Doesn&#8217;t work on Unix yet.)<br>
<tt><font size=+1>func()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Step repeatedly until after a function return.<br>
<tt><font size=+1>stopped(</font></tt><i>pid</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;This replaceable function is called automatically
when the given process stops. It normally prints the program counter
and returns to the prompt.<br>
<tt><font size=+1>asm(</font></tt><i>address</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Disassemble 30 machine instructions beginning at the
given address.<br>
<tt><font size=+1>mem(</font></tt><i>address</i><tt><font size=+1>,</font></tt><i>string</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Print a block of memory interpreted according to a string of format
codes.<br>
</table>
</table>
<tt><font size=+1>dump(</font></tt><i>address</i><tt><font size=+1>,</font></tt><i>n</i><tt><font size=+1>,</font></tt><i>string</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Like <tt><font size=+1>mem</font></tt>(), repeated for <i>n</i> consecutive blocks.<br>
</table>
</table>
<tt><font size=+1>print(</font></tt><i>expr</i><tt><font size=+1>,</font></tt><i>...</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;Print the values of the expressions.<br>
<tt><font size=+1>newproc(</font></tt><i>arguments</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Start a new process with arguments given as a string and halt
at the first instruction.<br>
</table>
</table>
<tt><font size=+1>new()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Like <i>newproc</i>(), but take arguments (except <tt><font size=+1>argv[0]</font></tt>) from
string variable <tt><font size=+1>progargs</font></tt>.<br>
<tt><font size=+1>win()</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Like <i>new</i>(), but run the process in a separate window.<br>
<tt><font size=+1>start(</font></tt><i>pid</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Start a stopped process.<br>
<tt><font size=+1>kill(</font></tt><i>pid</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Kill the given process.<br>
<tt><font size=+1>setproc(</font></tt><i>pid</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;Make the given process current.<br>
<tt><font size=+1>rc(</font></tt><i>string</i><tt><font size=+1>)</font></tt>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Escape to the shell, <a href="../man1/rc.html"><i>rc</i>(1)</a>, to execute the command string.<br>
<tt><font size=+1>include(</font></tt><i>string</i><tt><font size=+1>)</font></tt>Read acid commands from the named file.<br>
<tt><font size=+1>includepipe(</font></tt><i>string</i><tt><font size=+1>)<br>
</font></tt>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Run the command string, reading its standard output as acid commands.<br>
</table>
</table>
<p><font size=+1><b>Shared library segments </b></font><br>
When a pid or core file is specified on the command line, <i>acid</i>
will, as part of its startup, determine the set of shared libraries
in use by the process image and map those at appropriate locations.
If <i>acid</i> is started without a pid or core file and is subsequently
attached to a process via <tt><font size=+1>setproc</font></tt>, the shared library maps
can be initialized by calling <tt><font size=+1>dynamicmap()</font></tt>.<br>
<p><font size=+1><b>Type information </b></font><br>
Unix compilers conventionally include detailed type information
in the debugging symbol section of binaries. The external program
<tt><font size=+1>acidtypes</font></tt> extracts this information and formats it as <i>acid</i> program
text. Once the shared libraries have been mapped, the default
<i>acid</i> startup invokes <tt><font size=+1>acidtypes</font></tt> (via
<tt><font size=+1>includepipe</font></tt>) on the set of currently mapped text files. The function
<tt><font size=+1>acidtypes()</font></tt> can be called to rerun the command after changing
the set of mapped text files.<br>
<p><font size=+1><b>Acid Libraries </b></font><br>
There are a number of <i>acid</i> &#8216;libraries&#8217; that provide higher-level
debugging facilities. One notable example is <i>trump</i>, which uses
<i>acid</i> to trace memory allocation. <i>Trump</i> requires starting <i>acid</i>
on the program, either by attaching to a running process or by
executing <tt><font size=+1>new()</font></tt> on a binary (perhaps after setting <tt><font size=+1>progargs</font></tt>),
stopping the process, and then running <tt><font size=+1>trump()</font></tt> to execute the
program under the scaffolding. The output will be a trace of the
memory allocation and free calls executed by the program. When
finished tracing, stop the process and execute <tt><font size=+1>untrump()</font></tt> followed
by <tt><font size=+1>cont()</font></tt> to resume execution.
</table>
<p><font size=+1><b>EXAMPLES </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
Start to debug <tt><font size=+1>/bin/ls</font></tt>; set some breakpoints; run up to the first
one (this example doesn&#8217;t work on Unix yet):<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>% acid /bin/ls<br>
/bin/ls: mips plan 9 executable<br>
/sys/lib/acid/port<br>
/sys/lib/acid/mips<br>
acid: new()<br>
70094: system call &nbsp;&nbsp;&nbsp;_main &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ADD &nbsp;&nbsp;&nbsp;$&#8722;0x14,R29<br>
70094: breakpoint &nbsp;&nbsp;&nbsp;&nbsp;main+0x4 &nbsp;&nbsp;&nbsp;MOVW R31,0x0(R29)<br>
acid: pid<br>
70094<br>
acid: argv0 = **main:argv\s<br>
acid: whatis argv0<br>
integer variable format s<br>
acid: *argv0<br>
/bin/ls<br>
acid: bpset(ls)<br>
acid: cont()<br>
70094: breakpoint &nbsp;&nbsp;&nbsp;ls &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ADD &nbsp;&nbsp;&nbsp;$&#8722;0x16c8,R29<br>
acid: <br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
</table>
Display elements of a linked list of structures:<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>complex Str { 'D' 0 val; 'X' 4 next; };<br>
s = *headstr;<br>
while s != 0 do{<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
complex Str s;<br>
print(s.val, &quot;\n&quot;);<br>
s = s.next;<br>
</table>
}<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
</table>
Note the use of the <tt><font size=+1>.</font></tt> operator instead of <tt><font size=+1>&#8722;&gt;</font></tt>.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Display an array of bytes declared in C as <tt><font size=+1>char array[]</font></tt>.<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>*(array\s)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
</font></tt>
</table>
This example gives <tt><font size=+1>array</font></tt> string format, then prints the string
beginning at the address (in <i>acid</i> notation) <tt><font size=+1>*array</font></tt>.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Trace the system calls executed by <a href="../man1/ls.html"><i>ls</i>(1)</a> (neither does this one):<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>% acid &#8722;l truss /bin/ls<br>
/bin/ls:386 plan 9 executable<br>
/sys/lib/acid/port<br>
/sys/lib/acid/kernel<br>
/sys/lib/acid/truss<br>
/sys/lib/acid/386<br>
acid: progargs = &quot;&#8722;l lib/profile&quot;<br>
acid: new()<br>
acid: truss()<br>
open(&quot;#c/pid&quot;, 0)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 3<br>
</table>
pread(3, 0x7fffeeac, 20, &#8722;1)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 12<br>
data: &quot; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;166 &quot;<br>
</table>
...<br>
stat(&quot;lib/profile&quot;, 0x0000f8cc, 113)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 65<br>
</table>
open(&quot;/env/timezone&quot;, 0)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 3<br>
</table>
pread(3, 0x7fffd7c4, 1680, &#8722;1)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 1518<br>
data: &quot;EST &#8722;18000 EDT &#8722;14400<br>
9943200 &nbsp;&nbsp;&nbsp;&nbsp;25664400 &nbsp;&nbsp;&nbsp;&nbsp;41392800 &nbsp;&nbsp;&nbsp;&nbsp;57718800 &nbsp;&nbsp;&nbsp;&nbsp;73447200 &nbsp;&nbsp;&nbsp;&nbsp;89168400<br>
104896800 &nbsp;&nbsp;&nbsp;...&quot;<br>
</table>
close(3)<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 0<br>
</table>
pwrite(1, &quot;&#8722;&#8722;rw&#8722;rw&#8722;r&#8722;&#8722; M 9 rob rob 2519 Mar 22 10:29 lib/profile<br>
&quot;, 54, &#8722;1)<br>
&#8722;&#8722;rw&#8722;rw&#8722;r&#8722;&#8722; M 9 rob rob 2519 Mar 22 10:29 lib/profile<br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
return value: 54<br>
</table>
...<br>
166: breakpoint &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;_exits+0x5 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;INTB $0x40<br>
acid: cont()<br>
</font></tt>
</table>
</table>
<p><font size=+1><b>FILES </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>/usr/local/plan9/acid/$objtype<br>
/usr/local/plan9/acid/port<br>
/usr/local/plan9/acid/kernel<br>
/usr/local/plan9/acid/trump<br>
/usr/local/plan9/acid/truss<br>
$home/lib/acid<br>
</font></tt>
</table>
<p><font size=+1><b>SOURCE </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<tt><font size=+1>/usr/local/plan9/src/cmd/acid<br>
</font></tt>
</table>
<p><font size=+1><b>SEE ALSO </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
<a href="../man1/mk.html"><i>mk</i>(1)</a>, <a href="../man1/db.html"><i>db</i>(1)</a><br>
Phil Winterbottom, &#8220;Acid Manual&#8221;.<br>
</table>
<p><font size=+1><b>DIAGNOSTICS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
At termination, kill commands are proposed for processes that
are still active.<br>
</table>
<p><font size=+1><b>BUGS </b></font><br>
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
There is no way to redirect the standard input and standard output
of a new process.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Source line selection near the beginning of a file may pick an
adjacent file.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
With the extant stepping commands, one cannot step through instructions
outside the text segment and it is hard to debug across process
forks.
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
Breakpoints do not work yet. Therefore, commands such as <tt><font size=+1>step</font></tt>,
<tt><font size=+1>new</font></tt>, and <tt><font size=+1>truss</font></tt> do not work either. <tt><font size=+1>New</font></tt> in particular will need
some help to cope with dynamic libraries.<br>
</table>
<td width=20>
<tr height=20><td>
</table>
<!-- TRAILER -->
<table border=0 cellpadding=0 cellspacing=0 width=100%>
<tr height=15><td width=10><td><td width=10>
<tr><td><td>
<center>
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
</center>
</table>
<!-- TRAILER -->
</body></html>