scolock(XC)


scolock -- locks X display

Command syntax

scolock [-frames n] [Xt_options] [-icons | -worlds [-numworlds n] | -blank] [-framerate n] [-norotate] [-autolock] [-screensaver] [-delay n] [-lockout n]

Desktop syntax

Double-click on the Lock icon, which is in Accessories by default.

Description

scolock locks your display by preventing mouse and keyboard input from having any effects on your computer system. After scolock is activated, your screen is filled with rotating objects, which spin around the screen. Any movement with the mouse or activity on the keyboard brings up a dialog box requesting your password. Entering the password unlocks your display. scolock also allows you to activate a screen saver.


NOTE: Save your current session before locking your display. Your desktop information is not saved if the system crashes while your display is locked.

You can change the objects that display by dropping the new objects onto the Lock icon. You can also have a blank screen appear when the display is locked rather than any objects, as described below.

Command options

You can use the following options with the scolock command:

-icons
causes icons to be displayed rather than worlds or a blank screen.

-worlds
causes worlds to be displayed. Used as an argument to this option, -numworlds n determines how many worlds are displayed.

-blank
causes a blank screen to be displayed rather than objects.

-frames n
sets the number of frames used in each spinning of an object (the higher the number, the smoother the spin and the slower the animation). A typical value is 30.

-framerate n
sets the rate at which to animate the rotation of the objects. A typical value is 1.

-norotate
causes the objects to not rotate.

-autolock
causes the system to lock automatically.

-screensaver
activates the screen saver feature.

-delay n
sets the time it takes (in seconds) for the screen to lock. A typical value is 600.

-lockout n
sets the time between attempts to enter the password. A typical value is 5 (in seconds).

Resources

You can customize the characteristics of scolock using your personal X resource file, $HOME/.Xdefaults-hostname, where -hostname is the name of the machine on which the client is running. If this file does not exist in your home directory, you will need to create it. Changes made to this file take effect the next time you run scolock.

scolock defines the following application-specific resources:


icons
to have icons (rather than worlds) rotate on the screen. The default is True.

worlds
to have worlds (rather than icons) rotate on the screen. The default is False.

blankScreen
to have the screen blank when the display is locked (that is, neither icons nor worlds are displayed). The default is False.

frames
specifies the number of frames to be used during the rotation of icons. Higher numbers cause the spin to be smoother and the animation to be slower. A typical default value is 30. (When rotating worlds, the value is always 30.)

frameRate
specifies the rate at which frames are redisplayed. A typical default value is 1.

noRotate
disables or enables rotation of worlds/icons. The default is False.

autoLock
locks the screen with a password. The default is False.

screenSaver
specifies if the screen saver feature is activated. The default is False.

delay
specifies the time in seconds before the screen saver comes on. A typical default value is 600.

lockoutDelay
specifies the time in seconds between a password error and the redisplay of the password window. A typical default value is 5.

autoUnmapDelay
specifies the time in seconds until the password window is visible. A typical default value is 60.

noRootPassword
specifies that only the user's password can be used to unlock the display when set to True (the default). If False, enables the root password to be entered to unlock the display.

cursor
determines the password dialog mouse cursor to use for the login window. The default is left_ptr.

lockNice
specifies how much CPU time is used for the screen lock. A typical default value is 0; however, a value such as 5 causes the screen lock to use up less CPU time.

saveNice
specifies how much CPU time is used for the screen saver. A typical default value is 0; however, a value such as 5 causes the screen saver to use up less CPU time.

loginString
specifies the password dialog box prompt. The default is ``Enter your login password''.

See also

Xt_options(XC)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 26 May 2005