Ubuntu Manpage: st - urządzenie taśmy SCSI

nazwa
składnia
opis
wartość zwracana
pliki
uwagi
zobacz także
o stronie
tłumaczenie

NAZWA

       st - urządzenie taśmy SCSI

SKŁADNIA

       #include <sys/mtio.h>

       int ioctl(int fd, int request [, (void *)arg3]);
       int ioctl(int fd, MTIOCTOP, (struct mtop *)mt_cmd);
       int ioctl(int fd, MTIOCGET, (struct mtget *)mt_status);
       int ioctl(int fd, MTIOCPOS, (struct mtpos *)mt_pos);

OPIS

Sterownik st udostępnia interfejs do różnego rodzaju napędów taśm magnetycznych SCSI. Obecnie sterownik
przejmuje kontrolę nad wszystkimi wykrytymi urządzeniami typu "sequential-access" (dostępu
sekwencyjnego). Sterownikowi st przydzielony został numer główny 9.

Każde urządzenie ma osiem numerów podrzędnych. Na pięciu najniższych bitach numeru podrzędnego
reprezentowane są przydzielone kolejno numery urządzeń (kolejność detekcji). Numery podrzędne można
pogrupować w dwóch zbiorach po cztery numery: główne numery podrzędne (urządzenia z przewijaniem), n,
oraz numery urządzeń "bez przewijania", (n+ 128). Urządzenie otwarte przy wykorzystaniu głównego numeru
podrzędnego otrzyma polecenie REWIND podczas jego zamykania. Urządzenia otwierane przy wykorzystaniu
numeru urządzenia "bez przewijania" nie otrzymają takiego rozkazu. (Trzeba zauważyć, że używanie
urządzenia "bez przewijania" do pozycjonowania taśmy, na przykład za pomocą mt, nie prowadzi do
pożądanego efektu: taśma jest przewijana po wydaniu polecenia mt i następne polecenie zaczyna od początku
taśmy.)

W każdej grupie dostępne są cztery numery podrzędne, definiujące urządzenia o różnej charakterystyce
(rozmiar bloku, kompresja, gęstość itp.). Podczas startu systemu dostępne jest tylko pierwsze
urządzenie. Aktywacja pozostałych trzech następuje po zdefiniowaniu ich domyślnych charakterystyk (patrz
niżej). (Zmieniając wartości stałych podczas kompilacji, możliwa jest zmiana równowagi pomiędzy
maksymalną liczbą napędów taśm a liczbą numerów podrzędnych dla każdego napędu. Domyślna alokacja powala
na sterowanie 32 napędami taśm. Na przykład, można sterować nie więcej niż 64 napędami taśm, posiadając
po dwa numery podrzędne dla różnych opcji.)

Pliki urządzeń są zwykle tworzone za pomocą poleceń:

mknod -m 666 /dev/st0 c 9 0
mknod -m 666 /dev/st0l c 9 32
mknod -m 666 /dev/st0m c 9 64
mknod -m 666 /dev/st0a c 9 96
mknod -m 666 /dev/nst0 c 9 128
mknod -m 666 /dev/nst0l c 9 160
mknod -m 666 /dev/nst0m c 9 192
mknod -m 666 /dev/nst0a c 9 224

Brak jest odpowiadających urządzeń blokowych.

Sterownik używa wewnętrznego bufora o rozmiarze dostatecznie dużym, by pomieścił co najmniej jeden blok
taśmy. W jądrach wcześniejszych niż 2.1.121 bufor ten jest przydzielany jako jeden ciągły blok pamięci.
Ogranicza to rozmiar bloku na taśmie do największego ciągłego bloku pamięci, który może zostać
przydzielony przez procedurę przydzielania pamięci w jądrze. Obecnie ograniczenie to wynosi 128 kB dla
architektur 32-bitowych i 256 kB dla architektur 64-bitowych. W nowszych jądrach sterownik przydziela,
jeśli trzeba, pamięć dla bufora w kilku częściach. Domyślna maksymalna liczba fragmentów wynosi 16.
Oznacza to, że maksymalny rozmiar bloku jest bardzo duży (2 MB, jeśli uda się przydzielić 16 bloków po
128 kB).

Rozmiar wewnętrznego bufora sterownika jest określony przez stałą czasu kompilacji, ale można go zmienić
za pomocą opcji startowej jądra. Dodatkowo, sterownik próbuje przydzielać większy bufor tymczasowy, jeśli
zajdzie taka potrzeba w trakcie pracy. Jednakże, przydzielanie podczas pracy dużych ciągłych bloków
pamięci może się nie udać i zaleca się nie polegać za bardzo na przydzielaniu buforów dynamicznych w
jądrach starszych niż 2.1.121 (dotyczy to także ładowania na żądanie sterownika za pomocą kerneld lub
kmod).

