scolock(X) 19 June 1992 scolock(X) Name scolock - lock X display Command syntax scolock [-confirm] [Xtoptions] Desktop syntax Controls >> Lock Description scolock (Lock icon) locks your display by confining mouse, keyboard, and server activity. Your display remains locked until you enter your system password. If a process is running, Lock temporarily interrupts it. When you unlock your display, the process continues from the point where it stopped. _________________________________________________________________________ NOTE Save your current session before locking your display. Your desktop information is not saved if the system crashes while your display is locked. _________________________________________________________________________ Command option You can use the following option with the scolock command: -confirm waits for the user's confirmation before locking the display. Click on OK to lock the display. This option is the default from the desktop. Errors If Lock is unable to access your keyboard, mouse, or X server, you see the following message: Cannot lock display. This message indicates one of the following errors: + You started Lock while using the mouse to move a window or select a menu option. Do move the mouse, open windows, or press any mouse but- tons after you select Lock. + Before starting Lock, you selected Secure Keyboard from the UNIX->Options->Display menu; this option restricts usage of the key- board to a single application. Click on OK in the error message dialog box to return to the Desktop, then select Lock to try again. Resources You can customize scolock by editing the .Xdefaults-hostname resource file, located in the following path: $HOME/.Xdefaults-hostname ``$HOME'' represents your home directory. The most useful resources are listed here. For guidelines on how to modify the resources, refer to the Graphical Environment Administrator's Guide. prompt.labelString specifies the dialog box prompt that scolock displays when it locks the X display. The default prompt is This display is locked. To unlock, enter the password for <logname>. prompt.bottomPosition specifies where the scolock dialog box prompt displays on the screen. This location is expressed in a percentage that determines the prompt's distance from the top of the window. The percentage values range from 1 to 100; the default is 44. passwordError.messageString specifies the message the error dialog box displays if you type an incorrect password. The default message is Invalid password. grabServerError.messageString specifies the message the error dialog box displays to indicate scolock cannot lock the X display. The default message is Cannot to lock display. ConfirmMessage.labelString specifies the dialog box prompt that scolock displays before it locks the X display with the -confirm option. The default message is Once locked, the display can only be unlocked with your password. See also Xtoptions(X)