BSD 4_4_Lite2 release

[unix-history] / usr / src / share / doc / psd / 05.sysman / 2.5.t

diff --git a/usr/src/share/doc/psd/05.sysman/2.5.t b/usr/src/share/doc/psd/05.sysman/2.5.t
index fac5420..e2e0cef 100644 (file)
--- a/usr/src/share/doc/psd/05.sysman/2.5.t
+++ b/usr/src/share/doc/psd/05.sysman/2.5.t
@@ -1,9 +1,35 @@
 .\" Copyright (c) 1983, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" Copyright (c) 1983, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
 .\"

-.\" %sccs.include.redist.roff%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"    @(#)2.5.t       8.4 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"    @(#)2.5.t       8.6 (Berkeley) 5/29/94

 .\"
 .Sh 2 "Process debugging
 .Sh 3 "Traditional debugging
 .\"
 .Sh 2 "Process debugging
 .Sh 3 "Traditional debugging


@@ -22,9 +48,6 @@ and examine and change its core image.
 Its primary use is for the implementation of breakpoint debugging.
 There are four arguments whose interpretation
 depends on a request argument.
 Its primary use is for the implementation of breakpoint debugging.
 There are four arguments whose interpretation
 depends on a request argument.

-Generally, pid is the process ID of the traced process,
-which must be a child (no more distant descendant)
-of the tracing process.

 A process being traced behaves normally until it
 encounters a signal (whether internally generated like
 ``illegal instruction'' or externally generated
 A process being traced behaves normally until it
 encounters a signal (whether internally generated like
 ``illegal instruction'' or externally generated


@@ -52,9 +75,6 @@ The debugger finds (or creates) the process that it wants to
 debug and then issues an attach command via the \fIctl\fP file.
 Further interaction can then be done with the process through
 the other files provided by the \fI/proc\fP filesystem.
 debug and then issues an attach command via the \fIctl\fP file.
 Further interaction can then be done with the process through
 the other files provided by the \fI/proc\fP filesystem.

-This interface has the benefit of being able to debug
-arbitrary processes on the system rather than just processes
-started by the debugger.

 .Sh 3 "Kernel tracing
 .LP
 Another facility for debugging programs is provided by the
 .Sh 3 "Kernel tracing
 .LP
 Another facility for debugging programs is provided by the


@@ -69,7 +89,7 @@ char *tracefile; int ops, trpoints, pid;
 does kernel trace logging for the specified processes.
 The kernel operations that are traced include system calls,
 pathname translations, signal processing, and I/O.
 does kernel trace logging for the specified processes.
 The kernel operations that are traced include system calls,
 pathname translations, signal processing, and I/O.

-This facility can be particularly useful for debugging
+This facility can be particularly useful to debug

 programs for which you do not have the source.
 .\"
 .\" We currently do not document the vtrace call
 programs for which you do not have the source.
 .\"
 .\" We currently do not document the vtrace call