Ten sterownik nie zawiera żadnej specyficznej obsługi dla taśm wybranego producenta, czy modelu. Po
starcie systemu opcje urządzenia taśmowego są określane na podstawie firmware napędu. Na przykład, jeśli
firmware napędu wybiera tryb o stałej długości bloku, urządzenie taśmowe również używa trybu o stałej
długości bloku. Opcje te można zmienić za pomocą jawnych wywołań ioctl(2) i zmiany te pozostają aktywne,
gdy urządzenie zostanie zamknięte i ponownie otwarte. Ustawione opcje dotyczą zarówno urządzeń z
przewijaniem, jak i bez przewijania.

Można podawać różne opcje dla różnych urządzeń w ramach podgrupy czterech urządzeń. Opcje są ustawiane
dla urządzenia, gdy jest otwierane. Na przykład, administrator systemu może zdefiniować jedno urządzenie
zapisujące w trybie o stałej długości bloku i jedno zapisujące w trybie o zmiennej długości bloku (jeśli
napęd obsługuje obydwa tryby).

Sterownik obsługuje strefy taśm, jeśli są one obsługiwane przez napęd. (Trzeba tu zwrócić uwagę, że
strefy taśm nie mają nic wspólnego z partycjami dysków [po angielsku w obu przypadkach "partitions" -
przyp. tłum.]. Taśma podzielona na strefy może być widziana jako kilka logicznych taśm na jednym
nośniku). Obsługę stref trzeba włączyć za pomocą ioctl(2). Przy zmianach stref zachowywane jest położenie
na taśmie w obrębie każdej ze stref. Strefę, której mają dotyczyć następne operacje wybiera się za pomocą
ioctl(2). Przełączanie stref odbywa się łącznie z następną operacją na taśmie, aby uniknąć niepotrzebnego
przewijania taśmy. Maksymalna liczba stref na taśmie określona jest przez stałą czasu kompilacji
(pierwotnie: cztery). Sterownik zawiera ioctl(2) pozwalający sformatować taśmę z jedną lub dwiema
strefami.

Urządzenie /dev/tape jest zwykle dowiązaniem zwykłym lub symbolicznym do domyślnego urządzenia
reprezentującego taśmę magnetyczną w danym systemie.

Od jądra 2.6.2, sterownik eksportuje do katalogu sysfs /sys/class/scsi_tape dołączone urządzenia i część
parametrów przypisanych do urządzenia.

Transfer danych
Sterownik może pracować zarówno w trybie o stałej, jak i o zmiennej długości bloku (jeśli napęd obsługuje
oba tryby). W trybie o stałej długości bloku napęd zapisuje bloki określonej długości i rozmiar bloku nie
zależy od liczby bajtów, która została podana systemowej funkcji zapisu. W trybie o zmiennej długości
bloku zapisywany jest jeden blok przy każdym wywołaniu funkcji zapisu, a liczba bajtów podanych tej
funkcji określa rozmiar odpowiedniego bloku na taśmie. Należy tu zwrócić uwagę, ze bloki na taśmie nie
zawierają informacji o trybie zapisu: jedyną ważną rzeczą podczas odczytu jest używanie poleceń
akceptujących rozmiary bloków znajdujących się na taśmie.

W trybie o zmiennej długości bloku ilość odczytywanych bajtów nie musi dokładnie odpowiadać długości
bloku na taśmie. Jeśli liczba bajtów jest większa niż następny blok na taśmie, sterownik zwróci dane, a
funkcja zwróci rozmiar bieżącego bloku. Jeśli długość bloku jest większa niż liczba bajtów, zwrócona
zostanie żądana ilość danych, począwszy od początku bloku, a reszta bloku zostanie odrzucona.

W trybie o stałej długości bloku ilość odczytywanych bajtów może być dowolna, gdy włączone jest
buforowanie. Musi natomiast być wielokrotnością długości bloku, gdy buforowanie jest wyłączone. Jądra
wcześniejsze niż 2.1.121 pozwalały na zapis dowolnej liczby bajtów przy włączonym buforowaniu. Natomiast
w pozostałych przypadkach (jądra wcześniejsze niż 2.1.121 z wyłączonym buforowaniem oraz nowsze jądra)
liczba zapisywanych bajtów musi być wielokrotnością długości bloku na taśmie.

W jądrze 2.6, sterownik stara się używać bezpośrednich transferów pomiędzy buforem użytkownika a
urządzeniem. Jeśli nie jest to możliwe, używany jest wewnętrzny bufor sterownika. Powodem, dla którego
transfer bezpośredni nie jest użyty, może być niepoprawne wyrównanie bufora użytkownika (domyślne wynosi
512 bajtów, ale może być zmienione w sterowniku HBA), niedostępność jednej lub więcej stron bufora
użytkownika dla adaptera SCSI itp.

Znacznik pliku jest zapisywany na taśmie automatycznie, jeśli ostatnią operacją na tej taśmie przed jej
zamknięciem był zapis.

