FADCAT(1) General Commands Manual FADCAT(1)
NAME
fadcat - concatenate FAD files
SYNOPSIS
fadcat [ -V | --version ] [ -v | --verbose | -d level | --debug=level ]
[ -h | --help ] [ -p | --paths ] [ -n | --simulate ] [ -o outfile |
--file=outfile ] [ -g regexp | --grep=regexp ] [ infile ... ]
DESCRIPTION
Fadcat reads the contents of FAD files whose names are specified by in-
file, or it reads standard input if no names are supplied. It concate-
nates the input files, in much the same manner as cat(1)) and writes
the result to standard output.
Fadcat can read and write plain files or files compressed with either
compress(1) or gzip(1), but only if they have the appropriate file ex-
tension and are specified on the command line, rather than fed through
standard input.
CONFIGURATION
None.
OPTIONS
-d level, --debug=level Determines how verbose this program will be.
The message types displayed for the different
values of level are as follows: 0 displays no
messages; 1 displays only errors, 2 displays
errors and warnings; 3 displays errors, warn-
ings and informational messages; higher values
display errors, warnings, informational mes-
sages and various messages intended for debug-
ging. The default is 2.
-h, --help Displays a brief usage message.
-p, --paths Lists the compiled-in paths of various files
and directories that this program uses. -n,
--simulate Some external commands that this
program runs may be displayed rather than ac-
tually executed. BEWARE: different programs
implement different levels of simulation; so
this option may work perfectly; on the other
hand it may do nothing at all!
-v, --verbose Equivalent to -d 3.
-V, --version Prints the program's version number and exits.
-g, --grep=regexp output only those lines which match the speci-
fied Perl regular expression (see perlre(1)).
-o,, --file=outfile Writes to outfile. The default is to write to
standard output.
EXIT STATUS
On success fadcat returns zero. On failure it returns non-zero and dis-
plays a diagnostic message.
FILES
None.
ENVIRONMENT VARIABLES
None.
EXAMPLES
The following command merges two FAD files, saving the result:
fadcat file1.fad file2.fad > fad3.fad
This will extract records from fad3.fad for files whose name contains
the text 'foo', formatting it into a correctly headered FAD file and
send it to file 'foo.fad':
fadcat -g foo -o foo.fad fad3.fad
CAVEATS
None.
STANDARDS
This manual page documents version 7 of fadcat.
SEE ALSO
perlre(1), fad(5), find(1), faddiff(1), compress(1), gzip(1), cat(1),
fad-config(1)
AUTHOR
Alexis Huxley <alexishuxley@gmail.com>
COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1995-2024 Alexis Huxley
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER-
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
30 Jul 2024 FADCAT(1)
