XLOCK(1)

πŸ“¦ version 5.80, in opensuse-leap 16.0

✨ XLOCK(1) β€” General Commands Manual, but make it bestie ✨


πŸ’– NAME πŸ’–

xlock β€” locks the local X display until a password is entered. That's it, that's the whole vibe. πŸ”’


✨ SYNOPSIS ✨

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 ] [ -/+allowroot
] [ -/+debug ] [ -/+description ] [ -/+echokeys ] [ -echokey echokey ] [
-/+enablesaver ] [ -/+resetsaver ] [ -/+grabmouse ] [ -/+grabserver ] [
-/+install ] [ -/+mousemotion ] [ -/+sound ] [ -/+showdate ] [
-/+timeelapsed ] [ -/+usefirst ] [ -/+verbose ] [ -nice level ] [
-lockdelay seconds ] [ -timeout seconds ] [ -xkblockgroup layout ] [
-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 ]

🌸 DESCRIPTION 🌸

Okay so picture this: 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, Ctrl+U (Control-U) and Ctrl+H (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. Cute, right? πŸŽ€

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. Yes, it checks them in that order. πŸ’…

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 authentication styles.


πŸŽ€ NOTE ON ETIQUETTE πŸŽ€

Xlock should not be used on public terminals when there is a high demand for them. Like, read the room, bestie. πŸ™ˆ

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.


πŸ’… OPTIONS πŸ’…

  • -help β€” Print options and a brief description to standard output.
  • -version β€” Print version number (if >= 4.00) to standard output.
  • -resources β€” Print default resource file to standard output.
  • -display displayname β€” 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.
  • -visual visualname β€” visualname which is one of "StaticGray", "GrayScale", "StaticColor", "PseudoColor", "TrueColor", "DirectColor", or "default". default is used to set the screen's default visual (the visual of the root window).
  • -name resourcename β€” resourcename is used instead of XLock when looking for resources to configure xlock.
  • -mode modename β€” As of this writing there are over 90 display modes supported (plus one more for random selection of one of these).

Here's the whole mode menu, no cap:

  • anemone β€” Shows wiggling tentacles.
  • ant β€” Shows Langton's and Turk's generalized ants.
  • ant3d β€” Shows 3D ants.
  • apollonian β€” Shows Apollonian circles.
  • atlantis β€” Shows moving sharks/whales/dolphin. May not be available depending on how it was configured.
  • atunnels β€” Advance GL tunnels screensaver. May not be available depending on how it was configured.
  • ball β€” Shows bouncing balls.
  • bat β€” Shows bouncing flying bats.
  • bevel β€” Shows an auto-solving Bevel or Helicopter Cube. May not be available depending on how it was configured.
  • blot β€” Shows Rorschach's ink blot test.
  • bouboule β€” Shows Mimi's bouboule of moving stars.
  • bounce β€” Shows bouncing footballs.
  • boxed β€” Shows GL's boxed balls.
  • braid β€” Shows random braids and knots.
  • bubble β€” Shows popping bubbles.
  • bubble3d β€” Shows Richard Jones's GL bubbles. May not be available depending 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.
  • dino β€” Shows an auto-solving Dinosaur Cube. May not be available depending on how it was configured.
  • discrete β€” 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.
  • fadeplot β€” Shows a fading plot of sine squared.
  • fiberlamp β€” 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 configured.
  • glplanet β€” 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.
  • lightning β€” Shows Keith's fractal lightning bolts.
  • lisa β€” Shows animated lissajous loops.
  • lissie β€” Shows lissajous worms.
  • loop β€” Shows Langton's self-producing loops.
  • mandelbrot β€” Shows mandelbrot sets.
  • marquee β€” Shows text.
  • matrix β€” Shows the matrix.
  • maze β€” Shows a random maze and a depth first search solution.
  • mball β€” Shows an auto-solving Masterball puzzle. May not be available depending on how it was configured.
  • moebius β€” Shows the Moebius Strip II, an Escher-like GL scene with ants. May not be available depending on how it was configured.
  • molecule β€” Draws molecules, based on coordinates from PDB (Protein Data Base) files.
  • morph3d β€” Shows GL morphing polyhedra. May not be available depending on how it was configured.
  • mountain β€” 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.
  • oct β€” Shows an auto-solving octahedron puzzle. May not be available depending on how it was configured.
  • 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.
  • polyominoes β€” Shows attempts to place polyominoes into a rectangle.
  • puzzle β€” Shows a puzzle being scrambled and then solved.
  • pyraminx β€” Shows an auto-solving Pyraminx puzzle. May not be available depending on how it was configured.
  • 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.
  • sierpinski β€” Shows a Sierpinski's triangle.
  • sierpinski3d β€” 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.
  • solitaire β€” 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.
  • sproingies β€” 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.

okay so the mode roster keeps rolling, and it’s giving ✨ variety show ✨:

  • starfish β€” Shows starfish. That’s it. That’s the gig. Iconic.
  • strange β€” Shows strange attractors. Spooky math slay.
  • superquadrics β€” Shows 3D mathematical shapes. Heads up: may not be available depending on how it was configured.
  • swarm β€” Shows a swarm of bees following a wasp. The drama of it all.
  • swirl β€” Shows animated swirling patterns.
  • t3d β€” Shows a Flying Balls Clock Demo.
  • tetris β€” Shows an autoplaying tetris game.
  • text3d | text3d2 β€” Shows 3D moving texts.
  • thornbird β€” Shows an animated Bird in a Thorn Bush fractal map.
  • tik_tak β€” Shows rotating polygons.
  • toneclock β€” Shows Peter Schat's toneclock.
  • triangle β€” 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 mode.
  • 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 configured.
  • random β€” Shows a random mode from above except blank (and bomb).

  • -delay usecs β€” 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.

  • -count num β€” The batchcount option sets number of things to do per batch to num. Here’s the mode-by-mode tea, bestie:
    • anenome β€” means nothing.
    • ant and ant3d β€” the number of ants.
    • apollonian β€” the number of possible ways to embed circles within a circle, all of integer curvature.
    • atlantis β€” the number of sharks.
    • atunnels β€” means nothing.
    • ball β€” the number of balls.
    • bat β€” the number of bats, could be less because of conflicts.
    • bevel β€” the number of moves.
    • blot β€” the number of pixels rendered in the same color.
    • bouboule β€” the number of stars.
    • bounce β€” the number of balls, could be less because of conflicts.
    • braid β€” the upper bound number of strands.
    • bubble β€” the number of bubbles.
    • bubble3d β€” the number of bubbles.
    • bug β€” the number of bugs, could be less because of conflicts.
    • cage β€” means nothing.
    • clock β€” the percentage of the screen, but less than 100%.
    • coral β€” the number of seeds.
    • crystal β€” the number of polygons.
    • daisy β€” the number flowers that make a meadow.
    • dclock β€” means nothing.
    • deco β€” the depth.
    • demon β€” the number of colors.
    • dilemma β€” the number of initial defectors.
    • dino β€” the number of moves.
    • discrete β€” the number of points.
    • drift β€” the number of levels to recurse (larger = more complex).
    • dragon β€” means nothing.
    • euler2d β€” the number of segments.
    • eyes β€” the number of eyes.
    • fadeplot β€” the number of steps.
    • fiberlamp β€” the number of fibers.
    • fire β€” the number of fire particles (set it to 0 to have rain).
    • flag β€” means nothing.
    • flame β€” the number of levels to recurse (larger = more complex).
    • flow β€” the number of bees.
    • forest β€” the number trees that make a forest.
    • fzort β€” means nothing.
    • galaxy β€” the number of galaxies.
    • gears β€” the number of degrees to rotate the set of gears by.
    • glplanet β€” the number of hundredth degrees to roll the planet by.
    • goop β€” the number of blobs per plane.
    • grav β€” the number of planets.
    • helix β€” means nothing.
    • hop β€” the number of pixels rendered in the same color.
    • hyper β€” the number of dimensions.
    • ico β€” the ith platonic solid.
    • ifs β€” means nothing.
    • image β€” it is the number of logos on screen at once.
    • juggle β€” time in milliseconds between a throw and the next catch.
    • juggler3d β€” time in milliseconds between a throw and the next catch.
    • julia β€” the depth of recursion.
    • kaleid β€” the number of pens.
    • kumppa β€” means nothing.
    • lament β€” means nothing.
    • laser β€” the number lasers.
    • life and life3d β€” the number of generations before a glider is introduced.
    • life1d β€” means nothing.
    • lisa β€” the number of loops.
    • lissie β€” the number of worms.
    • loop β€” the number of flaws.
    • mandelbrot β€” the order.
    • marquee β€” means nothing.
    • matrix β€” means nothing.
    • maze β€” means nothing.
    • mball β€” the number of moves.
    • moebius β€” means nothing.
    • molecule β€” means nothing.
    • morph3d β€” the ith platonic solid.
    • mountain β€” the number of mountains.
    • munch β€” means nothing.
    • noof β€” means nothing.
    • nose β€” means nothing.
    • qix β€” the number of points.
    • oct β€” the number of moves.
    • pacman β€” means the number of ghosts.
    • penrose β€” means nothing.
    • petal β€” the greatest random number of petals.
    • petri β€” means nothing.
    • pipes β€” shows different joints, 0 random, 1 spherical, 2 bolted elbow, 3 elbow, and 4 alternating.
    • polyominoes β€” means nothing.
    • puzzle β€” the number of moves.
    • pyraminx β€” the number of moves.
    • pyro β€” the maximum number flying rockets at one time.
    • pyro2 β€” means nothing.
    • rain β€” means nothing.
    • roll β€” the number of points.
    • rotor β€” the number of rotor thingys which whirr...
    • rubik β€” the number of moves.
    • sballs β€” the number of spheres.
    • scooter β€” the number of doors.
    • shape β€” means nothing.
    • sierpinski β€” the number of points.
    • skewb β€” the number of moves.
    • slip β€” means nothing.
    • solitaire β€” means nothing.
    • space β€” the number of stars.
    • sphere β€” means nothing.
    • spiral β€” the number of spirals.
    • spline β€” the number of points "splined".
    • sproingies β€” the number of sproingies.
    • stairs β€” means nothing.
    • star β€” the number of stars on the screen at once.
    • starfish β€” means nothing.
    • strange β€” means nothing.
    • superquadrics β€” the number of horizontal and vertical lines in the superquadric.
    • swirl β€” the number of "knots".
    • swarm β€” the number of bees.
    • t3d β€” means nothing.
    • tetris β€” means nothing.
    • text3d β€” means nothing.
    • thornbird β€” the number of points.
    • triangular β€” the number of mountains.
    • tube β€” a rectangle (= 1), an ellipse (= 2), or a polygon if greater.
    • turtle β€” means nothing.
    • vines β€” draw a complete vine (= 0) or a portion (= 1).
    • voters β€” the number of parties, 2 or 3.
    • wator β€” the breed time for the fish.
    • wire β€” the length of the circuit.
    • world β€” the number of worlds.
    • worm β€” the number of worms.
    • xcl β€” the number of planes.
    • xjack β€” means nothing.
    • blank β€” means nothing.
    • bomb β€” the number of minutes to autologout.

And yes, bestie: a negative count allows for randomness. The range goes from the minimum allowed nonnegative count for a particular mode to the ABS( count ) (or maximum allowed count, whichever is less). πŸ’…

  • -batchcount num β€” The batchcount option is deprecated but should still work as count. 🫢
  • -cycles num β€” okay so this one is like the ✨main character✨ of "it depends on the mode" options πŸ’…. It 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, mountain, petal, sierpinski, shape, spline +erase, t3d, thornbird, triangle, tube, voters, wator, and wire. And then it gets so specific, buckle up buttercup πŸŽ€:
    • for atlantis it is the shark speed 🦈
    • for bevel it is the number of steps to complete a 180 degree move
    • for dino it is the number of steps to complete a move of 120 or 180 degrees
    • for euler2d and worm it is the length of the lines
    • for fadeplot, julia and spiral it is the length of the trail of dots
    • for 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 mball it is the number of steps to complete a turn
    • for molecule it is the time in seconds until timeout
    • for oct it is the number of steps to complete a move of 90 or 120 degrees
    • for pipes it is the number of systems to draw before clearing the screen
    • for pyraminx it is the number of steps to complete a move of 120 or 180 degrees
    • 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 number 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. Bestie that is genuinely the entire list, I did not skip a single one 🫢.

  • -size num β€” 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 crystal, tik_tak, and toneclock, size of polyhedron in ico, size of lissie in lissie, size of dots of flag, for kaleid it is the symmetry, 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 🦈. In mball it is the number of bands. In pyraminx, oct, and rubik it is size the puzzle. A negative number allows for randomness, similar 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 πŸ”₯.
  • -ncolors num β€” sets the maximum number of colors to be used. That's it, that's the whole vibe 🌈.
  • -saturation value β€” sets saturation of the color ramp used to value. 0 is grayscale and 1 is very rich color. 0.4 is a nice pastel πŸŽ€ (pastel girlies stay winning).
  • -erasemode modename β€” 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 "spiral+venetian" ✨.
  • -erasedelay usecs β€” sets the number of microseconds for steps of the erasemode (a setting of 0 and the erasemode is bypassed) πŸ’€.
  • +/-nolock β€” 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 screen saver. Lowkey just a vibe generator at that point πŸ¦‹.
  • -/+inwindow β€” 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. Main character energy, zero security ✨.
  • -/+inroot β€” runs xlock in your root window. Like the inwindow option it no longer locks the screen, it just looks good 🌸.
  • -/+remote β€” 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 similarly.)
