Difference between revisions of "Manpages"

From CRIU
Jump to navigation Jump to search
(slight rephrasing)
 
(28 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= About man-pages =
+
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.
  
Since we modify kernel source code and userspace API, we need to reflect such changes in official man-pages package (which lives at http://git.kernel.org/?p=docs/man-pages/man-pages.git). So lets track the status here.
+
== Status ==
 
 
= Status =
 
  
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
! Manpage
 
! Manpage
 
! Description
 
! Description
 +
! Version
 
! Status
 
! Status
! Comments
 
 
|-
 
|-
 
|{{man-pages.git|98ef180325}} || kcmp system call || v3.46 || merged
 
|{{man-pages.git|98ef180325}} || kcmp system call || v3.46 || merged
 
|-
 
|-
 
|{{man-pages.git|69287cb678}} || prctl SET_MM extension || v3.39 || merged
 
|{{man-pages.git|69287cb678}} || prctl SET_MM extension || v3.39 || 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
 
|}
 
|}
  
= Need to check =
+
== Need to check ==
 +
 
 +
=== xemul@ ===
 +
* 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@ ===
 +
 
 +
* 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@ ===
 +
 
 +
* MSG_COPY for IPC
 +
 
 +
=== gorcunov@ ===
 +
 
 +
* 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
  
inet dialogue (uncluding SOCK_DIAG_BY_FAMILY) --> man7/netlink.7
+
[[Category:Development]]

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