The grun Utility Program

The grun Utility Program remotely executes a program using a MULTI debug server to control the execution environment.

Usage

To use grun, enter:

grun [options] dbserv_cmd -- program [arguments]

where

options Specific grun options, listed below.

dbserv_cmd Name of a MULTI debug server.

-- Double dash separates debug server name from program name.

program Name of executable program.

arguments Optional program command line arguments.

The grun options include:

-help

Display information about all options.

-text addr

Specifies addr as the starting address of the program's text (code). This is appropriate for Position Independent Code (PIC) programs.

-data addr

Specifies addr as the starting address of the program's data. This is appropriate for Position Independent Data (PID) programs.

-stack addr

Specifies addr as the initial value for the program's stack pointer.

-detach

Causes grun to immediately terminate after downloading the program to the target system. grun usually engages in communication with the debug server before exiting, which may halt an executing target program. This switch is frequently used with various target monitors or Boot ROMs when the program being downloaded will take the control of the target system and terminate the target monitor.

-download

Causes the program to be downloaded, but does not start it running.

-pro

Like -profile, but also translates the profiling data.

-profile

Executes the target program with profiling enabled.

The grun utility downloads and starts the executable program, subject to the options above. If the -bail flag is specified, grun exits immediately after starting the program. Otherwise, grun waits for target program completion before exiting. grun will wait until 10 minutes with no I/O. After that time, or if grun is interrupted by the user, it halts the target program and exits. While grun is running, its standard input and output are copied to and from the executing program, redirecting the program's I/O to the user's terminal.


Previous

Next



Copyright © 1999, Green Hills Software. All rights reserved.