ngl bestie, that remote one is a whole warning label. Read it twice πŸ’€
  • -/+mono β€” causes xlock to display monochrome, (black and white) pixels rather than the default colored ones on color displays πŸ–€πŸ€.
  • -/+allowaccess β€” 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 reason... 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.
  • -vtlock modename β€” used on a XFree86 system to manage VT switching in [off|noswitch|switch|restore] mode:
    • off β€” means no VT switch locking.
    • switch β€” means VT switch locking + switching to xlock VT when activated.
    • restore β€” means VT switch locking + switching to xlock VT when activated + switching back to previous VT when deactivated.
    • noswitch β€” means VT switch locking only when xlock VT is active.
  • -/+allowroot β€” 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 configured.
  • -/+debug β€” allows xlock to be debugged by doing all but locking the screen πŸ”. Fr fr the "do everything except the scary part" mode.
  • -/+description β€” causes xlock shows a mode description above password window. The default is to show this description.
  • -/+echokeys β€” 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 πŸ™ˆ.
  • -echokey echokey β€” the text character to use for echo key in echokeys.
  • -/+enablesaver β€” 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.
  • -/+resetsaver β€” by default xlock will call XResetScreenSaver. This may be undesirable with DPMS monitors.
  • -/+grabmouse β€” causes xlock to grab the mouse and keyboard, this is the default. xlock can not lock the screen without this πŸ–±οΈβŒ¨οΈ.
  • -/+grabserver β€” causes xlock to grab the server. This is not usually needed but some unsecure X servers can be defeated without this πŸ‘€.
  • -/+install β€” allows xlock to install its own colormap if xlock runs out of colors. May not work on with some window managers (fvwm) and does not work with the -inroot option.
  • -/+mousemotion β€” allows you to turn on and off the sensitivity to the mouse to bring up the password window 🐭.
  • -/+sound β€” allows you to turn on and off sound if installed with the capability πŸ”Š.
  • -/+showdate β€” allows you to turn on and off the date on password window. On by default πŸ“….
  • -/+timeelapsed β€” allows you to find out how long a machine is locked so you can complain to an administrator that someone is hogging a machine 😀 periodt.
  • -/+usefirst β€” 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 β€” verbose mode, tells what options it is going to use πŸ—£οΈβœ¨.
  • -nice nicelevel β€” sets system nicelevel of the xlock process to nicelevel.
  • -lockdelay seconds β€” sets the number of seconds before the screen needs a password to be unlocked. Good for use with an autolocking mechanism like xautolock(1) πŸ•°οΈ.
  • -timeout seconds β€” sets the number of seconds before the password screen will time out.
  • -font fontname β€” sets the font to be used on the prompt screen πŸŽ€.
  • -planfont fontname β€” option sets the font to be used for the text that is displayed in the lower part of the password screen.
  • -fg color β€” sets the color of the text on the password screen to color.
  • -bg color β€” sets the color of the background on the password screen to color.
  • -foreground color β€” sets the color of the text on the password screen to color.
  • -background color β€” sets the color of the background on the password screen to color.
