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

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

 



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.

Thanks,

Michael
--
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