usr.bin/quota/quota.1

   1 .\"     $NetBSD: quota.1,v 1.13 2003/02/25 10:35:51 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1983, 1990, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to Berkeley by
   7 .\" Robert Elz at The University of Melbourne.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\" 3. Neither the name of the University nor the names of its contributors
  18 .\"    may be used to endorse or promote products derived from this software
  19 .\"    without specific prior written permission.
  20 .\"
  21 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  22 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  25 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  26 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  27 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  29 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  30 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  31 .\" SUCH DAMAGE.
  32 .\"
  33 .\"     from: @(#)quota.1       8.1 (Berkeley) 6/6/93
  34 .\"
  35 .Dd June 6, 1993
  36 .Dt QUOTA 1
  37 .Os
  38 .Sh NAME
  39 .Nm quota
  40 .Nd display disk usage and limits
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl g
  44 .Op Fl u
  45 .Op Fl v | Fl q
  46 .Nm
  47 .Op Fl u
  48 .Op Fl v | Fl q
  49 .Ar user
  50 .Nm
  51 .Op Fl g
  52 .Op Fl v | Fl q
  53 .Ar group
  54 .Sh DESCRIPTION
  55 .Nm
  56 displays users' disk usage and limits.
  57 By default only the user quotas are printed.
  58 .Pp
  59 Options:
  60 .Pp
  61 .Bl -tag -width Ds
  62 .It Fl g
  63 Print group quotas for the group
  64 of which the user is a member.
  65 The optional
  66 .Fl u
  67 flag is equivalent to the default.
  68 .It Fl v
  69 .Nm
  70 will display quotas on filesystems
  71 where no storage is allocated.
  72 .It Fl q
  73 Print a more terse message,
  74 containing only information
  75 on filesystems where usage is over quota.
  76 .El
  77 .Pp
  78 Specifying both
  79 .Fl g
  80 and
  81 .Fl u
  82 displays both the user quotas and the group quotas (for
  83 the user).
  84 .Pp
  85 Only the super-user may use the
  86 .Fl u
  87 flag and the optional
  88 .Ar user
  89 argument to view the limits of other users.
  90 Non-super-users can use the
  91 .Fl g
  92 flag and optional
  93 .Ar group
  94 argument to view only the limits of groups of which they are members.
  95 .Pp
  96 The
  97 .Fl q
  98 flag takes precedence over the
  99 .Fl v
 100 flag.
 101 .Pp
 102 .Nm
 103 tries to report the quotas of all mounted filesystems.
 104 If the filesystem is mounted via
 105 .Em NFS
 106 it will attempt to contact the
 107 .Xr rpc.rquotad 8
 108 daemon on the
 109 .Em NFS
 110 server.
 111 For
 112 .Em FFS
 113 filesystems, quotas must be turned on in
 114 .Pa /etc/fstab .
 115 If
 116 .Nm
 117 exits with a non-zero status, one or more filesystems
 118 are over quota.
 119 .Sh FILES
 120 .Bl -tag -width quota.group -compact
 121 .It Pa quota.user
 122 located at the filesystem root with user quotas
 123 .It Pa quota.group
 124 located at the filesystem root with group quotas
 125 .It Pa /etc/fstab
 126 to find filesystem names and locations
 127 .El
 128 .Sh SEE ALSO
 129 .Xr quotactl 2 ,
 130 .Xr fstab 5 ,
 131 .Xr edquota 8 ,
 132 .Xr quotacheck 8 ,
 133 .Xr quotaon 8 ,
 134 .Xr repquota 8 ,
 135 .Xr rpc.rquotad 8
 136 .Sh HISTORY
 137 The
 138 .Nm
 139 command appeared in
 140 .Bx 4.2 .