[RFC 0/2] proc.5: Add fresh VmFlags and fdinfo output

[RFC 0/2] proc.5: Add fresh VmFlags and fdinfo output

[Cyrill Gorcunov]

fdinfo output is not yet covered well since it's a way more tricker
than anything else, so I desided to start with small steps.

Please review and comment.

Cyrill Gorcunov (2):
  proc.5: Add description of VmFlags field
  proc.5: Start describing /proc/fdinfo format

 man5/proc.5 | 82 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)

-- 
1.8.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[RFC 1/2] proc.5: Add description of VmFlags field

[Cyrill Gorcunov]

Signed-off-by: Cyrill Gorcunov <gorcunov-GEFAQzZX7r8dnm+yROfE0A@public.gmane.org>
---
 man5/proc.5 | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 375a131..c1e01db 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -889,6 +889,8 @@ Shared_Clean:       424 kB
 Shared_Dirty:         0 kB
 Private_Clean:        0 kB
 Private_Dirty:        0 kB
+\&...
+VmFlags: rd ex mr mw me de
 
 .fi
 .in
@@ -900,6 +902,43 @@ the amount of the mapping that is currently resident in RAM,
 the number of clean and dirty shared pages in the mapping,
 and the number of clean and dirty private pages in the mapping.
 
+The
+.I VmFlags
+field (since Linux 3.8) represents the kernel flags associated with
+the particular virtual memory area in two letter encoded manner.
+The codes are the following:
+.nf
+.in +5
+rd = readable
+wr = writeable
+ex = executable
+sh = shared
+mr = may read
+mw = may write
+me = may execute
+ms = may share
+gd = stack segment growns down
+pf = pure PFN range
+dw = disabled write to the mapped file
+lo = pages are locked in memory
+io = memory mapped I/O area
+sr = sequential read advise provided
+rr = random read advise provided
+dc = do not copy area on fork
+de = do not expand area on remapping
+ac = area is accountable
+nr = swap space is not reserved for the area
+ht = area uses huge tlb pages
+nl = non-linear mapping
+ar = architecture specific flag
+dd = do not include area into core dump
+mm = mixed map area
+hg = huge page advise flag
+nh = no-huge page advise flag
+mg = mergable advise flag
+.fi
+.in
+
 This file is present only if the
 .B CONFIG_MMU
 kernel configuration
-- 
1.8.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[RFC 2/2] proc.5: Start describing /proc/fdinfo format

[Cyrill Gorcunov]

Signed-off-by: Cyrill Gorcunov <gorcunov-GEFAQzZX7r8dnm+yROfE0A@public.gmane.org>
---
 man5/proc.5 | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index c1e01db..b177bab 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -349,6 +349,49 @@ field is an octal number that displays the
 file access mode and file status flags (see
 .BR open (2)).
 
+The files such as
+.BR eventfd (2),
+.BR signalfd (2),
+.BR epoll (2)
+among regular
+.I pos
+and
+.I flags
+fields pair provide additional information specific to the objects
+they represent (only additional fields are posted here):
+.in +4n
+.nf
+
+.RB "" "eventfd files"
+eventfd-count:	5a
+
+.RB "" "signalfd files"
+sigmask:	0000000000000200
+
+.RB "" "epoll files"
+tfd:        5 events:       1d data: ffffffffffffffff
+
+.fi
+.in
+
+All fields except
+.IR tfd
+are provided in hex format.
+
+Former idea of providing additional data was to give user space applications
+enough information to recreate (or, more precisely, to restore) these objects
+using appropriate library or system calls.
+
+.IR eventfd-count
+and
+.IR sigmask
+represent values of counter and signal mask associated with appropriate files.
+
+.IR tfd,
+.IR events,
+.IR data
+represent file descriptor number, event mask and data associated with epoll file.
+
 The files in this directory are readable only by the owner of the process.
 .\" FIXME document /proc/[pid]/io
 .\" .TP
-- 
1.8.1.4

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html