Chex Usage

Chex (which stands for stands for Cheops execute) executes a program on Cheops from the host workstation. By default, Chex stays resident on the host to service printf, scanf, file I/O, and other basic UNIX system calls from the program, redirecting the program's stdin and stdout to your terminal or xterm window.

A serial I/O option (-ser 0) is provided which forces Chex to only download and start the program's execution - standard I/O is then redirected to the serial console port (see chterm).

Before Chex can be invoked to handle local program execution, your shell's search path, environment variables, and aliases should be configured.

Usage:

    chex [-ser (0|1)] [-which] [-help]
         [-Ttext < hex_addr> ]   [-Tdata < hex_addr> ]
         < program_path>   [ < program_args>   ]

Options:

-ser 0

downloads the program via SCSI but then starts its execution using the Cheops SER_0 port for stdin and stdout.

-ser 1

don't try this alone.

-which

echoes the executable path of the program without executing it.The environment variable $CHEOPS_LOCAL_PATH defines the path of directories that chex searches for to find your executable program.

-help

prints out the above usage reminder.

-Ttext < hex_addr>

relocates the text (code) segment to the given Cheops local address, rather than automatically allocating space for it.

-Tdata < hex_addr>

relocates the uninitialized data segment to the given Cheops local address, rather than automatically allocating space for it.

< program_path>

is the path of the application program.

< program_args>

are the additional optional arguments sent as command line arguments to the downloaded process.

• Use (control-c) to stop your program. Chex kills the program before killing itself.
• DON'T (control-a) in your chterm console window while your program is running; this action soft reboots Cheops which will abruptly terminate your host's SCSI connection. On some platforms this connection can only be reestablished during the host's reboot cycle.
• Chex must be called from the host machine attached to a particular Cheops.
• Chex scans its command line for special options that it recognizes. The first word that it does not recognize, it considers to be the name of the Cheops program you want to execute. All words following the program name are sent as command line arguments for that program in conventional argc/argv format.

Go to Chex Details for more information about the chex utility.

This is a "fix it yourself" page, located at /mas/garden/cheops/WWW/software/chex_usage.html