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. 

SunOS 5.5/x86  —  Last change: 30 March 1994