From d24348c636c46522bc435265996d15668d9563c1 Mon Sep 17 00:00:00 2001 From: Ben Gras Date: Sun, 27 Jun 2010 15:52:50 +0000 Subject: [PATCH] man - statvfs(5) manpage --- man/man5/Makefile | 2 +- man/man5/statvfs.5 | 87 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 88 insertions(+), 1 deletion(-) create mode 100644 man/man5/statvfs.5 diff --git a/man/man5/Makefile b/man/man5/Makefile index 87985b0c4..64bd09e47 100644 --- a/man/man5/Makefile +++ b/man/man5/Makefile @@ -1,6 +1,6 @@ MAN= configfile.5 crontab.5 dhcp.conf.5 dir.5 ethers.5 \ fstab.5 hosts.5 httpd.conf.5 http_status.5 keymap.5 \ - passwd.5 resolv.conf.5 resolver.5 rhosts.5 serv.access.5 \ + passwd.5 resolv.conf.5 resolver.5 rhosts.5 statvfs.5 serv.access.5 \ syslog.conf.5 termcap.5 ttytab.5 TZ.5 tzfile.5 utmp.5 \ whatis.5 diff --git a/man/man5/statvfs.5 b/man/man5/statvfs.5 new file mode 100644 index 000000000..ff112a4be --- /dev/null +++ b/man/man5/statvfs.5 @@ -0,0 +1,87 @@ +.\" $NetBSD: statvfs.5,v 1.10 2008/06/23 04:22:36 dholland Exp $ +.\" +.\" Copyright (c) 1989, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)statfs.2 8.5 (Berkeley) 5/24/95 +.\" +.Dd June 23, 2008 +.Dt STATVFS 5 +.Os +.Sh NAME +.Nm statvfs +.Nd file system statistics +.Sh SYNOPSIS +.In sys/types.h +.In sys/statvfs.h +.Sh DESCRIPTION +The +.Aq Pa sys/statvfs.h +header defines the structures and functions that +return information about a mounted file system. +The +.Nm statvfs +structure is defined as follows: +.Bd -literal + +struct statvfs { + unsigned long f_bsize; /* system block size */ + unsigned long f_frsize; /* system fragment size */ + + fsblkcnt_t f_blocks; /* number of blocks in file system */ + fsblkcnt_t f_bfree; /* free blocks avail in file system */ + fsblkcnt_t f_bavail; /* free blocks avail to non-root */ + + fsfilcnt_t f_files; /* total file nodes in file system */ + fsfilcnt_t f_ffree; /* free file nodes in file system */ + fsfilcnt_t f_favail; /* free file nodes avail to non-root */ + + unsigned long f_fsid; /* File system ID */ + + unsigned long f_flag; /* flags */ + + unsigned long f_namemax;/* maximum filename length */ +}; +.Ed +.Pp +The +.Fa f_flag +argument can have the following bits set: +.Bl -tag -width ST_SYNCHRONOUS +.It Dv ST_RDONLY +The filesystem is mounted read-only; +Even the super-user may not write on it. +.It Dv ST_NOSUID +Setuid and setgid bits on files are not honored when they are executed. +.El +.Sh SEE ALSO +.Xr statvfs 2 +.Sh HISTORY +The +.Aq Pa sys/statvfs.h +header first appeared in +.Nx 3.0 .