2 .\" Written by Garrett Wollman
3 .\" This file is in the public domain.
10 .Nd process file system
13 proc /proc procfs rw 0 0
16 The process file system, or
18 implements a view of the system process table inside the file system.
19 It is normally mounted on
24 provides a two-level view of process space, unlike the previous
28 At the highest level, processes themselves are named, according to
29 their process ids in decimal, with no leading zeros.
33 which always refers to the process making the lookup request.
35 Each node is a directory which contains the following entries:
36 .Bl -tag -width status
38 The debug registers as defined by
43 is currently only implemented on the i386 architecture.
45 The type of the executable referenced by the
49 A symbolic link to the file from which the process text was read.
50 This can be used to gain access to the process' symbol table,
51 or to start another copy of the process.
52 If the file cannot be found, the link target is
55 The floating point registers as defined by
60 is only implemented on machines which have distinct general
61 purpose and floating point register sets.
63 A map of the process' virtual memory.
65 The complete virtual memory image of the process.
66 Only those address which exist in the process can be accessed.
67 Reads and writes to this file modify the process.
68 Writes to the text segment remain private to the process.
70 Used for sending signals to the process.
73 Used for sending signal to the process group.
76 Allows read and write of the kernel osrel value assigned to the process.
77 It affects the compatibility shims that are turned on and off
78 depending on the value.
79 Initial process value is read from the ABI note tag in the executed ELF image,
80 and is zero if the tag not supported by binary format or was not found.
82 Allows read and write access to the process' register set.
83 This file contains a binary data structure
88 can only be written when the process is stopped.
90 This is a read-only file containing the process current and maximum
92 Each line is of the format
93 .Ar rlimit current max ,
98 This file is read-only and returns a single line containing
99 multiple space-separated fields as follows:
114 of the controlling terminal, or
117 if there is no controlling terminal.
119 a list of process flags:
121 if there is a controlling terminal,
123 if the process is a session leader,
125 if neither of the other two flags are set.
127 the process start time in seconds and microseconds,
130 the user time in seconds and microseconds,
133 the system time in seconds and microseconds,
136 the wait channel message
138 the process credentials consisting of
139 the effective user id
140 and the list of groups (whose first member
141 is the effective group id)
144 the hostname of the jail in which the process runs, or
146 to indicate that the process is not running within a jail.
150 Each node is owned by the process's user, and belongs to that user's
153 .Bl -tag -width /proc/curproc/XXXXXXX -compact
155 normal mount point for the
158 directory containing process information for process
161 directory containing process information for the current process
162 .It Pa /proc/curproc/cmdline
163 the process executable name
164 .It Pa /proc/curproc/etype
166 .It Pa /proc/curproc/file
168 .It Pa /proc/curproc/fpregs
169 the process floating point register set
170 .It Pa /proc/curproc/map
171 virtual memory map of the process
172 .It Pa /proc/curproc/mem
173 the complete virtual address space of the process
174 .It Pa /proc/curproc/note
175 used for signaling the process
176 .It Pa /proc/curproc/notepg
177 used for signaling the process group
178 .It Pa /proc/curproc/osrel
179 the process osrel value
180 .It Pa /proc/curproc/regs
181 the process register set
182 .It Pa /proc/curproc/rlimit
183 the process current and maximum rlimit
184 .It Pa /proc/curproc/status
185 the process' current status
193 .Dl "mount -t procfs proc /proc"
202 This manual page written by
203 .An Garrett Wollman ,
204 based on the description
206 .An Jan-Simon Pendry ,
207 and revamped later by