~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/truncate.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
2
 
.TH TRUNCATE "1" "October 2012" "GNU coreutils 8.20" "User Commands"
3
 
.SH NAME
4
 
truncate \- shrink or extend the size of a file to the specified size
5
 
.SH SYNOPSIS
6
 
.B truncate
7
 
\fIOPTION\fR... \fIFILE\fR...
8
 
.SH DESCRIPTION
9
 
.\" Add any additional description here
10
 
.PP
11
 
Shrink or extend the size of each FILE to the specified size
12
 
.PP
13
 
A FILE argument that does not exist is created.
14
 
.PP
15
 
If a FILE is larger than the specified size, the extra data is lost.
16
 
If a FILE is shorter, it is extended and the extended part (hole)
17
 
reads as zero bytes.
18
 
.PP
19
 
Mandatory arguments to long options are mandatory for short options too.
20
 
.TP
21
 
\fB\-c\fR, \fB\-\-no\-create\fR
22
 
do not create any files
23
 
.TP
24
 
\fB\-o\fR, \fB\-\-io\-blocks\fR
25
 
treat SIZE as number of IO blocks instead of bytes
26
 
.TP
27
 
\fB\-r\fR, \fB\-\-reference\fR=\fIRFILE\fR
28
 
base size on RFILE
29
 
.TP
30
 
\fB\-s\fR, \fB\-\-size\fR=\fISIZE\fR
31
 
set or adjust the file size by SIZE
32
 
.TP
33
 
\fB\-\-help\fR
34
 
display this help and exit
35
 
.TP
36
 
\fB\-\-version\fR
37
 
output version information and exit
38
 
.PP
39
 
SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units
40
 
are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
41
 
.PP
42
 
SIZE may also be prefixed by one of the following modifying characters:
43
 
\&'+' extend by, '\-' reduce by, '<' at most, '>' at least,
44
 
\&'/' round down to multiple of, '%' round up to multiple of.
45
 
.SH AUTHOR
46
 
Written by Padraig Brady.
47
 
.SH "REPORTING BUGS"
48
 
Report truncate bugs to bug\-coreutils@gnu.org
49
 
.br
50
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
51
 
.br
52
 
General help using GNU software: <http://www.gnu.org/gethelp/>
53
 
.br
54
 
Report truncate translation bugs to <http://translationproject.org/team/>
55
 
.SH COPYRIGHT
56
 
Copyright \(co 2012 Free Software Foundation, Inc.
57
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
58
 
.br
59
 
This is free software: you are free to change and redistribute it.
60
 
There is NO WARRANTY, to the extent permitted by law.
61
 
.SH "SEE ALSO"
62
 
dd(1), truncate(2), ftruncate(2)
63
 
.PP
64
 
The full documentation for
65
 
.B truncate
66
 
is maintained as a Texinfo manual.  If the
67
 
.B info
68
 
and
69
 
.B truncate
70
 
programs are properly installed at your site, the command
71
 
.IP
72
 
.B info coreutils \(aqtruncate invocation\(aq
73
 
.PP
74
 
should give you access to the complete manual.