Man Pages

---

Back to Software Index  Manpage Top Level

Name

Synopsis

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.

Table of Contents

• Name
• Synopsis
• Description
• Options
• Examples
• Diagnostics
• Notes