NAME

toolwait - control client program startup

SYNOPSIS

toolwait [ -display displaystring ] [ -timeout nseconds ] [ -help ] command

DESCRIPTION

toolwait is a program that controls the startup of an X11 client program. toolwait takes a client program as its argument. When the client program has started, toolwait will exit.

OPTIONS

The basic options are as follows:

-display string

Specify the name of the display that toolwait should monitor. Overrides the DISPLAY environment variable, if any.

-timeout nsecs

Specifies the time to wait for the client to start up. Toolwait will exit if the client hasn't started by nsecs seconds. Default is 15 seconds.

-help

Display a short summary of the possible command line options.

EXAMPLES

To start a cmdtool with toolwait, the following command may be used:

example% toolwait cmdtool -Wp 0 0 -Ws 557 95 -WP 263 833

To start a mailtool on display "host2" with a timeout of 25 seconds, use the following command:

example% toolwait -display host2:0 -timeout 25 mailtool

-display host2:0

DIAGNOSTICS

Exit status is 0 for clean exits, the exit status of the child if the child has problems, and 1 if toolwait has problems.

NOTES

In the current version of toolwait, a client is considered "started" when it has mapped a top level window on the display. As soon as toolwait detects that a top level window has been mapped, it will exit.