|
|
file system bsize bfree block
|
|
getmnt(2) System Calls Manual getmnt(2) Name getmnt - get information about mounted file systems Syntax #include <sys/types.h> #include <sys/param.h> #include <sys/mount.h> getmnt(start, buffer, nbytes, mode, path) int *start; struct fs_data *buffer; int nbytes, mode; char *path; Description The system call retrieves information about mounted file systems. The mode argument is one of the following: or If mode is or then path is the name of a single file system for which information is desired, start and nbytes are ignored, and buffer is assumed to be large enough to hold one structure. If mode is or then path is ignored. The start argument is the current logical location within the internal system mount table and must be initially set to The start argument is updated to reflect the current logical location within the system mount table, allowing successive executions of to retrieve information about all the mounted file systems. The nbytes argument defines the size of buffer, into which the file system information is returned. Buffer sizes must be a multiple of bytes. Larger buffer sizes allow information about multiple file systems to be returned. If mode is or then dynamic information (the number of free inodes and the number of free blocks) could be out of date, but these calls are guaranteed to return. The file system information in memory is not updated. If mode is or then the file system information in memory is updated. However, if the server of any file system for which information is being retrieved is down, then these calls will hang until the server responds. When information about multiple file systems is returned, it is stored within consecutive buffer locations. The information for each file system is described by the structure struct fs_data { struct fs_data_req fd_req; /* required data */ u_int fd_spare[113]; /* spare */ }; /* 2560 bytes */ struct fs_data_req { /* required part for all file systems */ u_int flags; /* how mounted */ u_int mtsize; /* max transfer size in bytes */ u_int otsize; /* optimal transfer size in bytes */ u_int bsize; /* fs block size in bytes for vm code */ u_int fstype; /* see ../h/fs_types.h */ u_int gtot; /* total number of gnodes */ u_int gfree; /* # of free gnodes */ u_int btot; /* total number of 1K blocks */ u_int bfree; /* # of free 1K blocks */ u_int bfreen; /* user consumable 1K blocks */ u_int pgthresh; /* min size in bytes before paging*/ int uid; /* uid that mounted me */ dev_t dev; /* major/minor of fs */ dev_t pad; /* alignment: dev_t is a short*/ char devname[MAXPATHLEN + 4]; /* name of dev */ char path[MAXPATHLEN + 4]; /* name of mount point */ } Return Values Upon successful completion, a value indicating the number of structures stored in buffer is returned. If the file system is not mounted (mode is or or there are no more file systems in the mount table (mode is or is returned. Otherwise, is returned and the global variable errno is set to indicate the error. Diagnostics [ENOTDIR] A component of the path prefix of path is not a directory. [EINVAL] Invalid argument. [ENAMETOOLONG] The length of a component of path exceeds 255 characters, or the length of path exceeds 1023 characters. [ENOENT] The file referred to by path does not exist. [EACCESS] Search permission is denied for a component of the path prefix of path. [ELOOP] Too many symbolic links were encountered in translating path. [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 gfsi(5) getmnt(2)
