usr/src/man/man1m/quot.1m

   1 '\" te
   2 .\" Copyright (c) 2001, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" Copyright 1989 AT&T
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH QUOT 1M "May 30, 2001"
   8 .SH NAME
   9 quot \- summarize file system ownership
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBquot\fR [\fB-acfhnv\fR] \fIfilesystem\fR...
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBquot\fR \fB-a\fR [\fB-cfhnv\fR]
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .sp
  23 .LP
  24 \fBquot\fR displays the number of blocks (1024 bytes) in the named
  25 \fIfilesystem\fR (one or more) currently owned by each user. There is a limit
  26 of 2048 blocks. Files larger than this will be counted as a 2048 block file,
  27 but the total block count will be correct.
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 The following options are supported:
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB-a\fR\fR
  36 .ad
  37 .RS 6n
  38 Generate a report for all mounted file systems.
  39 .RE
  40
  41 .sp
  42 .ne 2
  43 .na
  44 \fB\fB-c\fR\fR
  45 .ad
  46 .RS 6n
  47 Display three columns giving a file size in blocks, the number of files of that
  48 size, and a cumulative total of blocks containing files of that size or a
  49 smaller size.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-f\fR\fR
  56 .ad
  57 .RS 6n
  58 Display three columns giving, for each user, the number of blocks owned, the
  59 count of number of files, and the user name. This option is incompatible with
  60 the \fB-c\fR and \fB-v\fR options.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fB-h\fR\fR
  67 .ad
  68 .RS 6n
  69 Estimate the number of blocks in the file. This does not account for files with
  70 holes in them.
  71 .RE
  72
  73 .sp
  74 .ne 2
  75 .na
  76 \fB\fB-n\fR\fR
  77 .ad
  78 .RS 6n
  79 Attach names to the list of files read from standard input. \fBquot\fR \fB-n\fR
  80 cannot be used alone, because it expects data from standard input. For example,
  81 the pipeline
  82 .sp
  83 \fBncheck myfilesystem | sort +0n | quot \fR\fB-n\fR\fB myfilesystem\fR
  84 .sp
  85 will produce a list of all files and their owners. This option is incompatible
  86 with all other options.
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-v\fR\fR
  93 .ad
  94 .RS 6n
  95 In addition to the default output, display three columns containing the number
  96 of blocks not accessed in the last 30, 60, and 90 days.
  97 .RE
  98
  99 .SH OPERANDS
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fIfilesystem\fR\fR
 104 .ad
 105 .RS 14n
 106 mount-point of the filesystem(s) being checked
 107 .RE
 108
 109 .SH USAGE
 110 .sp
 111 .LP
 112 See \fBlargefile\fR(5) for the description of the behavior of \fBquot\fR when
 113 encountering files greater than or equal to 2 Gbyte ( 2^31 bytes).
 114 .SH EXIT STATUS
 115 .sp
 116 .ne 2
 117 .na
 118 \fB\fB0\fR\fR
 119 .ad
 120 .RS 6n
 121 Successful operation.
 122 .RE
 123
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fB32\fR\fR
 128 .ad
 129 .RS 6n
 130 Error condition (bad or missing argument, bad path, or other error).
 131 .RE
 132
 133 .SH FILES
 134 .sp
 135 .ne 2
 136 .na
 137 \fB\fB/etc/mnttab\fR\fR
 138 .ad
 139 .RS 15n
 140 Lists mounted file systems.
 141 .RE
 142
 143 .sp
 144 .ne 2
 145 .na
 146 \fB\fB/etc/passwd\fR\fR
 147 .ad
 148 .RS 15n
 149 Used to obtain user names
 150 .RE
 151
 152 .SH SEE ALSO
 153 .sp
 154 .LP
 155 \fBdu\fR(1), \fBmnttab\fR(4), \fBpasswd\fR(4), \fBattributes\fR(5),
 156 \fBlargefile\fR(5)
 157 .SH NOTES
 158 .sp
 159 .LP
 160 This command can only be used by the super-user.