summaryrefslogtreecommitdiff
path: root/loaderinfo.1
blob: e6168e2d17ae94811acb86e943d061f268678ce3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
.\" tapeinfo.1  Document copyright 2000 Eric Lee Green
.\"  Program Copyright 2000 Eric Lee Green <eric@badtux.org>
.\"  Copyright 2007-2008 by Robert Nelson <robertn@the-nelsons.org>
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.TH LOADERINFO 1 LOADERINFO1.0
.SH NAME
loaderinfo \- report SCSI tape device info
.SH SYNOPSIS
loaderinfo -f <scsi-generic-device>
.SH DESCRIPTION
The
.B loaderinfo
command reads various information from SCSI tape loaders. Its intended
use is for high-level programs that are trying to decide what the
capabilities of a device are.
.P
The following are printed:
.TP 10
.B  Element Address Assignment Page:
This tells how many elements are in the loader, and what their raw
hardware addresses are.

.TP 10
.B Transport Geometry Descriptor Page:
Will display whether media is invertible or not (usable with some
optical jukeboxes for detirmining whether to "flip" media after writing
to the first side).

.TP 10
.B Device Capabilities Page
Currently will only display whether we can transfer between slots (i.e.
whether 'mtx transfer' works).

.TP 10
.B Inquiry Page
Aside from the normal inquiry info, will also print out whether we have
a bar code reader (for loaders that support the Exabyte extension for
reporting presence of said reader).


.SH OPTIONS
The first argument, given following
.B -f
, is the SCSI generic device corresponding to your tape loader.
Consult your operating system's documentation for more information (for
example, under Linux these are generally start at /dev/sg0
under FreeBSD these start at /dev/pass0).
.P
Under FreeBSD, 'camcontrol devlist' will tell you what SCSI devices you
have, along with which 'pass' device controls them. Under Linux,
the command
.B lsscsi \-\-generic
will tell you what SCSI devices you have.
Under Solaris 8,
.B find /devices -name '*changer*'
will display the device names for your attached changers. Make sure
to configure your 'sgen' driver first.

.SH BUGS AND LIMITATIONS
.P
This program has only been tested on Linux with a limited number of
loaders (Ecrix Autopack, Exabyte 220, IBM TS3100).
.P
.SH AVAILABILITY
.B loaderinfo
is currently being maintained by Robert Nelson <robertnelson@users.sourceforge.net>
as part of the 'mtx' suite of programs. The 'mtx' home page is
http://mtx.sourceforge.net and the actual code is currently available there and via
SVN from http://sourceforge.net/projects/mtx.

.SH SEE ALSO
.BR mt (1), tapeinfo (1), mtx (1)