share/man/man5/linprocfs.5

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