Imported upstream version 1.5
[manpages-zh.git] / src / man1 / du.1
blobd81f89b7bc36b527b4d23190328d2689fdb2b2d2
1 .\" Copyright Andries Brouwer, Ragnar Hojland Espinosa and A. Wik, 1998.
2 .\"  Chinese Version Copyright mhss, www.linuxforum.net, 2000
3 .\" This file may be copied under the conditions described
4 .\" in the LDP GENERAL PUBLIC LICENSE, Version 1, September 1998
5 .\" that should have been distributed together with this file.
6 .\"
7 .TH DU 1 "November 1998" "GNU fileutils 4.0"
8 .SH NAME
9 du \- 报告磁盘空间使用情况
10 .SH 总览
11 .BI "du [" options "] [" file... ] 
12 .sp
13 POSIX 选项: 
14 .B [\-askx]
15 .SH GNU 选项 (最短格式):
16 .B "[-abcDhHklLmsSxX]"
17 .BI "[--block-size=size] [--exclude=pattern] [--max-depth=n]"
18 .B "[--help] [--version] [--]"
19 .SH 描述
20 du 报告指定的文件已使用的磁盘空间的总量,包括在层次结构中以
21 这些以指定文件为根的目录在内。这里的“已使用的磁盘空间”意思
22 为指定的文件下的整个文件层次结构所使用的空间。
23 .PP
24 在没给定参数的情况下,du 报告当前目录所使用的磁盘空间。
25 .SH POSIX 细节
26 输出结果在缺省时以512字节为计数单位,若给以 -k 选项,则以
27 1024字节为计数单位。
28 .SH GNU 细节
29 (在没有用选项指定计数单位的情况下)输出结果以1024字节为计数
30 单位,但不包括由于设置了环境变量POSIXLY_CORRECT而跟从POSIX 
31 标准的情况。
32 .SH POSIX 选项
33 .TP
34 .B "\-a"
35 显示对涉及到的所有文件的统计,而不只是包含子目录。
36 .TP
37 .B "\-k"
38 用1024字节作为计数单位,替代缺省时512字节的计数单位。
39 .TP
40 .B "\-x"
41 只输出指定参数的实际使用空间,而不包括其下的子目录。
42 .TP
43 .B "\-s"
44 只统计指定参数的在同一设备上所使用的空间。
46 .SH GNU 选项
47 .TP
48 .B "\-a, \-\-all"
49 显示对所有文件的统计,而不只是包含子目录。
50 .TP
51 .B "\-b, \-\-bytes"
52 输出以字节为单位的大小,替代缺省时1024字节的计数单位。
53 .TP
54 .BI "\-\-block\-size=" size
55 输出以块为单位的大小,块的大小为 size 字节。( file-
56 utils-4.0 的新选项)
57 .TP
58 .B "\-c, \-\-total"
59 在处理完所有参数后给出所有这些参数的总计。这个选项被
60 用给出指定的一组文件或目录使用的空间的总和。
61 .TP
62 .B "\-D, \-\-dereference\-args"
63 引用命令行参数的符号连接。但不影响其他的符号连接。
64 这对找出象 /usr/tmp 这样的目录的磁盘使用量有用,
65 /usr/tmp 等通常是符号连接。 
66 译住:例如在 /var/tmp 下建立一个目录test, 而/usr/tmp 
67 是指向 /var/tmp 的符号连接。du /usr/tmp 返回一项
68 /usr/tmp , 而 du - D /usr/tmp 返回两项 /usr/tmp,/usr/tmp/test。 
69 .TP
70 .BI "\-\-exclude=" pattern
71 在递归时,忽略与指定模式相匹配的文件或子目录。模式
72 可以是任何 Bourne shell 的文件 glob 模式。( file-
73 utils-4.0 的新选项) 
74 .TP
75 .B "\-h, \-\-human\-readable"
76 为每个数附加一个表示大小单位的字母,象用M表示二进制
77 的兆字节。
78 .TP
79 .B "\-H, \-\-si"
80 与 -h 参数起同样的作用,只是使用法定的 SI 单位( 用
81 1000的幂而不是 1024 的幂,这样 M 代表的就是1000000
82 而不是 1048576)。(fileutils-4.0 的新选项)
83 .TP
84 .B "\-k, \-\-kilobytes"
85 输出以1024字节为计数单位的大小。
86 .TP
87 .B "\-l, \-\-count\-links"
88 统计所有文件的大小,包括已经被统计过的(作为一个硬连接)。 
89 .TP
90 .B "\-L, \-\-dereference"
91 引用符号连接(不是显示连接点本身而是连接指向的文件或
92 目录所使用的磁盘空间)。
93 .TP
94 .B "\-m, \-\-megabytes"
95 输出以兆字节的块为计数单位的大小(就是 1,048,576 字节)。
96 .TP
97 .BI "\-\-max\-depth=" n
98 只输出命令行参数的小于等于第 n 层的目录的总计。
99 --max-depth=0的作用同于-s选项。(fileutils-4.0的新选项)
101 .B "\-s, \-\-summarize"
102 对每个参数只显示总和。
104 .B "\-S, \-\-separate\-dirs"
105 单独报告每一个目录的大小,不包括子目录的大小。
107 .B "\-x, \-\-one\-file\-system"
108 忽略与被处理的参数不在同一个文件系统的目录。
110 .BI "\-X " "file, " "\-\-exclude\-from=" "file"
111 除了从指定的文件中得到模式之外与 --exclude 一样。
112 模式以行的形式列出。如果指定的文件是'-',那么从标准输
113 入中读出模式。(fileutils-4.0 的新选项)
114 GNU 标准选项
116 .B "\-\-help"
117 在标准输出上输出帮助信息后正常退出。
119 .B "\-\-version"
120 在标准输出上输出版本信息后正常退出。
122 .B "\-\-"
123 终结选项列表
124 .SH 缺陷
125 对于从 HP-UX 系统上以 NFS 方式挂装上的文件,在 BSD 系统上的
126 du 报告的大小是正确数值的一半;而对于从 BSD 系统上以 NFS 方
127 式挂装上的文件,HP-UX 系统上的 du 报告的大小是正确数值的翻
128 倍。这是 HP-UX 的缺陷导致的,这个缺陷也影响HP-UX的 du 程序。
129 .SH 变量
130 变量 POSIXLY_CORRECT 确定计数单位的选择。如果没有设置此变
131 量并且环境变量 BLOCKSIZE 的值以‘HUMAN’为前缀,那么,除了
132 -k 或 -m 选项优先生效的情况,计数单位的行为同于 -h 选项。
133 变量 LANG、LC_ALL、LC_CTYPE 和 LC_MESSAGES 的意义和字面上
134 一样。 
135 .SH 遵循的标准
136 POSIX 1003.2
137 .SH 注意事项
138 本页面描述的 du 可在 fileutils-4.0 包中找到,其他版本可能有细
139 微的不同。把更正和补充以邮件的形式发送到 aeb@cwi.nl。向 file
140 utils-bugs@gnu.ai.mit.edu.报告程序存在的缺陷。
142 .SH "[中文版维护人]"
143 .B mhss <jijingzhisheng@up369.com>
144 .SH "[中文版最新更新]"
145 .BR 2000/10/19
146 .SH "《中国linux论坛man手册页翻译计划》:"
147 .BI http://cmpp.linuxforum.net