Doubts with sysfs(2)

Doubts with sysfs(2)

[Davidlohr Bueso]

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.

Thanks,
Davidlohr

--
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: Doubts with sysfs(2)

[Michael Kerrisk]

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

Re: Doubts with sysfs(2)

[Denis Barbier]

On 2010/6/27 Michael Kerrisk wrote:
[...]
> --- 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

Hello Michael,

There is an extra 'the' just above, found in commit d1d721be.

Denis
--
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: Doubts with sysfs(2)

[Michael Kerrisk]

Hello Denis,

On Sun, Aug 29, 2010 at 11:25 AM, Denis Barbier <bouzim-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> On 2010/6/27 Michael Kerrisk wrote:
> [...]
>> --- 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
>
> Hello Michael,
>
> There is an extra 'the' just above, found in commit d1d721be.
>
> Denis

Thanks. Fixed.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.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