diff options
Diffstat (limited to 'man2/sysfs.2')
-rw-r--r-- | man2/sysfs.2 | 103 |
1 files changed, 103 insertions, 0 deletions
diff --git a/man2/sysfs.2 b/man2/sysfs.2 new file mode 100644 index 000000000..c3ebc4cdd --- /dev/null +++ b/man2/sysfs.2 @@ -0,0 +1,103 @@ +.\" Copyright (C) 1995, Thomas K. Dyas <tdyas@eden.rutgers.edu> +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.\" Created Wed Aug 9 1995 Thomas K. Dyas <tdyas@eden.rutgers.edu> +.\" +.\" FIXME -- I can't find this in SVr4! +.TH SYSFS 2 1995-08-09 "Linux 1.3.16" "Linux Programmer's Manual" +.SH NAME +sysfs \- get file system type information +.SH SYNOPSIS +.BI "int sysfs(int " option ", const char *" fsname ); + +.BI "int sysfs(int " option ", unsigned int " fs_index ", char *" buf ); + +.BI "int sysfs(int " option ); +.SH DESCRIPTION +.B sysfs +returns information about the file system types currently present in +the kernel. The specific form of the +.B sysfs +call and the information returned depends on the +.I option +in effect: + +.TP +.B 1 +Translate the file-system identifier string +.I fsname +into a file-system type index. +.TP +.B 2 +Translate the file-system type index +.I fs_index +into a NUL-terminated file-system identifier string. This string will +be written to the buffer pointed to by +.IR buf . +Make sure that +.I buf +has enough space to accept the string. +.TP +.B 3 +Return the total number of file system types currently present in the +kernel. + +.PP +The numbering of the file-system type indexes begins with zero. +.SH "RETURN VALUE" +On success, +.B sysfs +returns the file-system index for option +.BR 1 , +zero for option +.BR 2 , +and the number of currently configured file systems for option +.BR 3 . +On error, \-1 is returned, and +.I errno +is set appropriately. +.SH ERRORS +.TP +.B EFAULT +.RI "Either " fsname " or " buf +is outside your accessible address space. +.TP +.B EINVAL +.I fsname +is not a valid file-system type identifier; +.I fs_index +is out-of-bounds; +.I option +is invalid. +.PP +.SH "CONFORMING TO" +SVr4. +.SH NOTE +On Linux with the +.I proc +filesystem mounted on +.IR /proc , +the same information can be derived from +.IR /proc/filesystems . +.SH BUGS +There is no libc or glibc support. +There is no way to guess how large \fIbuf\fP should be. |