[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    owplaces(1) manual page Table of Contents

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

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

-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)


Table of Contents