1 .\" Copyright (c) 2011,2012 François Tigeot
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 .\" Note: The date here should be updated whenever a non-trivial
27 .\" change is made to the manual page.
33 .Nd VFS quota system utility
43 This manual page documents the
45 utility which provides functions for managing virtual file system
46 accounting and quotas.
52 tunable needs to be set in
55 The following options are available:
58 Debug flag, show raw messages sent to and received from kernel
60 "Human-readable" output. Use unit suffixes: Byte, Kilobyte, Megabyte,
61 Gigabyte, Terabyte and Petabyte in order to reduce the number of
62 digits to four or fewer.
64 Show raw user and group ids. Normally
66 attempts to resolve and display full user and group names.
69 The commands are as follows:
70 .Bl -tag -width indent
72 .It Cm check Ar directory
73 Reports the space (in bytes) occupied by files names located in the
74 directory hierarchy present under
79 List mounted file systems having space accounting enabled
82 .It Cm show Ar mount_point
83 Show file size usage and quota limits for the file system mounted under
85 The information is broken down by uid and gid
88 .It Cm sync Ar mount_point
89 Initialize in one go the usage counters for the filesystem
92 with real usage data. This command scans an entire filesystem
93 directory hierarchy and may be slow to run
95 .It Cm limit Ar mount_point size
98 bytes for the filesystem mounted under
101 .It Cm ulim Ar mount_point user size
104 bytes for the filesystem mounted under
109 .It Cm glim Ar mount_point group size
112 bytes for the filesystem mounted under
118 A limit of 0 effectively means checks are disabled.
121 The following is an example of a typical usage
126 .Dl "vquota show /mnt/data"
134 utility first appeared in
137 .An Francois Tigeot Aq ftigeot@wolfpond.org