gethostid/sethostid in wrong manual section

gethostid/sethostid in wrong manual section

[Colin Watson]

https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/17551 reports
(and I've confirmed) that gethostid/sethostid are in section 2 despite
being implemented by glibc, not the kernel; they aren't just syscall
stubs either. Should they be moved to section 3?

Thanks,

-- 
Colin Watson                                       [cjwatson-GeWIH/nMZzLQT0dZR+AlfA@public.gmane.org]
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: gethostid/sethostid in wrong manual section

[Michael Kerrisk]

Hi Colin,

On Tue, Dec 23, 2008 at 12:39 PM, Colin Watson <cjwatson-GeWIH/nMZzLQT0dZR+AlfA@public.gmane.org> wrote:
> https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/17551 reports
> (and I've confirmed) that gethostid/sethostid are in section 2 despite
> being implemented by glibc, not the kernel; they aren't just syscall
> stubs either. Should they be moved to section 3?

I suspect this is a historical thing, since in the original BSD docs,
these interfaces were documented in Section 2, although I see FreeBSD
for example now has them in Section 3.

Anyway, I have relocated the page to section 3 as you suggest, and
created some .so link files so that "man 2 [gs]ethostid" will continue
to do the right thing.

(There were also a few other broken pieces in the page -- e.g., no
return value or error description for sethostid() -- that I also fixed
along the way.)

The changes will be in man-pages-3.16.

Cheers,

Michael

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html