64 lines
2.2 KiB
Groff
64 lines
2.2 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH TRUNCATE "1" "April 2025" "GNU coreutils 9.7" "User Commands"
|
|
.SH NAME
|
|
truncate \- shrink or extend the size of a file to the specified size
|
|
.SH SYNOPSIS
|
|
.B truncate
|
|
\fI\,OPTION\/\fR... \fI\,FILE\/\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 sparse 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=\fI\,RFILE\/\fR
|
|
base size on RFILE
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-size\fR=\fI\,SIZE\/\fR
|
|
set or adjust the file size by SIZE bytes
|
|
.TP
|
|
\fB\-\-help\fR
|
|
display this help and exit
|
|
.TP
|
|
\fB\-\-version\fR
|
|
output version information and exit
|
|
.PP
|
|
The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
|
|
Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000).
|
|
Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
|
|
.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"
|
|
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
|
|
.br
|
|
Report any translation bugs to <https://translationproject.org/team/>
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2025 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
\fBdd\fP(1), \fBtruncate\fP(2), \fBftruncate\fP(2)
|
|
.PP
|
|
.br
|
|
Full documentation <https://www.gnu.org/software/coreutils/truncate>
|
|
.br
|
|
or available locally via: info \(aq(coreutils) truncate invocation\(aq
|