tf

NAME

SYNOPSIS

tf filter file...

type file | tf filter -
tf filter - < file

type filelist | tf filter --
tf filter -- < filelist

AVAILABILITY

DESCRIPTION

The filter file is an awk(3) or gawk(3) script that has to be located in the WA2LWinTools/var/scripts/ directory. The file name format is tf.filter.awk to be handled with the tf command.

OPTIONS

-h

usage message.

-V

print program version.

-l

list existing filters located in the WA2LWinTools/var/scripts/ directory respectively in the additional locations defined in the tf.cfg config file.

filter

a (g)awk script to act as filter for the data stream.

file...

file(s) to transform the data from. When - is specified as file, read the data from stdin.

The file option allows multiple wildcards in the path, as:

  tf localadmin LocalAdminsReport\*\*.csv > output-all.csv
  tf localadmin LocalAdminsReport/*/*.csv > output-all.csv

or

  tf localadmin L*\*\*.csv > output-all.csv
  tf localadmin L*/*/*.csv > output-all.csv

--

read the files from a filelist (one per line).

ENVIRONMENT

%TF_FILTERPATH%

semicolon separated search path of tf filters.

The settings in %TF_FILTERPATH% prepend the settings made in the WA2LWinTools/etc/tf.cfg file.

See also tf.cfg(4)

%TF_INCLUDE%

semicolon separated include files containing library functions to be used in tf filters.

The settings in %TF_INCLUDE% prepend the settings made in the WA2LWinTools/etc/tf.cfg file.

%TF_FILTER%

filter file name. This environment variable is exported by the tf command to the filter.

See also tf.cfg(4)

EXIT STATUS

0

no error.

2

specified filter does not exist.

4

usage message displayed.

5

version printed.

6

filters listed.

FILES

WA2LWinTools/var/scripts/tf.filter.awk

(g)awk filter to be used to convert the input data.

Place new filters to this location or set the filter path in tf.cfg or in the %TF_FILTERPATH% environment variable to use another filter directory.

WA2LWinTools/var/lib/tf/tf.filter.awk

set of filters distributed with WA2L/WinTools to be used to convert the input data.

Do not place own filters to this directory.

WA2LWinTools/etc/tf.cfg

optional configuration file for tf.

EXAMPLES

SEE ALSO

NOTES

BUGS

To go around that constraint when many files have to be submitted to tf, provide a list of files thru stdin:

type filelist | tf filter --

or:

lsw *.ext | tf filter --

AUTHOR

COPYRIGHT

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.