6198 Let's EOL cachefs
[illumos-gate.git] / usr / src / man / man5 / largefile.5
blob3da728fe79c9161f8680ac2a59f7150ee8aa6cba
1 '\" te
2 .\"  Copyright (c) 2007 Sun Microsystems, Inc. All Rights Reserved
3 .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
4 .\" Copyright 2015 Nexenta Systems, Inc. All rights reserved.
5 .\" 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. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
6 .\" or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add
7 .\" 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]
8 .TH LARGEFILE 5 "Sep 8, 2015"
9 .SH NAME
10 largefile \- large file status of utilities
11 .SH DESCRIPTION
12 .LP
13 A \fIlarge file\fR is a regular file whose size is greater than or equal to 2
14 Gbyte ( 2^31 bytes). A \fIsmall file\fR is a regular file whose size is less
15 than 2 Gbyte.
16 .SS "Large file aware utilities"
17 .LP
18 A utility is called \fIlarge file aware\fR if it can process large files in the
19 same manner as it does small files. A utility that is large file aware is able
20 to handle large files as input and generate as output large files that are
21 being processed. The exception is where additional files  are used as system
22 configuration files or support files that can augment the processing. For
23 example, the \fBfile\fR utility supports the \fB-m\fR option for an alternative
24 "magic" file and the \fB-f\fR option for a support file that can contain a list
25 of file names. It is unspecified whether a utility that is large file aware
26 will accept configuration or support files that are large files. If a large
27 file aware utility does not accept configuration or support files that are
28 large files, it will cause no data loss or corruption upon encountering such
29 files and will return an appropriate error.
30 .LP
31 The following \fB/usr/bin\fR utilities are large file aware:
32 .sp
34 .sp
35 .TS
36 l l l l l
37 l l l l l .
38 \fBadb\fR       \fBaliasadm\fR  \fBawk\fR       \fBbdiff\fR     \fBcat\fR
39 \fBchgrp\fR     \fBchmod\fR     \fBchown\fR     \fBcksum\fR     \fBcmp\fR
40 \fBcompress\fR  \fBcp\fR        \fBcsh\fR       \fBcsplit\fR    \fBcut\fR
41 \fBdd\fR        \fBdircmp\fR    \fBdu\fR        \fBegrep\fR     \fBfgrep\fR
42 \fBfile\fR      \fBfind\fR      \fBftp\fR       \fBgetconf\fR   \fBgrep\fR
43 \fBgzip\fR      \fBhead\fR      \fBjoin\fR      \fBjsh\fR       \fBksh\fR
44 \fBksh93\fR     \fBln\fR        \fBls\fR        \fBmailcompat\fR        \fBmailstats\fR
45 \fBmdb\fR       \fBmkdir\fR     \fBmkfifo\fR    \fBmore\fR      \fBmv\fR
46 \fBnawk\fR      \fBpage\fR      \fBpaste\fR     \fBpathchck\fR  \fBpg\fR
47 \fBpraliases\fR \fBrcp\fR       \fBremsh\fR     \fBrksh\fR      \fBrksh93\fR
48 \fBrm\fR        \fBrmdir\fR     \fBrsh\fR       \fBsed\fR       \fBsh\fR
49 \fBsort\fR      \fBsplit\fR     \fBsum\fR       \fBtail\fR      \fBtar\fR
50 \fBtee\fR       \fBtest\fR      \fBtouch\fR     \fBtr\fR        \fBuncompress\fR
51 \fBuudcode\fR   \fBuuencode\fR  \fBvacation\fR  \fBwc\fR        \fBzcat\fR
52 .TE
54 .LP
55 The following \fB/usr/xpg4/bin\fR utilities are large file aware:
56 .sp
58 .sp
59 .TS
60 l l l l l
61 l l l l l .
62 \fBawk\fR       \fBcp\fR        \fBchgrp\fR     \fBchown\fR     \fBdu\fR
63 \fBegrep\fR     \fBfgrep\fR     \fBfile\fR      \fBgrep\fR      \fBln\fR
64 \fBls\fR        \fBmore\fR      \fBmv\fR        \fBrm\fR        \fBsed\fR
65 \fBsh\fR        sort    tail    tr      
66 .TE
68 .LP
69 The following \fB/usr/xpg6/bin\fR utilities are large file aware:
70 .sp
72 .sp
73 .TS
74 l l l l l .
75 \fBgetconf\fR   \fBls\fR        \fBtr\fR                
76 .TE
78 .LP
79 The following \fB/usr/sbin\fR utilities are large file aware:
80 .sp
82 .sp
83 .TS
84 l l l l l
85 l l l l l .
86 \fBeditmap\fR   \fBinstall\fR   \fBmakemap\fR   \fBmkfile\fR    \fBmknod\fR
87 \fBmvdir\fR     \fBswap\fR                      
88 .TE
90 .LP
91 The following \fB/usr/lib\fR utilities are large file aware:
92 .sp
94 .sp
95 .TS
96 l l l l l .
97 \fBmail.local\fR        \fBsendmail\fR  \fBsmrsh\fR             
98 .TE
101 See the USAGE section of the \fBswap\fR(1M) manual page for limitations of
102 \fBswap\fR on block devices greater than 2 Gbyte on a 32-bit operating system.
105 The following \fB/usr/ucb\fR utilities are large file aware:
110 l l l l l
111 l l l l l .
112 \fBchown\fR     \fBfrom\fR      \fBln\fR        \fBls\fR        \fBsed\fR
113 \fBsum\fR       \fBtouch\fR                     
117 The \fB/usr/bin/cpio\fR and \fB/usr/bin/pax\fR utilities are large file aware,
118 but cannot archive a file whose size exceeds 8 Gbyte - 1 byte.
120 The \fB/usr/bin/truss\fR utilities has been modified to read a dump file and
121 display information relevant to large files, such as offsets.
122 .SS "nfs file systems"
124 The following utilities are large file aware for \fBnfs\fR file systems:
129 l l
130 l l .
131 \fB/usr/lib/autofs/automountd\fR        \fB/usr/sbin/mount\fR
132 \fB/usr/lib/nfs/rquotad\fR      
135 .SS "ufs file systems"
137 The following \fB/usr/bin\fR utility is large file aware for \fBufs\fR file
138 systems:
140 \fBdf\fR
142 The following \fB/usr/lib/nfs\fR utility is large file aware for \fBufs\fR file
143 systems:
145 \fBrquotad\fR
147 The following \fB/usr/xpg4/bin\fR utility is large file aware for \fBufs\fR
148 file systems:
150 \fBdf\fR
152 The following \fB/usr/sbin\fR utilities are large file aware for \fBufs\fR file
153 systems:
158 l l l l l
159 l l l l l .
160 \fBclri\fR      \fBdcopy\fR     \fBedquota\fR   \fBff\fR        \fBfsck\fR
161 \fBfsdb\fR      \fBfsirand\fR   \fBfstyp\fR     \fBlabelit\fR   \fBlockfs\fR
162 \fBmkfs\fR      \fBmount\fR     \fBncheck\fR    \fBnewfs\fR     \fBquot\fR
163 \fBquota\fR     \fBquotacheck\fR        \fBquotaoff\fR  \fBquotaon\fR   \fBrepquota\fR
164 \fBtunefs\fR    \fBufsdump\fR   \fBufsrestore\fR        \fBumount\fR    
167 .SS "Large file safe utilities"
169 A utility is called \fBlarge file safe\fR if it causes no data loss or
170 corruption when it encounters a large file. A utility that is large file safe
171 is unable to process properly a large file, but returns an appropriate error.
173 The following \fB/usr/bin\fR utilities are large file safe:
178 l l l l l
179 l l l l l .
180 \fBaudioconvert\fR      \fBaudioplay\fR \fBaudiorecord\fR       \fBcomm\fR      \fBdiff\fR
181 \fBdiff3\fR     \fBdiffmk\fR    \fBed\fR        \fBlp\fR        \fBmail\fR
182 \fBmailcompat\fR        \fBmailstats\fR \fBmailx\fR     \fBpack\fR      \fBpcat\fR
183 \fBred\fR       \fBrmail\fR     \fBsdiff\fR     \fBunpack\fR    \fBvi\fR
184 \fBview\fR                              
188 The following \fB/usr/xpg4/bin\fR utilities are large file safe:
193 l l l l l .
194 \fBed\fR        \fBvi\fR        \fBview\fR              
198 The following \fB/usr/xpg6/bin\fR utility is large file safe:
203 l l l l l .
204 \fBed\fR                                
208 The following \fB/usr/sbin\fR utilities are large file safe:
213 l l l l l .
214 lpfilter                lpforms                 
218 The following \fB/usr/ucb\fR utilities are large file safe:
223 l l l l l .
224 \fBMail\fR      \fBlpr\fR                       
227 .SH SEE ALSO
229 \fBlf64\fR(5), \fBlfcompile\fR(5), \fBlfcompile64\fR(5)