Reference Guide › Utilities › selockcom Utility—Control the selock Utility

selockcom Utility—Control the selock Utility

Valid on UNIX

The selockcom utility controls the currently active selock process. This includes restarting and stopping selock, as well as switching between the lock, saver, and monitor modes.

Note: When selock is loaded, it disables the terminal's built‑in screen saver to prevent race or overlap conditions between selock and the built‑in screen saver. If you stop selock with the selockcom exit switch, no screen saver is active on your terminal. You can restart selock or the terminal's built‑in screen saver using the standard X command xset s on. For more information on the xset command, see your UNIX documentation.

This command has the following format:

selockcom {-activate|-deactivate|-exit|-restart|-lock} \

[-display hostname:display#.screen#]

‑activate

Switches selock from the monitor mode to the saver mode without waiting for the predefined time-out period to pass. The keyboard is locked and the CA ControlMinder logo appears on the screen.

‑deactivate

Switches selock back to the monitor mode. This switch simulates user input to the selock process. If selock is currently in the lock mode, the password dialog appears; enter your password to return to the monitor mode. If selock is in the saver mode, you are returned to the monitor mode.

‑exit

Terminates the selock process. You can also terminate selock by sending it a sigterm signal. As a last resort, you can also use the sigkill signal (kill ‑9). If you use the last method, selock does not exit gracefully; therefore you should not normally use it. If you are running a virtual‑root window manager, using kill ‑9 forces you to restart the window manager to restore the virtual window.

‑restart

Terminates the selock process and then immediately restarts it with the same command line options as the previous invocation. This is a good way to get selock to re‑read the resource database if the database was changed since you last invoked selock.

‑lock

Switches selock to the lock mode, regardless of the current lock‑timeout value.

‑display hostname:display#.screen#

Instructs selockcom to control the selock process operating on the specified display. This option allows you to control selock from a remote terminal.

You can find the display and screen numbers in an X‑session listing from your system. To do this, you must have authorization from the user currently running the specified display monitor. The default assumption is that you want to lock your own display.