Difference between revisions of "Manpages"

From CRIU
Jump to navigation Jump to search
(slight rephrasing)
 
(19 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
Line 15: Line 13:
 
|{{man-pages.git|69287cb678}} || prctl SET_MM extension || v3.39 || merged
 
|{{man-pages.git|69287cb678}} || prctl SET_MM extension || v3.39 || merged
 
|-
 
|-
−
| || prctl PR_GET_TID_ADDRESS || - || sent for review
+
|{{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@ ==
+
=== xemul@ ===
−
net dialogue interface (uncluding SOCK_DIAG_BY_FAMILY,NETLINK_SOCK_DIAG) --> man7/netlink.7
+
* 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
  
−
kernel.ns_last_pid, is kernel docs enough?
+
=== avagin@ ===
  
−
SO_PEEK_OFF -- for socket
+
* 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]
  
−
sockoption -- TCP_REPAIR and etc
+
=== skinsbursky@ ===
  
−
Allow to create links with given ifindex RTM_NEWLINK
+
* MSG_COPY for IPC
  
−
PACKET_SHOW_ (diag modules details)
+
=== gorcunov@ ===
  
−
SO_BINDTODEVICE readable now
+
* 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
  
−
SO_GET_FILTER
+
[[Category:Development]]
−
 
 
−
/proc/pid/map_files links (like /proc/pid/fd ones)
 
−
 
 
−
== avagin@ ==
 
−
 
 
−
proc: don't show nonexistent capabilities ?
 
−
 
 
−
== skinsbursky@ ==
 
−
 
 
−
MSG_COPY for IPC
 
−
 
 
−
== gorcunov@ ==
 
−
 
 
−
* tty's TIOCGPKT,TIOCGPTLCK,TIOCGEXCL codes -- unclear where to put, since there is no man for other ioctls
 
−
* smaps flags in man5/proc.5 ?
 
−
* map_files as well
 
−
* fdinfo ?
 
−
* F_GETOWNER_UIDS in fcntl
 

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
Retrieved from "https://criu.org/index.php?title=Manpages&oldid=3577"