Plan 9 /sys/man/8/screenlock

NAME

screenlock – disable access to a terminal

SYNOPSIS

screenlock

DESCRIPTION

Screenlock grabs the screen, keyboard, and mouse devices to disable access to the Plan 9 terminal on which it is run. The screen can be unlocked by typing the invoking user's Plan 9 password and a newline.

FILES

/lib/bunny.bit the image displayed while the terminal is locked

SOURCE

/sys/src/cmd/screenlock.c

SEE ALSO

auth(2), factotum(4)

DIAGNOSTICS

Per BUGS, a missing role=server attribute makes screenlock misleadingly report a password mismatch.

BUGS

Use of this program on communal terminals is anti–social.
Screenlock uses auth_userpasswd, which requires a role=server attribute in a factotum entry for the invoking user. This requirement may be a mistake.

Copyright © 2025 Plan 9 Foundation


	Screenlock grabs the screen, keyboard, and mouse devices to disable access to the Plan 9 terminal on which it is run. The screen can be unlocked by typing the invoking user's Plan 9 password and a newline.


	`/lib/bunny.bit` the image displayed while the terminal is locked


	Per `BUGS`, a missing `role=server` attribute makes screenlock misleadingly report a password mismatch.


	Use of this program on communal terminals is anti–social. Screenlock uses auth_userpasswd, which requires a `role=server` attribute in a factotum entry for the invoking user. This requirement may be a mistake.