.\" Man page for plextor-tool.
.TH PLEXTOR-TOOL 8 "February 2002" "PLEXTOR-TOOL V 0.5.0"
.SH NAME
plextor-tool \-  change parameters of plextor cd-rom drives
.SH SYNOPSIS
.B plextor-tool
\fIDEVICE\fR [\fIOPTIONS\fR]
.br
.B plextor-tool
\fI-l\fR [\fI-v\fR]
.br
.B plextor-tool
[\fI-?\fR|\fI-h\fR|\fI\-\-help\fR|\fI\-\-version\fR]
.SH DESCRIPTION
.PP
.\" Additional description here
.PP
.B Plextor-tool
is used for setting and querying some parameters of
Plextor(r)/MMC CD-ROM/CD-R(W) drives. MMC drives don't have the \fB\-m\fR
option and only Plextor PX-20TSx or greater CD-ROM drives have the
\fB\-a\fR/\fB\-w\fR options
Furthermore
.B plextor-tool
will only accept speed settings that can be fulfilled by a CD-ROM
drive (it is not possible to select 20 for a PX-20TSx because 0
represents the maximum value; that is 12-20x). In contrast MMC drives
will allow any value up to 372 and the next available speed below the
selected one will be chosen (0 does the same as 372).
.TP
\fB\-q\fR
query properties of DEVICE, no other options are allowed (\fB\-v\fR
will be silently ignored).
.TP
\fB\-s\fR \fIx\fR
set speed of DEVICE to \fIx\fR (multiple of 150KB/sec) 0 represents maximum speed of drive (other possible values are 1/2/4/8/20).
.TP
\fB\-i\fR \fIx\fR
set spindown time to 0 | 125ms | 250ms | 500ms | 1sec | 2sec | 4sec | 8sec | 16sec | 32sec | 1min | 2min | 4min | 8min | 16min | 32min, 0 represents infinite.
.TP
\fB\-o\fR \fIx[,y]\fR
set volume to x (x or y must be in the range 0..255) if both x and y are given x is the volume of the left channel and y the volume of the right channel.
.TP
\fB\-m\fR 0|1
controls whether the drive slows down on read errors: 0 slow-down (default), 1 don't slow down (overrides -a setting!).
.TP
\fB\-a\fR 0|1
controls whether the drive slows down to avoid vibrations: 0 slow-down (default), 1 don't slow down (both settings are only effective if the speed mode bit is not set!).
.TP
\fB\-w\fR 1|0
controls whether drive transfers data before reaching maximum speed: 1 waits for maximum speed (default), 0 transfers before reaching maximum speed.
.TP
\fB\-v\fR
set verbose level to 1, giving detailed messages about the operations
.B plextor-tool
performs.
.TP
\fB\-?\fR, \fB\-h\fR, \fB\-\-help\fR
display help and exit.
.TP
\fB\-\-version\fR
display version number and exit.
.PP
.SH PRECONDITIONS
According to the SCSI-Programming-HOWTO
.B plextor-tool
will need at least a kernel with revision 1.1.68 (with the exceptions of 1.1.77
up to 1.1.89 and 1.3.52 up to 1.3.56 due to broken scsi generic
interface). Nevertheless it is absolutely necessary to have scsi
generic support from the kernel and the special devices
(/dev/sg0/... or /dev/sga/...).
.SH NOTES
At least with a Yamaha CRW-4260 (a MMC compatible CD-RW drive) the
setting of spindown values does not work (this can be seen when using
the \fB\-v\fR option). At the moment I do not know the exact reason and
would be interested in any information regarding this topic (because
general SCSI documents just tell me the spindown value can be
retrieved/set as with Plextor CD-ROM drives).
.SH BUGS
Report bugs to <georg@ist.org>.
.SH AVAILABILITY
The most recent version of
.B plextor-tool
is always available from www.technik.sth.ac.at/plextor-tool/.
.SH COPYRIGHT
.B (c) 1999-2002 Georg Huettenegger, <georg@ist.org>.
.PP
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.PP
.SH AUTHOR
Georg Huettenegger <georg@ist.org>.
