getmountent(3) Library Functions Manual getmountent(3)
Name
getmountent - get information about mounted file systems without blocking
Syntax
#include <sys/types.h>
#include <sys/param.h>
#include <sys/mount.h>
getmountent(start, buffer, nentries)
int *start;
struct fs_data *buffer;
int nentries;
Description
The library routine retrieves mounted file system information from memory without blocking. The file system information retrieved (the
number of free inodes and blocks) might not be up to date. If the accuracy of the file system information retrieved is critical, you
should use or instead of
The start argument is the current logical location within the internal system mount table and must be initially set to 0. The buffer argu-
ment is the holding area for the returned information; that is, the structures. The size of buffer should be at least the number of
entries times the size of the structure, in bytes.
The nentries argument defines the number of mount table entries that are to be retrieved.
The number of file systems described by the information placed in buffer is returned. The start argument is updated so that successive
calls can be used to retrieve the entire mount table.
Return Values
Upon successful completion, a value indicating the number of structures stored in buffer is returned. If there are no more file systems in
the mount table, is returned. Otherwise, is returned and the global variable errno is set to indicate the error.
Diagnostics
EINVAL Invalid argument.
EFAULT Either buffer or start causes an illegal address to be referenced.
EIO An I/O error occurred while reading from the file system.
See Also
getmnt(2), statfs(3)
getmountent(3)
