summaryrefslogtreecommitdiffhomepage
path: root/pkg/sentry/fs/proc
diff options
context:
space:
mode:
authorMichael Pratt <mpratt@google.com>2018-05-17 16:25:51 -0700
committerShentubot <shentubot@google.com>2018-05-17 16:26:42 -0700
commitb960559fdb9a22c986af11ba4e886ffb316a3574 (patch)
tree3af8eb2d591a89055450250f0b17412e42774617 /pkg/sentry/fs/proc
parentb904250b862c5c14da84e08b6a5400c7bf2458b0 (diff)
Cleanup docs
This brings the proc document more up-to-date. PiperOrigin-RevId: 197070161 Change-Id: Iae2cf9dc44e3e748a33f497bb95bd3c10d0c094a
Diffstat (limited to 'pkg/sentry/fs/proc')
-rw-r--r--pkg/sentry/fs/proc/README.md96
1 files changed, 54 insertions, 42 deletions
diff --git a/pkg/sentry/fs/proc/README.md b/pkg/sentry/fs/proc/README.md
index c510ee63a..6ad7297d2 100644
--- a/pkg/sentry/fs/proc/README.md
+++ b/pkg/sentry/fs/proc/README.md
@@ -10,17 +10,16 @@ inconsistency, please file a bug.
The following files are implemented:
-| File /proc/ | Content |
-| :------------------------ | :----------------------------------------------- |
-| [cpuinfo](#cpuinfo) | Info about the CPU |
-| [filesystem](#filesystem) | Supported filesystems |
-| [loadavg](#loadavg) | Load average of last 1, 5 & 15 minutes |
-| [meminfo](#meminfo) | Overall memory info |
-| [stat](#stat) | Overall kernel statistics |
-| [sys](#sys) | Change parameters within the kernel |
-| [uptime](#uptime) | Wall clock since boot, combined idle time of all |
-: : cpus :
-| [version](#version) | Kernel version |
+| File /proc/ | Content |
+| :------------------------ | :---------------------------------------------------- |
+| [cpuinfo](#cpuinfo) | Info about the CPU |
+| [filesystems](#filesystems) | Supported filesystems |
+| [loadavg](#loadavg) | Load average of last 1, 5 & 15 minutes |
+| [meminfo](#meminfo) | Overall memory info |
+| [stat](#stat) | Overall kernel statistics |
+| [sys](#sys) | Change parameters within the kernel |
+| [uptime](#uptime) | Wall clock since boot, combined idle time of all cpus |
+| [version](#version) | Kernel version |
### cpuinfo
@@ -62,26 +61,20 @@ cache_alignment | Always 64
address sizes | Always 46 bits physical, 48 bits virtual
power management | Always blank
-Otherwise fields are derived from the SentryCPUIDSpec proto config.
+Otherwise fields are derived from the sentry configuration.
-### filesystem
+### filesystems
```bash
-$ cat /proc/filesystem
+$ cat /proc/filesystems
nodev 9p
+nodev devpts
nodev devtmpfs
nodev proc
-nodev ramdiskfs
nodev sysfs
nodev tmpfs
```
-Notable divergences:
-
-Filesystem | Notes
-:--------- | :--------------------------------------------------------
-ramdiskfs | No Linux equivalent, see the SentryRamdiskFS proto config
-
### loadavg
```bash
@@ -166,10 +159,6 @@ DirectMap4k | Missing
DirectMap2M | Missing
DirectMap1G | Missing
-See [Memory
-Accounting](pkg/sentry/usage/g3doc/memory-accounting.md)
-for general caveats.
-
### stat
```bash
@@ -236,22 +225,26 @@ Linux version 3.11.10 #1 SMP Fri Nov 29 10:47:50 PST 2013
The following files are implemented:
-File /proc/PID | Content
-:------------------ | :---------------------------------------------------
-[auxv](#auxv) | Copy of auxiliary vector for the process
-[cmdline](#cmdline) | Command line arguments
-[comm](#comm) | Command name associated with the process
-[exe](#exe) | Symlink to the process's executable
-[fd](#fd) | Directory containing links to open file descriptors
-[fdinfo](#fdinfo) | Information associated with open file descriptors
-[gid_map](#gid_map) | Mappings for group IDs inside the user namespace
-[io](#io) | IO statistics
-[maps](#maps) | Memory mappings (anon, executables, library files)
-[ns](#ns) | Directory containing info about supported namespaces
-[stat](#stat) | Process statistics
-[status](#status) | Process status in human readable format
-[task](#task) | Directory containing info about running threads
-[uid_map](#uid_map) | Mappings for user IDs inside the user namespace
+File /proc/PID | Content
+:---------------------- | :---------------------------------------------------
+[auxv](#auxv) | Copy of auxiliary vector for the process
+[cmdline](#cmdline) | Command line arguments
+[comm](#comm) | Command name associated with the process
+[environ](#environ) | Process environment
+[exe](#exe) | Symlink to the process's executable
+[fd](#fd) | Directory containing links to open file descriptors
+[fdinfo](#fdinfo) | Information associated with open file descriptors
+[gid_map](#gid_map) | Mappings for group IDs inside the user namespace
+[io](#io) | IO statistics
+[maps](#maps) | Memory mappings (anon, executables, library files)
+[mounts](#mounts) | Mounted filesystems
+[mountinfo](#mountinfo) | Information about mounts
+[ns](#ns) | Directory containing info about supported namespaces
+[stat](#stat) | Process statistics
+[statm](#statm) | Process memory statistics
+[status](#status) | Process status in human readable format
+[task](#task) | Directory containing info about running threads
+[uid_map](#uid_map) | Mappings for user IDs inside the user namespace
### auxv
@@ -265,6 +258,10 @@ TODO
TODO
+### environment
+
+TODO
+
### exe
TODO
@@ -291,6 +288,14 @@ TODO: add more detail.
TODO
+### mounts
+
+TODO
+
+### mountinfo
+
+TODO
+
### ns
TODO
@@ -302,9 +307,16 @@ num_threads, and exit_signal.
TODO: add more detail.
+### statm
+
+Only has data for vss and rss.
+
+TODO: add more detail.
+
### status
-Statically created, most of the fields have no data.
+Contains data for Name, State, Tgid, Pid, Ppid, TracerPid, FDSize, VmSize,
+VmRSS, Threads, CapInh, CapPrm, CapEff, CapBnd, Seccomp.
TODO: add more detail.