xref: /minix3/minix/man/man5/statvfs.5 (revision 433d6423c39e34ec4b79c950597bb2d236f886be)
1*433d6423SLionel Sambuc.\"	$NetBSD: statvfs.5,v 1.10 2008/06/23 04:22:36 dholland Exp $
2*433d6423SLionel Sambuc.\"
3*433d6423SLionel Sambuc.\" Copyright (c) 1989, 1991, 1993
4*433d6423SLionel Sambuc.\"	The Regents of the University of California.  All rights reserved.
5*433d6423SLionel Sambuc.\"
6*433d6423SLionel Sambuc.\" Redistribution and use in source and binary forms, with or without
7*433d6423SLionel Sambuc.\" modification, are permitted provided that the following conditions
8*433d6423SLionel Sambuc.\" are met:
9*433d6423SLionel Sambuc.\" 1. Redistributions of source code must retain the above copyright
10*433d6423SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer.
11*433d6423SLionel Sambuc.\" 2. Redistributions in binary form must reproduce the above copyright
12*433d6423SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer in the
13*433d6423SLionel Sambuc.\"    documentation and/or other materials provided with the distribution.
14*433d6423SLionel Sambuc.\" 3. Neither the name of the University nor the names of its contributors
15*433d6423SLionel Sambuc.\"    may be used to endorse or promote products derived from this software
16*433d6423SLionel Sambuc.\"    without specific prior written permission.
17*433d6423SLionel Sambuc.\"
18*433d6423SLionel Sambuc.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19*433d6423SLionel Sambuc.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20*433d6423SLionel Sambuc.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21*433d6423SLionel Sambuc.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22*433d6423SLionel Sambuc.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23*433d6423SLionel Sambuc.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24*433d6423SLionel Sambuc.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25*433d6423SLionel Sambuc.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26*433d6423SLionel Sambuc.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27*433d6423SLionel Sambuc.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28*433d6423SLionel Sambuc.\" SUCH DAMAGE.
29*433d6423SLionel Sambuc.\"
30*433d6423SLionel Sambuc.\"	@(#)statfs.2	8.5 (Berkeley) 5/24/95
31*433d6423SLionel Sambuc.\"
32*433d6423SLionel Sambuc.Dd June 23, 2008
33*433d6423SLionel Sambuc.Dt STATVFS 5
34*433d6423SLionel Sambuc.Os
35*433d6423SLionel Sambuc.Sh NAME
36*433d6423SLionel Sambuc.Nm statvfs
37*433d6423SLionel Sambuc.Nd file system statistics
38*433d6423SLionel Sambuc.Sh SYNOPSIS
39*433d6423SLionel Sambuc.In sys/types.h
40*433d6423SLionel Sambuc.In sys/statvfs.h
41*433d6423SLionel Sambuc.Sh DESCRIPTION
42*433d6423SLionel SambucThe
43*433d6423SLionel Sambuc.Aq Pa sys/statvfs.h
44*433d6423SLionel Sambucheader defines the structures and functions that
45*433d6423SLionel Sambucreturn information about a mounted file system.
46*433d6423SLionel SambucThe
47*433d6423SLionel Sambuc.Nm statvfs
48*433d6423SLionel Sambucstructure is defined as follows:
49*433d6423SLionel Sambuc.Bd -literal
50*433d6423SLionel Sambuc
51*433d6423SLionel Sambucstruct statvfs {
52*433d6423SLionel Sambuc	unsigned long	f_bsize;  /* system block size */
53*433d6423SLionel Sambuc	unsigned long	f_frsize; /* system fragment size */
54*433d6423SLionel Sambuc
55*433d6423SLionel Sambuc	fsblkcnt_t	f_blocks; /* number of blocks in file system */
56*433d6423SLionel Sambuc	fsblkcnt_t	f_bfree;  /* free blocks avail in file system */
57*433d6423SLionel Sambuc	fsblkcnt_t	f_bavail; /* free blocks avail to non-root */
58*433d6423SLionel Sambuc
59*433d6423SLionel Sambuc	fsfilcnt_t	f_files;  /* total file nodes in file system */
60*433d6423SLionel Sambuc	fsfilcnt_t	f_ffree;  /* free file nodes in file system */
61*433d6423SLionel Sambuc	fsfilcnt_t	f_favail; /* free file nodes avail to non-root */
62*433d6423SLionel Sambuc
63*433d6423SLionel Sambuc	unsigned long	f_fsid;   /* File system ID */
64*433d6423SLionel Sambuc
65*433d6423SLionel Sambuc	unsigned long	f_flag;	  /* flags */
66*433d6423SLionel Sambuc
67*433d6423SLionel Sambuc	unsigned long	f_namemax;/* maximum filename length */
68*433d6423SLionel Sambuc};
69*433d6423SLionel Sambuc.Ed
70*433d6423SLionel Sambuc.Pp
71*433d6423SLionel SambucThe
72*433d6423SLionel Sambuc.Fa f_flag
73*433d6423SLionel Sambucargument can have the following bits set:
74*433d6423SLionel Sambuc.Bl -tag -width ST_SYNCHRONOUS
75*433d6423SLionel Sambuc.It Dv ST_RDONLY
76*433d6423SLionel SambucThe filesystem is mounted read-only;
77*433d6423SLionel SambucEven the super-user may not write on it.
78*433d6423SLionel Sambuc.It Dv ST_NOSUID
79*433d6423SLionel SambucSetuid and setgid bits on files are not honored when they are executed.
80*433d6423SLionel Sambuc.It Dv ST_NOTRUNC
81*433d6423SLionel SambucFile names longer than NAME_MAX are not truncated.
82*433d6423SLionel Sambuc.El
83*433d6423SLionel Sambuc.Sh SEE ALSO
84*433d6423SLionel Sambuc.Xr statvfs 2
85*433d6423SLionel Sambuc.Sh HISTORY
86*433d6423SLionel SambucThe
87*433d6423SLionel Sambuc.Aq Pa sys/statvfs.h
88*433d6423SLionel Sambucheader first appeared in
89*433d6423SLionel Sambuc.Nx 3.0 .
90