xlock [ -help ] [ -version ] [ -resources ] [ -display displayname ] [
-visual visualname ] [ -name resourcename ] [ -mode modename ] [ -delay
usecs ] [ -batchcount num ] [ -count num ] [ -cycles num ] [ -ncolors
num ] [ -size num ] [ -saturation value ] [ -erasemode modename ] [
-erasedelay usecs ] [ -/+allowaccess ] [ -vtlock modename ] [ -/+nolock
] [ -/+inwindow ] [ -/+inroot ] [ -/+remote ] [ -/+mono ] [ -/+allowââ
root ] [ -/+debug ] [ -/+description ] [ -/+echokeys ] [ -echokey
echokey ] [ -/+enablesaver ] [ -/+resetsaver ] [ -/+grabmouse ] [
-/+grabserver ] [ -/+install ] [ -/+mousemotion ] [ -/+sound ] [
-/+showdate ] [ -/+timeelapsed ] [ -/+usefirst ] [ -/+verbose ] [ -nice
level ] [ -lockdelay seconds ] [ -timeout seconds ] [ -font fontname ]
[ -planfont fontname ] [ -bg color ] [ -fg color ] [ -background color
] [ -foreground color ] [ -username string ] [ -password string ] [
-info string ] [ -validate string ] [ -invalid string ] [ -geometry
geom ] [ -icongeometry geom ] [ -glgeometry geom ] [ -/+wireframe ] [
-/+showfps ] [ -fpsfont fontname ] [ -/+fpstop ] [ -/+use3d ] [
-delta3d value ] [ -none3d color ] [ -right3d color ] [ -left3d color ]
[ -both3d color ] [ -program programname ] [ -messagesfile formatted-
filename ] [ -messagefile filename ] [ -message string ] [ -messagefont
fontname ] [ -bitmap filename ] [ -cpasswd crypted-password ] [
-forceLogout minutes ] [ -logoutButton minutes ] [ -logoutButtonLabel
textstring ] [ -logoutButtonHelp textstring ] [ -logoutFailedString
textstring ] [ -/+dtsaver ] [ -/+xinerama ] [ -modulepath path ] [
-locksound string ] [ -infosound string ] [ -validsound string ] [
-invalidsound string ] [ -startCmd string ] [ -endCmd string ] [
-pipepassCmd string ] [ -logoutCmd string ]
xlock locks the X server till the user enters their password at the
keyboard. While xlock is running, all new server connections are
refused. The screen saver is disabled. The mouse cursor is turned
off. The screen is blanked and a changing pattern is put on the
screen. If a key or a mouse button is pressed then the user is
prompted for the password of the user who started xlock.
If the correct password is typed, then the screen is unlocked and the X
server is restored. When typing the password Control-U and Control-H
are active as kill and erase respectively. To return to the locked
screen, click in the small icon version of the changing pattern.
In the lower part of the password screen a text is displayed. This
message is taken from the first file of the following that exists:
$HOME/.xlocktext, $HOME/.plan, or $HOME/.signature.
On systems which support new BSD style authentication, the password may
be prefixed by an authentication style followed by a colon (i.e.
"style:password"). See the login.conf(5) for more information on
NOTE ON ETIQUETTE
Xlock should not be used on public terminals when there is a high
demand for them.
If you find a public terminal that has been locked by another user and
there are no other terminals available, and the terminal appears to
have been left idle for a while (normally more than 15 minutes), it is
fair to try to reset the session in some manner.
Print options and a brief description to standard output.
Print version number (if >= 4.00) to standard output.
Print default resource file to standard output.
The display option sets the X11 display to lock. xlock locks all
available screens on a given server, and restricts you to locking
only a local server such as unix:0, localhost:0, or :0 unless you
set the -remote option.
visualname which is one of "StaticGray", "GrayScale", "Staticâ
Color", "PseudoColor", "TrueColor", "DirectColor", or "default".
default used to set the screen's default visual (the visual of the
resourcename is used instead of XLock when looking for resources
to configure xlock.
As of this writing there are over 90 display modes supported (plus
one more for random selection of one of these).
anemone Shows wiggling tentacles.
ant Shows Langton's and Turk's generalized ants.
ant3d Shows 3D ants.
Shows Apollonian circles.
Shows moving sharks/whales/dolphin. May not be available
depending on how it was configured.
Advance GL tunnels screensaver. May not be available depending
on how it was configured.
ball Shows bouncing balls.
bat Shows bouncing flying bats.
blot Shows Rorschach's ink blot test.
Shows Mimi's bouboule of moving stars.
bounce Shows bouncing footballs.
braid Shows random braids and knots.
bubble Shows popping bubbles.
Shows Richard Jones's GL bubbles. May not be available dependâ
ing on how it was configured.
bug Shows Palmiter's bug evolution and a garden of Eden.
clock Shows Packard's oclock.
coral Shows a coral reef.
crystal Shows polygons in 2D plane groups.
daisy Shows a meadow of daisies.
dclock Shows a floating digital clock or message.
deco Shows art as ugly as sin.
demon Shows Griffeath's cellular automata.
dilemma Shows Lloyd's Prisoner's Dilemma simulation.
Shows various discrete maps.
dragon Shows Deventer's Hexagonal Dragons Maze.
drift Shows cosmic drifting flame fractals.
cage Shows the Impossible Cage, an Escher-like GL scene. May not be
available depending on how it was configured.
euler2d Shows a simulation of 2D incompressible inviscid fluid.
eyes Shows eyes following a bouncing grelb.
Shows a fading plot of sine squared.
Shows a Fiber Optic Lamp.
fire Shows a 3D fire-like image. May not be available depending on
how it was configured.
flag Shows a waving flag image. This may be text or a graphic
image. Default text is the hostname and operating system.
flame Shows cosmic flame fractals.
flow Shows dynamic strange attractors.
forest Shows binary trees of a fractal forest.
fzort Shows a metallic-looking fzort.
galaxy Shows crashing spiral galaxies.
gears Shows GL's gears. May not be available depending on how it was
Animates texture mapped sphere (planet)
goop Shows goop from a lava lamp.
grav Shows orbiting planets.
helix Shows string art.
hop Shows real plane iterated fractals.
hyper Shows spinning n-dimensional hypercubes.
ico Shows a bouncing polyhedron.
ifs Shows a modified iterated function system.
image Shows randomly appearing logos.
juggle Shows a Juggler, juggling.
juggle Shows a 3D Juggler, juggling.
julia Shows the Julia set.
kaleid Shows Brewster's Kaleidoscope.
kumppa Shows kumppa.
laser Shows spinning lasers.
life Shows Conway's game of life.
life1d Shows Wolfram's game of 1D life.
life3d Shows Bays' game of 3D life.
Shows Keith's fractal lightning bolts.
lisa Shows animated lissajous loops.
lissie Shows lissajous worms.
loop Shows Langton's self-producing loops.
Shows mandelbrot sets.
marquee Shows text.
matrix Shows the matrix.
maze Shows a random maze and a depth first search solution.
moebius Shows the Moebius Strip II, an Escher-like GL scene with ants.
May not be available depending on how it was configured.
Draws molecules, based on coordinates from PDB (Protein Data
morph3d Shows GL morphing polyhedra. May not be available depending on
how it was configured.
Shows Papo's mountain range.
munch Shows munching squares.
noof Shows SGI Diatoms.
nose Shows a man with a big nose runs around spewing out text.
pacman Shows Pacman(tm).
penrose Shows Penrose's quasiperiodic tilings.
petal Shows various GCD Flowers.
petri Shows a mold simultation in a petri dish
pipes Shows a self-building pipe system. May not be available
depending on how it was configured.
Shows attempts to place polyominoes into a rectangle.
puzzle Shows a puzzle being scrambled and then solved.
pyro Shows fireworks.
pyro2 Shows other fireworks.
qix Shows spinning lines a la Qix(tm).
roll Shows a rolling ball.
rain Shows rain.
rotor Shows Tom's Roto-Rooter.
rubik Shows an auto-solving Rubik's Cube. May not be available
depending on how it was configured.
sballs Shows balls spinning like crazy in GL. May not be available
depending on how it was configured.
scooter Shows a journey through space tunnel and stars.
shape Shows stippled rectangles, ellipses, and triangles.
Shows a Sierpinski's triangle.
Shows a Sierpinski's gasket.
skewb Shows an auto-solving Skewb. May not be available depending on
how it was configured.
slip Shows slipping blits.
Shows Klondike's game of solitaire.
space Shows a journey into deep space.
sphere Shows a bunch of shaded spheres.
spiral Shows a helical locus of points.
spline Shows colorful moving splines.
Shows Sproingies! Nontoxic. Safe for pets and small children.
May not be available depending on how it was configured.
stairs Shows Infinite Stairs, an Escher-like GL scene. May not be
available depending on how it was configured.
star Shows a star field with a twist.
strange Shows strange attractors.
Shows 3D mathematical shapes. May not be available depending
on how it was configured.
swarm Shows a swarm of bees following a wasp.
swirl Shows animated swirling patterns.
t3d Shows a Flying Balls Clock Demo.
tetris Shows an autoplaying tetris game.
text3d | text3d2
Shows 3D moving texts.
Shows an animated Bird in a Thorn Bush fractal map.
tik_tak Shows rotating polygons.
Shows Peter Schat's toneclock.
Shows a triangular mountain range.
tube Shows an animated tube.
turtle Shows turtle fractals.
vines Shows fractal-like vines.
voters Shows Dewdney's Voters.
wator Shows Dewdney's Water-Torus planet of fish and sharks.
wire Shows a random circuit with 2 electrons.
world Shows spinning Earths.
worm Shows wiggly worms.
xjack Shows Jack having one of those days.
xcl Shows a Control Line combat model race
blank Shows nothing but a black screen. Does not show up in random
bomb Shows a bomb and will autologout after a time. Does not show
up in random mode and may be available depending on how it was
random Shows a random mode from above except blank (and bomb).
The delay option sets the speed at which a mode will operate. It
simply sets the number of microseconds to delay between batches of
animations. In blank mode, it is important to set this to some
small number of seconds, because the keyboard and mouse are only
checked after each delay, so you cannot set the delay too high,
but a delay of zero would needlessly consume cpu checking for
mouse and keyboard input in a tight loop, since blank mode has no
work to do.
The batchcount option sets number of things to do per batch to num
In anenome mode it is means nothing.
In ant and ant3d modes this refers the number of ants.
In apollonian mode it is the number of possible ways to imbed cirâ
cles within a circle, all of integer curvature.
In atlantis mode it is the number of sharks.
In atunnels mode it is means nothing.
In ball mode it is the number of balls.
In bat mode it is the number of bats, could be less because of
In blot mode this refers to the number of pixels rendered in the
In bouboule mode it is the number of stars.
In bounce mode it is the number of balls, could be less because of
In braid mode it is the upper bound number of strands.
In bubble mode it is the number of bubbles.
In bubble3d mode it is the number of bubbles.
In bug mode it is the number of bugs, could be less because of
In cage mode it is means nothing.
In clock mode it is the percentage of the screen, but less than
In coral mode it is the number of seeds.
In crystal mode it is the number of polygons.
In daisy mode it is the number flowers that make a meadow.
In dclock mode it means nothing.
In deco mode it is the depth.
In demon mode this refers the number of colors.
In dilemma mode this refers the number of initial defectors.
In discrete mode it is the number of points.
In drift mode it is the number of levels to recurse (larger = more
In dragon mode it means nothing.
In euler2d mode it is the number of segments.
In eyes mode it is the number of eyes.
In fadeplot mode it is the number of steps.
In fiberlamp it is the number of fibers.
In fire mode it is the number of fire particles (set it to 0 to
In flag mode it means nothing.
In flame mode it is the number of levels to recurse (larger = more
In flow mode it is the number of bees.
In forest mode it is the number trees that make a forest.
In fzort mode it means nothing.
In galaxy mode it means the number of galaxies.
In gears mode it is the number of degrees to rotate the set of
In glplanet mode it is the number of hundredth degrees to roll the
In goop mode it is the number of blobs per plane.
In grav mode it is the number of planets.
In helix mode it means nothing.
In hop mode this refers to the number of pixels rendered in the
In hyper mode it the number of dimensions.
In ico mode it is the ith platonic solid.
In ifs mode it means nothing.
In image mode it means it is the number of logos on screen at
In juggle mode it is time in milliseconds between a throw and the
In juggler3d mode it is time in milliseconds between a throw and
the next catch.
In julia mode it is the depth of recursion.
In kaleid mode it is the number of pens.
In kumppa mode it means nothing.
In lament mode it means nothing.
In laser mode it is the number lasers.
In life and life3d modes it is the number of generations before a
glider is introduced.
In life1d mode it means nothing.
In lisa mode it is the number of loops.
In lissie mode it is the number of worms.
In loop mode it is the number of flaws.
In mandelbrot mode it is the order.
In marquee mode it means nothing.
In matrix mode it means nothing.
In maze mode it means nothing.
In moebius mode it is means nothing.
In molecule mode it means nothing.
In morph3d mode it is the ith platonic solid.
In mountain mode it is the number of mountains.
In munch mode it means nothing.
In noof mode it means nothing.
In nose mode it means nothing.
In qix mode it is the number of points.
In pacman mode it means the number of ghosts.
In penrose mode it means nothing.
In petal mode it the greatest random number of petals.
In petri mode it means nothing.
In pipes mode it shows different joints, 0 random, 1 spherical, 2
bolted elbow, 3 elbow, and 4 alternating.
In polyominoes mode it means nothing.
In puzzle mode it the number of moves.
In pyro mode it is the maximum number flying rockets at one time.
In pyro2 mode it is means nothing.
In rain mode it is means nothing.
In roll mode it is the number of points.
In rotor mode it is the number of rotor thingys which whirr...
In rubik mode it is the number of moves.
In sballs mode it is the number of spheres.
In scooter mode it is the number of doors.
In shape mode it means nothing.
In sierpinski mode it is the number of points.
In skewb mode it is the number of moves.
In slip mode it means nothing.
In solitaire mode it means nothing.
In space mode it is the number of stars.
In sphere mode it means nothing.
In spiral mode it is the number of spirals.
In spline mode it is the number of points "splined".
In sproingies mode it is the number of sproingies.
In stairs mode it is means nothing.
In star mode it is the number of stars on the screen at once.
In starfish mode it means nothing.
In strange mode it means nothing.
In superquadrics mode its the number of horizontal and vertical
lines in the superquadric.
In swirl mode it means the number of "knots".
In swarm mode it is the number of bees.
In t3d mode it means nothing.
In tetris mode it means nothing.
In text3d mode it means nothing.
In thornbird mode it is the number of points.
In triangular mode it is the number of mountains.
In tube mode it is a rectangle (= 1), an ellipse (= 2), or a polyâ
gon if greater.
In turtle mode it means nothing.
In vines mode it is draw a complete vine (= 0) or a portion (= 1).
In voters mode it means the number of parties, 2 or 3.
In wator mode it means the breed time for the fish.
In wire mode it means the length of the circuit.
In world mode it is the number of worlds.
In worm mode it is the number of worms.
In xcl mode it represents the number of planes.
In xjack mode it means nothing.
In blank mode it means nothing.
In bomb mode it means the number of minutes to autologout.
A negative count allows for randomness. The range from the miniâ
mum allowed nonnegative count for a particular mode to the ABS(
count ) (or maximum allowed count , whichever is less).
The batchcount option is deprecated but should still work as
The cycles option sets the number of cycles until time out for
ant, ant3d, apollonian, blot, braid, bug, clock, crystal, daisy,
deco, demon, dilemma, discrete, dragon, eyes, fiberlamp, flag,
flow, forest, galaxy, helix, hop, hyper, ico, juggle, juggler3d,
laser, life, life1d, life3d, lisa, lissie, loop, mandelbrot, mounâ
tain, petal, sierpinski, shape, spline +erase, t3d, thornbird,
triangle, tube, voters, wator, and wire. For euler2d and worm it
is the length of the lines, for atlantis it is the shark speed,
for fadeplot, julia and spiral it is the length of the trail of
dots, munch it is the minimum size of the squares, for kaleid it
is the % of black, for qix it is the number of lines, for spline
-erase it means the number of splines * 64 (for compatibility with
+erase), for gears it is the number of degrees to increment the
spin of each gear by, for glplanet it is the number of hundredth
degrees to rotate the planet by, for molecule it is the time in
seconds until timeout, for pipes it is the number of systems to
draw before clearing the screen, for rubik it is the number of
steps to complete a 90 degree move, for sballs it is the sphere
speed value, for scooter it is the speed, for skewb it is the numâ
ber of steps to complete a 120 degree move, for superquadrics it
is the number of frames it takes to morph from one shape to
another. for text3d it is the number of times drawing a word
before the next one, For others it means nothing.
The size option sets the size maximum size of a star in bouboule,
pyro and star, size of ball in ball and bounce, size of bat in
bat, maximum size of bubble in bubble, size of clock in clock,
minimum size of rectangles in deco, size of the polygons in crysâ
tal, tik_tak, and toneclock, size of polyhedron in ico, size of
lissie in lissie, size of dots of flag, for kaleid it is the symâ
metry, width of maze hallway, size of side of penrose tile, radius
of loop in lisa, radius of ball in roll, number of corners in
sierpinski, number of stars in scooter, size of tube in tube,
width of worm in worm, line width in rotor, size of cells in ant,
bug, dilemma, dragon, life, life1d, pacman, petri, tetris, voters,
wator, and wire. In pipes it is the maximum length of a system.
In flow and swarm it is the length of the lines. In atlantis it
is the shark size. A negative number allows for randomness, simiâ
lar to count. In atunnels, fire, gears, sballs and sproingies it
is the size of the screen (default 400), this is because on many
slow systems it runs too slow when the picture covers the full
screen. Set to 0 for full screen on fast machines.
The ncolors option sets the maximum number of colors to be used.
The saturation option sets saturation of the color ramp used to
value . 0 is grayscale and 1 is very rich color. 0.4 is a nice
As of this writing there are over 12 erase modes supported (if its
not chosen its assumed random). The erase modes are random_lines,
random_squares, venetian, triple_wipe, quad_wipe, circle_wipe,
three_circle_wipe, squaretate, fizzle, spiral, slide_lines,
losira, no_fade. modename is now similar to the option modelist
where you can it can be something like "all-losira" to get all
erasemodes but losira. Use a "+" or a "," to add modes like "spiâ
The erasedelay option sets the number of microseconds for steps of
the erasemode (a setting of 0 and the erasemode is bypassed).
The nolock option causes xlock to only draw the patterns and not
lock the display. A key press or a mouse click will terminate the
Runs xlock in a window, so that you can iconify, move, or resize
it and still use your screen for other stuff. When running in a
window, xlock no longer locks your screen, it just looks good.
Runs xlock in your root window. Like the inwindow option it no
longer locks the screen, it just looks good.
The remote option tells xlock to not stop you from locking remote
X11 servers. This option should be used with care and is intended
mainly to lock X11 terminals which cannot run xlock locally. If
you lock someone else's workstation, they will have to know your
password to unlock it. Using +remote overrides any resource
derived values for remote and prevents xlock from being used to
lock other X11 servers. (Use `+' instead of `-' to override
resources for other options that can take the `+' modifier simiâ
The mono option causes xlock to display monochrome, (black and
white) pixels rather than the default colored ones on color disâ
This option is required for servers which do not allow clients to
modify the host access control list. It is also useful if you
need to run x clients on a server which is locked for some reaâ
son... When allowaccess is true, the X11 server is left open for
clients to attach and thus lowers the inherent security of this
lock screen. A side effect of using this option is that if xlock
is killed -KILL, the access control list is not lost.
This option is used on a XFree86 system to manage VT switching in
off means no VT switch locking.
switch means VT switch locking + switching to xlock VT when actiâ
restore means VT switch locking + switching to xlock VT when actiâ
vated + switching back to previous VT when desactivated.
noswitch means VT switch locking only when xlock VT is active.
The allowroot option allows the root password to unlock the server
as well as the user who started xlock. May not be able to turn
this on and off depending on your system and how xlock was configâ
Allows xlock to be debugged by doing all but locking the screen.
The description option causes xlock shows a mode description above
password window. The default is to show this description.
The echokeys option causes xlock to echo '?' characters (default)
for each key typed into the password prompt. Some consider this a
security risk, so the default is to not echo anything.
The text character to use for echo key in echokeys .
By default xlock will disable the normal X server's screen saver
since it is in effect a replacement for it. Since it is possible
to set delay parameters long enough to cause phosphor burn on some
displays, this option will turn back on the default screen saver
which is very careful to keep most of the screen black.
By default xlock will call XResetScreenSaver. This may be undeâ
sirable with DPMS monitors.
The grabmouse option causes xlock to grab the mouse and keyboard,
this is the default. xlock can not lock the screen without this.
The grabserver option causes xlock to grab the server. This is
not usually needed but some unsecure X servers can be defeated
Allows xlock to install its own colormap if xlock runs out of colâ
ors. May not work on with some window managers (fvwm) and does
not work with the -inroot option.
Allows you to turn on and off the sensitivity to the mouse to
bring up the password window.
Allows you to turn on and off sound if installed with the capabilâ
Allows you to turn on and off the date on password window. On by
Allows you to find out how long a machine is locked so you can
complain to an administrator that someone is hogging a machine.
The usefirst option causes xlock to use the keystroke which got
you to the password screen as the first character in the password.
The default is to ignore the first key pressed.
Verbose mode, tells what options it is going to use.
The nice option sets system nicelevel of the xlock process to
The lockdelay option sets the number of seconds before the screen
needs a password to be unlocked. Good for use with an autolocking
mechanism like xautolock(1).
The timeout option sets the number of seconds before the password
screen will time out.
The font option sets the font to be used on the prompt screen.
option sets the font to be used for the text that is displayed in
the lower part of the password screen.
The fg option sets the color of the text on the password screen to
The bg option sets the color of the background on the password
screen to color .
The foreground option sets the color of the text on the password
screen to color .
The background option sets the color of the background on the
password screen to color .
Text string is shown in front of user name, defaults to "Name: ".
Text string is the password prompt string, defaults to "Password:
Text string is an informational message to tell the user what to
do, defaults to "Enter password to unlock; select icon to lock.".
Text string is a message shown while validating the password,
defaults to "Validating login..."
Text string is a message shown when password is invalid, defaults
to "Invalid login."
The geometry option sets geom the size and offset of the lock winâ
dow (normally the entire screen). The entire screen format is
still used for entering the password. The purpose is to see the
screen even though it is locked. This should be used with caution
since many of the modes will fail if the windows are far from
square or are too small (size must be greater than 0x0). This
should also be used with -enablesaver to protect screen from phosâ
The icongeometry option sets geom the size of the iconic screen
(normally 64x64) seen when entering the password. This should be
used with caution since many of the modes will fail if the windows
are far from square or are too small (size must be greater than
0x0). The greatest size is 256x256. There should be some limit
so users could see who has locked the screen. Position informaâ
tion of icon is ignored.
The glgeometry option sets geom the size of the screen for gl
modes. Not normally available or needed.
Turn on/off wireframe, available on ant3d, atlantis, atunnels,
daisy, fire, gears, lament, life3d, mountain, sballs, sproingies,
superquadrics, and triangle.
Turn on/off frame per sec display, available on atlantis, atunâ
nels, bubble3d, cage, fire, gears, invert, lament, moebius,
morph3d, rubik, sballs, skewb, stairs, and superquadrics.
Turn on/off frame per sec display on top of screen, used if
showfps is on.
The fpsfont option sets the font to be used in the frame per sec
display, used if showfps is on.
Turn on/off 3d view, available on bouboule, pyro, star, and worm.
Space between the center of your 2 eyes for 3d mode.
Color used for empty size in 3d mode.
Color used for right eye in 3d mode.
Color used for left eye in 3d mode.
Color used for overlapping images for left and right eye in 3d
The program option sets the program to be used as the fortune genâ
erator. Currently used only for marquee and nose modes.
The messagesfile option sets the file to be used as the fortune
generator. The first entry is the number of fortunes, the next
line contains the first fortune. Fortunes begin with a "%%" on a
line by itself. Currently used only for marquee and nose modes.
If one exists, it takes precedence over the fortune program.
The messagefile option sets the file whose contents are displayed.
Currently used only for marquee and nose modes. If one exists, it
takes precedence over the fortune program and messagesfile.
The message option sets the text to be displayed in a mode. Curâ
rently used only for flag, marquee and nose modes. If one exists,
it takes precedence over the fortune program, messagesfile and
The messagefont option sets the font to be used in the mode. Curâ
rently used only for flag, marquee, and nose modes.
The bitmap option sets the xbm, xpm, or ras file to be displayed
with flag, image, life, life1d, maze, or puzzle mode. For eyes
and pacman only a xbm file is accepted. Certain modes reject the
bitmap if too big. /
MORE OPTIONS (these may not be available)
The cpasswd option sets the key to be this text string to unlock
xlock instead of password file.
The forceLogout option sets minutes to auto-logout.
The logoutButton option sets minutes to logoutButton is available
on password screen.
Text string is a message shown inside logout button when logout
button is displayed. Defaults to "Logout".
Text string is a message shown outside logout button when logout
button is displayed. Defaults to "Click the \"Logout\" button to
log out current\n user and make workstation available."
Text string is a message shown when a logout is attempted and
fails. Defaults to "Logout attempt FAILED.\n Current user could
not be automatically logged out."
Turn on/off CDE Saver Mode. This option is only available if CDE
support was compiled in.
Turn on/off Xinerama. This option is only available if Xinerama
support was compiled in.
The modulepath option sets the directories that xlock searches for
mode modules to load. It is a colon separated list of directories
to search. If "%S" is included in the path, it is replaced by the
default modulepath. To add a private module directory to the
default path, use something like '%S:~/mymoduledir' as the path.
This option is only available if module support was compiled in.
Text string references sound to use at lock time. Default sound,
male voice: "Thank you, for your cooperation."
Text string references sound to use for information. Default
sound, male voice: "Identify please."
Text string references sound to when a password is valid. Default
sound, female voice: "Complete."
Text string references sound to when a password is invalid.
Default sound, female voice: "I am not programmed to give you that
Text string command to execute when the screen is locked. Commonly
used instructions include: "zaway". This command, if still running
when the screensaver exits, will be killed.
Text string command to execute when the screen is unlocked.
Text string command into which to pipe the password when the
screen is unlocked.
Text string command to execute when the program logs the user out
(either via the autologout or by pressing the logout button).
Text string command to execute when the program to check mail.
Text string of file for the "mail arrived" bitmap.
Text string of file for the "no mail" bitmap.
Allows one to set DPMS Standby for monitor (0 is defined as infiâ
nite). (Horizontal sync on, Vertical sync off, RGB guns off,
power supply on, tube filaments energized, (screen saver mode).
Typical 17 inch screen... 110 out of 120 watts with a 3 sec
recovery time.) This option is only available if DPMS support was
compiled in. Minimum timeout is 5 seconds.
Allows one to set DPMS Suspend for monitor (0 is defined as infiâ
nite). (Horizontal sync off, Vertical sync on, RGB guns off,
power supply off, tube filaments energized. Typical 17 inch
screen ... 15 out of 120 watts with a 3 sec recovery time.) This
option is only available if DPMS support was compiled in. Minimum
timeout is 5 seconds.
Allows one to set DPMS Power Off for monitor (0 is defined as
infinite). (Horizontal sync off, Vertical sync off, Small auxilâ
iary circuit stays on to monitor the HS/VS signals to enable power
on when data needs to be displayed on the screen. Typical 17 inch
screen ... 5 out of 120 watts with a 10 sec recovery time.) This
option is only available if DPMS support was compiled in. Minimum
timeout is 5 seconds.
SPECIAL MODE DEPENDENT OPTIONS
The neighbors option sets the number of neighbors of a cell to 3,
4, 6, 9 (may not have real mathematical meaning), or 12 for sevâ
eral automata modes (ant, bug, demon, dilemma, life, loop, voters,
wator, and wire) (bug and loop do not span this full range). Setâ
ting it to 0 typically randomizes this, except where bitmaps are
used (dilemma, life, voters, and wator).
Turn on and off eyes for ant, ant3d, and bug.
Turn on and off colour cycling in crystal, lyapunov, mandelbrot,
starfish, swirl, tetris, tik_tak, toneclock, and tube.
Turn on and off alternate space and number labeling in apollonian.
For ant and ant3d this turns on and off the labeling of the rule.
For life and life3d this turns on and off the labeling of the patâ
tern name and rule.
Turn on and off sequential allocation of colors in kaleid. For
life and life3d this turns on and off the picking of sequential
patterns (to be used with middle button of the mouse).
Turn on and off mouse interaction in eyes, fire, julia, solitaire,
sballs, swarm, and tetris. For maze, pacman, solitaire and tetris
this may not be available depending on how xlock was configured.
Turn on and off texturing in fire, lament and sballs. This may
not be available depending on how xlock was configured.
The rule string is defined as S<neighborhood>/B<neighborhood> for
life and life3d. Special parameters: P, picks a random rule from
all rules that have known patterns; G, picks a random rule from
all rules that have known gliders. For life a good example is
Conway's rule which is S23/B3. Others are B36/S23 and
B3678/S34678. For life3d good examples are Bay's rules which are
S45/B5, S567/B6, S56/B5, and S67/B67. The rule string is defined
as a binary string (requires at least one 1 and one 0) for ant and
a base 4 (or quadranary) string (requires 3 of 4 digits to be repâ
resented) for ant3d. Here a special parameter, T and then a numâ
ber, will pick a specific table.
The lifefile option sets the life and life3d lifeform. Only one
format is currently supported, similar to the #P xlife format.
For life3d, 2 linefeeds in a row are assumed to advance the depth.
Allows one to set the number of arms in anemone.
Allows one to set the width of the arms in anemone.
Allows one to set the final number of points in each array of
Allows one to set the withdraw frequency in
-turnspeed num Allows one to set the turning speed in
Turn on and off Truchet lines (trail) in ant.
Turn on and off alternate geometries (off euclidean space, on
includes spherical and hyperbolic) in apollonian mode.
Allows one to set the speed of the whales and dolphin in atlantis.
Turn on and off having the bubbles bubble up in bubble.
Allows one to set the number of unit cells in x-direction in crysâ
Allows one to set the number of unit cells in y-direction in crysâ
Turn on and off the centering on screen in crystal.
Turn on and off the centering on screen in crystal.
Turn on and off the drawing of unit cell in crystal.
Turn on and off the drwing of grid of unit cells (if -cell is on)
Turn off and on garden look in daisy.
Turn on and off the binary clock in dclock.
Turn on and off the led clock in dclock.
Turn on and off the population explosion counter in dclock.
Turn on and off the tropical deforest (hectares/acres) counter in
Turn on and off the HIV infection counter in dclock.
Turn on and off the Animal Research counter in dclock.
Turn on and off the Animal Consumation counter in dclock.
Turn on and off the Year 2000 countdown in dclock.
Turn on and off the Second Millennium (January 1, 2001) countdown
Allows one to set the bonus for cheating... between 1.0 and 4.0 in
Turn off and on self-awareness in dilemma.
Turn on and off growing fractals (else they are animated) for
Turn on and off using lissajous figures to get points for drift.
Turn on and off fog for fire.
Turn on and off shadows for fire.
Validate the displaying of trees for fire if greater than zero.
Turn on and off inverting of the flag.
Turn on/off rotating around attractor in flow.
Turn on/off rideing in the flow.
Turn on/off bounding box in flow.
Turn on/off periodic attractors in flow.
Turn on/off search for new attractors in flow.
Turn on/off double buffering in flow.
Turn on and off star tracks in galaxy.
Turn on and off lighting of the planet for glplanet.
Turn on and off bouncing movement of the planet for glplanet.
Use the named xbm or xpm file for texturing the planet for
glplanet. Use BUILTIN as filename for the builtin image taken
Turn on and off rolling of the planet for glplanet.
Turn on and off rotation of the planet for glplanet.
Turn on and off texturing of the planet for glplanet.
Turn on and off showing stars in the background for glplanet.
Turn on and off decaying orbits for grav.
Turn on and off decaying trail of dots for grav.
Turn on and off ellipse format in helix.
Turn on and off Barry Martin's square root hop. -/+popcorn Turn
on and off Clifford A. Pickover's popcorn hop.
Turn on and off Ed J. Kubaitis' hops.
Turn on and off Renaldo Recuerdo's hop.
Turn on and off Jong's hop.
Turn on and off Barry Martin's sine hop.
Allows one to set the pattern for juggle.
Minimum Trail Length for juggle.
Turn on/off real-time juggling for juggle. Deprecated. There
should be no need to turn off real-time juggling, even on slow
systems. Adjust speed using -count.
Turn on/off pattern descriptions in juggle.
Turn on/off Balls in juggle.
Turn on/off Clubs in juggle.
Turn on/off Flaming Torches in juggle.
Turn on/off Knives in juggle.
Turn on/off Rings in juggle.
Turn on/off Bowling Balls in juggle.
Turn on and off planetary gears in gears.
Sets the size of the screen for planetary option in gears. This
is for machines with slower CPU. (Set to 0 for full screen).
Turn on and off disconnected pen movement in kaleid.
Turn on and off alternate rotated display mode kaleid.
Turn on and off quad mirrored/rotated mode similar to size 4 in
Turn on and off oct mirrored/rotated mode similar to size 8 in
Turn on and off Cartesian/Polar coordinate mode in kaleid.
Turn on and off John Conway's original Life rule S23/B3 life.
Turn on and off David Bell's HighLife rule S23/B36 life.
Turn on and off Nathan Thompson's Day and Night rule S34678/B3678
Turn on and off Paul Callahan's S2b34/B2a hexagonal life.
Turn on and off Bob Andreen's S2a2b4a/B2a3a4b hexagonal life.
Turn on and off Carter Bays' S34/B45 triangular life.
Turn on and off Carter Bays' S45/B456 triangular life.
Turn on and off Carter Bays' S23/B45 triangular life.
Turn on and off totalistic rules for life1d. If this is off then
it follows rules of the LCAU collection. These rules may not be
symmetric and are more general.
Turn on and off additive functions mode in lisa.
Turn on and off disolving state in loop.
Turn on and off Evolving Loops in loop.
Turn on and off Langton Loops for loop.
Turn on and off sheath extension for loop.
Turn on and off wrapping of borders for loop.
Sets the option for increasing orders in mandelbrot.
Turn on and off interior displaying level of closest return in
Turn on and off binary decomposition color modulation in mandelâ
Turn on and off Distance Estimator Method (instead of escape time)
Turn on and off interior displaying iteration of closest return in
Turn on and off interior displaying according to an estimate of
the Lyapunov exponent in mandelbrot.
Turn on and off adding z^z in mandelbrot.
Turn on and off adding sin(z) in mandelbrot.
Turn off and on ants in moebius.
Turn on and off solid Mobius strip in moebius.
Turn on and off the drawing of spheres for the atoms in molecule.
Turn on and off showing the molecules in a blue box in molecule.
Turn on and off the drawing of the atomic bonds in molecule.
Read a molecule structure from a pdb file in molecule.
Turn on and off the labeling of the atoms in molecule.
Set the axis for molecule rotation in molecule. The default is
Turn off the molecule rotation in molecule.
Turn on and off the molecule description in molecule.
Turn on and off the moving of the molecule on a sinoid curve in
molecule. Turn on and off movements in fire.
Turn on and off lines for penrose.
Allows fine adjustments to order in mandelbrot.
Turn on and off erasing for spline. If this option is on, cycles
is divided by 64 to compute the number of lines, so as to be comâ
patible when using -fullrandom.
Number of extra factory parts in pipes.
Turn on if you want a zoomed-in view of pipes.
Turn on if you want the pipes to bend more often.
Turn on if you want the pipe system rotated in pipes.
Turn on or off complete graph morphing in qix.
Allows one to pass different explosion elements to pyro2. The
explosion types is one of &0, &1, ... &9, &a, ... &f each of which
presents a different type of explosion. Normal text can be sent,
the string may contain blanks if quoted. An operation system logo
will be shown, if the # sign is sent.
Allows one to pass different elements to pyro2.
Number represents the number of cubies on the x, y, or z axis.
Negative numbers offer randomness from 2 to the absolute value of
the number. star.
Turn on or off hidden shuffle phase for rubik and skewb.
Turn on or off borders in shape.
Turn on or off shadowing in shape.
Turn on or off stippling in shape.
Set the brightness (default 2185) of the sierpinski structure for
Set the maximum depth (up to 10) of the sierpinski structure for
Determines after how much steps the depth changes for sierpinâ
If its a high number you will see the space ship all the time in
Turn on and off rocks for star. If this is off, stars will be
Turn on if star gets you motion sick.
Set speed of cycling in starfish.
Set rotation velocity in starfish.
Set thickness in starfish.
Turn on and off blob for starfish.
Set speed of rotation, in degrees per frame for superquadrics.
Turn on in tetris to see 5 square bonus pieces.
Turn on in tetris to see welltris.
Sets the True Type font file (or font directory) used for text3d
Sets length of the text extrusion for text3d
Sets rotation amplitude value of each letter for text3d
Sets rotation frequency for text3d
Turn on and off word splitting for text3d
Sets the animation function used for text3d. Currently one of :
Random FullRandom Default Default2 None Crazy UpDown
Extrude RotateXY RotateYZ Frequency Amplitude
The speed for all planes in km/h for xcl.
The time for one frame on the screen. This time is used to calcuâ
late the delay time and depends on the speed of the X server for
The distance between the pilot and the plane for xcl.
The distance between spectator and pilot. It should be grater than
the line_length and the half wing width of the plane to be not
dangerous for the spectator for xcl.
Shows an animated view of one model for xcl.
Sets the colors for the first two planes fixed to red and yellow
Shows some additional timing information to make sure that the
calibrate procedure goes right in xcl.
The auto scale for automatic fit into the window is Deactivated
with this option for xcl.
Use a random start point for models at startup for xcl.
Allows one to set a duration for a mode in random. Duration of 0
is defined as infinite.
Turn on/off randomness options within modes in random. Not impleâ
mented for all mode options.
Allows one to pass a list of files to randomly display to random.
"all" will get all files but blank (and bomb if compiled in).
"all,blank" will get all modes. "all,-image bounce,+blank" will
get all modes excluding image and bounce modes. "bug wator" will
get only bug and wator. "allgl" will get only the GL modes if
compiled in, all-allgl will get all excluding the GL modes, "allâ
nice" will weed out high cpu usage modes (as well as hackers and
gl modes). "allxpm" will get all modes that use xpm. "allwrite"
will get all modes that take advantage of writable colormaps (not
including xpm). "all3d" will get all the modes that support this
option. "allmouse" will get all the modes that support mouse
interaction. Similarly, "allautomata" for automata modes, "allâ
fractal" for fractal modes, "allgeometry" for geometry modes,
"allspace" for space modes. The random mode itself can not be
Turn on non-random random option.
xlock can appear to hang if it is competing with a high-priority
process for the CPU. For example, if xlock is started after a process
with 'nice -20' (high priority), xlock will take considerable amount
of time to respond.
If the machine is using a shadow password system, then xlock may not be
set up to get the real password and so must be given one of its own.
This can be either on the command line, via the -cpasswd option, or in
the file $HOME/.xlockrc, with the first taking precedence. In both
cases an encrypted password is expected (see makekey(8)). If neither
is given, then xlock will prompt for a password and will use that, also
storing an encrypted version of it in $HOME/.xlockrc for future use.
XLOCK AND SSH-AGENT
If you use ssh-agent(1) to avoid entering a passphrase every time you
use one of your ssh(1) private keys, it's good security practice to
have ssh-agent forget the keys before you leave your terminal unatâ
tended. That way, an attacker who takes over your terminal won't be
able to use your private ssh keys to log in to other systems. Once you
return to your terminal, you can enter the passphrase and re-add the
keys to ssh-agent. There are a couple of ways in which xlock can help
to automate this process. Firstly, the startCmd option allows xlock to
be configured to run 'ssh-add -D' every time you lock the screen, so
that your keys are automatically deleted from ssh-agent. If the
passphrase on your ssh keys is the same as your password, then xlock
can also be made to re-add the keys to ssh-agent when you unlock the
screen, via the pipepassCmd option. This requires a bit of scripting,
as the command must read your password from standard input and then
automate the interaction with ssh-add to re-add the keys. There is an
example of such a script in the xlock distribution - see etc/xlockssh*
"kill -KILL xlock " causes the server that was locked to be unusable,
since all hosts (including localhost) were removed from the access conâ
trol list to lock out new X clients, and since xlock could not catch
SIGKILL, it terminated before restoring the access control list. This
will leave the X server in a state where "you can no longer connect to
that server, and this operation cannot be reversed unless you reset the
server." -From the X11R4 Xlib Documentation, Chapter 7.
NCD terminals do not allow xlock to remove all the hosts from the
access control list. Therefore you will need to use the "-remote" and
"-allowaccess" switches. If you happen to run without "-allowaccess"
on an NCD terminal, xlock will not work and you will need to reboot the
terminal, or simply go into the SETUP menus, under 'Network Parameâ
ters', and turn off TCP/IP access control.
X(1), Xlib Documentation.
David A. Bagley, <bagleyd AT verizon.net>
The latest version is currently at:
Patrick J. Naughton, <naughton AT eng.sun.com>
Sun Microsystems Laboratories, Inc.
Mountain View, CA 94043
with many additional contributors.
Copyright (c) 1988-1991 by Patrick J. Naughton
Copyright (c) 1993-2017 by David A. Bagley
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, proâ
vided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in supâ
This file is provided AS IS with no warranties of any kind. The author
shall have no liability with respect to the infringement of copyrights,
trade secrets or any patents by this file or any part thereof. In no
event will the author be liable for any lost revenue or profits or
other special, indirect and consequential damages.
The original BSD daemon is Copyright (c) 1988 Marshall Kirk McKusick.
All Rights Reserved.
DEC, HP, IBM, Linux, SCO, SGI, and Sun icons have their respective
X11R6 Contrib 23 March 2017 XLOCK(1)