xref: /NextBSD/share/man/man5/linprocfs.5 (revision eb1a5f8de9f7ea602c373a710f531abbf81141c4)
1.\" $FreeBSD$
2.\" Written by Garrett Wollman
3.\" This file is in the public domain.
4.\"
5.Dd August 10, 1994
6.Dt LINPROCFS 5
7.Os
8.Sh NAME
9.Nm linprocfs
10.Nd Linux process file system
11.Sh SYNOPSIS
12.Bd -literal
13linproc		/compat/linux/proc	linprocfs	rw 0 0
14.Ed
15.Sh DESCRIPTION
16The Linux process file system, or
17.Nm ,
18emulates a subset of Linux' process file system and is required for
19the complete operation of some Linux binaries.
20.Pp
21The
22.Nm
23provides a two-level view of process space.
24At the highest level, processes themselves are named, according to
25their process ids in decimal, with no leading zeros.
26There is also a special node called
27.Pa self
28which always refers to the process making the lookup request.
29.Pp
30Each node is a directory containing several files:
31.Bl -tag -width status
32.It Pa exe
33A reference to the vnode from which the process text was read.
34This can be used to gain access to the process' symbol table,
35or to start another copy of the process.
36.It Pa mem
37The complete virtual memory image of the process.
38Only those addresses which exist in the process can be accessed.
39Reads and writes to this file modify the process.
40Writes to the text segment remain private to the process.
41.El
42.Pp
43Each node is owned by the process's user, and belongs to that user's
44primary group, except for the
45.Pa mem
46node, which belongs to the
47.Li kmem
48group.
49.Sh FILES
50.Bl -tag -width /compat/linux/proc/self/XXXXXXX -compact
51.It Pa /compat/linux/proc
52The normal mount point for the
53.Nm .
54.It Pa /compat/linux/proc/cpuinfo
55CPU vendor and model information in human-readable form.
56.It Pa /compat/linux/proc/meminfo
57System memory information in human-readable form.
58.It Pa /compat/linux/proc/pid
59A directory containing process information for process
60.Pa pid .
61.It Pa /compat/linux/proc/self
62A directory containing process information for the current process.
63.It Pa /compat/linux/proc/self/exe
64The executable image for the current process.
65.It Pa /compat/linux/proc/self/mem
66The complete virtual address space of the current process.
67.El
68.Sh EXAMPLES
69To mount a
70.Nm
71file system on
72.Pa /compat/linux/proc :
73.Pp
74.Dl "mount -t linprocfs linproc /compat/linux/proc"
75.Sh SEE ALSO
76.Xr mount 2 ,
77.Xr unmount 2 ,
78.Xr procfs 5 ,
79.Xr pseudofs 9
80.Sh HISTORY
81The
82.Nm
83first appeared in
84.Fx 4.0 .
85.Sh AUTHORS
86.An -nosplit
87The
88.Nm
89was derived from
90.Nm procfs
91by
92.An Pierre Beyssac .
93This manual page was written by
94.An Dag-Erling Sm\(/orgrav ,
95based on the
96.Xr procfs 5
97manual page by
98.An Garrett Wollman .
99