Gdy podczas odczytu napotkany zostanie znacznik pliku, dzieje się co następuje. Jeśli w chwili
natrafienia na znacznik pliku w buforze były dane, zostaną zwrócone dane z bufora. Następny odczyt zwróci
zero bajtów. Kolejne odczyty zwrócą dane z następnego pliku. Koniec zapisanych danych jest sygnalizowany
zwróceniem zerowej liczby bajtów przez dwa kolejne wywołania funkcji odczytu. Trzeci odczyt zwróci błąd.

Kontrolki systemowe (ioctl)
Sterownik obsługuje trzy wywołania funkcji ioctl(2). Wywołania nierozpoznawane przez sterownik i st są
przekazywane do sterownika SCSI. Poniższe definicje pochodzą z pliku /usr/include/linux/mtio.h:

MTIOCTOP — wykonanie operacji na taśmie
To wywołanie wymaga argumentu typu (struct mtop *). Nie wszystkie napędy obsługują wszystkie polecenia.
Jeśli napęd odrzuca polecenie, sterownik przekazuje wartość EIO.

/* Struktura dla polecenia MTIOCTOP dla taśmy magnetycznej: */
struct mtop {
short mt_op; /* operacje zdefiniowane poniżej */
int mt_count; /* liczba powtórzeń operacji */
};

Operacje na taśmie magnetycznej:

MTBSF Przesunięcie do tyłu o mt_count znaczników pliku.

MTBSFM Przesunięcie do tyłu o mt_count znaczników pliku. Ustawienie taśmy po stronie EOT (końca
taśmy) ostatniego znacznika pliku.

MTBSR Przesunięcie do tyłu o mt_count rekordów (bloków taśmy).

MTBSS Przesunięcie do tyłu o mt_count znaczników (setmarks).

MTCOMPRESSION Włączenie kompresji danych na taśmie dla danego napędu, gdy mt_count jest niezerowe,
wyłączenie kompresji, gdy mt_count jest zerem. Polecenie to korzysta z MODE page 15
obsługiwanego przez większość urządzeń DAT.

MTEOM Przesunięcie do końca zapisanej części nośnika (w celu dogrania plików).

MTERASE Usunięcie zapisu z taśmy. W jądrach 2.6 szybkie usuwanie (oznaczenie taśmy jako pustej)
jest wykonywane, gdy argumentem jest zero. W przeciwnym wypadku przeprowadzane jest długie
usuwanie (usuwanie wszystkiego).

MTFSF Przesunięcie do przodu o mt_count znaczników pliku.

MTFSFM Przesunięcie do przodu o mt_count znaczników pliku. Ustawienie taśmy po stronie BOT
(początku taśmy) ostatniego znacznika pliku.

MTFSR Przesunięcie do przodu o mt_count rekordów (bloków taśmy).

MTFSS Przesunięcie do przodu o mt_count znaczników (setmarks).

MTLOAD Wykonanie polecenia SCSI "load" (załadowanie taśmy). Szczególny przypadek dotyczący
wyłącznie niektórych automatycznie ładujących napędów HP: gdy mt_count jest równe stałej
MT_ST_HPLOADER_OFFSET powiększonej o pewną liczbę, to ta liczba jest przesyłana do napędu
dla celów sterowania automatycznym załadowaniem.

MTLOCK Zablokowanie kieszeni napędu taśm.

MTMKPART Sformatowanie taśmy na jedną lub dwie strefy. Gdy mt_count jest niezerowe, określa rozmiar
pierwszej strefy, a druga strefa obejmuje resztę taśmy. Gdy mt_count jest zerem, taśma jest
formatowana jako jedna strefa. Polecenie to nie jest dozwolone dla napędów, dla których
nie włączono obsługi stref (zobacz MT_ST_CAN_PARTITIONS poniżej).

MTNOP Brak operacji — jako efekt uboczny opróżnia bufor sterownika. Powinno się tego używać
przed odczytaniem stanu za pomocą MTIOCGET.

MTOFFL Przewinięcie taśmy i odłączenie napędu.

MTRESET Inicjalizacja napędu.

MTRETEN Wyrównanie napięcia taśmy.

MTREW Przewinięcie.

MTSEEK Wyszukanie na taśmie bloku o numerze podanym w mt_count. Ta operacja wymaga albo
sterownika SCSI-2, który obsługuje polecenie LOCATE (adres specyficzny dla urządzenia) albo
urządzenia SCSI-1 zgodnego z Tandberg (Tandberg, Archive Viper, Wangtek, ... ). Numer
bloku powinien być równy zwróconemu poprzednio przez MTIOCPOS, gdy używany jest adres
specyficzny dla urządzenia.

MTSETBLK Ustawienie długości bloku sterownika równej wartości podanej w mt_count. Długość równa 0
wprowadza napęd w tryb bloków o zmiennej długości.

