owplaces(1) manual page
Table of Contents
owplaces - list client applications running on a display
owplaces
[ -display displaystring ] [ -timeout nseconds ]
[
-single | -multi | -pointer ]
[
-all | -local | -remote | -host hostname ]
[
-script ] [ -output filename ] [ -ampersand ] [ -tw ]
[
-silent ]
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
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.
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.
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.
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.
To create a $HOME/.openwin-init startup script
just as olwm(1)
does for "Save Workspace":
example% owplaces -multi -script -output $HOME/.openwin-init
olwm(1)
, xlsclients(1)
, toolwait(1)
Table of Contents