NAME

owplaces - list client applications running on a display

SYNOPSIS

owplaces [ -display displaystring ] [ -timeout nseconds ]

[ -single | -multi | -pointer ]

[ -all | -local | -remote | -host hostname ]

[ -script ] [ -output filename ] [ -ampersand ] [ -tw ]

[ -silent ]

DESCRIPTION

owplaces is a tool to list the command lines for the selected clients. The output is geared towards use in a startup script such as $HOME/.openwin-init

OPTIONS

The basic options are as follows:

-display string

Specify the name of the display to manage. Overrides the DISPLAY environment variable, if any.

-timeout nsecs

Specifies the time to wait for a reply for those clients that are updating their command lines. Default is 30 seconds.

MODE OPTIONS

Options that control which clients are printed:

-single

Search only the default screen of the specified display for clients.

-multi

Search all screens of the specified display for clients. This is the default.

-pointer

Print only the client selected by clicking the mouse in the desired window.

CLIENT MACHINE FILTER

Options to filter clients based on host machine (as specified by the WM_CLIENT_MACHINE property):

OPTIONS

-all

Print clients on all hosts. This is the default.

-local

Print clients local to this machine only.

-remote

Print clients that are remote to this machine.

-host hostname

Print clients from hostname only.

INITIALIZATION SCRIPT OPTIONS

Options useful to producing shell scripts:

-script

Instead of printing command lines, output will be a Bourne shell script suitable for use as an initialization file. The script can handle multiple screens if -multi is also specified.

-output filename
                Directs output to filename instead of stdout. If filename exists, it is
                renamed as filename.BAK.

-ampersand

Appends an ampersand character (&) to end of each command line. This is implied if -script is used.

-tw

Prepends the command toolwait(1) to each client. The -ampersand option has no affect if this option is specified.

-silent

Suppress error messages.

EXAMPLES

To create a $HOME/.openwin-init startup script just as olwm(1) does for "Save Workspace":

example% owplaces -multi -script -output $HOME/.openwin-init

SEE ALSO

olwm(1), xlsclients(1), toolwait(1)