MTSETDENSITY Ustawienie gęstości zapisu taśmy zakodowanej w mt_count. Kody określające gęstość zapisu
obsługiwane przez dany napęd można znaleźć w jego dokumentacji.

MTSETPART Przełączenie aktywnej strefy na mt_count. Strefy są numerowane od zera. Polecenie to nie
jest dozwolone dla napędów, dla których nie włączono obsługi stref (zobacz
MT_ST_CAN_PARTITIONS poniżej).

MTUNLOAD Wykonanie polecenia SCSI "unload" (nie wysuwa taśmy).

MTUNLOCK Odblokowanie kieszeni napędu taśm.

MTWEOF Zapisanie mt_count znaczników pliku.

MTWSM Zapisanie mt_count znaczników (setmarks).

Polecenia ustawiające opcje dla napędów taśm magnetycznych (mogą być wydawane tylko przez
administratora):

MTSETDRVBUFFER
Ustawienie różnych opcji napędu i sterownika, zgodnie z wartościami pól bitowych przekazanych w
mt_count. Dotyczy to sposobu buforowania przez sterownik, zestawu logicznych parametrów
sterownika oraz progu zapisu bufora, domyślnej długości bloku i gęstości oraz czasów
przeterminowania (tylko w jądrach >= 2.1). Pojedyncze działanie może zmienić ustawienia tylko
dla jednej pozycji z powyższej listy (parametry logiczne są traktowane jako jedna całość).

Wartość, której 4 najwyższe bity są równe 0 zostanie wykorzystana do ustawienia trybu buforowania
napędu. Do wyboru są następujące tryby:

0 Napęd nie będzie sygnalizować stanu GOOD po poleceniach zapisu, dopóki dane nie zostaną
zapisane fizycznie na nośniku.

1 Napęd może sygnalizować stan GOOD po poleceniach zapisu, gdy tylko wszystkie dane zostaną
umieszczone w wewnętrznym buforze napędu.

2 Napęd może sygnalizować stan GOOD po poleceniach zapisu, gdy tylko (a) wszystkie dane
zostaną przesłane do wewnętrznego bufora napędu i (b) wszystkie buforowane dane (z innych
poleceń) zostaną pomyślnie zapisane na nośniku.

Aby kontrolować próg zapisu, wartość mt_count musi zawierać stałą MT_ST_WRITE_THRESHOLD dodaną za
pomocą bitowego OR do liczby bloków w 28 najniższych bitach. Liczba bloków odnosi się do
1024-bajtowych bloków, a nie bloków o fizycznym rozmiarze bloku dla danego urządzenia. Próg
zapisu nie może przekroczyć rozmiaru wewnętrznego bufora napędu (patrz OPIS powyżej).

Aby ustawić lub usunąć opcje logiczne, wartość mt_count musi zawierać jedną ze stałych
MT_ST_BOOLEANS, MT_ST_SETBOOLEANS, MT_ST_CLEARBOOLEANS lub MT_ST_DEFBOOLEANS dodaną za pomocą
bitowego OR do dowolnej kombinacji poniższych opcji. Użycie MT_ST_BOOLEANS powoduje nadanie
wszystkim opcjom wartości podanych na odpowiednich polach bitowych. Przy MT_ST_SETBOOLEANS
ustawione zostaną tylko wybrane opcje, natomiast przy MT_ST_DEFBOOLEANS tylko wybrane opcje
zostaną usunięte.

Za pomocą MT_ST_DEFBOOLEANS ustawiane są domyślne opcje dla urządzenia taśmowego. Nieaktywne
urządzenia taśmowe (np. urządzenia o numerze podrzędnym 32 lub 160) są aktywowane po pierwszym
ustawieniu dla nich domyślnych opcji. Aktywowane urządzenie dziedziczy od urządzenia aktywowanego
podczas startu systemu opcje, które nie zostały jawnie podane.

Dostępne są następujące opcje logiczne:

MT_ST_BUFFER_WRITES (Domyślnie: włączona)
Buforowanie wszystkich operacji zapisu w trybie o stałej długości bloku. Jeśli ta opcja
jest wyłączona i napęd używa stałej długości bloku, wtedy wszystkie operacje zapisu muszą
dotyczyć wielokrotności długości bloku. Opcja ta powinna być wyłączona, jeśli chcemy w
sposób pewny zapisywać archiwa składające się z wielu wolumenów.

MT_ST_ASYNC_WRITES (Domyślnie: włączona)
Gdy opcja ta jest włączona, wtedy operacje zapisu przekazują sterowanie natychmiast, bez
oczekiwania na przesłanie informacji do napędu, jeśli tylko dane mieszczą się w buforze
sterownika. Stopień wypełnienia bufora, przy którym zostanie wydane polecenie zapisu
SCSI, jest określony przez próg zapisu. Wszystkie błędy zgłoszone przez napęd będą
wstrzymane aż do następnej operacji. Opcja ta powinna być wyłączona, jeśli chcemy w sposób
pewny zapisywać archiwa składające się z wielu wolumenów.