yeah bestie -fg/-bg and -foreground/-background are literally the same thing twice, they said it, not me πŸ’…
  • -username string β€” text string is shown in front of user name, defaults to "Name: ".
  • -password string β€” text string is the password prompt string, defaults to "Password: ".
  • -info string β€” text string is an informational message to tell the user what to do, defaults to "Enter password to unlock; select icon to lock.".
  • -validate string β€” text string is a message shown while validating the password, defaults to "Validating login..." ⏳
  • -invalid string β€” this is the message that shows when the password is invalid, and it defaults to "Invalid login." πŸ’…
  • -geometry geom β€” sets geom as the size and offset of the lock window (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. Use this with caution, bestie: 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 the screen from phosphor burn. πŸ”₯
  • -icongeometry geom β€” sets geom as the size of the iconic screen (normally 64x64) seen when entering the password. Use with caution: many modes will fail if the windows are far from square or 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 information of the icon is ignored. πŸŽ€
  • -glgeometry geom β€” sets geom as the size of the screen for gl modes. Not normally available or needed. ✨
  • -/+wireframe β€” turns wireframe on/off, available on ant3d, atlantis, atunnels, daisy, fire, gears, lament, life3d, mountain, sballs, sproingies, superquadrics, and triangle.
  • -/+showfps β€” turns the frame per sec display on/off, available on atlantis, atunnels, bevel, dino, bubble3d, cage, fire, gears, invert, lament, moebius, morph3d, mball, oct, pyraminx, rubik, sballs, skewb, stairs, and superquadrics.
  • -/+fpstop β€” turns the frame per sec display on top of the screen on/off, used if showfps is on.
  • -fpsfont fontname β€” sets the font used in the frame per sec display, used if showfps is on. πŸ¦‹
  • -/+use3d β€” turns the 3d view on/off, available on bouboule, pyro, star, and worm.
  • -delta3d value β€” the space between the center of your 2 eyes for 3d mode. πŸ‘€
  • -none3d color β€” the color used for empty size in 3d mode.
  • -right3d color β€” the color used for the right eye in 3d mode.
  • -left3d color β€” the color used for the left eye in 3d mode.
  • -both3d color β€” the color used for overlapping images for the left and right eye in 3d mode.
  • -program programname β€” sets the program to be used as the fortune generator. Currently used only for marquee and nose modes. 🌸
  • -messagesfile formatted-filename β€” 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. πŸ“
  • -messagefile filename β€” 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.
  • -message textstring β€” sets the text to be displayed in a mode. Currently used only for flag, marquee and nose modes. If one exists, it takes precedence over the fortune program, messagesfile and message. No cap, that’s literally what it says. 😭
  • -messagefont fontname β€” sets the font to be used in the mode. Currently used only for flag, marquee, and nose modes.
  • -bitmap filename β€” 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. / β€” yes, the source has a stray slash here, preserving it πŸ’€

🌈 MORE OPTIONS (these may not be available) 🌈

  • -cpasswd crypted-password β€” sets the key to be this text string to unlock xlock instead of the password file. πŸ”
  • -forceLogout minutes β€” sets minutes to auto-logout.
  • -logoutButton minutes β€” sets minutes to when logoutButton is available on the password screen.
  • -logoutButtonLabel string β€” text string shown inside the logout button when the logout button is displayed. Defaults to "Logout".
  • -logoutButtonHelp string β€” text string shown outside the logout button when the logout button is displayed. Defaults to "Click the \"Logout\" button to log out current\n user and make workstation available."
  • -logoutFailedString string β€” text string shown when a logout is attempted and fails. Defaults to "Logout attempt FAILED.\n Current user could not be automatically logged out."
  • -/+dtsaver β€” turns CDE Saver Mode on/off. This option is only available if CDE support was compiled in.
  • -/+xinerama β€” turns Xinerama on/off. This option is only available if Xinerama support was compiled in.
  • -modulepath path β€” 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. 🧚
  • -locksound string β€” text string references the sound to use at lock time. Default sound, male voice: "Thank you, for your cooperation." 🫢
  • -infosound string β€” text string references the sound to use for information. Default sound, male voice: "Identify please."
  • -validsound string β€” text string references the sound to use when a password is valid. Default sound, female voice: "Complete."
  • -invalidsound string β€” text string references the sound to use when a password is invalid. Default sound, female voice: "I am not programmed to give you that information."
  • -startCmd string β€” 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. ⭐
  • -endCmd string β€” text string command to execute when the screen is unlocked.
  • -pipepassCmd string β€” text string command into which to pipe the password when the screen is unlocked.
  • -logoutCmd string β€” text string command to execute when the program logs the user out (either via the autologout or by pressing the logout button).
  • -mailCmd string β€” text string command to execute when the program checks mail.
  • -mailIcon string β€” text string of file for the "mail arrived" bitmap. πŸ’Œ
  • -nomailIcon string β€” text string of file for the "no mail" bitmap. πŸ™ˆ
  • -dpmsstandby seconds β€” allows one to set DPMS Standby for the monitor (0 is defined as infinite). (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. ⚑
  • -dpmssuspend seconds β€” allows one to set DPMS Suspend for the monitor (0 is defined as infinite). (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. ⚑
  • -dpmsoff seconds β€” allows one to set DPMS Power Off for the monitor (0 is defined as infinite). (Horizontal sync off, Vertical sync off, Small auxiliary 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 πŸ’«

  • -neighbors num β€” sets the number of neighbors of a cell to 3, 4, 6, 9 (may not have real mathematical meaning), or 12 for several automata modes (ant, bug, demon, dilemma, life, loop, voters, wator, and wire) (bug and loop do not span this full range). Setting it to 0 typically randomizes this, except where bitmaps are used (dilemma, life, voters, and wator). πŸ”₯
  • -/+eyes β€” turns eyes on and off for ant, ant3d, and bug. πŸ‘€
  • -/+cycle β€” turns colour cycling on and off in crystal, lyapunov, mandelbrot, starfish, swirl, tetris, tik_tak, toneclock, and tube.
  • -/+label β€” turns alternate space and number labeling on and off in apollonian. For ant and ant3d this turns the labeling of the rule on and off. For life and life3d this turns the labeling of the pattern name and rule on and off. πŸŽ€
  • -/+serial β€” turns sequential allocation of colors on and off in kaleid. For life and life3d this turns the picking of sequential patterns on and off (to be used with middle button of the mouse).
  • -/+trackmouse β€” turns mouse interaction on and off 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. πŸ–±οΈ
  • -/+texture β€” turns texturing on and off in fire, lament and sballs. This may not be available depending on how xlock was configured.
  • -rule <rule> β€” the rule string is defined as B<neighborhood>/S<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 B3/S23. Others are B36/S23 and B3678/S34678. For life3d good examples are Bay's rules which are B5/S45, B6/S567, B5/S56, and B67/S67. 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 represented) for ant3d. Here a special parameter, T and then a number, will pick a specific table. πŸ‘‘
  • -lifefile filename β€” 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. πŸ¦‹
  • -arms num β€” allows one to set the number of arms in anemone. 🌸
  • -finpoints num β€” sets how wide the arms are in anemone. arms = swole. πŸ’ͺ
  • -width num β€” sets the final number of points in each array of anemone. yes, both exist, they do different things, don't come for me.
  • -withdraws num β€” sets the withdraw frequency in anemone.
  • -turnspeed num β€” sets the turning speed in anemone.
  • -/+truchet β€” turns Truchet lines (the trail, bestie, the trail) on and off in ant.
  • -/+altgeom β€” turns alternate geometries on and off in apollonian mode. off = plain euclidean space, on = it also includes spherical and hyperbolic. geometry glow-up fr 🌐
  • -whalespeed num β€” sets the speed of the whales and the dolphin in atlantis. they're swimming, let them live πŸ‹
  • -/+boil β€” turns on and off having the bubbles bubble up in bubble.
  • -nx num β€” sets the number of unit cells in the x-direction in crystal.
  • -ny num β€” sets the number of unit cells in the y-direction in crystal.
  • -/+centre β€” turns centering on screen on and off in crystal.
  • -/+maxsize β€” turns centering on screen on and off in crystal. (yes, same description as -/+centre, that's literally what the page says, I don't make the rules πŸ’€)
  • -/+cell β€” turns the drawing of the unit cell on and off in crystal.
  • -/+grid β€” turns the drawing of the grid of unit cells on and off in crystal (only matters if -cell is on).
  • -/+garden β€” turns the garden look off and on in daisy. (yes it's backwards, it says "off and on", I'm just the messenger 🌼)
  • -/+binary β€” turns the binary clock on and off in dclock.
  • -/+led β€” turns the led clock on and off in dclock.
  • -/+popex β€” turns the population explosion counter on and off in dclock. dark.
  • -/+forest β€” turns the tropical deforest counter (hectares/acres) on and off in dclock. also dark.
  • -/+hiv β€” turns the HIV infection counter on and off in dclock.
  • -/+lab β€” turns the Animal Research counter on and off in dclock.
  • -/+veg β€” turns the Animal Consumation counter on and off in dclock.
  • -/+y2k β€” turns the Year 2000 countdown on and off in dclock. it's giving 1999 panic πŸŽ€
  • -/+millennium β€” turns the Second Millennium countdown (January 1, 2001) on and off in dclock.
  • -bonus value β€” sets the bonus for cheating... between 1.0 and 4.0 in dilemma. cheating era only πŸ’…
  • -/+conscious β€” turns self-awareness off and on in dilemma. (again, off and on, exact words, don't @ me)
  • -/+grow β€” turns growing fractals on and off for drift (when it's off they're animated instead).
  • -/+liss β€” turns using lissajous figures to get points for drift on and off.
  • -/+fog β€” turns fog on and off for fire. πŸ”₯
  • -/+shadows β€” turns shadows on and off for fire.
  • -trees num β€” validates the displaying of trees for fire if it's greater than zero.
  • -/+invert β€” turns inverting of the flag on and off.
  • -/+rotate β€” turns rotating around the attractor on/off in flow.
  • -/+ride β€” turns rideing on/off in the flow. yes, "rideing", iconic spelling, keeping it 🫢
  • -/+box β€” turns the bounding box on/off in flow.
  • -/+periodic β€” turns periodic attractors on/off in flow.
  • -/+search β€” turns the search for new attractors on/off in flow.
  • -/+dbuf β€” turns double buffering on/off in flow.
  • -/+tracks β€” turns star tracks on and off in galaxy. ✨
  • -/+light β€” turns lighting of the planet on and off for glplanet.
  • -/+bounce β€” turns bouncing movement of the planet on and off for glplanet.
  • -pimage filename β€” uses the named xbm or xpm file for texturing the planet for glplanet. pass BUILTIN as the filename and you get the builtin image taken from Xearth. no file needed, she's self-sufficient πŸͺ
  • -/+roll β€” turns rolling of the planet on and off for glplanet.
  • -/+rotate β€” turns rotation of the planet on and off for glplanet.
  • -/+texture β€” turns texturing of the planet on and off for glplanet.
  • -/+stars β€” turns showing stars in the background on and off for glplanet.

  • -/+decay β€” turns decaying orbits on and off for grav.
  • -/+trail β€” turns a decaying trail of dots on and off for grav.
  • -/+ellipse β€” turns ellipse format on and off in helix.
  • -/+martin β€” turns Barry Martin's square root hop on and off.
  • -/+popcorn β€” turns Clifford A. Pickover's popcorn hop on and off.
  • -/+ejk1...ejk6 β€” turns Ed J. Kubaitis' hops on and off. that's six hops, one flag, she's efficient.
  • -/+rr β€” turns Renaldo Recuerdo's hop on and off.
  • -/+jong β€” turns Jong's hop on and off.
  • -/+sine β€” turns Barry Martin's sine hop on and off.
  • -pattern <pattern> β€” sets the pattern for juggle. 🀹
  • -tail num β€” minimum Trail Length for juggle.
  • -/+real β€” turns real-time juggling on/off for juggle. Deprecated. there should be no need to turn off real-time juggling, even on slow systems β€” just adjust speed using -count. please stop touching this one πŸ™ˆ
  • -/+describe β€” turns pattern descriptions on/off in juggle.
  • -/+balls β€” turns Balls on/off in juggle.
  • -/+clubs β€” turns Clubs on/off in juggle.
  • -/+torches β€” turns Flaming Torches on/off in juggle. πŸ”₯
  • -/+knives β€” turns Knives on/off in juggle. risk it all.
  • -/+rings β€” turns Rings on/off in juggle.
  • -/+bballs β€” turns Bowling Balls on/off in juggle. heavy. πŸ’€
  • -/+planetary β€” turns planetary gears on and off in gears.
  • -planetsize num β€” sets the size of the screen for the planetary option in gears. this one's for machines with a slower CPU. set it to 0 for full screen. be kind to your elderly laptop 🫢
  • -/+disconnected β€” turns disconnected pen movement on and off in kaleid.
  • -/+alternate β€” turns alternate rotated display mode on and off in kaleid.
  • -/+quad β€” turns quad mirrored/rotated mode on and off, similar to size 4 in kaleid.
  • -/+oct β€” turns oct mirrored/rotated mode on and off, similar to size 8 in kaleid.
  • -/+linear β€” turns Cartesian/Polar coordinate mode on and off in kaleid.
  • -/+conway β€” turns John Conway's original Life rule B3/S23 on and off for life. the icon, the legend πŸ‘‘
  • -/+highlife β€” turns David Bell's HighLife rule B36/S23 on and off for life.
  • -/+daynight β€” turns Nathan Thompson's Day and Night rule B3678/S34678 on and off for life.
  • -/+callahan β€” turns Paul Callahan's B2o/S2m34 hexagonal life on and off.
  • -/+andreen β€” turns Bob Andreen's B2o3o4m/S2om4o hexagonal life on and off.
  • -/+trilife β€” turns Carter Bays' B45/S34 triangular life on and off.
  • -/+trilife1 β€” turns Carter Bays' B456/S45 triangular life on and off.
  • -/+trilife2 β€” turns Carter Bays' B45/S23 triangular life on and off.
  • -/+totalistic β€” turns totalistic rules on and off for life1d. if it's off then it follows the rules of the LCAU collection β€” those rules may not be symmetric and are more general.
  • -/+additive β€” turns additive functions mode on and off in lisa.
  • -/+dissolve β€” turns the disolving state on and off in loop. ("disolving", yes, keeping it exactly)
  • -/+evolve β€” turns Evolving Loops on and off in loop.
  • -/+langton β€” turns Langton Loops on and off for loop.
  • -/+sheath β€” turns sheath extension on and off for loop.
  • -/+wrap β€” turns wrapping of borders on and off for loop.
  • -increment num β€” sets the option for increasing orders in mandelbrot.
  • -/+alpha β€” turns interior displaying level of closest return on and off in mandelbrot.
  • -/+binary β€” turns binary decomposition color modulation on and off in mandelbrot. (different -/+binary than the dclock one, keep up bestie)
  • -/+dem β€” turns Distance Estimator Method on and off in mandelbrot (instead of escape time).
  • -/+index β€” turns interior displaying iteration of closest return on and off in mandelbrot.
  • -/+lyap β€” turns interior displaying according to an estimate of the Lyapunov exponent on and off in mandelbrot.
  • -/+pow β€” turns adding z^z on and off in mandelbrot.
  • -/+sin β€” turns adding sin(z) on and off in mandelbrot.
  • -/+noants β€” turns ants off and on in moebius. (off and on!! stay with me)
  • -/+solidmoebius β€” turns the solid Mobius strip on and off in moebius.
  • -/+atoms β€” turns the drawing of spheres for the atoms on and off in molecule.
  • -/+bbox β€” turns showing the molecules in a blue box on and off in molecule. πŸ¦‹
  • -/+bonds β€” turns the drawing of the atomic bonds on and off in molecule.
  • -molecule filename β€” reads a molecule structure from a pdb file in molecule.
  • -/+labels β€” turns the labeling of the atoms on and off in molecule.
  • -spin{x|y|z} β€” sets the axis for molecule rotation in molecule. the default is "XYZ".
  • +spin β€” turns off the molecule rotation in molecule. note there's no dash here, it's just +spin, she's special.
  • -/+titles β€” turns the molecule description on and off in molecule.
  • -/+wander β€” turns the moving of the molecule on a sinoid curve on and off in molecule. also: "Turn on and off movements in fire." that's the whole sentence, take it as it is πŸ”₯

  • -/+ammann β€” turns lines on and off for penrose.
  • -increment value β€” allows fine adjustments to order in mandelbrot. (yes there's a -increment num too, they're both here, they're different, breathe)
  • -/+erase β€” turns erasing on and off for spline. when this option is on, cycles is divided by 64 to compute the number of lines β€” so it stays compatible when you're using -fullrandom.
  • -factory num β€” number of extra factory parts in pipes. 🏭
  • -/+fisheye β€” turn it on if you want a zoomed-in view of pipes.
  • -/+tightturns β€” turn it on if you want the pipes to bend more often.
  • -/+rotatepipes β€” turn it on if you want the pipe system rotated in pipes.
  • -/+complete β€” turns complete graph morphing on or off in qix.
  • -msg textstring β€” lets you pass different explosion elements to pyro2. the explosion types are one of &0, &1, ... &9, &a, ... &f, each of which presents a different type of explosion. normal text can be sent too, and the string may contain blanks if quoted. send the # sign and an operation system logo gets shown. πŸ’₯
  • -fnt font β€” lets you pass different elements to pyro2.
  • -size[xyz] num β€” the 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. (that trailing "star." is just there. it's in the source text. we keep it. ⭐)
  • -/+hideshuffling β€” turns the hidden shuffle phase on or off for bevel, dino, mball, oct, pyraminx, rubik and skewb.
  • -/+border β€” turns borders on or off in shape.
  • -/+shadowing β€” turns shadowing on or off in shape.
  • -/+stippling β€” turns stippling on or off in shape.
  • -intensity value β€” sets the brightness (default 2185) of the sierpinski structure for sierpinski3d.
  • -maxdepth value β€” sets the maximum depth (up to 10) of the sierpinski structure for sierpinski3d.
  • -speed value β€” determines after how many steps the depth changes for sierpinski3d.
  • -trek num β€” if it's a high number you'll see the space ship all the time in star. πŸš€
  • -/+rock β€” turns rocks on and off for star. if this is off, stars will be seen instead.
  • -/+straight β€” turn this on if star gets you motion sick. πŸ₯²
  • -cyclepeed num β€” sets the speed of cycling in starfish πŸŒ€
  • -rotation num β€” sets rotation velocity in starfish πŸŒ€
  • -thickness num β€” sets thickness in starfish πŸŒ€
  • -/+rock β€” turns on and off the blob for starfish
  • -curve num β€” sets the curve factor of the attractors for strange
  • -points num β€” changes the number of points/iterations each frame for strange
  • -point-size num β€” changes the size of individual points for strange
  • -zoom float β€” zooms in or out for strange
  • -brightness float β€” adjusts the brightness for accumulator mode for strange
  • -motion-blur float β€” adds motion blur for strange
  • -spinspeed num β€” sets speed of rotation, in degrees per frame for superquadrics
  • -/+bonus β€” turns on in tetris to see 5 square bonus pieces
  • -/+well β€” turns on in tetris to see welltris
  • -ttfont filename β€” sets the True Type font file (or font directory) used for text3d
  • -extrusion num β€” sets the length of the text extrusion for text3d
  • -rot_amplitude float β€” sets rotation amplitude value of each letter for text3d
  • -rot_frequency float β€” sets rotation frequency for text3d
  • -/+no_split β€” turns on and off word splitting for text3d
  • -ttanimate function_name β€” sets the animation function used for text3d. Currently one of: Random FullRandom Default Default2 None Crazy UpDown Extrude RotateXY RotateYZ Frequency Amplitude
  • -speed km/h β€” the speed for all planes in km/h for xcl
  • -frametime microseconds β€” the time for one frame on the screen. This time is used to calculate the delay time and depends on the speed of the X server for xcl
  • -line_length mm β€” the distance between the pilot and the plane for xcl
  • -spectator mm β€” 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
  • -viewmodel β€” shows an animated view of one model for xcl
  • -/+oldcolor β€” sets the colors for the first two planes fixed to red and yellow in xcl
  • -xcldebug β€” shows some additional timing information to make sure that the calibrate procedure goes right in xcl
  • -automatic β€” the auto scale for automatic fit into the window is Deactivated with this option for xcl
  • -randomstart β€” use a random start point for models at startup for xcl
  • -duration seconds β€” allows one to set a duration for a mode in random. Duration of 0 is defined as infinite
  • -/+fullrandom β€” turn on/off randomness options within modes in random. Not implemented for all mode options
  • -modelist textstring β€” 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, "allnice" 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, "allfractal" for fractal modes, "allgeometry" for geometry modes, "allspace" for space modes. The random mode itself can not be referenced
  • -/+sequential β€” turn on non-random random option

⚠️ WARNING ⚠️

Okay so real talk: 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 a considerable amount of time to respond. Not the vibe, but them’s the facts πŸ’€.

πŸ•ΆοΈ SHADOW PASSWORDS πŸ•ΆοΈ

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 unattended. 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* 🐚.

πŸ’€ BUGS πŸ’€

Okay this one is serious, bestie. This:

"kill -KILL xlock "

causes the server that was locked to be unusable, since all hosts (including localhost) were removed from the access control 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 Parameters', and turn off TCP/IP access control 😭.

πŸ‘€ SEE ALSO πŸ‘€

  • X(1), Xlib Documentation.

🌟 AUTHOR 🌟

Maintained by:

  • David A. Bagley, <bagleyd AT verizon.net>

The latest version is currently at:

Original Author:

  • Patrick J. Naughton, <naughton AT eng.sun.com>
  • Mailstop 21-14
  • Sun Microsystems Laboratories, Inc.
  • Mountain View, CA 94043
  • 415/336-1080

with many additional contributors. πŸ’–

Copyright (c) 1988-1991 by Patrick J. Naughton Copyright (c) 1993-2024 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, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation.

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 copyrights.


And that’s the whole XLOCK(1) page, bestie β€” source/version vibes are X11R6 Contrib, dated 16 May 2024, and it’s giving classic manpage energy πŸ’…βœ¨

πŸ“¦ where this page comes from