.TH TOSHSET 1 "January 2002" "toshset 2" "User-installed Software"
.SH NAME
toshset \- manipulate bios and hardware settings of Toshiba laptops
.SH SYNOPSIS
.B toshset
[\fITOGGLEOPTIONS\fR | \fIQUERYOPTIONS\fR | \fIFEATUREOPTIONS\fR]...
.SH DESCRIPTION
.PP
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 speed.

This package is based on a version of Jonathan Buzzard's
toshutils package which does not require a special kernel
module. Hence, no recompilation is required if a kernel upgrade is
performed. 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 be root or use a sudo-like
tool. Turning on the binary's suid bit will not have the desired
effect. 

All credit for the difficult task of
reverse-engineering the Toshiba hardware interface goes to Jonathan Buzzard.
A link for Jonathan's tools is
.hr
http://www.buzzard.org.uk/toshiba/

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.

.PP
.SS "Toggle Options:"
.TP
\fB\-l\fR
toggle long query in which the assocated command-line option is
printed with each queried feature.
.TP
\fB\-v\fR
toggle verbose mode in which normally silent messages are printed.
.PP
.SS "Query Options:"
.TP
\fB\-q\fR \fI [glob]\fR
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.
.PP
.SS "Feature Options:"
Valid settings for features can be listed by omitting the
argument. The current list of feature options is 
.TP
\fB\-b\fR \fI <on|off> \fR
enable/disable system beep
.TP
\fB\-lcd\fR \fI<setting>\fR
set lcd brightness
.TP
\fB\-pow\fR \fI<setting>\fR
set power-up mode
.TP
\fB\-vol\fR \fI<0-4>\fR
set beep volume. Note that this controls the modem volume for my
PCMCIA modem.
.TP
\fB\-hdd\fR \fI<num>\fR
number of minutes until disk spindown
.TP
\fB\-dstretch\fR \fI<on|off>\fR
enable/disable display stretch
.TP
\fB\-d\fR \fI<num>\fR
number of minutes until display auto-off
.TP
\fB\-c\fR \fI<method>\fR
set cooling method
.TP
\fB\-bs\fR \fI<setting>\fR
set battery-save mode
.TP
\fB\-bl\fR \fI<on|off>\fR
control lcd backlight
.TP
\fB\-fan\fR \fI<setting>\fR
control fan
.TP
\fB\-video\fR \fI<int|ext|both>\fR
video out
.TP
\fB\-cpu\fR \fI<fast|slow>\fR
set CPU speed
.TP
\fB\-cpucache\fR \fI<on|off>\fR
enable/disable CPU cache
.TP
\fB\-sleep\fR \fI<on|off>\fR
enable/disable CPU sleep mode
.TP
\fB\-balarm\fR \fI<on|off>\fR
enable/disable battery alarm
.TP
\fB\-palarm\fR \fI<on|off>\fR
enable/disable lid-closed alarm
.TP
\fB\-walarm\fR \fI<dis|HH:MM[/everyday|DD/MM[/YYYY]]>\fR
set time/date to wake
.TP
\fB\-ppower\fR \fI<on|off>\fR
enable/disable annoying feature of powering-off computer when lid is
closed. 
.TP
\fB\-parallel\fR \fI<mode>\fR
set parallel port mode
.TP
\fB\-autooff\fR \fI<dis|HH:MM[/everyday|DD/MM[/YYYY]]>\fR
set auto-off time
.TP
\fB\-ostring\fR \fI<owner string>\fR
set owner string. This string is displayed at boot or resume time.

.SH BUGS
Many features are locked and can not be changed when the battery save
mode is not ``user.'' Since I only have a Tecra8100, 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 visa-versa.

.SH AUTHOR
Written by <Charles@Schwieters.org>
.br
News, updates and documentation: visit
http://schwieters.org/toshset.html 
.SH COPYRIGHT
Copyright \(co 2002 Charles D. Schwieters
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.