MT_ST_READ_AHEAD (Domyślnie: włączona)
Opcja ta powoduje zapewnienie przez sterownik buforowania i odczytu wyprzedzającego w
trybie o stałej długości bloku. Jeśli ta opcja jest wyłączona i napęd używa bloków o
stałej długości, wtedy wszystkie operacje odczytu muszą dotyczyć wielokrotności długości
bloku.

MT_ST_TWO_FM (Domyślnie: wyłączona)
Opcja ta zmienia zachowanie sterownika w momencie zamknięcia pliku. Zwykle towarzyszy
temu zapisanie pojedynczego znacznika końca pliku. Jeśli opcja jest włączona, sterownik
zapisze dwa znaczniki i cofnie się przed drugi.

Uwaga: Ta opcja nie powinna być włączona w przypadku napędów QIC, ponieważ nie są one w
stanie nadpisać danych na znaczniku pliku. Napędy te wykrywają koniec zapisanych danych
poprzez sprawdzenie, czy taśma jest pusta, zamiast stwierdzania dwóch kolejnych znaczników
końca pliku. Większość innych współczesnych napędów również wykrywa koniec zapisanych
danych, więc posługiwanie się dwoma znacznikami końca pliku jest niezbędne jedynie przy
wymianie taśm z niektórymi innymi systemami.

MT_ST_DEBUGGING (Domyślnie: wyłączona)
Ta opcja włącza wypisywanie przez sterownik komunikatów diagnostycznych (skuteczne tylko
gdy sterownik został skompilowany ze zdefiniowaną niezerową wartością DEBUG).

MT_ST_FAST_EOM (Domyślnie: wyłączona)
Włączenie tej opcji powoduje, że polecenia MTEOM są przesyłane bezpośrednio do napędu,
potencjalnie przyspieszając operację, lecz jednocześnie powodując utratę przez sterownik
informacji o aktualnym położeniu taśmy - numerze pliku, zwykle przekazywanego jako wynik
zapytania MTIOCGET. Jeśli opcja MT_ST_FAST_EOM jest wyłączona, sterownik będzie
odpowiadał na polecenie MTEOM przewijaniem taśmy plik po pliku.

MT_ST_AUTO_LOCK (Domyślnie: wyłączona)
Jeśli ta opcja jest włączona, to kieszeń napędu będzie blokowana po otwarciu urządzenia, a
odblokowywana po jego zamknięciu.

MT_ST_DEF_WRITES (Domyślnie: wyłączona)
Opcje taśmy (długość bloku, tryb, kompresja itp.) mogą ulec zmianie przy przełączaniu z
jednego urządzenia skojarzonego z napędem na inne urządzenia skojarzone z tym samym
napędem, w zależności od definicji tych urządzeń. Ta opcja określa, kiedy sterownik
powinien wymusić zmiany wysyłając polecenia SCSI oraz kiedy należy polegać na
właściwościach autodetekcyjnych urządzenia. Jeśli opcja ta jest wyłączona, sterownik
będzie wysyłać polecenia SCSI natychmiast po zmianie urządzenia. Jeśli jest ona włączona,
polecenia SCSI nie zostaną wysłane dopóki nie pojawi się żądanie zapisu. W tym przypadku
firmware napędu może dokonywać podczas odczytu autodetekcji struktury taśmy, a polecenia
SCSI mają na celu jedynie zapewnienie, aby zapis na taśmie odbywał się zgodnie z właściwą
specyfikacją.

MT_ST_CAN_BSR (Domyślnie: wyłączona)
Gdy wykorzystywany jest odczyt wyprzedzający, taśma musi być czasami cofnięta do właściwej
pozycji. Dzieje się to, gdy urządzenie jest zamykane i wykorzystywane jest w tym celu
polecenie SCSI cofania o zadaną ilość rekordów. Niektóre starsze napędy nie potrafią
wykonać tego polecenia w sposób pewny i opcja ta służy to zabronienia napędowi używania
tych poleceń. Końcowym efektem jest nieprawidłowe pozycjonowanie taśmy po zamknięciu
urządzenia przy włączonym odczycie wyprzedzającym w trybie o stałej długości bloku.

MT_ST_NO_BLKLIMS (Domyślnie: wyłączona)
Niektóre napędy nie obsługują polecenia SCSI READ BLOCK LIMITS. Jeśli opcja ta jest
włączona, sterownik nie używa tego polecenia. Wadą jest brak możliwości sprawdzenia przez
sterownik przed wysłaniem polecenia, czy zadana długość bloku jest akceptowana przez
napęd.

