|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | STANDARDS | HISTORY | SEE ALSO | COLOPHON |
|
|
|
ustat(2) System Calls Manual ustat(2)
ustat - get filesystem statistics
Standard C library (libc, -lc)
#include <sys/types.h>
#include <unistd.h> /* libc[45] */
#include <ustat.h> /* glibc2 */
[[deprecated]] int ustat(dev_t dev, struct ustat *ubuf);
ustat() returns information about a mounted filesystem. dev is a
device number identifying a device containing a mounted
filesystem. ubuf is a pointer to a ustat structure that contains
the following members:
daddr_t f_tfree; /* Total free blocks */
ino_t f_tinode; /* Number of free inodes */
char f_fname[6]; /* Filsys name */
char f_fpack[6]; /* Filsys pack name */
The last two fields, f_fname and f_fpack, are not implemented and
will always be filled with null bytes ('\0').
On success, zero is returned and the ustat structure pointed to
by ubuf will be filled in. On error, -1 is returned, and errno
is set to indicate the error.
EFAULT ubuf points outside of your accessible address space.
EINVAL dev does not refer to a device containing a mounted
filesystem.
ENOSYS The mounted filesystem referenced by dev does not support
this operation, or any version of Linux before Linux
1.3.16.
None.
SVr4. Removed in glibc 2.28.
ustat() is deprecated and has been provided only for
compatibility. All new programs should use statfs(2) instead.
HP-UX notes
The HP-UX version of the ustat structure has an additional field,
f_blksize, that is unknown elsewhere. HP-UX warns: For some
filesystems, the number of free inodes does not change. Such
filesystems will return -1 in the field f_tinode. For some
filesystems, inodes are dynamically allocated. Such filesystems
will return the current number of free inodes.
stat(2), statfs(2)
This page is part of the man-pages (Linux kernel and C library
user-space interface documentation) project. Information about
the project can be found at
⟨https://www.kernel.org/doc/man-pages/⟩. If you have a bug report
for this manual page, see
⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
This page was obtained from the tarball man-pages-6.9.1.tar.gz
fetched from
⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
2024-06-26. If you discover any rendering problems in this HTML
version of the page, or you believe there is a better or more up-
to-date source for the page, or you have corrections or
improvements to the information in this COLOPHON (which is not
part of the original manual page), send a mail to
[email protected]
Linux man-pages 6.9.1 2024-06-15 ustat(2)
Pages that refer to this page: syscalls(2)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|