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