MT_ST_CAN_PARTITIONS (Domyślnie: wyłączona)
Opcja ta włącza obsługę kilku stref na jednej taśmie. Dotyczy ona wszystkich urządzeń
skojarzonych z napędem.

MT_ST_SCSI2LOGICAL (Domyślnie: wyłączona)
Ta opcja poleca sterownikowi używanie logicznych adresów bloków zdefiniowanych w
standardzie SCSI-2 podczas wykonywania operacji wyszukiwania (seek) oraz "tell" (dla
poleceń MTSEEK i MTIOCPOS oraz przy zmianie strefy taśmy). W przeciwnym razie używane są
adresy specyficzne dla urządzenia. Włączenie tej opcji jest wysoce zalecane, jeśli napęd
obsługuje adresy logiczne, gdyż zliczają one również znaczniki plików. Niektóre napędy
obsługują wyłącznie logiczne adresy bloków.

MT_ST_SYSV (Domyślnie: wyłączona)
Gdy ta opcja jest włączona, urządzenia taśmowe używają semantyki Systemu V. W przeciwnym
razie używana jest semantyka BSD. Najważniejsza różnica pomiędzy tymi semantykami polega
na tym, co się dzieje, gdy urządzenie używane do odczytu jest zamykane: w semantyce SYSV
taśma jest przewijana do przodu poza najbliższy znacznik pliku, jeśli nie stało się to
wcześniej. W semantyce BSD pozycja taśmy nie jest zmieniana.

MT_NO_WAIT (Domyślnie: wyłączona)
Włącza tryb natychmiastowy niektórych poleceń, np. rewind - nie czeka na zakończenie
polecenia.

Przykład:

struct mtop mt_cmd;
mt_cmd.mt_op = MTSETDRVBUFFER;
mt_cmd.mt_count = MT_ST_BOOLEANS |
MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;
ioctl(fd, MTIOCTOP, mt_cmd);

Domyślny rozmiar bloku dla urządzenia można ustawić przy użyciu MT_ST_DEF_BLKSIZE, a domyślny kod
gęstości można ustawić przy użyciu MT_ST_DEFDENSITY. Wartości tych parametrów powinny być dodane
za pomocą bitowej alternatywy (OR) kodu operacji.

W jądrach 2.1.x i późniejszych wartości czasu przeterminowania (timeout) można ustawić przy
użyciu podpolecenia MT_ST_SET_TIMEOUT dodanego za pomocą bitowego OR do czasu przeterminowania w
sekundach. Długie czasy przeterminowania (wykorzystywane przy poleceniach przewijania i
niektórych innych trwających długo) można ustawić przy użyciu MT_ST_SET_LONG_TIMEOUT. Domyślne
wartości jądra są bardzo długie, aby zapewnić, że pomyślnie wykonywane polecenie nie zostanie
przeterminowane przez żaden napęd. Z tego powodu niniejszy sterownik może sprawiać wrażenie
zawieszonego, nawet gdy jedynie czeka on na przeterminowanie operacji. Polecenia te mogą służyć
do ustawienia bardziej praktycznych wartości dla konkretnego napędu. Czasy przeterminowania
ustawione dla jednego urządzenia dotyczą wszystkich urządzeń skojarzonych z tym samym napędem.

Od jąder 2.4.19 i 2.5.43, sterownik obsługuje bit statusu, wskazujący czy sterownik żąda
czyszczenia. Metoda używana przez napęd do zwrócenia informacji o czyszczeniu jest ustawiona za
pomocą podpolecenia MT_ST_SEL_CLN. Jeśli wartość wynosi 0, to bit czyszczenia wynosi zawsze zero.
Przy wartości jeden, używane są dane TapeAlert zdefiniowane w standardzie SCSI-3 (jeszcze nie
zaimplementowane). Wartości 2-17 są zastrzeżone. Jeśli najniższe osiem bitów wynosi >=18, to
używane są bity z rozszerzonych danych próbkowania. Bity 9-16 określają maskę do wybrania bitów,
które mają być wyszukiwane, a bity 17-23 określają wzorzec bitowy do wyszukiwania. Jeśli wzorzec
bitowy wynosi 0, to jeden lub więcej bitów pod maską oznacza żądanie czyszczenia. Jeśli wzorzec
jest niezerowy, musi od pasować do maskowanego bajtu danych próbkowania.

MTIOCGET — odczytanie stanu
To polecenie wykorzystuje argument typu (struct mtget *).

/* struktura dla MTIOCGET - odczytanie stanu taśmy magn. */
struct mtget {
long mt_type;
long mt_resid;
/* Następne rejestry są specyficzne dla urządzenia */

long mt_dsreg;
long mt_gstat;
long mt_erreg;
/* Kolejne dwa pola nie zawsze są używane */
daddr_t mt_fileno;
daddr_t mt_blkno;
};

