Difference between revisions of "Manpages"

From CRIU
Jump to navigation Jump to search
(slight rephrasing)
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Since CRIU have patches in kernel that add/modify userspace API, such changes need to be reflected in the official man-pages package (which lives at http://git.kernel.org/?p=docs/man-pages/man-pages.git). So let's track the status here.
+
Since CRIU have patches in kernel that add/modify userspace API, such changes need to be reflected in the official man-pages package (which lives [http://git.kernel.org/?p=docs/man-pages/man-pages.git here]). This page is for status tracking of man-pages changes.
  
 
== Status ==
 
== Status ==
Line 14: Line 14:
 
|-
 
|-
 
|{{man-pages.git|b4bd57d56d}} || prctl PR_GET_TID_ADDRESS extension || v3.48 || merged
 
|{{man-pages.git|b4bd57d56d}} || prctl PR_GET_TID_ADDRESS extension || v3.48 || merged
 +
|-
 +
|{{man-pages.git|83e03f72cb}} || socket SO_BINDTODEVICE option || v3.48 || merged
 +
|-
 +
|{{man-pages.git|5048ae1ffe}} || RTM_NEWLINK message || v3.48 || merged
 +
|-
 +
|{{man-pages.git|b4f89985b9}} || /proc/[pid]/map_files || v3.51 || merged
 +
|-
 +
|{{man-pages.git|8cd5dce111}} || SO_PEEK_OFF || v3.45 || merged
 +
|-
 +
|{{man-pages.git|fa97928b5d}} || prctl.2: srcfix: cite PR_SET_MM kernel commits || v3.61 || merged
 +
|-
 +
|{{man-pages.git|5e5d2c43ff}} || prctl.2: wfix: fix wording in PR_SET_MM_EXE_FILE description || v3.61 || merged
 +
|-
 +
|{{man-pages.git|215db7b496}} || prctl.2: Note PR_SET_MM options appeared in Linux 3.5 || v3.61 || merged
 +
|-
 +
|{{man-pages.git|77649527ec}} || prctl.2: Document (uncomment) PR_SET_MM options in Linux 3.5 || v3.61 || merged
 
|}
 
|}
  
Line 23: Line 39:
 
* sockoption -- TCP_REPAIR and etc
 
* sockoption -- TCP_REPAIR and etc
 
* SO_GET_FILTER
 
* SO_GET_FILTER
 
==== PATCHSENT state ====
 
 
* SO_PEEK_OFF -- for socket
 
* Allow to create links with given ifindex RTM_NEWLINK
 
* SO_BINDTODEVICE readable now
 
* /proc/pid/map_files links (like /proc/pid/fd ones)
 
  
 
=== avagin@ ===
 
=== avagin@ ===
  
 
* proc: don't show nonexistent capabilities ?
 
* proc: don't show nonexistent capabilities ?
 +
* ptrace sigmask extension [http://comments.gmane.org/gmane.linux.man/4214 patch]
 +
* ptrace peek-siginfo extension [http://comments.gmane.org/gmane.linux.man/4214 patch]
  
 
=== skinsbursky@ ===
 
=== skinsbursky@ ===
Line 41: Line 52:
 
=== gorcunov@ ===
 
=== gorcunov@ ===
  
* tty's TIOCGPKT,TIOCGPTLCK,TIOCGEXCL codes -- unclear where to put, since there is no man for other ioctls
+
* tty's TIOCGPKT,TIOCGPTLCK,TIOCGEXCL codes -- there is no man pages for other ioctls code, probably just drop this idea
 
* smaps flags in man5/proc.5
 
* smaps flags in man5/proc.5
 
* fdinfo
 
* fdinfo

Latest revision as of 19:42, 22 September 2016

Since CRIU have patches in kernel that add/modify userspace API, such changes need to be reflected in the official man-pages package (which lives here). This page is for status tracking of man-pages changes.

Status[edit]

Manpage Description Version Status
man-pages: 98ef180325 kcmp system call v3.46 merged
man-pages: 69287cb678 prctl SET_MM extension v3.39 merged
man-pages: b4bd57d56d prctl PR_GET_TID_ADDRESS extension v3.48 merged
man-pages: 83e03f72cb socket SO_BINDTODEVICE option v3.48 merged
man-pages: 5048ae1ffe RTM_NEWLINK message v3.48 merged
man-pages: b4f89985b9 /proc/[pid]/map_files v3.51 merged
man-pages: 8cd5dce111 SO_PEEK_OFF v3.45 merged
man-pages: fa97928b5d prctl.2: srcfix: cite PR_SET_MM kernel commits v3.61 merged
man-pages: 5e5d2c43ff prctl.2: wfix: fix wording in PR_SET_MM_EXE_FILE description v3.61 merged
man-pages: 215db7b496 prctl.2: Note PR_SET_MM options appeared in Linux 3.5 v3.61 merged
man-pages: 77649527ec prctl.2: Document (uncomment) PR_SET_MM options in Linux 3.5 v3.61 merged

Need to check[edit]

xemul@[edit]

  • net dialogue interface (uncluding SOCK_DIAG_BY_FAMILY,NETLINK_SOCK_DIAG) --> man7/netlink.7
  • kernel.ns_last_pid, is kernel docs enough?
  • sockoption -- TCP_REPAIR and etc
  • SO_GET_FILTER

avagin@[edit]

  • proc: don't show nonexistent capabilities ?
  • ptrace sigmask extension patch
  • ptrace peek-siginfo extension patch

skinsbursky@[edit]

  • MSG_COPY for IPC

gorcunov@[edit]

  • tty's TIOCGPKT,TIOCGPTLCK,TIOCGEXCL codes -- there is no man pages for other ioctls code, probably just drop this idea
  • smaps flags in man5/proc.5
  • fdinfo
  • F_GETOWNER_UIDS in fcntl