man1/pen_recorder

Table of Contents

Name

pen_recorder - on screen pen recorder

Synopsis

pen_recorder <argument list>

Description

This program is an 24 channel on screen pen recorder. Only one copy may be started on each host.

Arguments

Argument processing is done using Unix long argument syntax

The values of all the parameters listed here (whether or not they were supplied on the command line) are printed on stderr when the program starts.

--color_tbl <fn>

Pathname to the color table file.
--color_tbl2 <fn>

Pathname to the color table file used when color is reversed.
--def_path <pn>

pathname to the directory used to load default setups.

Setups in this directory can’t be overwritten by the user.

--user_path <pn>

pathname to the directory used to load and save user defined setups.

Setups in this directory can be overwritten by the user.

The setups may be protected from being overwritten by setting them to be read only in the file system.

If this is not set the user will be unable to save setups.

--user_help <fn>

pathname to a site specific help file.

This file will be loaded in addition to the program’s help file and additional items will appear on the help menu.

--show_tbl

print various table’s information to stderr.
--show_env

print settings of environment vars used by program to stderr
--diag_menu

Enable the diagnostic menu. This gives access to internal table information.
--verbose

Normally the program does it’s work silently. This causes it to print several messages on startup.
--help

print the help info to stderr and exit.

Setup Directories

There are two directories where pen recorder setups may be restored from. Each directory contains a maximum of 30 possible setups. The files are named trend_saveXX where XX is the setup number.

The directory specified by the --data_path argument contains setups which may be loaded. The program doesn’t allow setups to be saved in this directory.

The directory specified by the --user_path argument contains setups which may be loaded or saved.

The idea is the the --data_path directory allows permanent setups to be created when the system is configured and the --user_path directory allows new ones to be created by the users of the system.

The easiest way to create setups for the --data_path directory is to create and save a setup in the --user_path directory and copy it to the --data_path directory.

Environment Variables

TREND_COLOR_TBL

pathname to file containing the color information. See trend_color(5) for information about the format.
TREND_COLOR_TBL2

pathname to file containing the color information to use when the display colors are flipped by using the prefernces menu command. See trend_color(5) for information about the format.

Example


#!/bin/sh
export TREND_COLOR_TBL=./trend_color.dat
export TREND_COLOR_TBL2=./trend_color_rev.dat
pen_recorder

Notes

sending SIGHUP to the program makes it dump internal state information to stderr.

The example shown above isn’t very good....

See Also

Xcrt(1) , crt(1) , ts(1) , m_crt(1) , and trend_color(5)

Manual Page Revision

$Id: pen_recorder.1,v 1.4 2007/09/10 16:55:47 kitchen Exp $

Table of Contents