mt_type Plik nagłówkowy definiuje wiele możliwych wartości mt_type, lecz bieżący sterownik raportuje
jedynie typy podstawowe MT_ISSCSI1 (Generic SCSI-1 tape) oraz MT_ISSCSI2 (Generic SCSI-2
tape).

mt_resid zawiera numer strefy bieżącej taśmy.

mt_dsreg raportuje bieżące ustawienia długości bloku (w najniższych 24 bitach) oraz gęstości zapisu (w
8 najwyższych bitach). Pola są zdefiniowane przez MT_ST_BLKSIZE_SHIFT, MT_ST_BLKSIZE_MASK,
MT_ST_DENSITY_SHIFT i MT_ST_DENSITY_MASK.

mt_gstat raportuje podstawowe (niezależne od urządzenia) informacje o stanie. Plik nagłówkowy zawiera
definicje makrodefinicji do testowania przekazywanych bitów stanu:

GMT_EOF(x): Taśma została ustawiona tuż za znacznikiem pliku (zawsze nieprawdziwe po poleceniu
MTSEEK).

GMT_BOT(x): Taśma została ustawiona na początku pierwszego pliku (zawsze nieprawdziwe po
poleceniu MTSEEK).

GMT_EOT(x): Wykonanie polecenia spowodowało osiągnięcie fizycznego końca nośnika.

GMT_SM(x): Taśma jest aktualnie ustawiona na znaczniku (setmark) (zawsze nieprawdziwe po
poleceniu MTSEEK).

GMT_EOD(x): Taśma jest ustawiona na końcu zapisanych danych.

GMT_WR_PROT(x): Napęd jest chroniony przed zapisem. W przypadku niektórych urządzeń może to
również oznaczać, że napęd nie obsługuje zapisu na bieżącym typie nośnika.

GMT_ONLINE(x): Ostatnie wykonanie funkcji open(2) zastało napęd gotowy do działania z
odpowiednio umiejscowionym nośnikiem.

GMT_D_6250(x), GMT_D_1600(x), GMT_D_800(x): Ta "podstawowa" informacja o stanie urządzenia
zawiera również ustawienia gęstości zapisu, lecz jedynie dla 9-ścieżkowych ½" urządzeń.

GMT_DR_OPEN(x): Brak taśmy w napędzie.

GMT_IM_REP_EN(x): Tryb natychmiastowego raportowania. To pole bitowe jest ustawiane na 1, gdy
nie ma gwarancji, że dane zostały fizycznie zapisane na taśmie do chwili zakończenia
funkcji zapisu. Natomiast jest ustawiane na zero tylko wtedy, gdy sterownik nie buforuje
danych i napęd został ustawiony na ich niebuforowanie.

GMT_CLN(x): Napęd zażądał czyszczenia. Zaimplementowane w jądrach od wersji 2.4.19 and 2.5.43.

mt_erreg Jedyne pole zdefiniowane w mt_erreg to licznik naprawionych błędów, który znajduje sie w 16
niskich bitach (jak to zdefiniowano przez MT_ST_SOFTERR_SHIFT i MT_ST_SOFTERR_MASK). Z powodu
niezgodności w sposobie zgłaszania naprawionych błędów przez napędy, licznik ten często nie
jest obsługiwany (większość napędów domyślnie nie zgłasza naprawionych błędów, ale można to
zmienić poleceniem SCSI "MODE SELECT").

mt_fileno podaje bieżący numer pliku (licząc od zera). W przypadku gdy numer pliku nie jest znany (np.
po MTBSS lub MTSEEK), przekazywana jest wartość -1.

mt_blkno raportuje numer bloku (licząc od zera) wewnątrz bieżącego pliku. Gdy numer bloku nie jest
znany (np. po poleceniach MTBSF, MTBSS lub MTSEEK), przekazywana jest wartość -1.

MTIOCPOS — odczytanie położenia taśmy
To polecenie używa argumentu typu (struct mtpos *) i podaje bieżący numer bloku taśmy (w sensie, w jakim
go rozumie napęd), co nie jest równoważne z mt_blkno przekazywanym przez MTIOCGET. Musi to być urządzenie
SCSI-2, które obsługuje polecenie READ POSITION (adres specyficzny dla urządzenia) lub urządzenie SCSI-1
zgodne z Tandberg (Tandberg, Archive Viper, Wangtek, ...).

/* struktura dla MTIOCPOS - odczytanie położenia taśmy magn. */
struct mtpos {
long mt_blkno; /* numer bieżącego bloku */
};

