man1/m_crt

Table of Contents

Name

m_crt - motif crt

Synopsis

m_crt <arg list>

Description

This is a new version of the crt(1) program. It has pulldown menus and many other features not present in the older program. It is expected that this program will eventually replace crt(1) in most cases.

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.

--dbman_host <hn>

The host where dbman(8) is running.
If this argument is not present the default is "localhost". The DBMAN_HOST environment variable is used if present.
--pgman_host <hn>

The host where pgman is running.

pgman is a copy of dbman which is used to serve pages to crt and m_crt. Usually this is running on the same host as dbman.

However, the possiblity exists to use a separate copy of dbman/pgman to serve pages. This could be useful in cases where dbman is located remotely on a somewhat slow connection. One might wish to run a local copy and have the page information come from there rather than serving it across the internet.

If this is option is not used the value is the same as --dbman_host, i.e. whatever the final value of --dbman_host is, whether it came from the command line or the DBMAN_HOST.

If PGMAN_HOST is present it is used unless overridden by --pgman_host.

--assign_host <hn>

The host where assignd(8) is running.
--meter_host <hn>

The host where meterd(8) is running.
--knob_host <hn>

The host where knobd(8) is running.
--pen_host <hn>

The host where pen_recorder(1) is running.
--remote_assign

Allow assign request processing when running on a remote display.

Be careful with this option because mixing remote and local display copies of crt and m_crt will confuse the assign processing.

--ctl_lock=<n>

lock control

<n> is an optional argument. If not provided it defaults to 1.

valid values for <n> are:

0 - not locked (usually this is not used)
1 - start up locked (allow user to change setting)
2 - permanently locked (user can’t change setting)

--ctl_hide=<n>

hide control area

<n> is an optional argument. If not provided it defaults to 1.

valid values for <n> are:

0 - not hidden    (usually this is not used)
1 - start up hidden (allow user to change setting)
2 - permanently hidden (user can’t change setting)

--ctl_win_w=<n>

control window field sizing

<n> is an optional argument. If not provided it defaults to 1.

valid values for <n> are:

0 - normal sizing (usually this is not used)
1 - compact sizing

--ctl_wlock=<n>

control write lock usage

<n> is an optional argument if not provided it

defaults to 1

valid values for <n> are:

2 - normal write locking (this is the starting value)
1 - only write lock RSet and friends
0 - don’t write lock

This is useful when connecting to remote sites where the connection has a significant time lag.

Setting it to 1 makes Inc/Dec and Momentary controls behave much better because the program doesn’t need to wait for the write lock to be established before updating.

--size_tbl <fn>

Pathname to a file containing size information for the shared memory partition.
--color_tbl <fn>

Pathname to a file containing color and font information.
--color_tbl2 <fn>

Pathname to a file containing color information which is used when the display colors are reversed.
--user_help

Pathname to a site specific help file.

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

--show_tbl

print various table’s information to stderr
--show_env

print settings of the environment vars used by program to stderr
--show_par_desc

show the parameter name in the error message window when a parameter is selected in the control area.

This setting may be later overridden from the "Actions" menu.

--geom <spec>

use this instead of -geom
--page <num>

the starting page number
--left_anchor

left anchor DCpnt fields

This is a pragma for dealing with databases which haven’t been converted to right anchored DCpnt records.

--pn_ic_legend

Override the default page number (3) for the Icon Legend page.

--help

print the help info and exit.

Environment Variables

DBMAN_HOST

The host where dbman is running. Use this or use the --dbman_host option. if both are present --dbman_host option overrides DBMAN_HOST
PGMAN_HOST

The host where pgman is running. Use this or use the --pgman_host option. if both are present --pgman_host option overrides PGMAN_HOST
CRT_SIZE_FILE

The pathname to shared memory partition sizing file. If not present default sizes will be used.
CRT_COLOR_TBL

pathname to file containing the color information. See xcrt_color(5) for information about the format.
CRT_COLOR_TBL2

pathname to file containing the color information to use when the display colors are flipped. See xcrt_color(5) for information about the format.
ASSIGN

The hostname where assignd(8) is running.

If this environment variable is not present or the --assign_host command isn’t used the value defaults to <not set>.

METER

The hostname where meterd(8) is running.

If this environment variable is not present or the --meter_host command isn’t used the value defaults to <not set>.

KNOB

The hostname where knobd(8) service is running.

If this environment variable is not present or the --meter_host command isn’t used the value defaults to <not set>.

TREND

The hostname where pen_recorder(1) is running.

If this environment variable is not present or the --meter_host command isn’t used the value defaults to <not set>.

ASSIGN_OK

Normally m_crt will attempt to connect to assignd(8) if running on the local display. Placing ASSIGN_OK with any value in the environment will allow m_crt to connect to assignd(8) even if not running on the local display.

This could be used in a case where meter/knob service may actually run on another box but it is desired to use it.

XCRT_TBL_ADDR

If present this value is used for the shared memory attachment address. If not, the value of segaddrCRT in memdef.h is used.

See Also


Xcrt(1) ,
crt(1) ,
ts(1) ,
and xcrt_color(5)

Manual Page Revision

$Id: m_crt.1,v 1.5 2009/12/16 18:13:03 kitchen Exp $

Table of Contents