Provided by: tardy_1.25-2_amd64 bug

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 filename pattern will be removed.
               Be careful with wild cards, they match everything, including slash (/) characters.
               The exclude pattern 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 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.

       -No_Directories
               This option may be used to suppress directories from  the  output.   This  can  be
               useful when the archive has been created with directories 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  format  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)