WANDIOCAT(1)

NAME
wandiocat - read and write files using libwandio routines

SYNOPSIS
wandiocat [-z level] [-Z method]
        [-o outputfilename] inputfile [inputfile ...]

DESCRIPTION
wandiocat is a simple program designed to demonstrate how libwandio can be used to easily read and write files using any of the supported compression methods. Each input file specified will be concatenated into a single output file (or written to standard output if no output file is specified) which will be compressed according to the compression method and level supplied by the user. wandiocat will automatically detect the compression method required to read the input files, so they do not need to be decompressed first.

OPTIONS

-h  Show summary of supported command-line options.

-Z method
    Specifies which compression method should be used to write output. Must be one of 'gzip', 'bzip2', 'lzma', 'lzo', 'zstd', or 'lz4'. If not specified, the output is written uncompressed.

-z level
    Specifies the compression level to be used when writing output. The level must be an integer value between 0 (uncompressed) and 9 (maximum compression) inclusive. Usually compression level 1 is sufficient for most purposes. Defaults to 0.

-o outputfilename
    Sets the name of the output file. If not specified, output will be written to standard output instead.

SECURITY
wandiocat should usually be run unprivileged. The only exception would be when the user wants to use Intel QuickAssist hardware to perform gzip compression (and has configured and installed libwandio with QuickAssist support enabled) -- in this case, wandiocat may need to be run as root to be able to access the hardware.

AUTHOR
wandiocat was originally written by Perry Lorier, while working for the University of Waikato WAND Network Research Group <contact@wand.net.nz>.

This manual page was written by Shane Alcock <shane.alcock@waikato.ac.nz>