TARDY(1)						      General Commands Manual							  TARDY(1)

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 archive files.  Supported archive formats include tar(1), cpio(1) and
       ar(1).

       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.  Note that tardy will refuse to read from or write
       to a terminal, as this indicates that the user has made a mistake.

       If the input is in gzip(1) format, it will be automatically gunzip(1)ed before processing.  Similarly, if the output  file  name  indicates
       that gzip(1) should be used, this will be done automatically on output.

OPTIONS

       The following options are understood:

       -Block_Size number
	       This  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.

       -EXclude pattern
	       This option may be used to completely remove files from the archive.  All files that have a filename patching the given shell file-
	       name pattern will be removed.  Be careful with wild cards, they match everything, including slash (/) characters.  The exclude pat-
	       tern is applied before all file-name manipulating patterns.

       -eXtract
	       This option may be used to extract the contents of an archive.

       -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
	       By default, the input file is examined to automatically detect the input archive file's format.	This option may be used to specify
	       the input format to be used.  The input format names are

	       tar     This format understands all of the various tar(1) formats.  This is the default.

	       tar-bsd This format expects BSD tar(1) archives.

	       ustar   This format expects ustar(1) format archives.

	       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.

	       directory
		       The input is a text file which contains one file name per line.	The named files are read as if they were an archive input.
		       If any directories are found, they will be descended recursively.

	       cpio    The file is expected to be in one of the cpio(5) formats, and will be examined to figure out which.

	       cpio-bin
		       This format expects cpio(5) "old binary" format archives.

	       cpio-crc
		       This format expects cpio(5) "crc" format archives.

	       cpio-new-ascii
		       This format expects cpio(5) "new ascii" format archives.

	       cpio-old-ascii
		       This format expects cpio(5) "old ascii" format archives.

	       ar      The file is expected to be in one of the ar(1) formats, and will be examined to figure out which.

	       ar-bsd  This format expects ar(1) "BSD" format archives.

	       ar-pdp11
		       This format expects ar(1) archives, in the ancient pre-V7 format.

	       ar-v7   This format expects ar(1) "Unix Version 7" format archives.

	       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.

       -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 second; if neither is specified the mode of each file is unal-
	       tered.

       -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.

       -No_Directories
	       This  option may be used to suppress directories from the output.  This can be useful when the archive has been created with direc-
	       tories in useless modes.

       -Now
	       Set the last-time-modified field of the headers to the current time, all files will be given 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
	       By default, tardy tries to write the same format on output as it sees on input.	This option may be used to specify the output for-
	       mat to be used.	The output format names are

	       ar      The archive will be written using the ar(1) format, BSD variant.  Note that this format	only  supports	simple	files;	it
		       silently discards directories, and even discards directory portions of file names.

	       ar-bsd  The  archive  will  be  written	using the ar(1) format, BSD variant.  Long file names are handled by a special file at the
		       start of the archive full of file names.

	       ar-bsd-l2
		       The archive will be written using the ar(1) format, BSD variant.  Long file names are handled by special file name mangling
		       in the archive, with the actual file name transparently injected into the start of the file data.

	       ar-pdp11
		       The  archive  will  be written using the ar(1) format, in the most ancient pre-V7 variant.  (There are also ar-pdp11-le and
		       ar-pdp11-le names, if you need to select the byte order.)

	       ar-port5
		       The archive will be written using the ar(1) format, in the PORT5 variant.  (There  are  also  ar-port5-le  and  ar-port5-le
		       names, if you need to select the byte order.)

	       ar-v7   The archive will be written using the ar(1) format, ancient Unix Version 7 variant.  (There are also ar-v7-le and

	       posix   The format that GNU tar uses.

	       tar-bsd The format that BSD tar(1) uses.

	       cpio    The new cpio(5) ASCII format.

	       cpio-bin
		       The cpio(5) "old binary" format, using host byte order.

	       cpio-bin-le
		       The cpio(5) "old binary" format, using little-endian byte order.

	       cpio-bin-be
		       The cpio(5) "old binary" format, using big-endian byte order.

	       cpio-crc
		       The cpio(5) "crc ascii" format.

	       cpio-old-ascii
		       The old cpio(5) ASCII format.

	       ustar   This is the format that Joerg Schilling's ustar(1) uses.

	       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 preceding 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.

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.

SEE ALSO

       ar(1)   Create, modify, and extract from archives

       ar(5)   Format of ar(1) archive files (not all systems have this man page).

       cpio(1) Copy files to and from archives

       cpio(5) Format of cpio(1) archive files

       find(1) Search for files in a directory hierarchy

       tar(1)  Store and extract files from a tape or disk archive

       tar(5)  Format of tar(1) archive files

COPYRIGHT

       tardy version 1.25.D001
	       Copyright  (C)  1993,  1994,  1995, 1996, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2006, 2008, 2009, 2010, 2011 Peter Miller

	       The tardy program comes with ABSOLUTELY NO WARRANTY;  for  details  use the  'tardy  -VERSion   License'  command.   This  is  free
	       software and you are welcome to redistribute it under certain  conditions;  for	details use the 'tardy -VERSion License' command.

AUTHOR

       Peter Miller <pmiller@opensource.org.au>
	       http://miller.emu.id.au/pmiller/

																	  TARDY(1)