manual/GNU_coreutils/original/man1/truncate.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH TRUNCATE "1" "April 2010" "GNU coreutils 8.5" "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=\fIFILE\fR
  28 use this FILE's size
  29 .TP
  30 \fB\-s\fR, \fB\-\-size\fR=\fISIZE\fR
  31 use this 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 may be (or may be an integer optionally followed by) one of following:
  40 KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
  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 .PP
  46 Note that the \fB\-r\fR and \fB\-s\fR options are mutually exclusive.
  47 .SH AUTHOR
  48 Written by Padraig Brady.
  49 .SH "REPORTING BUGS"
  50 Report truncate bugs to bug\-coreutils@gnu.org
  51 .br
  52 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
  53 .br
  54 General help using GNU software: <http://www.gnu.org/gethelp/>
  55 .br
  56 Report truncate translation bugs to <http://translationproject.org/team/>
  57 .SH COPYRIGHT
  58 Copyright \(co 2010 Free Software Foundation, Inc.
  59 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  60 .br
  61 This is free software: you are free to change and redistribute it.
  62 There is NO WARRANTY, to the extent permitted by law.
  63 .SH "SEE ALSO"
  64 dd(1), truncate(2), ftruncate(2)
  65 .PP
  66 The full documentation for
  67 .B truncate
  68 is maintained as a Texinfo manual.  If the
  69 .B info
  70 and
  71 .B truncate
  72 programs are properly installed at your site, the command
  73 .IP
  74 .B info coreutils \(aqtruncate invocation\(aq
  75 .PP
  76 should give you access to the complete manual.