summaryrefslogtreecommitdiffstats
path: root/usr.sbin/quot/quot.8
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/quot/quot.8')
-rw-r--r--usr.sbin/quot/quot.8120
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 ,
OpenPOWER on IntegriCloud