VLOCK-MAIN(8) Linux Programmer's Manual VLOCK-MAIN(8)NAME
vlock-main - lock current virtual console
SYNOPSIS
vlock-main [plugins...]
DESCRIPTION
vlock-main is part of vlock(1), the Virtual Console locking program for Linux. It locks the current session and will only exit if the cur-
rent user can authenticate themselves. The root user will also be able to unlock the session, unless disabled at compile time. The com-
mand line arguments specify plugins that should be loaded by vlock-main. See vlock-plugins(5) for more information.
If plugin support is disabled at compile time, the only supported argument is "all".
ENVIRONMENT VARIABLES
The following environment variables can be used to change the behavior of vlock-main:
USER
If this variable is when vlock-main is run as root (uid 0) vlock locks the screen as this user instead of root. The root password
will still be able to unlock the session, unless disabled at compile time.
VLOCK_ALL_MESSAGE
If this variable is set and all consoles are locked its contents will be used as the locking message instead of the default message.
VLOCK_CURRENT_MESSAGE
If this variable is set and only the current consoles is locked its contents will be used as the locking message instead of the
default message.
VLOCK_MESSAGE
If this variable is set its contents will be used as the locking message instead of the default. This overrides the former two
variables.
VLOCK_TIMEOUT
Set this variable to specify the timeout (in seconds) after which the screen saver plugins (if any) will be invoked. If this vari-
able is unset or set to an invalid value or 0 no timeout is used. See vlock-plugins(5) for more information about plugins.
VLOCK_PROMPT_TIMEOUT
Set this variable to specify the amount of time (in seconds) you will have to enter your password at the password prompt. If this
variable is unset or set to an invalid value or 0 no timeout is used. Warning: If this value is too low, you may not be able to
unlock your session.
SIGNALS
Several signals are ignored. vlock-main will try to exit cleanly if SIGTERM is received.
SEE ALSO vlock(1), vlock-plugins(5)AUTHORS
Frank Benkstein <frank-vlock@benkstein.net>
Linux 28 July 2007 VLOCK-MAIN(8)
Check Out this Related Man Page
HIBERNATE(8)HIBERNATE(8)NAME
hibernate - save your computer's state to disk, and then switch it off
SYNOPSIS
hibernate [OPTION]...
DESCRIPTION
The hibernate script (or "suspend script") is used to invoke the Linux kernel's Hibernation functionality.
When you hibernate your machine, the contents of your computer's memory will be saved to disc, and your computer will switch off. When you
switch it back on again, it will resume exactly as it was when you hibernated. This script is designed for TuxOnIce, which is not yet
included in the main kernel tree and must be downloaded from the TuxOnIce web site at http://www.tuxonice.net/, but can also utilise the
vanilla kernel interfaces for swsusp or pmdisk (through /proc/acpi/sleep or /sys/power/state). Instructions on setting up the kernel can
also be found on that web site.
The hibernate script takes care of the user-space side of the suspend, including unloading and reloading drivers which don't suspend prop-
erly, setting the system clock after resuming, taking down and bringing up network interfaces and various other hacks that may be required
on some hardware. By default, all it does is restore the system clock after suspending; see hibernate.conf(5) for information on configur-
ing the rest of its functionality.
If the hibernate script is invoked with a name of the form hibernate-foo then it will use the configuration file /etc/hibernate/foo.conf
instead of the default.
The hibernate script accepts the following command-line options:
OPTIONS -h, --help Shows this help screen.
--version Shows the Hibernate Script version.
-f, --force Ignore errors and suspend anyway.
-k, --kill Kill processes if needed, in order to suspend.
-v<n>, --verbosity=<n>
Change verbosity level (0 = errors only, 3 = verbose, 4 = debug)
-F<file>, --config-file=<file>
Use the given configuration file instead of the default ()
--dry-run Don't actually do anything.
-g, --restore-grub
Restores the grub menu to normal (use if a resume was not completed successfully) and exits the script. A suspend is not
performed.
--lock-console-as <username>
Uses vlock to lock the entire system after resuming, requirng you to enter the password for the given user to unlock it.
This overrides any username given in the configuration file. (Requires vlock)
-n, --no-suspend
Disables actually suspending the system. This is useful for testing the hibernate script itself.
-r[0|1], --reboot[=<0|1>] (requires UseTuxOnIce on)
If 0 is specified, disables rebooting after writing the image, regardless of the Reboot option in the configuration file.
If 1 or omitted, will force a reboot after writing the image.
--bug-report (requires UseTuxOnIce on)
Gathers a bunch of information about your machine and writes it to standard output. Please attach this information along
with any bug reports to the TuxOnIce mailing list.
EXIT CODES
The exit codes returned by the hibernate script are currently as follows:
0 Hibernation was completed successfully.
2 Hibernation was aborted due to errors from some part of the script. (eg, modules not unloading, devices or filesystems in use).
3 Hibernate script was aborted by user with Ctrl+C. (This does not mean the suspend was aborted by a user by pressing Escape).
4 Hibernation was aborted by a kernel problem (hibernate.log and dmesg should indicate why), or the user aborted the suspend with the
Escape key.
FILES
/etc/hibernate/hibernate.conf
Contains options which influence the hibernate script's behaviour. See hibernate.conf(5) for more information.
/etc/hibernate/scriptlets.d/
/usr/share/hibernate/scriptlets.d/
/usr/local/share/hibernate/scriptlets.d/
These directories contains "scriptlets" that provide functionality when suspending and resuming. See the SCRIPTLET-API file
included with the distribution (which can be found in /usr/share/doc/hibernate on Debian systems) for information on how these
work.
BUGS
Probably lots!
If you have problems with the hibernate script or TuxOnIce, the best place to ask is on the mailing list - tuxonice-users@lists.tuxon-
ice.net. You will need to subscribe to post. See http://www.tuxonice.net/lists for details.
If the suspend process itself crashes (while "Writing caches", "Reading caches", or "Copying original kernel back", etc), then the problem
lies with TuxOnIce itself. See the FAQ at http://www.tuxonice.net/ for help on debugging.
AUTHOR
This script was written by Bernard Blackham, with contributions from:
o Carsten Rietzschel (modules, bootsplash and grub scriptlets. many ideas and bugfixes)
o Cameron Patrick (many bugfixes and ideas, man page and Debian packaging)
SEE ALSO hibernate.conf(5)Linux Hibernation May 2012 HIBERNATE(8)