Re: clone(2) should be clone(3)

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Michael,

On 04/07/2013 12:15 PM, Michael Kerrisk (man-pages) wrote:
Hi Peter,

On Fri, Apr 5, 2013 at 6:01 PM, Peter Schiffer <pschiffe@xxxxxxxxxx> wrote:
Hi Michael,

it looks like the clone(2) man page is describing glibc implementation
and not the system call. So I guess it should be moved to the section 3
and a new man page for clone(2) syscall should be created in section 2.

The clone(2) syscall is defined like this:

SYSCALL_DEFINE5(clone, unsigned long, clone_flags, unsigned long, newsp,
                  int __user *, parent_tidptr,
                  int __user *, child_tidptr,
                  int, tls_val)

(I'm sorry, but I don't have a patch this time.)

The general tendency is to document all system calls in section 2, and
if there are some differences caused by wrapper functions, then they
are noted on the page.

I admint that clone(2) is an unusual case. The signature given at the
top of the page is for the wrapper (and later the difference to the
syscall raw interface are described). However, the details are
primarily about the underlying kernel interface, so I'm inclined to
leave the page where it is.


Ah, I see now. So, basically there are 2 problems:
 * it's not clear that in the synopsis is library call
 * system call is buried down in the page

Would it be viable to somehow have both signatures in the synopsis?
(I've checked some random man pages in section 2, but didn't find
anything similar..)

My aim here is, that when I'm opening man page in section 2, the first
thing I'm expecting to see is syscall signature. In clone(2), it's not
even clear that this is a library call.

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




[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux