NAME

FTimesCat - Write the contents of a file or stdin to stdout.

SYNOPSIS

ftimes-cat {file|-}

DESCRIPTION

The FTimesCat utility reads the contents of a file or stdin and writes them to stdout. The specified filename is assumed to be encoded (i.e., neutered by FTimes), and it is automatically decoded to obtain the real name, which may contain special characters.

MODES OF OPERATION

Currently, FTimesCat only has one mode of operation, which is given in the SYNOPSIS.

RETURN VALUES

Upon successful completion, a value of 0 (XER_OK) is returned. Otherwise, one of the following error codes is returned:

1 = XER_Usage
2 = XER_Abort

EXAMPLES

Example 1. Standard operation

This example demonstrates how to cat a file with a neutered name. In this case, the name contains space and newline characters.

    ftimes-cat name+with+spaces%0aand%0anewlines

Such a file can be created with the following Perl one-liner:

    perl -e 'open(F, ">name with spaces\nand\nnewlines"); print F "jinx\n";'

Example 2. Standard operation with input from stdin

This example demonstrates how to copy stdin to a file called 'out.zero'. The data for stdin will be generated by the dd(1) command reading from /dev/zero.

    dd if=/dev/zero bs=32k count=1 | ftimes-cat - > out.zero

SEE ALSO

cat(1), ftimes(1)

AUTHOR

Klayton Monroe

HISTORY

This utility was initially written to obtain the content of files with awkward or mischievous names (i.e., names requiring special handling to prevent terminal rendering issues and errors in various tools and shell scripts).

This utility first appeared in FTimes 3.9.0.