CTXT-UTIL

Section: Misc. Reference Manual Pages (8L)
Index Return to Main Contents

NAME

ctxt-util - manipulate DPS contexts

SYNOPSIS

ctxt-util
ctxt-util [ -h ]
ctxt-util [ -N appName::uid ]
ctxt-util [[ -p pid | -c ctxt ] -arH [ -u | -v ]]

DESCRIPTION

ctxt-util can list and selectively manipulate your DPS contexts from the command line.

The default display lists all active contexts on your DPS server. The information listed is:

SHORTNAME: the name of the process that owns the context (limited to 16 characters for obscure technical reasons)
PID: the process id
UID: the user id that owns the process
CTXT: the DPS context id
ICON: the window number of the icon associated with the context (if any)
MENU: the window number of the main menu associated with the context (this will be -1 if the menu has not yet been displayed on-screen)
MINIWINS: a list of ids for the miniwindows associated with this context (if any)

OPTIONS

-h: Display a short help message.
-N appName::uid: Display information for just the named process and user id
-p pid: Supply a process id that corresponds to an active context
-c ctxt: Supply a context id that corresponds to an active process
-a: In conjunction with -p or -c, activate a context/process (if not present, hides the context instead)
-r: In conjunction with -p or -c, raise the windows of the given context/process
-H: In conjunction with -p or -c and -r or -a, hide all contexts/processes except the one specified by -p or -c (in addition to the other actions)
-v: In conjunction with -p or -c, vanish (that is, hide) the icon associated with that context/process
-u: In conjunction with -p or -c, unvanish (that is, restore) the icon associated with that context/process

WARRANTY

None. You get what you pay for.

BUGS

Undoubtedly :-). Seriously though, the one big one I know about is that multiple instances of a given app being run by the same uid are not tracked properly. (Actually, they are tracked properly internally, but I'm too lazy to let you have a way to get at them at the moment).

The man page could use some work.

Of more pressing concern is that with enough senseless diddling using this utility, you are more than empowered to crash your window server. Of course, I disclaim any and all responsibility for it if you do (see WARRANTY, above), so be careful.

NOTES

ctxt-util was written by David C. Lambert (dcl@panix.com), at the instigation of Bill Bumgarnner and Christine Palmieri, as a way of extracting certain features from Fiend.

COPYRIGHT

1998 (c) David C. Lambert

This document was created by man2html, using the manual pages.
Time: 05:08:39 GMT, April 11, 2025