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)

SunOS 5.2  —  Last change: 7 January 1991