toshset Man page

TOSHSET(1) User-installed Software TOSHSET(1)


toshset – manipulate bios and hardware settings of Toshiba laptops




Toshset ia a command-line tool to allow access to much of the Toshiba
hardware interface developed by Jonathan Buzzard. It can do things like
set the hard drive spin-down time, turn off the display and set the fan

Credit for the difficult task of reverse-engineering the Toshiba hard‐
ware interface goes to Jonathan Buzzard. A link for Jonathan’s tools

All options are listed by running toshset with no arguments.

If an argument option is specified as the “-” character, stdin is
read for that option. This is particularly convenient when setting the
owner string.

The method used for access to the laptop hardware is given by the the
HCI/SCI access mode query field. This should be kernel or direct. The
kernel method requires kernel support and it is the only access method
supported for ACPI kernels. If ACPI is not used this package does not
require a special kernel module. Also, it is highly likely that this
tool will work under different flavors of *NIX. As a result of this
design consideration, and because of my own desire that not every user
be able to change my laptop’s hardware settings, the user must have
read/write permission to /dev/toshiba in order for this program to run

Toggle Options:
-l toggle long query in which the assocated command-line option is
printed with each queried feature.

-fast run in fast mode: a startup check is skipped, and values are not
queried after the are set. On machines for which ioctl is slow,
this can speed toshset up by up to a factor of 2/5.

-v toggle verbose mode in which normally silent messages are

Query Options:
-q [glob] query features specified by glob (all features if glob omitted).
The glob string is sandwiched between asterisks, so specifying
-q bat will query all features whose names contain the “bat”
substring. If no glob is given, then all features are queried.

Feature Options:
Valid settings for features can be listed by omitting the argument. The
current list of feature options is

enable/disable system beep

set lcd brightness.

set lcd brightness. Not all models support both -lcd and -inten.

set power-up mode

-vol <0-4>
set beep volume. Note that this controls the modem volume for my
PCMCIA modem.

number of minutes until disk spindown

enable/disable display stretch

number of minutes until display auto-off

set cooling method

set battery-save mode

control lcd backlight

power-up + attach internal bluetooth device, or shutdown.

control fan

set display device for video: internal lcd, external monitor, or

set CPU speed

enable/disable CPU cache

enable/disable CPU sleep mode

enable/disable battery alarm

enable/disable lid-closed alarm

-walarm set time/date to wake

enable/disable annoying feature of powering-off computer when
lid is closed.

set parallel port mode

number of minutes of idle time until system auto-off

set owner string. This string is displayed at boot or resume
time, if a user or supervisor password is set.

set or clear the user password. Toshset must be run on the con‐
sole for this to work. The password should be entered when the
prompt is displayed. If the password is currently set, entering
it will clear the password.

set the supervisor password. See the docs for -upasswd.

USB legacy mode: enable/disable using an USB mouse as it would
be a PS/2 one, without the need to install a USB driver.

-3g power-up + attach internal 3g modem device, or shutdown.

USB FDD emulation mode: is almost the same of the previous one
for a floppy. It enables the use of an USB floppy as it would be
attached to an internal FD controller (for booting etc.)

-lan Enables/disables internal LAN controller.

enable/disable startup sound logo.

startup logo mode (picture or animation>.

enable/disable the display’s transreflective mode.

Features may also be set by specifying the (zero-offset) index
of the option. e.g. toshset -cpu 0 sets the cpu speed to slow.


Many features are locked and can not be changed when the battery save
mode is not “user.” Since I only have one laptop, I can’t test this
utility on other hardware. User feedback in this regard is helpful.
Some features do not work on my laptop and they may work on your’s, and

Toshset requires an experimental version of the toshiba_acpi kernel
module with an ACPI-enabled kernel.


Written by
News, updates and documentation: visit‐


Copyright © 2002-8 Charles D. Schwieters
This is free software; see the source for copying conditions. There is

toshset 2 March 2008 TOSHSET(1)