'\" te
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
.TH TRUNCATE "1" "March 2012" "GNU coreutils 8.16" "User Commands"
.SH NAME
truncate \- shrink or extend the size of a file to the specified size
.SH SYNOPSIS
.B truncate
\fIOPTION\fR... \fIFILE\fR...
.SH DESCRIPTION
.\" Add any additional description here
.PP
Shrink or extend the size of each FILE to the specified size
.PP
A FILE argument that does not exist is created.
.PP
If a FILE is larger than the specified size, the extra data is lost.
If a FILE is shorter, it is extended and the extended part (hole)
reads as zero bytes.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-c\fR, \fB\-\-no\-create\fR
do not create any files
.TP
\fB\-o\fR, \fB\-\-io\-blocks\fR
treat SIZE as number of IO blocks instead of bytes
.TP
\fB\-r\fR, \fB\-\-reference\fR=\fIRFILE\fR
base size on RFILE
.TP
\fB\-s\fR, \fB\-\-size\fR=\fISIZE\fR
set or adjust the file size by SIZE
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
SIZE is an integer and optional unit (example: 10M is 10*1024*1024). Units
are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
.PP
SIZE may also be prefixed by one of the following modifying characters:
\&'+' extend by, '\-' reduce by, '<' at most, '>' at least,
\&'/' round down to multiple of, '%' round up to multiple of.
.SH AUTHOR
Written by Padraig Brady.
.SH "REPORTING BUGS"
Report truncate bugs to bug\-coreutils@gnu.org
.br
GNU coreutils home page:
.br
General help using GNU software:
.br
Report truncate translation bugs to
.SH COPYRIGHT
Copyright \(co 2012 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later .
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE ATTRIBUTE VALUE
=
Availability file/gnu-coreutils
=
Stability Uncommitted
.TE
.PP
.SH "SEE ALSO"
dd(1), truncate(3C), ftruncate(3C)
.PP
The full documentation for
.B truncate
is maintained as a Texinfo manual. If the
.B info
and
.B truncate
programs are properly installed at your site, the command
.IP
.B info coreutils \(aqtruncate invocation\(aq
.PP
should give you access to the complete manual.
.SH NOTES
.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland. The original community source was downloaded from http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz
Further information about this software can be found on the open source community website at http://www.gnu.org/software/coreutils/.