© Copyright Clive E. Chapman 2008. All rights reserved.

TEE User Guide

Version 5.00 (2008-07-25)

Contents

This page Other pages
Overview Main Page
Invocation Licence
Usage Notes FL User Guide
  FLCUST User Guide
  FLFIND User Guide
  FLTREE User Guide
  FLVIEW User Guide

Overview

TEE is a simple command-line tool that reads data from a pipe, and writes that data to standard output (usually the screen), and to a file. The data must be character data; if TEE is used with binary data, the results are undefined.

TEE would typically be used from the command line, or from a batch file (for example, a BAT file or REX file).

[Back to Contents]

Invocation

TEE [[drive][path]name.ext] [/A] [/?]

where square brackets [ ] denote optional items. Parameters and options are as follows:

Parameters

[drive][path]name.ext
This is the filespec of the output file to which the data is written. If the drive and/or path are not specified, the filespec is resolved using the usual rules. If the filespec contains blanks, the filespec must be enclosed in double quotes. If the filespec does not contain blanks, the double quotes are optional.

If this parameter is not specified, the output data is written only to standard output.

Options

Options can be specifed using either "/" or "-" as the option prefix character, and can occur before or after the positional parameters. The following options are valid:

/A
This option specifies that the output should be appended to the file if the file already exists. It is valid for this option to be specified when the file does not already exist. The option can be specified in upper or lower case, and can precede or follow the filespec.

If this option is not specified, the output replaces the file.

/?
This option causes TEE to display brief help information.

[Back to Contents]

Usage Notes

  1. TEE can be used with any program that writes character data to standard output ("stdout"). The program's standard output must be redirected to TEE's standard input using the pipe character ("|"). Examples:

    DIR *.BAT | TEE DIR.OUT
    DIR *.EXE | TEE DIR.OUT /A
    ATTRIB | TEE ATTR.OUT

  2. If TEE detects an error during its operation, an error message is written to standard error ("stderr").

[Back to Contents]

[FL Main Page]

Valid HTML 4.01 Page last changed: 2008-07-25 Valid CSS