Index: usr.bin/truncate/truncate.1 =================================================================== --- usr.bin/truncate/truncate.1 (revision 0) +++ usr.bin/truncate/truncate.1 (revision 1255) @@ -0,0 +1,153 @@ +.\" +.\" Copyright (c) 2000 Sheldon Hearn . +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD: src/usr.bin/truncate/truncate.1,v 1.15 2006/12/19 11:20:34 ru Exp $ +.\" +.Dd December 19, 2006 +.Dt TRUNCATE 1 +.Os +.Sh NAME +.Nm truncate +.Nd truncate or extend the length of files +.Sh SYNOPSIS +.Nm +.Op Fl c +.Bk -words +.Fl s Xo +.Sm off +.Op Cm + | - +.Ar size +.Op Cm K | k | M | m | G | g | T | t +.Sm on +.Xc +.Ek +.Ar +.Nm +.Op Fl c +.Bk -words +.Fl r Ar rfile +.Ek +.Ar +.Sh DESCRIPTION +The +.Nm +utility adjusts the length of each regular file given on the command-line. +.Pp +The following options are available: +.Bl -tag -width indent +.It Fl c +Do not create files if they do not exist. +The +.Nm +utility does not treat this as an error. +No error messages are displayed +and the exit value is not affected. +.It Fl r Ar rfile +Truncate or extend files to the length of the file +.Ar rfile . +.It Fl s Xo +.Sm off +.Op Cm + | - +.Ar size +.Op Cm K | k | M | m | G | g | T | t +.Sm on +.Xc +If the +.Ar size +argument is preceded by a plus sign +.Pq Cm + , +files will be extended by this number of bytes. +If the +.Ar size +argument is preceded by a dash +.Pq Cm - , +file lengths will be reduced by no more than this number of bytes, +to a minimum length of zero bytes. +Otherwise, the +.Ar size +argument specifies an absolute length to which all files +should be extended or reduced as appropriate. +.Pp +The +.Ar size +argument may be suffixed with one of +.Cm K , +.Cm M , +.Cm G +or +.Cm T +(either upper or lower case) to indicate a multiple of +Kilobytes, Megabytes, Gigabytes or Terabytes +respectively. +.El +.Pp +Exactly one of the +.Fl r +and +.Fl s +options must be specified. +.Pp +If a file is made smaller, its extra data is lost. +If a file is made larger, +it will be extended as if by writing bytes with the value zero. +If the file does not exist, +it is created unless the +.Fl c +option is specified. +.Pp +Note that, +while truncating a file causes space on disk to be freed, +extending a file does not cause space to be allocated. +To extend a file and actually allocate the space, +it is necessary to explicitly write data to it, +using (for example) the shell's +.Ql >> +redirection syntax, or +.Xr dd 1 . +.Sh EXIT STATUS +.Ex -std +If the operation fails for an argument, +.Nm +will issue a diagnostic +and continue processing the remaining arguments. +.Sh SEE ALSO +.Xr dd 1 , +.Xr touch 1 , +.Xr truncate 2 +.Sh STANDARDS +The +.Nm +utility conforms to no known standards. +.Sh HISTORY +The +.Nm +utility first appeared in +.Fx 4.2 . +.Sh AUTHORS +The +.Nm +utility was written by +.An Sheldon Hearn +.Aq sheldonh@starjuice.net . Index: usr.bin/truncate/truncate.c =================================================================== --- usr.bin/truncate/truncate.c (revision 0) +++ usr.bin/truncate/truncate.c (revision 1255) @@ -0,0 +1,216 @@ +/* + * Copyright (c) 2000 Sheldon Hearn . + * All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * + * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + * + */ + +#ifndef lint +static const char rcsid[] = + "$FreeBSD: src/usr.bin/truncate/truncate.c,v 1.12 2006/09/18 16:39:23 maxim Exp $"; +#endif + +#include + +#include +#include +#include +#include +#include +#include +#include + +static int parselength(char *, off_t *); +static void usage(void); + +static int no_create; +static int do_relative; +static int do_refer; +static int got_size; + +int +main(int argc, char **argv) +{ + struct stat sb; + mode_t omode; + off_t oflow, rsize, sz, tsize; + int ch, error, fd, oflags; + char *fname, *rname; + + rsize = tsize = 0; + error = 0; + rname = NULL; + while ((ch = getopt(argc, argv, "cr:s:")) != -1) + switch (ch) { + case 'c': + no_create = 1; + break; + case 'r': + do_refer = 1; + rname = optarg; + break; + case 's': + if (parselength(optarg, &sz) == -1) + errx(EXIT_FAILURE, + "invalid size argument `%s'", optarg); + if (*optarg == '+' || *optarg == '-') + do_relative = 1; + got_size = 1; + break; + default: + usage(); + /* NOTREACHED */ + } + + argv += optind; + argc -= optind; + + /* + * Exactly one of do_refer or got_size must be specified. Since + * do_relative implies got_size, do_relative and do_refer are + * also mutually exclusive. See usage() for allowed invocations. + */ + if (do_refer + got_size != 1 || argc < 1) + usage(); + if (do_refer) { + if (stat(rname, &sb) == -1) + err(EXIT_FAILURE, "%s", rname); + tsize = sb.st_size; + } else if (do_relative) + rsize = sz; + else + tsize = sz; + + if (no_create) + oflags = O_WRONLY; + else + oflags = O_WRONLY | O_CREAT; + omode = S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH; + + while ((fname = *argv++) != NULL) { + if (fd != -1) + close(fd); + if ((fd = open(fname, oflags, omode)) == -1) { + if (errno != ENOENT) { + warn("%s", fname); + error++; + } + continue; + } + if (do_relative) { + if (fstat(fd, &sb) == -1) { + warn("%s", fname); + error++; + continue; + } + oflow = sb.st_size + rsize; + if (oflow < (sb.st_size + rsize)) { + errno = EFBIG; + warn("%s", fname); + error++; + continue; + } + tsize = oflow; + } + if (tsize < 0) + tsize = 0; + + if (ftruncate(fd, tsize) == -1) { + warn("%s", fname); + error++; + continue; + } + } + if (fd != -1) + close(fd); + + return error ? EXIT_FAILURE : EXIT_SUCCESS; +} + +/* + * Return the numeric value of a string given in the form [+-][0-9]+[GMKT] + * or -1 on format error or overflow. + */ +static int +parselength(char *ls, off_t *sz) +{ + off_t length, oflow; + int lsign; + + length = 0; + lsign = 1; + + switch (*ls) { + case '-': + lsign = -1; + case '+': + ls++; + } + +#define ASSIGN_CHK_OFLOW(x, y) if (x < y) return -1; y = x + /* + * Calculate the value of the decimal digit string, failing + * on overflow. + */ + while (isdigit(*ls)) { + oflow = length * 10 + *ls++ - '0'; + ASSIGN_CHK_OFLOW(oflow, length); + } + + switch (*ls) { + case 'T': + case 't': + oflow = length * 1024; + ASSIGN_CHK_OFLOW(oflow, length); + case 'G': + case 'g': + oflow = length * 1024; + ASSIGN_CHK_OFLOW(oflow, length); + case 'M': + case 'm': + oflow = length * 1024; + ASSIGN_CHK_OFLOW(oflow, length); + case 'K': + case 'k': + if (ls[1] != '\0') + return -1; + oflow = length * 1024; + ASSIGN_CHK_OFLOW(oflow, length); + case '\0': + break; + default: + return -1; + } + + *sz = length * lsign; + return 0; +} + +static void +usage(void) +{ + fprintf(stderr, "%s\n%s\n", + "usage: truncate [-c] -s [+|-]size[K|k|M|m|G|g|T|t] file ...", + " truncate [-c] -r rfile file ..."); + exit(EXIT_FAILURE); +} Index: usr.bin/truncate/Makefile =================================================================== --- usr.bin/truncate/Makefile (revision 0) +++ usr.bin/truncate/Makefile (revision 1255) @@ -0,0 +1,4 @@ +PROG = truncate + +topdir=../.. +include $(topdir)/config.mk Property changes on: usr.bin/truncate ___________________________________________________________________ Name: svnmerge-integrated + /sysutils/truncate/branches/vendor/freebsd-truncate:1-1253 Property changes on: . ___________________________________________________________________ Name: svnmerge-integrated + /sysutils/bsdmainutils/branches/vendor/bsdmainutils:1-1251