share/man/man5/linprocfs.5

   1 .\" $FreeBSD: src/share/man/man5/linprocfs.5,v 1.1.2.5 2001/08/17 13:08:47 ru Exp $
   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.  There is also a
  26 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 which contains the following entries:
  31 .Pp
  32 Each directory contains several files:
  33 .Bl -tag -width status
  34 .It Pa exe
  35 A reference to the vnode from which the process text was read.
  36 This can be used to gain access to the process' symbol table,
  37 or to start another copy of the process.
  38 .It Pa mem
  39 The complete virtual memory image of the process.
  40 Only those addresses which exist in the process can be accessed.
  41 Reads and writes to this file modify the process.
  42 Writes to the text segment remain private to the process.
  43 .El
  44 .Pp
  45 Each node is owned by the process's user, and belongs to that user's
  46 primary group, except for the
  47 .Pa mem
  48 node, which belongs to the
  49 .Li kmem
  50 group.
  51 .Sh FILES
  52 .Bl -tag -width /compat/linux/proc/self/XXXXXXX -compact
  53 .It Pa /compat/linux/proc
  54 normal mount point for the
  55 .Nm .
  56 .It Pa /compat/linux/proc/cpuinfo
  57 CPU vendor and model information in human-readable form.
  58 .It Pa /compat/linux/proc/meminfo
  59 System memory information in human-readable form.
  60 .It Pa /compat/linux/proc/pid
  61 directory containing process information for process
  62 .Pa pid .
  63 .It Pa /compat/linux/proc/self
  64 directory containing process information for the current process
  65 .It Pa /compat/linux/proc/self/exe
  66 executable image
  67 .It Pa /compat/linux/proc/self/mem
  68 the complete virtual address space of the process
  69 .El
  70 .Sh SEE ALSO
  71 .Xr mount 2 ,
  72 .Xr unmount 2 ,
  73 .Xr procfs 5 ,
  74 .Xr mount_linprocfs 8
  75 .Sh AUTHORS
  76 .An -nosplit
  77 The
  78 .Nm
  79 was derived from
  80 .Nm procfs
  81 by
  82 .An Pierre Beyssac .
  83 This manual page was written by
  84 .An Dag-Erling Sm\(/orgrav ,
  85 based on the
  86 .Xr procfs 5
  87 manual page by
  88 .An Garrett Wollman .
  89 .Sh HISTORY
  90 The
  91 .Nm
  92 first appeared in
  93 .Fx 4.0 .