Re: Doubts with sysfs(2)

[Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

Hello Dave,

On Sun, Jun 27, 2010 at 12:51 PM, Davidlohr Bueso <dave.bueso-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Hi,
>
> I recently ran into the sysfs(2) call and noticed that the manpage does
> not specify what header file(s) to include to use it. Now, is this
> because of the lack of libc/glibc support (hence no wrapper available)?
>
> If so, I think we should add this problem in the BUGS section of the
> page, and put something like:
>
> syscall(SYS_sysfs, number);
>
> Any comments would be appreciated.

sysfs() is obsolete. Probably nothing uses it any more, and nothing
new should, so explaining how to use it seems redundant. What I did do
was clarify that it is obsolete. The change below is for
man-pages-3.26.

Cheers,

Michael


--- a/man2/sysfs.2
+++ b/man2/sysfs.2
@@ -90,12 +90,12 @@ is invalid.
 .SH "CONFORMING TO"
 SVr4.
 .SH NOTES
-On Linux with the
-.I proc
-file system mounted on
+This System-V derived system call is obsolete; don't use it.
+On systems with
 .IR /proc ,
-the same information can be derived from
-.IR /proc/filesystems .
+the the same information can be obtained via
+.IR /proc/filesystems ;
+use that interface instead.
 .SH BUGS
 There is no libc or glibc support.
 There is no way to guess how large \fIbuf\fP should be.
--
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