NAME
tardy - a tar post-processor
SYNOPSIS
tardy [ option... ][ infile [ outfile ]]
tardy -Help
tardy -VERSion
DESCRIPTION
The tardy program is used to manipulate the file headers within tar(1)
archive files.
This is useful when preparing sources for Internet archive sites, and
you don’t want to included details of your development environment in
the tar(1) file.
One of the most useful features is the ability to add a prefix to the
names of the files within the tar(1) file. An example is adding the
prefix ".", for when you have a tar(1) file with absolute paths in it,
and need to extract the file with relative paths.
The GNU tar format headers are understood, including extended names.
If no input file is named, or the special name "-" is used, input will
be read from the standard input. Similarly, if no output file is
named, or the special name "-" is used, output will be written to the
standard output.
OPTIONS
The following options are understood:
-Block_Size number
Thsi option many be used to specify the block size, as a
multiple of 512 bytes. The default is -bs=20 resulting in a
10KB block size.
-Clean_Meta
This option may be used to ensure that file names do not
contain shell meta characters. If any are found, they are
replaced by a hyphen (-) character. Warning: duplicate file
names may result.
-Clean_Print
This option may be used to ensure that file names only contain
printable ascii characters. If any non-printable characters
are found, they are replaced by a hyphen (-) character.
Warning: duplicate file names may result.
-Clean_Space
This option may be used to ensure that file names contain no
white space characters. If any are found, they are replaced by
a hyphen (-) character. Warning: duplicate file names may
result.
-Clean
This option is a terse way of specifying all of the above 3
options.
-DownCase
This option may be used to force file names to be all lower
case. Warning: duplicate file names may result.
-Group arg
This option may be used to set both the group name and group
number fields in the header of every file in the archive file.
The argument may be either a string or a number. It is an
error if a corresponding entry cannot be found in the
/etc/group file.
-Group_NAme string
This option is used to set the group name field in the header
of every file in the archive file. The string may be any
arbitrary string, it is not restricted to a known group.
-Group_NAme number
This option is used to set the group name field in the header
of every file in the archive file. The number is mapped to a
group name through the /etc/group file. It is an error if a
corresponding group cannot be found.
-Group_NUmber string
This option is used to set the group number field in the header
of every file in the archive file. The string is mapped to a
group number through the /etc/group file. It is an error if a
corresponding group cannot be found.
-Group_NUmber number
This option is used to set the group number field in the header
of every file in the archive file. The number may be any
arbitrary number, it is not restricted to a known group.
-Help
This option may be used to obtain more information about how to
use the tardy program.
-Input_ForMaT name
This option may be used to specify the input format to be used.
The input names are
tar This format understands all of the various tar(1)
formats. This is the default.
list The input is a text file which contains one file name
per line. The named files are read as if they were the
input. It is common for find(1) to be used to form the
list of file names.
Any other format name will produce an error.
-List
Give a terse listing of the file headers on the standard error
as they are written to the output.
-No_Directories
This option may be used to supress directories from the output.
This can be useful when the archive has been created with
directories in useless modes.
-Mode_Clear bits
This option may be used to set the mode of each file in the
archive file. The bits specified are cleared in the mode. You
should use an octal number with a leading zero as the argument;
if you omit the leading zero it will be interpreted as decimal.
The -Mode_Set option is applied first, the -Mode_Clear option
is applied specond; if neither is specified the mode of each
file is unaltered.
-Mode_Set bits
This option may be used to set the mode of each file in the
archive file. The bits specified are set in the mode. You
should use an octal number with a leading zero as the argument;
if you omit the leading zero it will be interpreted as decimal.
-Now
Set the last-time-modified field of the headers to the current
time, all files will be giben the same time.
-Old_Type
By default, tardy corrects the old normal file type into the
modern normal file type. This option requests that old normal
file type indicators remain unaltered.
-Output_ForMaT name
This option may be used to specify the output format to be
used. The output names are
ustar The format that GNU tar uses. This is the default.
tar-bsd The format that BSD tar(1) uses.
cpio The new cpio(1) ASCII format.
cpio-old-ascii
The old cpio(1) ASCII format.
v7 The ancient UNIX V7 tar(1) format.
Any other format name will produce an error.
-Prefix string
This option is used to add a prefix directory name to the name
of every file in the archive file.
-PROgress
This option is used to obtain a progress indicator. Only works
in combination with the --ifmt=list option.
-Remove_Prefix number
This option is used to remove a number of leading directories
from the name of every file in the archive file, if present.
The prefixes will be removed before any prefix specified by the
-Prefix option is prepended.
-Remove_Prefix string
This option is used to remove a prefix directory name from the
name of every file in the archive file, if present. This
option may be given more than once, and as many of the prefixes
as appear will be removed. The prefixes will be removed before
any prefix specified by the -Prefix option is prepended.
This option is potentially ambiguous with the preceeding
option, if you wish to remove a leading prefix which looks like
a number. If this is the case, add a slash ("/") to the end of
the prefix to stop it looking like a number.
-UpCase
This option may be used to force file names to be all upper
case. Warning: duplicate file names may result.
-User arg
This option may be used to set both the user name and user
number fields in the header of every file in the archive file.
The argument may be either a string or a number. It is an
error if a corresponding entry cannot be found in the
/etc/passwd file.
-User_NAme string
This option is used to set the user name field in the header of
every file in the archive file. The string may be any
arbitrary string, it is not restricted to a known user.
-User_NAme number
This option is used to set the user name field in the header of
every file in the archive file. The number is mapped to a user
name through the /etc/passwd file. It is an error if a
corresponding user cannot be found.
-User_NUmber string
This option is used to set the user number field in the header
of every file in the archive file. The string is mapped to a
user number through the /etc/passwd file. It is an error if a
corresponding user cannot be found.
-User_NUmber number
This option is used to set the user number field in the header
of every file in the archive file. The number may be any
arbitrary number, it is not restricted to a known user.
-VERSion
Print the version of the tardy program being executed.
All options may be abbreviated; the abbreviation is documented as the
upper case letters, all lower case letters and underscores (_) are
optional. You must use consecutive sequences of optional letters.
All options are case insensitive, you may type them in upper case or
lower case or a combination of both, case is not important.
For example: the arguments "-help, "-HELP" and "-h" are all interpreted
to mean the -Help option. The argument "-hlp" will not be understood,
because consecutive optional characters were not supplied.
Options and other command line arguments may be mixed arbitrarily on
the command line, after the function selectors.
The GNU long option names are understood. Since all option names for
tardy are long, this means ignoring the extra leading ’-’. The
"--option=value" convention is also understood.
EXIT STATUS
The tardy command will exit with a status of 1 on any error. The tardy
command will only exit with a status of 0 if there are no errors.
COPYRIGHT
tardy version 1.12.D002
Copyright (C) 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001, 2002,
2003, 2004 Peter Miller;
All rights reserved.
The tardy program comes with ABSOLUTELY NO WARRANTY; for details use
the ’tardy -VERSion Warranty’ command. This is free software and you
are welcome to redistribute it under certain conditions; for details
use the ’tardy -VERSion Redistribution’ command.
AUTHOR
Peter Miller EMail: millerp@canb.auug.org.au
/\/\* WWW: http://www.canb.auug.org.au/~millerp/
tardy(1)