WARTOŚĆ ZWRACANA

       EACCES        Nastąpiła  próba  zapisu  lub skasowania taśmy chronionej przed zapisem. (Ten błąd nie jest
                     wykrywany podczas wykonywania funkcji open(2)).

       EBUSY         Urządzenie jest aktualnie w użyciu lub sterownikowi nie udało się przydzielić  pamięci  dla
                     bufora.

       EFAULT        Parametry  polecenia  wskazują  na  obszar  pamięci  nie  należący  do procesu wywołującego
                     funkcję.

       EINVAL        W wywołaniu ioctl(2) podano niedozwolony argument lub podano niedozwolony rozmiar bloku.

       EIO           Wydane polecenie nie może zostać zrealizowane.

       ENOMEM        Liczba bajtów w read(2) jest mniejsza od  następnego  bloku  fizycznego  na  taśmie  (przed
                     jądrami 2.2.18 i 2.4.0-test6 dodatkowe bajty były po cichu ignorowane).

       ENOSPC        Operacja zapisu nie może zostać zakończona ponieważ taśma osiągnęła koniec nośnika.

       ENOSYS        Nieznana funkcja ioctl(2).

       ENXIO         Podczas otwierania, takie urządzenie nie istnieje.

       EOVERFLOW     Nastąpiła  próba  odczytania  lub  zapisu bloku o zmiennej długości, który jest większy niż
                     wewnętrzny bufor sterownika.

       EROFS         Wystąpiła próba otwarcia z opcją O_WRONLY lub O_RDWR, podczas  gdy  taśma  znajduje  się  w
                     napędzie chronionym przed zapisem.

PLIKI

       /dev/st*    automatycznie przewijające urządzenia taśm SCSI

       /dev/nst*   nieprzewijające urządzenia taśm SCSI

UWAGI

1. Podczas wymiany danych pomiędzy systemami, oba systemy muszą uzgodnić długość fizycznego bloku na
taśmie. Parametry napędu po starcie systemu często różnią się od używanych dla danego urządzenia
przez większość systemów operacyjnych. Większość systemów używa napędów w trybie o zmiennej długości
bloku, o ile napęd ten tryb obsługuje. Dotyczy to większości współczesnych napędów, włączając w to
napędy DAT, 8 mm napędy wybierania spiralnego, napędy DLT itp. Można doradzić używanie tych napędów w
trybie o zmiennej długości bloku również w Linuksie (tzn. użycie MTSETBLK lub MTSETDEFBLK przy
starcie systemu w celu ustawienia tego trybu), przynajmniej podczas wymiany danych z obcym systemem.
Wadą tego jest konieczność użycia dość długiego bloku na taśmie, aby otrzymać akceptowalną wydajność
transferu na magistrali SCSI.

2. Wiele programów (np. tar(1)) pozwala użytkownikowi na określenie czynnika określającego rozmiar bloku
w linii poleceń. Należy zauważyć, że określa to długość fizycznego bloku na taśmie jedynie w trybie o
zmiennej długości bloku.

3. Aby można było używać napędów taśm SCSI, to podstawowy sterownik SCSI, sterownik kontrolera SCSI oraz
sterownik taśm SCSI muszą być wkompilowane w jądro lub załadowane jako moduły. Jeśli nie ma
sterownika taśm SCSI, napęd zostanie rozpoznany, ale opisana na tej stronie obsługa taśm nie będzie
dostępna.

4. Sterownik zapisuje komunikaty o błędach na konsolę lub do logów. Kody SENSE zapisane w niektórych
komunikatach są automatycznie tłumaczone na tekst, jeśli w konfiguracji jądra włączono opcję
rozwlekłych komunikatów SCSI.

5. Wewnętrzne buforowanie jądra pozwala na dobrą przepustowość w trybie o określonych blokach również
przy niewielkiej liczbie bajtów odczytywanych (read(2)) i zapisywanych (write(2)). Przy transferach
bezpośrednich nie jest to możliwe i może stanowić niemiłą niespodziankę przy przejściu na jądro 2.6.
Rozwiązaniem jest nakazanie oprogramowaniu użycie większych transferów (często - nakazanie użycia
większych bloków). Jeśli nie jest to możliwe, transfery bezpośrednie mogą być wyłączone.

ZOBACZ TAKŻE

       mt(1)

       Plik drivers/scsi/README.st lub Documentation/scsi/st.txt (jądra w wersji >= 2.6) w drzewie źródeł  jądra
       Linux zawierający najświeższe informacje dotyczące sterownika i jego możliwości konfiguracyjnych.

O STRONIE

       Angielska  wersja  tej strony pochodzi z wydania 4.05 projektu Linux man-pages. Opis projektu, informacje
       dotyczące  zgłaszania   błędów,   oraz   najnowszą   wersję   oryginału   można   znaleźć   pod   adresem
       https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia   niniejszej  strony  podręcznika  man  są:  Piotr  Pogorzelski  (PTM)
       <piotr.pogorzelski@ippt.gov.pl>, Andrzej M.  Krzysztofowicz  (PTM)  <ankry@green.mf.pg.gda.pl>  i  Michał
       Kułach <michal.kulach@gmail.com>.

       Polskie  tłumaczenie  jest  częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie błędów na stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  4.05 oryginału.