aboutsummaryrefslogtreecommitdiff
path: root/sbin
diff options
context:
space:
mode:
authorMike Pritchard <mpp@FreeBSD.org>1996-12-14 20:14:15 +0000
committerMike Pritchard <mpp@FreeBSD.org>1996-12-14 20:14:15 +0000
commit0d540c71bd2e7e421680e0375e6b3dd719aab25f (patch)
tree98d50a49ca5afd7c123c6345c335e32730285333 /sbin
parentc347ebabe1b75f65b9736e0de47e20facb142c9d (diff)
downloadsrc-0d540c71bd2e7e421680e0375e6b3dd719aab25f.tar.gz
src-0d540c71bd2e7e421680e0375e6b3dd719aab25f.zip
Remove the detailed description of the files in /proc
and instead refer the reader to procfs(5) so that the information does not need to be maintained in two places.
Notes
Notes: svn path=/head/; revision=20461
Diffstat (limited to 'sbin')
-rw-r--r--sbin/mount_std/mount_procfs.8167
1 files changed, 11 insertions, 156 deletions
diff --git a/sbin/mount_std/mount_procfs.8 b/sbin/mount_std/mount_procfs.8
index 87a21ad10049..253331016fd3 100644
--- a/sbin/mount_std/mount_procfs.8
+++ b/sbin/mount_std/mount_procfs.8
@@ -78,170 +78,25 @@ In addition, the special entry
.Pa curproc
references the current process.
.Pp
-Each directory contains several files.
-.Bl -tag -width status
-.It Pa ctl
-a writeonly file which supports a variety
-of control operations.
-Control commands are written as strings to the
-.Pa ctl
-file.
-The control commands are:
-.Bl -tag -width detach -compact
-.It attach
-stops the target process and arranges for the sending
-process to become the debug control process.
-.It detach
-continue execution of the target process and
-remove it from control by the debug process (which
-need not be the sending process).
-.It run
-continue running the target process until
-a signal is delivered, a breakpoint is hit, or the
-target process exits.
-.It step
-single step the target process, with no signal delivery.
-.It wait
-wait for the target process to come to a steady
-state ready for debugging.
-The target process must be in this state before
-any of the other commands are allowed.
-.El
-.Pp
-The string can also be the name of a signal, lower case
-and without the
-.Dv SIG
-prefix,
-in which case that signal is delivered to the process
-(see
-.Xr sigaction 2 ).
-.It Pa file
-A reference to the vnode from which the process text was read.
-This can be used to gain access to the process' symbol table,
-or to start another copy of the process.
-.It Pa mem
-The complete virtual memory image of the process.
-Only those address which exist in the process can be accessed.
-Reads and writes to this file modify the process.
-Writes to the text segment remain private to the process.
-.It Pa note
-Not implemented.
-.It Pa notepg
-Not implemented.
-.It Pa regs
-Allows read and write access to the process' register set.
-This file contains a binary data structure
-.Dv "struct regs"
-defined in
-.Pa <machine/reg.h> .
-.Pa regs
-can only be written when the process is stopped.
-.It Pa fpregs
-The floating point registers as defined by
-.Dv "struct fpregs"
-in
-.Pa <machine/reg.h> .
-.Pa fpregs
-is only implemented on machines which have distinct general
-purpose and floating point register sets.
-.It Pa status
-The process status.
-This file is readonly and returns a single line containing
-multiple space-separated fields as follows:
-.Pp
-.Bl -bullet -compact
-.It
-command name
-.It
-process id
-.It
-parent process id
-.It
-process group id
-.It
-session id
-.It
-.Ar major,minor
-of the controlling terminal, or
-.Dv -1,-1
-if there is no controlling terminal.
-.It
-a list of process flags:
-.Dv ctty
-if there is a controlling terminal,
-.Dv sldr
-if the process is a session leader,
-.Dv noflags
-if neither of the other two flags are set.
-.It
-the process start time in seconds and microseconds,
-comma separated.
-.It
-the user time in seconds and microseconds,
-comma separated.
-.It
-the system time in seconds and microseconds,
-comma separated.
-.It
-the wait channel message
-.It
-the process credentials consisting of
-the effective user id
-and the list of groups (whose first member
-is the effective group id)
-all comma separated.
-.El
-.El
-.Pp
-In a normal debugging environment,
-where the target is fork/exec'd by the debugger,
-the debugger should fork and the child should stop
-itself (with a self-inflicted
-.Dv SIGSTOP
-for example).
-The parent should issue a
-.Dv wait
-and then an
-.Dv attach
-command via the appropriate
-.Pa ctl
-file.
-The child process will receive a
-.Dv SIGTRAP
-immediately after the call to exec (see
-.Xr execve 2 ).
+Each directory contains several files. See
+.Xr procfs 5
+for a detailed description of each file.
.Sh FILES
.Bl -tag -width /proc/curproc -compact
-.It Pa /proc/#
+.It Pa /proc
+normal mount point for the
+.Nm procfs .
+.It Pa /proc/pid
+directory containg process information for process
+.Pa pid .
.It Pa /proc/curproc
-.It Pa /proc/curproc/ctl
-.It Pa /proc/curproc/file
-.It Pa /proc/curproc/mem
-.It Pa /proc/curproc/note
-.It Pa /proc/curproc/notepg
-.It Pa /proc/curproc/regs
-.It Pa /proc/curproc/fpregs
-.It Pa /proc/curproc/status
+directory containing process information for the current process
.El
.Sh SEE ALSO
-.Xr sigaction 2 ,
.Xr mount 2 ,
.Xr unmount 2 ,
+.Xr procfs 5
.Sh CAVEATS
-No
-.Pa .
-and
-.Pa ..
-entries appear when listing the contents of the
-.Pa /proc
-directory.
-This makes sense in the context of this filesystem, but is inconsistent
-with usual filesystem conventions.
-However, it is still possible to refer to both
-.Pa .
-and
-.Pa ..
-in a pathname.
.Pp
This filesystem may not be NFS-exported
since most of the functionality of