diff options
Diffstat (limited to 'man/man3/mach-cmd.html')
| -rw-r--r-- | man/man3/mach-cmd.html | 167 |
1 files changed, 0 insertions, 167 deletions
diff --git a/man/man3/mach-cmd.html b/man/man3/mach-cmd.html deleted file mode 100644 index 978e80b5..00000000 --- a/man/man3/mach-cmd.html +++ /dev/null @@ -1,167 +0,0 @@ -<head> -<title>mach-cmd(3) - 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>MACH-CMD(3)</b><td align=right><b>MACH-CMD(3)</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> - - attachargs, attachcore, attachdynamic, attachproc, proctextfile - – debugging processes and core files<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>#include <u.h><br> - #include <libc.h><br> - #include <mach.h> - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>int attachcore(Fhdr *hdr) - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>int attachproc(int pid) - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>int attachdynamic(void) - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>char* proctextfile(int pid) - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>int attachargs(int argc, char **argv, int omode) - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - </font></tt> - <tt><font size=+1>extern Fhdr* symhdr;<br> - </font></tt>extern char* symfil;<br> - extern Map* symmap;<br> - extern Fhdr* fhdrlist;<br> - extern Fhdr* corhdr;<br> - extern char* corfil;<br> - extern Map* cormap;<br> - extern int corpid;<br> - extern Regs* correg;<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> - - These routines provide access to the objects a typical debugger - manipulates: an executable binary, some number of shared libraries, - a memory image in the form of a core dump or active process, and - a register set. - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - - The maintained state is:<br> - <i>symhdr<br> - </i> - <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> - - The file header for the main binary.<br> - - </table> - <i>symfil</i>The file name of the main binary.<br> - <i>symmap<br> - </i> - <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> - - The memory map of the main binary.<br> - - </table> - <i>fhdrlist<br> - </i> - <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> - - A linked list (via the <tt><font size=+1>Fhdr.next</font></tt> fields) of all currently open - headers (see <i>symopen</i> in <a href="../man3/mach-symbol.html"><i>mach-symbol</i>(3)</a>). When dynamically linked - objects have been attached, they are present in this linked list, - and therefore included in searches by <i>indexsym</i>, <i>lookupsym</i>, and - <i>findsym</i> (see <a href="../man3/mach-symbol.html"><i>mach-symbol</i>(3)</a>). - - </table> - <i>corhdr</i>The file header for the core dump, if any.<br> - <i>corfil</i>The file name of the core dump, if any.<br> - <i>cormap<br> - </i> - <table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td> - - The memory map of the core dump or attached process.<br> - - </table> - <i>corpid</i>The process id of the attached process, if any.<br> - <i>correg</i>The register set of the core dump or attached process. If - these fields are not valid, they are zeroed. - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - - <i>Attachcore</i> and <i>attachproc</i> attach to an opened core file or an - executing process. They set <i>corhdr</i>, <i>corfil</i>, <i>cormap</i>, <i>corpid</i>, and - <i>correg</i>. - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - - <i>Proctextfile</i> returns the name of the main binary for the process - with id <i>pid</i>. - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - - <i>Attachdynamic</i> requires that the memory image already be attached. - It reads the dynamic linker’s internal run-time data structures - and then opens all the dynamic objects that are currently loaded. - - <table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table> - - <i>Attachargs</i> uses all of these functions while parsing an argument - vector as would be passed to a debugger like <a href="../man1/db.html"><i>db</i>(1)</a> or <a href="../man1/acid.html"><i>acid</i>(1)</a>. - It expects a list of executable files, core dump files, or process - ids, given in any order. If extra arguments are given (for example, - more than one executable, or both a core dump and a - process id), they are ignored and diagnostics are printed to standard - error. If arguments are missing (for example, the process id is - given without an executable file), <i>attachargs</i> fills them in as - best it can.<br> - -</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/libmach<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="../man3/mach.html"><i>mach</i>(3)</a>, <a href="../man3/mach-file.html"><i>mach-file</i>(3)</a>, <a href="../man3/mach-map.html"><i>mach-map</i>(3)</a><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> - - The interface needs to be changed to support multiple threads, - each with its own register set.<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> |