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