X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=original%2Fman2%2Fkcmp.2;h=d3c01c8db8d12d49742a46b26d3d2d975517a1ae;hb=c22bb444e1a8f4a0e08a82e80ea4ad06593869da;hp=8f15d7b7000c3a7c237a96cf7f6044366d661fee;hpb=504d22d4a96ccb4837812eca7e370714a5ed57f3;p=linuxjm%2FLDP_man-pages.git diff --git a/original/man2/kcmp.2 b/original/man2/kcmp.2 index 8f15d7b7..d3c01c8d 100644 --- a/original/man2/kcmp.2 +++ b/original/man2/kcmp.2 @@ -25,7 +25,7 @@ .\" .\" Kernel commit d97b46a64674a267bc41c9e16132ee2a98c3347d .\" -.TH KCMP 2 2013-01-27 "Linux" "Linux Programmer's Manual" +.TH KCMP 2 2013-12-08 "Linux" "Linux Programmer's Manual" .SH NAME kcmp \- compare two processes to determine if they share a kernel resource .SH SYNOPSIS @@ -74,8 +74,8 @@ and are ignored. .TP .BR KCMP_FS -Check whether the processes share the same file system information -(i.e., file mode creation mask, working directory, and file system root). +Check whether the processes share the same filesystem information +(i.e., file mode creation mask, working directory, and filesystem root). The arguments .I idx1 and @@ -100,7 +100,7 @@ are ignored. .TP .BR KCMP_SYSVSEM Check whether the processes share the same -list of System V semaphore undo operations. +list of System\ V semaphore undo operations. The arguments .I idx1 and @@ -117,10 +117,13 @@ are ignored. .PP Note the .BR kcmp () -is not protected against false positives which may have place if tasks are +is not protected against false positives which may occur if tasks are running. -Which means one should stop tasks being inspected with this syscall to obtain -meaningful results. +One should stop tasks by sending +.BR SIGSTOP +(see +.BR signal (7)) +prior to inspection with this system call to obtain meaningful results. .SH RETURN VALUE The return value of a successful call to .BR kcmp () @@ -160,7 +163,7 @@ On error, \-1 is returned, and .I errno is set appropriately. -.B kcmp () +.BR kcmp () was designed to return values suitable for sorting. This is particularly handy if one needs to compare a large number of file descriptors. @@ -198,7 +201,7 @@ The system call first appeared in Linux 3.5. .SH CONFORMING TO .BR kcmp () -is Linux specific and should not be used in programs intended to be portable. +is Linux-specific and should not be used in programs intended to be portable. .SH NOTES Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). @@ -210,7 +213,7 @@ checkpoint/restore in user space (CRIU) feature. The alternative to this system call would have been to expose suitable process information via the .BR proc (5) -file system; this was deemed to be unsuitable for security reasons. +filesystem; this was deemed to be unsuitable for security reasons. See .BR clone (2) @@ -219,3 +222,12 @@ referred to on this page. .SH SEE ALSO .BR clone (2), .BR unshare (2) +.SH COLOPHON +This page is part of release 3.67 of the Linux +.I man-pages +project. +A description of the project, +information about reporting bugs, +and the latest version of this page, +can be found at +\%http://www.kernel.org/doc/man\-pages/.