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 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565
|
.\" Copyright 1995 Robert K. Nichols (Robert.K.Nichols@att.com)
.\" Copyright 1996 C.Schmidt - deutsche bersetzung (c.schmidt@ius.gun.de)
.\" Interner Versionslevel (Deutsche Version) : 0.1
.\" nur bersetzt, nicht korrekturgelesen...
.\"
.\" Wenn jemand sich ber Rechtschreibfehler bzw. eine fehlerhafte ber-
.\" setzung aufregen mchte so kann er das /dev/null mitteilen.
.\" (Schlielich bersetze ich diese Dinger um meine Englischkenntnisse
.\" aufzubessern...)
.\"
.\" KONSTRUKTIVE Kritik oder ein netter Hinweis auf Fehler, aller
.\" Art, wrden mich aber freuen. Danke!
.\"
.\" Nach dem bersetzen dieser Manualpage mu ich "vermeindlich
.\" schlecht eingedeutschte Bedinungsanleitungen" auch aus einem
.\" Blickwinkel betrachten ;-)))
.\"
.\" Folgendes lass ich mal so steh'n ;-)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Mon Jun 10 01:42:49 1996 by Martin Schulze (joey@linux.de)
.\"
.TH ST 4 "Januar 1996" "Linux" "Gertedateien"
.SH BEZEICHNUNG
st \- SCSI tape device (Bandlaufwerke, Streamer)
.SH UEBERSICHT
.nf
.B #include <sys/mtio.h>
.sp
.BI "int ioctl(int " fd ", int " request " [, (void *)" arg3 "])"
.BI "int ioctl(int " fd ", \s-1MTIOCTOP\s+1, (struct mtop *)" mt_cmd ")"
.BI "int ioctl(int " fd ", \s-1MTIOCGET\s+1, (struct mtget *)" mt_status ")"
.BI "int ioctl(int " fd ", \s-1MTIOCPOS\s+1, (struct mtpos *)" mt_pos ")"
.fi
.SH BESCHREIBUNG
Der
.B st
Treiber stellt eine einheitliche Schnittstelle fr die Benutzung der
diversen SCSI Bandlaufwerke zur Verfgung. Im aktuellen Entwicklungsstand
bernimmt der Treiber die Kontrolle ber alle erkannten Laufwerke auf die nur
.BI sequentiell
zugegriffen werden kann.
Der
.B st
Treiber benutzt die dabei die
.IR "major device"
Nummer 9.
.PP
Zustzlich werden generell zwei
.IR "minor device"
Nummern benutzt. Eine grundstzliche
.IR "minor device"
Nummer,
.IR n ,
die sequentiell beim Erkennen der Laufwerke vergeben wird, und eine
\(lqnicht zurckspulen\(rq Device Nummer,
.IR "" ( n "+ 128)."
Wenn eine Bandeinheit ber die grundstzliche Device Nummer,
.IR n ,
geffnet wird, so wird nach dem Schlieen ein
\s-1REWIND\s+1 Kommando an die Bandeinheit geschickt; Bei der Benutzung
der Bandeinheit ber die \(lqnicht zurckspulen\(rq Device Nummer,
.IR "" ( n "+ 128)."
halt nicht ;-)
.PP
Optionen wie die Schreibdichte oder Blockgre sind nicht in die
.IR "minor device"
Nummern implementiert.
Diese Optionen mssen durch die Verwendung von
.B ioctl()
Aufrufen gesetzt werden
Sie werden erst nach Schlieen und einem darauffolgenden \(lqWieder-ffnen\(rq
der \(lqDevice-Datei\(rq aktiv.
.PP
Devices werden blicherweise mit dem Programm
.B mknod
eingetragen
.PP
.RS
.nf
mknod -m 660 /dev/st0 c 9 0
mknod -m 660 /dev/st1 c 9 1
mknod -m 660 /dev/nst0 c 9 128
mknod -m 660 /dev/nst1 c 9 129
.fi
.RE
.PP
Es gibt hier kein vergleichbares
.IR BLOCK
Device.
Das
.IR Character
(zeichenorientierte) Device bietet standartmig das Zwischenspeichern
von Zeichen (buffering) und das \(lq weiterlesen\(rq (read-ahead) Merkmal
an.
Ferner untersttzt es zuflliges Lesen und Schreiben, welches
nur durch den internen Treiber Buffer begrenzt ist.
(Standard: 32768 bytes)
.PP
Die Buffergre kann sowohl als Kernelparameter, sowie auch im
Quelltext \(lqfest\(rq vergeben werden.
.PP
blicherweise wird ein Soft-Link
.B /dev/tape
eingerichtet, der auf das im System vorhandene und zu benutzende
Device zeigt.
.SH "IOCTLS"
Der Treiber untersttzt drei
.B ioctl()
Aufrufe. Alle dem
.B st
Treiber unbekannten Aufrufe werden an den SCSI Treiber
bergeben.
Die folgenden Definitionen sind aus
.IR <linux/mtio.h> :
.SS "\s-1MTIOCTOP\s+1 \- Ausfhren einer Band Anweisung"
.PP
Diese Operation bentigt ein Argument vom Typ
.PP
.BR "(struct mtop *)" .
.PP
Nicht alle Laufwerke untersttzen jede der mglichen Anweisungen.
Der Treiber gibt ein EIO zurck, wenn das Laufwerk die Anweisung
nicht untersttzt.
.PP
Anm. des bersetzers
.PP
Das Folgende ist nur sehr schwer 100%ig ins Deutsche zu bersetzen,
da so mancher Begriff aus dem Englischen gelufiger ist, als seine
deutsche bersetzung.
Da ich nicht in der \(lqIBM bersetzerabteilung\(rq arbeite, habe ich
hier und dort das englische Original stehen lassen.
(Hauptschlich bei sehr kurzen Beschreibungen)
.PP
Bei \(lqUnverstehbarkeit\(rq des folgenden bitte ich auf die Original
(englischsprachige) man-page zu st.4 zurckzugreifen.
Speziell fr diesen Abschnitt wrde der bersetzter sich ber
Rckmeldungen der \(lqpraktischen Anwender\(rq freuen. ;-)
.PP
Fr eine gesunde Kritik einfach eine Mail an
.B c.schmidt@ius.gun.de
.PP
.nf
.ta +.4i +.7i +1i
/* Struktur fr \s-1MTIOCTOP\s+1 \- Anweisungen an das Bandlaufwerk */
.PP
struct mtop {
short mt_op; /* Welche Anweisung (Auflistung folgt) */
int mt_count; /* Wie oft diese Anweisung ausfhren */
};
.fi
.PP
Bandlaufwerk; mgliche Anweisungen:
.PD 0
.IP MTBSF 14
Zurckspulen ber
.B mt_count
Filemarks.
.IP MTBSFM
Zurckspulen ber
.B mt_count
Filemarks.
Positionieren des Mediums(Schreibkopf?) auf die EOT Seite des
letzten Filemarks.
.IP MTBSR
Zurckspulen ber
.B mt_count
records (tape blocks) BLOCKS.
.IP MTBSS
Zurckspulen ber
.B mt_count
setmarks.
.IP MTEOM
\(lqGeh an das Ende der aufgezeichenten Daten...\(rq Zum Anhngen
von Dateien/Archiven.
.IP MTERASE
Band lschen.
.IP MTFSF
Vorspulen ber
.B mt_count
Filemarks.
.IP MTFSFM
Vorspulen ber
.B mt_count
Filemarks.
Positionieren des Mediums(Schreibkopfes?) auf die BOT Seite des
letzen Filemarks.
.IP MTFSR
Vorspulen ber
.B mt_count
records (tape blocks) BLOCKS.
.IP MTFSS
Vorspulen ber
.B mt_count
Setmarks.
.IP MTNOP
Nichts machen \- Als Seiteneffekt wird der Treiberbuffer
gelscht. Kann mglicherweise in Verbindung mit
\s-1MTIOCGET\s+1 benutzt werden.
.IP MTOFFL
Zurckspulen und Bandlaufwerk stoppen.
.IP MTRESET
Reset drive.
.IP MTRETEN
Retension tape.
(Medium nicht auswerfen?)
.IP MTREW
Zurckspulen.
.IP MTSEEK
Suche nach dem BLOCK mit der Nummer
.BR mt_count .
Diese Anweisung erfordert ein SCSI-2 Bandlaufwerk, welches das \s-1LOCATE\s+1
Kommando untersttzt (Laufwerkspezifische Addresse),
oder ein Tandberg-kompatibles SCSI-1 Laufwerk.
(Tandberg, Archive, Viper, Wangtek, ... ).
Die BLOCK NUMMER ist dabei Laufwerk spezifisch und kann mglicherweise
ber den Rckgabewert von \s-1MTIOCPOS\s+1 herausgefunden werden.
.IP MTSETBLK
Setzen der BLOCK Gr0e auf den Wert, der in
.BR mt_count
angegeben ist.
Ein BLOCK Gre von 0 setzt das Laufwerk auf variable BLOCK Gre.
.IP MTSETDENSITY
Setzen der Schreibdichte (tape density) auf den Wert in
.BR mt_count .
bliche Werte fr die Schreibdichte sind
:
.RS 18
.nf
.ta +.5i +1.5i +.5i
0x00 Implicit 0x11 QIC-525
0x04 QIC-11 0x12 QIC-1350
0x05 QIC-24 0x13 DDS
0x0F QIC-120 0x14 Exabyte EXB-8200
0x10 QIC-150 0x15 Exabyte EXB-8500
.fi
.RE
.IP MTWEOF
Schreibe
.B mt_count
Filemarks.
.IP MTWSM
Schreibe
.B mt_count
Setmarks.
.IP MTSETDRVBUFFER 8
Set various drive and driver options according to bits encoded in
.BR mt_count .
.IP
Setzen der Laufwerk und Treiber Optionen.
.IP
Diese bestehen aus dem Setzen des Laufwerk \(lqbuffer\(rq Modi,
6 Treiber Optionen vom Typ Boolean und dem \(lqSchreibschwellwert des
Treiberbuffers.\(rq (buffer write threshold); d.h. ab dem Erreichen
des Schreibschwellwertes wird das Band physikalisch beschrieben.
Diese Parameter knnen nur vor vor dem ersten Schreiben auf Laufwerkes benutzt
werden, und bleiben auch beim Schliessen und ffenen des Devices bestehen.
Eine einzelne Anweisung kann dabei (a) nur den \(lqbuffer\(rq
Modi, und/oder (b) die Schalter von TYP Boolean, und/oder (c) den
Schreibschwellwert des Treiberbuffers betreffen.
.PD
.IP
Ein Wert von 0 in den \(lqhigh-order 4 Bits\(rq muss zum Setzen des
Laufwerk \(lqbuffer\(rq Modi benutzt werden.
Folgende Modi sind mglich:
.RS 12
.IP 0 4
Das Laufwerk gibt erst einen \s-1GOOD\s+1 Status zurck, wenn die
Datenblcke auf das Medium geschrieben wurden.
.PD 0
.IP 1
Mit groer Wahrscheinlichkeit wird das Laufwerk nach einer WRITE
Anweisung einen \s-1GOOD\s+1 Status zurckgeben, wenn alle Daten
in den internen Laufwerksbuffer bertragen sind.
.IP 2
Mit groer Wahrscheinlichkeit wird das Laufwerk nach einer WRITE
Anweisung einen \s-1GOOD\s+1 Status zurckgeben, wenn (a) alle Daten
in den internen Laufwerksbuffer bertragen sind, und (b) alle in dem
Laufwerksbuffer zwischengespeicherten Daten auf das Medium geschrieben
wurden.
.PD
.RE
.IP ""
Der Schwellwert fr das Schreiben wird ber
.B mt_count
kontrolliert.
.PP
.B mt_count
kann wie folgende Werte beinhalten:
.PP
\s-1MT_ST_WRITE_THRESHOLD\s+1
.PP
Logisch -ODER- Verknpft mit einem BLOCK Zhler in den unteren
28 Bits.
(logically ORed with a block count in the low 28 bits.)
Der BLOCK Zhler wird mit 1024-Byte groen BLCKEN bewertet,
nicht mit der wirklichen physikalischen Gre auf dem Medium.
Die Schwellwertgre darf, wie vorher beschrieben, die interne
Treiberbuffergre nicht berschreiten.
.IP
Setzen der Boolean\(aqschen Operatoren:
.PP
false\=falscher Aussagewert, true\=wahrer Aussagewert
.PP
.B mt_count
kann dabei folgende Werte annehmen.
.PP
Die KONSTANTE
.B \s-1MT_ST_BOOLEANS\s+1
logisch ODER verknpft mit einer der folgenden Kombinationen.
Jede nicht benutzte Option wird \(lqfalse\(rq gesetzt.
.IP
.PD 0
.RS
.IP "\s-1MT_ST_BUFFER_WRITES\s+1 (Default: true)"
.IP
Buffer all write operations.
Wird diese Option auf \(lqfalse\(rq gesetzt und das Laufwerk arbeitet
mit einer festen BLOCK Gre, dann mssen alle Schreiboperationen
mit einem vielfachen der BLOCK Gre durchgefhrt werden.
Diese Option muss \(lqfalse\(rq gesetzt werden um ein sicheres
Schreiben auf \(lqMulti-Volumes\(rq zu ermglichen.
.IP "\s-1MT_ST_ASYNC_WRITES\s+1 (Default: true)"
Wird diese Option auf \(lqtrue\(rq gesetzt, wird eine Schreiboperation
direkt beendet, ohne auf das \(lqwirklich physikalische\(rq Schreiben
auf das Medium zu warten.
Ein wirkliches SCSI \(lqWRITE\(rq Kommando wird erst nach erreichen
der Schreibschwellwertgre des Treiberbuffers abgesetzt.
Eine mgliche Fehlermeldung wird erst nach der nchsten Anweisung
zurckgegeben.
Diese Option muss \(lqfalse\(rq gesetzt werden um ein sicheres
Schreiben auf \(lqMulti-Volumes\(rq zu ermglichen.
.IP "\s-1MT_ST_READ_AHEAD\s+1 (Default: true)"
Diese Option wird benutzt um die Zwischenspeicherung von Daten(buffering)
und das \(lqWeiterlesen\(rq (read-ahead) Merkmal des Treibers zu setzen.
Wird diese Option auf \(lqfalse\(rq gesetzt und das Laufwerk arbeitet
mit einer festen BLOCK Gre, dann mssen alle Schreiboperationen
mit einem vielfachen der BLOCK Gre durchgefhrt werden.
.IP "\s-1MT_ST_TWO_FM\s+1 (Default: false)"
Diese Option beinflut das Treiberverhalten beim Schlieen einer Datei.
Normalerweise wird ein einzelnes \(lqFilemark\(rq geschrieben, wenn
diese Option auf \(lqtrue\(rq gesetzt wird werden zwei \(lqFilemarks\(rq
geschrieben und danach an den Anfang des Zweiten zurckgesetzt.
(backspace over the second one)
.PD
.IP
Achtung:
Seid QIC Bandlaufwerke nicht mehr in der Lage sind \(lqFILEMARKS\(rq
zu berschreiben, sollte die Option \(lqtrue\(rq gesetzt werden.
Diese Art von Bandlaufwerken versucht das \(lqEnde der geschrieben Daten\(rq
durch einen Test auf freie Stellen auf dem Medium zu finden, anstatt
nach zwei aufeinanderfolgende \(lqFILEMARKS\(rq zu suchen.
.PP
.PD 0
.IP "\s-1MT_ST_DEBUGGING\s+1 (Default: false)"
Diese Option wird benutzt um die \(lqDebug Meldungen\(rq des Treibers
einzuschalten.(Untersttzung nur, wenn beim Treiberbersetzen
\s-1DEBUG\s+1 gesetzt war.)
.IP "\s-1MT_ST_FAST_EOM\s+1 (Default: false)"
Diese Option fhrt dazu, das die \s-1MTEOM\s+1 Anweisung direkt zum
Laufwerk geschickt wird; Mglicherweise ein Geschwindigkeitsvorteil
der aber dazu fhren kann, das der Treiber die aktuelle Dateinummer
(die normalerweise durch die \s-1MTIOCGET\s+1 Abfrage herausgefunden
werden kann) \(lqvergit\(rq.
Wenn \s-1MT_ST_FAST_EOM\s+1 den Status \(lqfalse\(rq hat, wird der Treiber
eine \s-1MTEOM\s+1 Anfrage mit \(lqforward spacing over files\(rq
beantworten.
.IP \s-1BEISPIEL\s+1
.nf
.ta +.4i +.7i +1i
.BI "struct mtop " mt_cmd ;
.IB "mt_cmd.mt_op" " = \s-1MTSETDRVBUFFER\s+1;"
.IB "mt_cmd.mt_count" " = \s-1MT_ST_BOOLEANS\s+1 |"
.B " \s-1MT_ST_BUFFER_WRITES\s+1 |"
.B " \s-1MT_ST_ASYNC_WRITES\s+1;"
.BI "ioctl(" fd ", \s-1MTIOCTOP\s+1, &" mt_cmd ");"
.fi
.RE
.PD
.SS "\s-1MTIOCGET\s+1 \- Get status"
.PP
Diese Abfrage bentigt ein Argument von Typ
.BR "(struct mtget *)" .
Der Treiber gibt eine EIO Fehlermeldung zurck, wenn das Laufwerk
die Operation nicht ausfhrt.
.PP
.nf
/* Aufbau von \s-1MTIOCGET\s+1 - \(lqBesorge dir den Bandlaufwerk Status\(rq
Anweisung
struct mtget {
long mt_type;
long mt_resid;
/* Die folgenden Register sind Laufwerksabhngig */
long mt_dsreg;
long mt_gstat;
long mt_erreg;
/* Die folgenden zwei Felder werden nicht immer benutzt */
daddr_t mt_fileno;
daddr_t mt_blkno;
};
.fi
.TP
.B mt_type 11
Es gibt viele \(lqHeader\(rq Definitionen fr
.BR mt_type ,
aber der aktuelle Treiber untersttzt generell nur die Typen
\s-1MT_ISSCSI1\s+1 (Generic SCSI-1 tape) und \s-1MT_ISSCSI2\s+1 (Generic SCSI-2 tape).
.PD 0
.TP
.B mt_resid
ist immer Null. (Nicht implementiert fr SCSI Bandlaufwerke.)
.TP
.B mt_dsreg
Gibt die aktuellen Laufwerk Einstellungen fr die BLOCK Grsse (in den
unteren 24 Bits) und der Schreibdichte (in den hohen 8 Bits) aus.
Diese Felder sind durch \s-1MT_ST-BLKSIZE_SHIFT\s+1, \s-1MT_ST_BLKSIZE_MASK\s+1,
\s-1MT_ST_DENSITY_SHIFT\s+1, und \s-1MT_ST_DENSITY_MASK\s+1 definiert.
.TP
.B mt_gstat
Gibt generelle ( Laufwerksunabhngige) Status Informationen zurck.
Das \(lqHeader File\(rq definiert die Makros zum Testen dieser
Status Bits.
.RS
.HP 4
\s-1GMT_EOF(\s+1\fIx\fP\s-1)\s+1:
Das Bandposition ist direkt nach einem \(lqFILEMARK\(rq.
(Immer \(lqfalse\(rq nach einer \s-1MTSEEK\s+1 Anweisung.
.HP
\s-1GMT_BOT(\s+1\fIx\fP\s-1)\s+1:
Die Bandposition ist : Anfang des ersten Datei
(Immer \(lqfalse\(rq nach einer \s-1MTSEEK\s+1 Anweisung.
.HP
\s-1GMT_EOT(\s+1\fIx\fP\s-1)\s+1:
Eine Bandanweisung hat das physikalische Ende des Bandes erreicht (EOT).
.HP
\s-1GMT_SM(\s+1\fIx\fP\s-1)\s+1:
Die Bandposition ist: Am Ende eines \(lqSETMARK.\(rq
(Immer \(lqfalse\(rq nach einer \s-1MTSEEK\s+1 Anweisung.
.HP
\s-1GMT_EOD(\s+1\fIx\fP\s-1)\s+1:
Die Bandposition ist: Am Ende der letzten geschriebenen Datei.
.HP
\s+1GMT_WR_PROT(\s+1\fIx\fP\s-1)\s+1:
Das Laufwerk(Medium??) ist schreibgeschtzt.
Bei manchen Laufwerken kann damit auch gemeint sein, das das
Laufwerk kein Schreiben auf das aktuelle Medium untersttzt.
.HP
\s-1GMT_ONLINE(\s+1\fIx\fP\s-1)\s+1:
Das letzte
.B open()
hat festgestellt, das ein Medium eingelegt ist und das Laufwerk
fr Anweisungen \(lqempfnglich\(rq ist.
.HP
\s-1GMT_D_6250(\s+1\fIx\fP\s-1)\s+1, \s-1GMT_D_1600(\s+1\fIx\fP\s-1)\s+1, \s-1GMT_D_800(\s+1\fIx\fP\s-1)\s+1:
Diese \(lqgenerelle\(rq Status Information gibt die aktuelle
Schreibdichte fr 9-Spuren (nur \(12" Laufwerke) aus
.HP
\s-1GMT_DR_OPEN(\s+1\fIx\fP\s-1)\s+1:
Kein Band eingelegt
.HP
\s-1GMT_IM_REP_EN(\s+1\fIx\fP\s-1)\s+1:
Unverzglicher Report Mode (nicht untersttzt)
Immediate report mode (not supported).
.RE
.TP
.B mt_erreg
Das einzigste definierte Feld in
.B mt_erreg
ist der \(lq Fehlerzhler\(rq (Es werden nur behobene Fehler gezhlt)
in den unteren 16 Bits (wie durch
\s-1MT_ST_SOFTERR_SHIFT\s+1 and \s-1MT_ST_SOFTERR_MASK\s+1 definiert).
Da dieser Zhler keinem Standard unterliegt (also von Laufwerk zu Laufwerk
unterschiedlich sein kann), wird er nicht oft benutzt.
.TP
.B mt_fileno
Ausgabe der aktuellen Datei/Archiv Nummer (zero-based).
Dieser Wert wird auf -1 gesetzt, wenn er nicht bekannt ist.
(Z.B. nach einer \s-1MTBSS\s+1 oder \s-1MTSEEK\s+1 Anweisung).
.TP
.B mt_blkno
Ausgabe der BLOCK Nummer der/des aktuellen Datei/Archiv (zero-based).
Dieser Wert wird auf -1 gesetzt, wenn er nicht bekannt ist.
(Z.B. nach einer \s-1MTBSF\s+1, \s-1MTBSS\s+1 oder \s-1MTSEEK\s+1 Anweisung).
.PD
.SS "\s-1MTIOCPOS\s+1 \- Get tape position"
.PP
Diese Anfrage benutzt ein Argument vom Typ
.B "(struct mtpos *)"
und gibt die aktuelle Band-Block Nummer aus. Diese ist Laufwerksabhngig
und nicht die gleiche wie
.B mt_blkno
welche durch Verwendung von
\s-1MTIOCGET\s+1.
zurckgegeben wird.
Das Laufwerk mu ein SCSI-2 Laufwerk sein, welches die \s-1READ POSITION\s+1
Anweisung untersttzt (Laufwerksabhngige Adresse), oder ein
Tandberg-kompatibles SCSI-1 Laufwerk (Tandberg, Archive, Viper, Wangtek, ... ).
.PP
.nf
/* structure for \s-1MTIOCPOS\s+1 - mag tape get position command */
struct mtpos {
long mt_blkno; /* aktielle Block Nummer */
};
.fi
.SH "RCKGABEWERT"
.IP EIO 14
Die Anweisung wurde nicht zuende gefhrt.
.IP ENOSPC
Eine Schreiboperation konnte nicht beendet werden, da das Ende des
Mediums (EOT) erreicht wurde.
.IP EACCES
Es wurde Versucht ein schreibgeschtztes Medium zu beschreiben.
(Dieser Fehler wird noch nicht bei einem
.BR open() .)
erkannt!)
.IP ENXIO
Beim ffen wurde festgestellt, das das Laufwerk nicht vorhanden ist.
.IP EBUSY
Das Laufwerk wird schon benutzt, oder der Treiber konnte keine
Daten \(lqPuffern\(rq.
(or the driver was unable to allocate a buffer)
.IP EOVERFLOW
Es wurde versucht einen Block mit einer variablen Lnge zu lesen,
der grer als der interne Treiber \(lqPuffer\(rq war.
.IP EINVAL
Einem
.B ioctl()
Aufruf wurde ein unzulssiges Argument bergeben, oder die
angeforderte Block Gre ist unzulssig.
.IP ENOSYS
Unbekannter
.BR ioctl() .
Aufruf
.SH COPYRIGHT
Copyright \(co 1995 Robert K. Nichols - englisches Original
Copyright \(co 1996 Christian Schmidt - deutsche bersetzung
.PP
Dieses Manual darf sowohl in der Original, als auch in der deutschen
Version mit folgender Einschrnkung benutzt, Vervielfltigt und Vertrieben
werden. Dieser Copyright Abschnitt und der \(lqHeader\(rq mu unverndert
in allen Kopien beibehalten werden. Ferner sind die zustzlichen Vereinbarungen
im \(lqHeader\(rq dieses Manuals zu beachten.
.SH "SIEHE AUCH:"
.BR mt (1).
|