diff options
Diffstat (limited to 'usr.sbin/quot/quot.8')
-rw-r--r-- | usr.sbin/quot/quot.8 | 120 |
1 files changed, 66 insertions, 54 deletions
diff --git a/usr.sbin/quot/quot.8 b/usr.sbin/quot/quot.8 index b1aefde..7b964d9 100644 --- a/usr.sbin/quot/quot.8 +++ b/usr.sbin/quot/quot.8 @@ -1,5 +1,6 @@ -.\" Copyright (c) 1980, 1991, 1993 -.\" The Regents of the University of California. All rights reserved. +.\" Copyright (C) 1994 Wolfgang Solfrank. +.\" Copyright (C) 1994 TooLs GmbH. +.\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions @@ -11,74 +12,85 @@ .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. 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 product includes software developed by TooLs GmbH. +.\" 4. The name of TooLs GmbH may not 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. +.\" THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``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 TOOLS GMBH 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. .\" -.\" @(#)quot.8 8.1 (Berkeley) 6/6/93 +.\" $Id: quot.8,v 1.3 1994/03/19 07:59:47 cgd Exp $ .\" -.Dd June 6, 1993 +.Dd February 8, 1994 .Dt QUOT 8 .Os BSD 4 .Sh NAME .Nm quot -.Nd display total block usage per user for a file system +.Nd display disk space occupied by each user .Sh SYNOPSIS .Nm quot -.Op Fl ncf -.Op Ar filesystem Ar ... +.Op Fl acfhknv +.Op Ar filesystem ... .Sh DESCRIPTION -The -.Nm quot -command -displays the total count of blocks owned by a user for the filesystem -.Ar filesystem . -If the filesystem option -.Ar filesystem -is not specified, -the file systems listed in -.Pa /etc/fstab -are used. +.Nm Quot +is used to gather statistics about the disk usage for each local user. +.Pp The following options are available: .Bl -tag -width Ds +.It Fl a +Include statistics for all mounted filesystems. .It Fl c -Display information on file size and block usage. The file sizes -are listed in the first column, the second column contains a count -of how many files of that size were found and the third column -lists the cumulative block usage for the displayed size and all smaller -files. +Display three columns containing number of blocks per file, +number of files in this category, and aggregate total of +blocks in files with this or lower size. .It Fl f -For each user, -the number of files (inodes) owned is displayed in addition -to the block usage. +For each user, display count of files and space occupied. +.It Fl h +Estimate the number of blocks in each file based on its size. +Despite that this doesn't give the correct resuls (it doesn't +account for the holes in files), this option isn't any faster +and thus is discouraged. +.It Fl k +By default, all sizes are reported in 512-byte block counts. +The +.Fl k +options causes the numbers to be reported in kilobyte counts. .It Fl n -A list sorted by block usage is displayed. -This is the result of -.Nm quot -executing the following command: +Given a list of inodes (plus some optional data on each line) +in the standard input, for each file print out the owner (plus +the remainder of the input line). This is traditionally used +in the pipe: .Bd -literal -offset indent -ncheck filesystem \&| sort +0n \&| quot \-n filesystem +ncheck filesystem | sort +0n | quot -n filesystem .Ed +.Pp +to get a report of files and their owners. +.It Fl v +In addition to the default output, display the number of files +not accessed within 30, 60 and 90 days. +.El +.Sh ENVIRONMENTAL VARIABLES +.Bl -tag -width BLOCKSIZE +.It Ev BLOCKSIZE +If the environmental variable +.Ev BLOCKSIZE +is set, and the +.Gl k +option is not specified, the block counts will be displayed in units of that +size block. .El +.\".Sh BUGS .Sh SEE ALSO -.Xr ls 1 , -.Xr du 1 -.Sh HISTORY -The -.Nm -command appeared in -.At 32v . +.Xr df 1 , +.Xr quota 1 , +.Xr getmntinfo 3 , +.Xr fstab 5 , +.Xr mount 8 , |