summaryrefslogtreecommitdiffstats
path: root/lib/libc/sys
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-03-20 13:40:08 +0000
committerru <ru@FreeBSD.org>2002-03-20 13:40:08 +0000
commit17501cd945c5ce1f1f657baa3cee3dceb14a4d85 (patch)
treefc6319a229840335c643ba0aa532e9ec1ff8fbf4 /lib/libc/sys
parentb62f36d9ed34d7d205c68cb781634848be3dc467 (diff)
downloadFreeBSD-src-17501cd945c5ce1f1f657baa3cee3dceb14a4d85.zip
FreeBSD-src-17501cd945c5ce1f1f657baa3cee3dceb14a4d85.tar.gz
mdoc(7) police: Fixed the spammage of this file with trailing whitespaces
in revisions 1.26-1.28. Fixed two bugs in punctuation cleanup in rev. 1.27. Removed hard sentence break not killed by rev. 1.26.
Diffstat (limited to 'lib/libc/sys')
-rw-r--r--lib/libc/sys/ptrace.241
1 files changed, 20 insertions, 21 deletions
diff --git a/lib/libc/sys/ptrace.2 b/lib/libc/sys/ptrace.2
index 66f0b2f..7b08791 100644
--- a/lib/libc/sys/ptrace.2
+++ b/lib/libc/sys/ptrace.2
@@ -18,16 +18,16 @@
.Sh DESCRIPTION
.Fn ptrace
provides tracing and debugging facilities.
-It allows one process
+It allows one process
(the
.Em tracing
-process)
-to control another
+process)
+to control another
(the
.Em traced
-process.)
+process).
Most of the time, the traced process runs normally, but when it
-receives a signal
+receives a signal
(see
.Xr sigaction 2 ) ,
it stops.
@@ -85,14 +85,12 @@ In the current
implementation, these two requests are completely identical.
The
.Fa addr
-argument specifies the address
-(in the traced process's virtual address space)
+argument specifies the address
+(in the traced process's virtual address space)
at which the read is to be done.
-This address does not have to meet any alignment constraints.
+This address does not have to meet any alignment constraints.
The value read is returned as the return value from
-.Eo \&
-.Fn ptrace
-.Ec .
+.Fn ptrace .
.It Dv PT_WRITE_I , Dv PT_WRITE_D
These requests parallel
.Dv PT_READ_I
@@ -105,10 +103,10 @@ argument supplies the value to be written.
.It Dv PT_IO
This request allows reading and writing arbitrary amounts of data in
the traced process's address space.
-The
+The
.Fa addr
-argument specifies a pointer to a
-.Vt struct ptrace_io_desc ,
+argument specifies a pointer to a
+.Vt "struct ptrace_io_desc" ,
which is defined as follows:
.Bd -literal
struct ptrace_io_desc {
@@ -136,8 +134,8 @@ upon return.
.It Dv PT_CONTINUE
The traced process continues execution.
.Fa addr
-is an address specifying the place where execution is to be resumed
-(a new value for the program counter,)
+is an address specifying the place where execution is to be resumed
+(a new value for the program counter),
or
.Po Vt caddr_t Pc Ns 1
to indicate that execution is to pick up where it left off.
@@ -160,7 +158,8 @@ given as the signal to be delivered.
.It Dv PT_ATTACH
This request allows a process to gain control of an otherwise
unrelated process and begin tracing it.
-It does not need any cooperation from the to-be-traced process. In
+It does not need any cooperation from the to-be-traced process.
+In
this case,
.Fa pid
specifies the process ID of the to-be-traced process, and the other
@@ -246,7 +245,7 @@ Additionally, machine-specific requests can exist.
Some requests can cause
.Fn ptrace
to return
-.Li -1
+\-1
as a non-error value; to disambiguate,
.Va errno
can be set to 0 before the call and checked afterwards.
@@ -271,7 +270,7 @@ The
.Fa request
was not one of the legal requests.
.It
-The signal number
+The signal number
(in
.Fa data )
to
@@ -297,7 +296,7 @@ was attempted on a process that was already being traced.
A request attempted to manipulate a process that was being traced by
some process other than the one making the request.
.It
-A request
+A request
(other than
.Dv PT_ATTACH )
specified a process that wasn't stopped.
@@ -305,7 +304,7 @@ specified a process that wasn't stopped.
.It Bq Er EPERM
.Bl -bullet -compact
.It
-A request
+A request
(other than
.Dv PT_ATTACH )
attempted to manipulate a process that wasn't being traced at all.
OpenPOWER on IntegriCloud