DOS2DOS

From Atariki

(Różnice między wersjami)
Jump to: navigation, search
Wersja z dnia 14:19, 17 gru 2010
KMK (Dyskusja | wkład)
(Operacje plikowe)
← Previous diff
Aktualna wersja
KMK (Dyskusja | wkład)

Linia 1: Linia 1:
-Protokół komunikacji ośmiobitowego Atari z pamięciami masowymi, które obsługują własny [[system plików]], np. z innym komputerem wyposażonym w pamięci masowe i działającym pod kontrolą "obcego" systemu operacyjnego. Protokół DOS2DOS został w 2010 roku opracowany przez [[KMK]] i zaimplementowany dla [[SpartaDOS X]] 4.43 (jako sterownik [[PCLink]]) oraz [[SIO2BSD]].+Protokół komunikacji ośmiobitowego Atari z pamięciami masowymi, które obsługują własny [[system plików]], np. z innym komputerem wyposażonym w pamięci masowe i działającym pod kontrolą "obcego" systemu operacyjnego. Protokół DOS2DOS został w 2010 roku opracowany przez [[KMK]] i zaimplementowany dla [[SpartaDOS X]] 4.43 (jako sterownik-klient [[PCLink]]). Jako serwer plików może działać [[SIO2BSD]] oraz emulator [[Altirra]].
== Założenia == == Założenia ==
Linia 9: Linia 9:
Protokół DOS2DOS ma za zadanie dać Atari dostęp do systemu plików urządzenia zewnętrznego bez konieczności implementowania całej obsługi tegoż systemu plików po stronie Atari. Innymi słowy, takie urządzenie zewnętrzne z własnym dyskiem ("peceta") traktuje się jako czarną skrzynkę, która jest serwerem plików. Konkretny typ systemu plików (EXT2, FAT, NTFS, UFS) jest dla Atari obojętny, gdyż całą jego obsługę bierze na siebie serwer i jego system operacyjny. Od strony Atari potrzebny jest program-klient (w idealnym przypadku: nakładka na DOS) wysyłający do serwera polecenia odnoszące się do znajdującej się na serwerze struktury plików (typu "otwórz plik o nazwie tej a tej") i odbierający wyniki zadanych operacji. Protokół DOS2DOS ma za zadanie dać Atari dostęp do systemu plików urządzenia zewnętrznego bez konieczności implementowania całej obsługi tegoż systemu plików po stronie Atari. Innymi słowy, takie urządzenie zewnętrzne z własnym dyskiem ("peceta") traktuje się jako czarną skrzynkę, która jest serwerem plików. Konkretny typ systemu plików (EXT2, FAT, NTFS, UFS) jest dla Atari obojętny, gdyż całą jego obsługę bierze na siebie serwer i jego system operacyjny. Od strony Atari potrzebny jest program-klient (w idealnym przypadku: nakładka na DOS) wysyłający do serwera polecenia odnoszące się do znajdującej się na serwerze struktury plików (typu "otwórz plik o nazwie tej a tej") i odbierający wyniki zadanych operacji.
-== Schemat ogólny ==+== Opis techniczny ==
 + 
 +=== Podstawy ===
Protokół bazuje na protokole [[SIO]]. Wszystkie operacje plikowe realizuje się przy użyciu kombinacji trzech rozkazów SIO: Protokół bazuje na protokole [[SIO]]. Wszystkie operacje plikowe realizuje się przy użyciu kombinacji trzech rozkazów SIO:
Linia 26: Linia 28:
Opcjonalnie serwer plików może rozpoznawać komendę $3F (?), SEND HIGH SPEED INDEX, jeśli komunikacja jest prowadzona przez złącze szeregowe i istnieje potrzeba przyspieszenia transmisji. Opcjonalnie serwer plików może rozpoznawać komendę $3F (?), SEND HIGH SPEED INDEX, jeśli komunikacja jest prowadzona przez złącze szeregowe i istnieje potrzeba przyspieszenia transmisji.
-== Blok parametrów ==+=== Blok parametrów ===
Blok parametrów przesyłany przy inicjowaniu operacji ma zmienną wielkość (wskazaną w DAUX1), gdyż różne operacje wymagają różnej ilości parametrów (np. "open" wymaga podania nazwy pliku itp., a "read" - nie). Blok parametrów przesyłany przy inicjowaniu operacji ma zmienną wielkość (wskazaną w DAUX1), gdyż różne operacje wymagają różnej ilości parametrów (np. "open" wymaga podania nazwy pliku itp., a "read" - nie).
Linia 38: Linia 40:
unsigned char handle; /* uchwyt pliku */ unsigned char handle; /* uchwyt pliku */
unsigned char f1,f2,f3; /* bajty pomocnicze */ unsigned char f1,f2,f3; /* bajty pomocnicze */
- unsigned char f4,f5,f5;+ unsigned char f4,f5,f6;
unsigned char fmode; /* tryb otwarcia pliku */ unsigned char fmode; /* tryb otwarcia pliku */
unsigned char fatr1; /* maska atrybutów wyszukiwanych */ unsigned char fatr1; /* maska atrybutów wyszukiwanych */
Linia 81: Linia 83:
</code> </code>
-== Operacje plikowe ==+=== Schemat operacji I/O ===
-Zdefiniowanych jest tu 20 funkcji realizujących różne operacje na systemie plików. W rzeczywistości są to wewnętrzne funkcje kernela SpartaDOS X 4.43.+Każda z operacji plikowych wymaga przesłania do serwera plików sekwencji komend SIO. Sterownik po stronie Atari gwarantuje przesłanie ich we właściwej kolejności. Podstawowa sekwencja wygląda następująco:
 + 
 +# Inicjowanie operacji: rozkaz P zapisujący blok parametrów.
 +# Status początkowy: rozkaz S, pozwala przejąć od serwera korektę parametrów (głównie wielkości bufora), lub przerwać procedurę w przypadku niepowodzenia i odczytać kod błędu.
 +# Realizacja: rozkaz R nadający lub odbierający właściwy blok danych.
 +# Status końcowy: rozkaz S, odczytanie końcowego statusu operacji.
 + 
 +Wartości DAUX1/2 we wszystkich rozkazach danej sekwencji powinny być takie same, jak dla P.
 + 
 +Nie każda operacja wymaga wykonania wszystkich czterech faz, spora część zadowala się pierwszymi dwiema, a nieliczne nawet tylko pierwszą.
 + 
 +Rozpisanie całości na tego typu fazy podyktowane jest ograniczeniami narzuconymi przez protokół SIO, który np. zasadniczo nie przewiduje przesyłania kodów błędów; SIO przesyła tylko tzw. potwierdzenia (negatywne lub pozytywne), co jest po pierwsze niewystarczające, a po drugie powoduje kłopoty, gdy sterownik SIO podejmie "samowolną" próbę powtórzenia zadanej operacji (co robi zawsze, gdy nadejdzie negatywne potwierdzenie).
 + 
 +Dlatego serwer plików powinien wszystko potwierdzać pozytywnie, zapisywać kod błędu do bloku statusu i liczyć na to, że program-klient odczyta go w następnym kroku. Negatywne potwierdzenie powinno nastąpić tylko wtedy, gdy komenda inicjująca jest nieprawidłowa, tzn. bajty DAUX1/2 wykazują niewłaściwy (zbyt duży) rozmiar bloku parametrów lub nieznany numer wersji protokołu. Poza tym serwer powinien postępować zgodnie ze specyfikacją SIO, a zwłaszcza ignorować bloki z błędną [[suma kontrolna SIO|sumą kontrolną]].
 + 
 +=== Tabela funkcji ===
 + 
 +Zdefiniowanych jest tu 21 funkcji realizujących różne operacje na systemie plików. W rzeczywistości są to wewnętrzne funkcje kernela SpartaDOS X 4.43.
<table border=1 cellpadding=5> <table border=1 cellpadding=5>
-<tr><td><b>Kod</b></td><td><b>Nazwa</b></td><td><b>Opis</b></td></tr>+<tr><td><b>Fno</b></td><td><b>Nazwa</b></td><td><b>Przebieg operacji</b></td><td width="50%"><b>Uwagi</b></td></tr>
-<tr><td>$00 (0)</td><td>FREAD</td><td> </td></tr>+<tr><td>$00 (0)</td><td>FREAD</td><td>
-<tr><td>$01 (1)</td><td>FWRITE</td><td> </td></tr>+# P przesyła 4 bajty parametrów, kolejno: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2. Dwa ostatnie zawierają kolejno młodszy i starszy bajt wielkości bufora (faux4/5 w SpartaDOS X, ICBUFL i ICBUFL+1 w [[CIO]] [[Atari OS]]).
-<tr><td>$02 (2)</td><td>FSEEK</td><td> </td></tr>+# S odczytuje 4 bajty statusu: bajt nr 0 jest ignorowany, bajt nr 1 zawiera ewentualny kod błędu lub $01, dwa ostatnie bajty zawierają "proponowaną" przez serwer plików wielkość bufora. Program-klient musi się zgodzić na tę "propozycję".
-<tr><td>$03 (3)</td><td>FTELL</td><td> </td></tr>+# R odczytuje blok danych o wynegocjowanej wielkości.
-<tr><td>$04 (4)</td><td>FILELENG</td><td> </td></tr>+# S odczytuje 4 bajty statusu: bajt nr 1 zawiera kod błędu lub $01 w przypadku powodzenia.
-<tr><td>$05 (5)</td><td>-</td><td>Funkcja zarezerwowana.</td></tr>+</td>
-<tr><td>$06 (6)</td><td>FNEXT</td><td> </td></tr>+<td>
-<tr><td>$07 (7)</td><td>FCLOSE</td><td> </td></tr>+<p>Jest to operacja odczytu bloku danych z pliku (lub katalogu) uprzednio otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
-<tr><td>$08 (8)</td><td>INIT</td><td> </td></tr>+<p>Objaśnień może wymagać narzucanie programowi-klientowi wielkości bufora przez serwer plików. Dzieje się to tylko wtedy, kiedy serwer plików stwierdza, że blok danych (plik) jest krótszy niż zadeklarowany przez klienta bufor. W każdym innym przypadku serwer "zgadza się" na wielkość zadeklarowaną przez klienta.</p>
-<tr><td>$09 (9)</td><td>FOPEN</td><td> </td></tr>+<p>Ta operacja wymaga po stronie Atari ustawienia dużej wartości timeout (DTIMLO), w granicach 22-25 jednostek.</p>
-<tr><td>$0a (10)</td><td>FFIRST</td><td> </td></tr>+<p>Przesyłanie w ten sposób niewielkich porcji danych (np. pojedynczych bajtów) jest bardzo nieefektywne, program-klient powinien tego typu operacje buforować.</p>
-<tr><td>$0b (11)</td><td>RENAME</td><td> </td></tr>+</td></tr>
-<tr><td>$0c (12)</td><td>REMOVE</td><td> </td></tr>+<tr><td>$01 (1)</td><td>FWRITE</td><td>
-<tr><td>$0d (13)</td><td>CHMOD</td><td> </td></tr>+# P przesyła 4 bajty parametrów, kolejno: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2. Dwa ostatnie zawierają kolejno młodszy i starszy bajt wielkości bufora (faux4/5 w SpartaDOS X, ICBUFL i ICBUFL+1 w [[CIO]] [[Atari OS]]).
-<tr><td>$0e (14)</td><td>MKDIR</td><td> </td></tr>+# S odczytuje 4 bajty statusu: bajt nr 0 jest ignorowany, bajt nr 1 zawiera ewentualny kod błędu lub 1, dwa ostatnie bajty zawierają "proponowaną" przez serwer plików wielkość bufora. Program-klient musi się zgodzić na tę "propozycję".
-<tr><td>$0f (15)</td><td>RMDIR</td><td> </td></tr>+# R zapisuje blok danych o wynegocjowanej wielkości.
-<tr><td>$10 (16)</td><td>CHDIR</td><td> </td></tr>+# S odczytuje 4 bajty statusu: bajt nr 1 zawiera kod błędu lub 1 w przypadku powodzenia.
-<tr><td>$11 (17)</td><td>GETCWD</td><td> </td></tr>+</td>
-<tr><td>$12 (18)</td><td>BOOT</td><td> </td></tr>+<td>
-<tr><td>$13 (19)</td><td>GETDFREE</td><td> </td></tr>+<p>Analogicznie do FREAD, jest to operacja zapisu bloku danych do pliku uprzednio otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
 +<p>SIO2BSD jako serwer plików nie przewiduje bezpośrednich zapisów do katalogów, próba wykonania takiej operacji skończy się [[Kody błędów Atari OS|błędem nr 146]].</p>
 +<p>Inaczej niż w przypadku FREAD, serwer plików zawsze zgadza się na deklarowaną wielkość bufora. Protokół FWRITE jest kopią FREAD po to, żeby program-klient mógł obsłużyć obie operacje jednym podprogramem.</p>
 +<p>Podobnie jak FREAD, FWRITE wymaga po stronie Atari ustawienia dużej wartości timeout (DTIMLO), w granicach 22-25 jednostek.</p>
 +<p>Przesyłanie w ten sposób niewielkich porcji danych (np. pojedynczych bajtów) jest bardzo nieefektywne, program-klient powinien tego typu operacje buforować.</p>
 +</td></tr>
 +<tr><td>$02 (2)</td><td>FSEEK</td>
 +<td>
 +# P przesyła 5 bajtów parametrów: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2, parbuf.f3. Trzy ostatnie zawierają nową pozycję w pliku, z zakresu od 0 do 16777215.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.
 +</td>
 +<td>
 +<p>Ustawienie bieżącej pozycji odczytu i zapisu dla pliku (lub katalogu) otwartego przez FOPEN. Ta pozycja jest to numer bajtu w pliku, który zostanie odczytany lub zapisany jako następny. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
 +<p>Dla plików otwartych do zapisu lub wymiany danych operacja powinna się zawsze udać. Dla plików otwartych do odczytu próba ustawienia pozycji odczytu poza końcem (wielkość + 1) powinna dawać błąd nr 166.</p>
 +</td></tr>
 +<tr><td>$03 (3)</td><td>FTELL</td>
 +<td>
 +# P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.
 +# R odczytuje 3 bajty zawierające wartość pozycji, z zakresu od 0 do 16777215.
 +</td>
 +<td>
 +<p>Odczytanie bieżącej pozycji odczytu i zapisu dla pliku (lub katalogu) otwartego przez FOPEN. Ta pozycja jest to numer bajtu w pliku, który zostanie odczytany lub zapisany jako następny. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
 +<p>Końcowy odczyt statusu jest pomijany, gdyż ta operacja nie może się nie udać.</p>
 +</td></tr>
 +<tr><td>$04 (4)</td><td>FILELENG</td>
 +<td>
 +# P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.
 +# R odczytuje 3 bajty zawierające wielkość wskazanego pliku, z zakresu od 0 do 16777215.
 +</td>
 +<td>
 +<p>Odczytanie wielkości pliku (lub katalogu) otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
 +<p>Końcowy odczyt statusu jest pomijany, gdyż ta operacja nie może się nie udać.</p>
 +</td></tr>
 +<tr><td>$05 (5)</td><td>-</td><td>-</td><td>Funkcja zarezerwowana.</td></tr>
 +<tr><td>$06 (6)</td><td>FNEXT</td>
 +<td>
 +# P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle
 +# R odczytuje 24 bajty danych: status końcowy + wpis katalogowy w [[Format SpartaDOS#Struktura katalogu|formacie SpartaDOS]]
 +</td>
 +<td>
 +<p>Odczytanie następnego wpisu katalogu otwartego uprzednio od odczytu przez FOPEN lub FFIRST. W parbuf.handle znajduje się uchwyt pliku zwrócony przez funkcję otwierającą. Pozostałe parametry (maska plików, atrybuty poszukiwane) wg tego, co zadano funkcji otwierającej.</p>
 +<p>W zwróconym wpisie katalogowym bajty nr 1 i 2 (wskaźnik do mapy sektorów pliku) są, jako bez znaczenia, zawsze wyzerowane.</p>
 +<p>W przypadku, kiedy nie ma więcej wpisów pasujących do zadanych kryteriów, status jest ustawiany na 136 (EOF), a zamiast wpisu katalogowego zwracane są 23 zera.</p>
 +</td></tr>
 +<tr><td>$07 (7)</td><td>FCLOSE</td>
 +<td>
 +# P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle
 +</td>
 +<td>
 +<p>Zamknięcie pliku (lub katalogu) otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.</p>
 +<p>Statusy są ignorowane, gdyż w systemie operacyjnym Atari ta operacja nie może się nie udać.</p>
 +</td></tr>
 +<tr><td>$08 (8)</td><td>INIT</td>
 +<td>
 +# P przesyła 1 bajt parametru: parbuf.fno
 +# S odczytuje 4 bajty statusu: ostatni bajt zawiera proponowany przez serwer plików, alternatywny kod identyfikacyjny urządzenia (CDEVIC), reszta jest ignorowana
 +</td>
 +<td>
 +<p>Inicjowanie komunikacji z serwerem plików. Klient powinien wykonać tę funkcję raz po załadowaniu programu obsługującego protokół DOS2DOS i następny raz przy każdym ciepłym resecie.</p>
 +<p>W odpowiedzi serwer plików zamyka wszystkie bieżąco otwarte pliki, inicjuje się do stanu początkowego i ustawia proponowany kod alternatywny identyfikacyjny urządzenia w bloku statusu. Program-klient może zignorować tę propozycję (serwer musi się odzywać zawsze jako CDEVIC=$6F). W przypadku jej uwzględnienia przesłany kod identyfikacyjny CDEVIC należy rozbić na wartość DUNIT i DDEVIC wg wzorów:</p>
 +* DDEVIC = (CDEVIC & 0xf0) + 1
 +* DUNIT = CDEVIC & 0x0f
 +</td></tr>
 +<tr><td>$09 (9)</td><td>FOPEN</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji (np. błąd 170)
 +# R odczytuje 24 bajty danych: uchwyt pliku plus 23 bajty wpisu katalogowego (w [[Format SpartaDOS#Struktura katalogu|formacie SpartaDOS]]) pliku, który jest otwierany
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera końcowy status operacji
 +</td>
 +<td>
 +<p>Procedura otwarcia wskazanego pliku. Z parametrów przesyłanych przez P parbuf.handle i parbuf.names są ignorowane.</p>
 +<p>Uchwyt zwrócony przez R jest wartością z zakresu od 1 do 15, arbitralnie wybraną przez serwer i identyfikującą plik przy późniejszym wywoływaniu, jako parbuf.handle.</p>
 +<p>W zwróconym wpisie katalogowym bajty nr 1 i 2 (wskaźnik do mapy sektorów pliku) są, jako bez znaczenia, zawsze wyzerowane.</p>
 +</td></tr>
 +<tr><td>$0a (10)</td><td>FFIRST</td>
 +<td>
 +<p>Patrz "Uwagi"</p>
 +</td>
 +<td>
 +<p>Funkcja otwiera wskazany katalog od odczytu a następnie zwraca zawarty w nim pierwszy wpis katalogowy pasujący do zadanych kryteriów (maska plików, maska atrybutów poszukiwanych).</p>
 +<p>W bieżącej implementacji, dla zaoszczędzenia pamięci po stronie Atari, FFIRST zrealizowano jako sekwencję wywołań FOPEN i FNEXT. Z tego powodu serwer plików nie ma potrzeby odróżniać tej funkcji od FOPEN. Kod serwera może jedynie chcieć (na własny użytek) poprawić przesłaną przez Atari wartość parbuf.fmode, która przy FFIRST często wynosi $04 zamiast $14.</p>
 +</td></tr>
 +<tr><td>$0b (11)</td><td>RENAME</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Zmiana nazwy pliku lub katalogu. Wpisy do zmiany wyszukiwane są w katalogu parbuf.path przy użyciu maski parbuf.name, a nowa nazwa powstaje przez kombinację maski parbuf.names z nazwą pasującą do maski parbuf.name (tj. znaki z tej nazwy są wstawiane w te miejsca, na których w parbuf.names są znaki '?'). parbuf.fatr1 decyduje, czy zmiana nazwy będzie dotyczyła plików czy katalogów. Reszta parametrów (oprócz parbuf.fno) jest ignorowana.</p>
 +<p>Jeśli plik o nazwie docelowej już istnieje w katalogu, operacja jest przerywana z błędem nr 151. Jeśli nie da się znaleźć pliku źródłowego, błąd ma numer 170.</p>
 +<p>Zmieniane są wszystkie wpisy, które spełniają podane kryteria.</p>
 +</td></tr>
 +<tr><td>$0c (12)</td><td>REMOVE</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Skasowanie pliku. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1, parbuf.name, parbuf.path. Reszta jest ignorowana.</p>
 +<p>Kasowane są wszystkie pliki, których wpisy spełniają podane kryteria.</p>
 +</td></tr>
 +<tr><td>$0d (13)</td><td>CHMOD</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Zmiana atrybutów wskazanego pliku. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1 (poszukiwane atrybuty), parbuf.fatr2 (nowe atrybuty), parbuf.name, parbuf.path. Reszta jest ignorowana.</p>
 +<p>Zmieniane są wszystkie wpisy, które spełniają podane kryteria.</p>
 +</td></tr>
 +<tr><td>$0e (14)</td><td>MKDIR</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Utworzenie katalogu. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.f1-f6 (data i czas dla katalogu), parbuf.name, parbuf.path. Reszta jest ignorowana.</p>
 +</td></tr>
 +<tr><td>$0f (15)</td><td>RMDIR</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Skasowanie (pustego) podkatalogu. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1, parbuf.name, parbuf.path. Reszta jest ignorowana.</p>
 +</td></tr>
 +<tr><td>$10 (16)</td><td>CHDIR</td>
 +<td>
 +# P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>Zmiana katalogu bieżącego. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.name, parbuf.path. Reszta jest ignorowana.</p>
 +</td></tr>
 +<tr><td>$11 (17)</td><td>GETCWD</td>
 +<td>
 +# P przesyła 1 bajt parametru: parbuf.fno
 +# R odczytuje 64 bajty danych: ścieżkę w postaci tekstowej, w formacie SpartaDOS, zakończoną bajtem o wartości 0
 +</td>
 +<td>
 +<p>Odczytanie ścieżki do katalogu bieżącego. Odczyt statusu można pominąć, ta operacja nie może się nie udać.</p>
 +</td></tr>
 +<tr><td>$12 (18)</td><td>SETBOOT</td>
 +<td>Patrz "Uwagi".</td>
 +<td>
 +<p>Ta funkcja służy do wskazania pliku, który zostanie uruchomiony podczas odczytu wstępnego przy starcie systemu. Ponieważ protokół DOS2DOS w bieżącej wersji nie przewiduje "bootowania" plików binarnych, SETBOOT pozostaje obecnie niezaimplementowane.</p>
 +</td></tr>
 +<tr><td>$13 (19)</td><td>GETDFREE</td><td>
 +# P przesyła 1 bajt parametru: parbuf.fno
 +# R odczytuje 64 bajty danych: tablicę dfree.
 +</td>
 +<td>
 +<p>Odczyt informacji o dysku. Informacje ten podane są w formacie wymaganym przez bibliotekę I/O SpartaDOS X:</p>
 +<code>
 + static uchar dfree[64] =
 + {
 + 0x21, /* nr wersji formatu */
 + 0x00, 0x00, /* wskaźnik do katalogu głównego */
 + 0xff, 0xff, /* całkowita liczba sektorów */
 + 0xff, 0xff, /* liczba wolnych sektorów */
 + 0x00, /* wielkość VTOC w sektorach */
 + 0x00, 0x00, /* numer początkowego sektora VTOC */
 + 0x00, 0x00, /* numer pierwszego wolnego sektora plików */
 + 0x00, 0x00, /* numer =="== katalogów */
 + ' ',' ',' ',' ',' ',' ',' ',' ', /* nazwa "dysku" */
 + 0x00, /* liczba ścieżek */
 + 0x01, /* zakodowana wielkość sektora */
 + 0x80, /* nr wersji */
 + 0x00, 0x02, /* odkodowana wielkość sektora */
 + 0x00, 0x00, /* liczba wpisów w sektorze mapy pliku */
 + 0x01, /* liczba sektorów na klaster */
 + 0x00, 0x00, /* nr sekwencyjny i losowy */
 + 0x00, 0x00, /* wskaźnik ustawiany przez SETBOOT */
 + 0x00, /* znacznik zabezpieczenia przed zapisem */
 + 0,0,0,0,0,0,0,0, /* bajty zarezerwowane */
 + 0,0,0,0,0,0,0,0,
 + 0,0,0,0,0,0,0,0,
 + 0,0,0,0,0
 + };
 +</code>
 + 
 +<p>Jak widać, jedyną konkretną informacją jest tu "nazwa dysku" (''volume name''), która zostanie wyświetlona przez SpartaDOS w listingu katalogu. Spacje zastępowane są nazwą ustawioną przez użytkownika (przy użyciu CHVOL), lub, gdy nic nie zostało ustawione, przez tekst "PCLink x" - ten ostatni znak jest zastępowany numerem urządzenia (przekazanym w młodszym półbajcie DAUX2) zwiększonym o $40 (czyli urządzenie nr 1 = 'A' itd.)</p>
 +<p>Odczyt statusów można pominąć, ta operacja nie może się nie udać.</p>
 +</td></tr>
 +<tr><td>$14 (20)</td><td>CHVOL</td><td>
 +# P przesyła 23 bajty parametrów: od parbuf.fno do parbuf.name (włącznie)
 +# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji
 +</td>
 +<td>
 +<p>CHVOL ustawia "nazwę dysku" dla danego urządzenia, jaka się będzie pojawiać w listingach katalogów (w linii "Volume: ") oraz będzie zwracana przez GETDFREE. Zmiana nazwy powinna być permanentna, tzn. restart serwera plików nie powinien powodować powrotu do nazwy defaultowej. W SIO2BSD 1.09 nazwa urządzenia jest przechowywana w "głównym" katalogu przydzielonym urządzeniu: zawiera ją plik .PCLINK.VOLUME.LABEL (może się on nazywać dowolnie, byleby nie był widoczny po stronie Atari).</p>
 +<p>Z przesłanego bloku parametrów ważne są tylko parbuf.fno i pierwszych 8 znaków parbuf.name, reszta danych jest ignorowana.</p>
 +</td></tr>
</table> </table>
-{{stub}} 
[[Kategoria:Atari 8-bit]] [[Kategoria:Atari 8-bit]]
[[Kategoria:Programowanie Atari 8-bit]] [[Kategoria:Programowanie Atari 8-bit]]
[[Kategoria:Emulacja]] [[Kategoria:Emulacja]]

Aktualna wersja

Protokół komunikacji ośmiobitowego Atari z pamięciami masowymi, które obsługują własny system plików, np. z innym komputerem wyposażonym w pamięci masowe i działającym pod kontrolą "obcego" systemu operacyjnego. Protokół DOS2DOS został w 2010 roku opracowany przez KMK i zaimplementowany dla SpartaDOS X 4.43 (jako sterownik-klient PCLink). Jako serwer plików może działać SIO2BSD oraz emulator Altirra.

Spis treści

Założenia

Dotychczas komunikacja Atari z pamięciami masowymi wygląda w ten sposób, że urządzenie peryferyjne rozpoznaje zestaw bardzo prostych komend, które udostępniają pamięć masową w jej stanie "surowym", tzn. można odczytać albo zapisać pojedyncze sektory i to jest właściwie wszystko. Zadaniem zorganizowania sektorów w system plików zajmuje się komputer Atari, a konkretnie DOS.

Ten system ma swoje zalety, ale kompletnie nie nadaje się do wygodnej wymiany plików pomiędzy różnymi komputerami. Np. przesłanie pliku z twardego dysku Atari na peceta oznacza na ogół nagranie go na obraz dyskietki (ATR), a następnie wyciągnięcie go stamtąd przy użyciu lokalnego oprogramowania. Przesłanie w ten sposób jednego-dwóch plików nie stanowi problemu, ale jeśli plików jest np. 1300, procedura zaczyna być uciążliwa.

Protokół DOS2DOS ma za zadanie dać Atari dostęp do systemu plików urządzenia zewnętrznego bez konieczności implementowania całej obsługi tegoż systemu plików po stronie Atari. Innymi słowy, takie urządzenie zewnętrzne z własnym dyskiem ("peceta") traktuje się jako czarną skrzynkę, która jest serwerem plików. Konkretny typ systemu plików (EXT2, FAT, NTFS, UFS) jest dla Atari obojętny, gdyż całą jego obsługę bierze na siebie serwer i jego system operacyjny. Od strony Atari potrzebny jest program-klient (w idealnym przypadku: nakładka na DOS) wysyłający do serwera polecenia odnoszące się do znajdującej się na serwerze struktury plików (typu "otwórz plik o nazwie tej a tej") i odbierający wyniki zadanych operacji.

Opis techniczny

Podstawy

Protokół bazuje na protokole SIO. Wszystkie operacje plikowe realizuje się przy użyciu kombinacji trzech rozkazów SIO:

  • $50 (P, jak parameters) - zapis - zainicjowanie operacji i nadanie parametrów
  • $52 (R, jak results) - zapis lub odczyt - realizacja operacji, nadanie dodatkowych danych, jeśli są potrzebne, odbiór wyników
  • $53 (S, jak status) - odczyt - negocjacja parametrów i kontrola stanu

Kluczowe znaczenie mają bajty DAUX1/2 bloku DCB:

  • DAUX1 - wielkość bloku parametrów, jaki ma być przesłany rozkazem P (przy pozostałych rozkazach ta wartość jest ignorowana). 0 oznacza 256 bajtów.
  • DAUX2 - bity 7-4: numer wersji protokołu (obecnie 0), bity 3-0: numer urządzenia.

Numer urządzenia przesyłany jest w DAUX2 po to, żeby można było komunikować się z wieloma różnymi urządzeniami plikowymi (mogą to być np. różne katalogi na serwerze plików) zajmując przy tym tylko jeden identyfikator urządzenia SIO. W bieżącej implementacji ten identyfikator to $6F (DDEVIC=$61, DUNIT=$0F). Protokół pozwala serwerowi plików go zmienić, jeśli zachodzi taka potrzeba (użytkownik sobie tego życzy).

Opcjonalnie serwer plików może rozpoznawać komendę $3F (?), SEND HIGH SPEED INDEX, jeśli komunikacja jest prowadzona przez złącze szeregowe i istnieje potrzeba przyspieszenia transmisji.

Blok parametrów

Blok parametrów przesyłany przy inicjowaniu operacji ma zmienną wielkość (wskazaną w DAUX1), gdyż różne operacje wymagają różnej ilości parametrów (np. "open" wymaga podania nazwy pliku itp., a "read" - nie).

W języku C blok ten jest zdefiniowany następująco:

struct
{
     unsigned char fno;           /* numer funkcji */
     unsigned char handle;        /* uchwyt pliku */
     unsigned char f1,f2,f3;      /* bajty pomocnicze */
     unsigned char f4,f5,f6;
     unsigned char fmode;         /* tryb otwarcia pliku */
     unsigned char fatr1;         /* maska atrybutów wyszukiwanych */
     unsigned char fatr2;         /* maska atrybutów nadawanych */
     unsigned char name[12];      /* maska pliku w formacie NNNNNNNNXXX zakończona zerem */
     unsigned char names[12];     /* alternatywna maska pliku w formacie jak powyżej */
     unsigned char path[65];      /* ścieżka dostępu zakończona zerem */
} parbuf;

Tryb otwarcia pliku (fmode) to:

  • $x4 - odczyt
  • $x8 - zapis
  • $x9 - dopisywanie
  • $xc - wymiana danych (zapis/odczyt)

W starszym półbajcie liczy się tylko bit 0 ($1x), jeśli jest ustawiony, operacja dotyczy otwarcia katalogu jako pliku (tzw. bezpośredni dostęp do katalogu). W przeciwnym wypadku operacja dotyczy pliku.

Maska atrybutów wyszukiwanych (fatr1) wybiera atrybuty, jakie ma mieć plik, żeby serwer plików go znalazł. Poszczególne bity są zdefiniowane następująco:

# define RA_PROTECT     0x01      /* tylko zabezpieczone */
# define RA_HIDDEN      0x02      /* tylko ukryte */
# define RA_ARCHIVED    0x04      /* tylko z ustawionym atrybutem A */
# define RA_SUBDIR      0x08      /* tylko katalogi */
# define RA_NO_PROTECT  0x10      /* tylko niezabezpieczone */
# define RA_NO_HIDDEN   0x20      /* tylko nieukryte */
# define RA_NO_ARCHIVED 0x40      /* tylko ze skasowanym atrybutem A */
# define RA_NO_SUBDIR   0x80      /* tylko zwykłe pliki */

Maska $00 wybiera wszystkie pliki. Maska atrybutów nadawanych zdefiniowana jest podobnie:

# define SA_PROTECT     0x01      /* zabezpiecz */
# define SA_HIDE        0x02      /* ukryj */
# define SA_ARCHIVE     0x04      /* oznacz jako zarchiwizowany */
# define SA_UNPROTECT   0x10      /* odbezpiecz */
# define SA_UNHIDE      0x20      /* ujawnij */
# define SA_UNARCHIVE   0x40      /* oznacz jako niezarchiwizowany */

Schemat operacji I/O

Każda z operacji plikowych wymaga przesłania do serwera plików sekwencji komend SIO. Sterownik po stronie Atari gwarantuje przesłanie ich we właściwej kolejności. Podstawowa sekwencja wygląda następująco:

  1. Inicjowanie operacji: rozkaz P zapisujący blok parametrów.
  2. Status początkowy: rozkaz S, pozwala przejąć od serwera korektę parametrów (głównie wielkości bufora), lub przerwać procedurę w przypadku niepowodzenia i odczytać kod błędu.
  3. Realizacja: rozkaz R nadający lub odbierający właściwy blok danych.
  4. Status końcowy: rozkaz S, odczytanie końcowego statusu operacji.

Wartości DAUX1/2 we wszystkich rozkazach danej sekwencji powinny być takie same, jak dla P.

Nie każda operacja wymaga wykonania wszystkich czterech faz, spora część zadowala się pierwszymi dwiema, a nieliczne nawet tylko pierwszą.

Rozpisanie całości na tego typu fazy podyktowane jest ograniczeniami narzuconymi przez protokół SIO, który np. zasadniczo nie przewiduje przesyłania kodów błędów; SIO przesyła tylko tzw. potwierdzenia (negatywne lub pozytywne), co jest po pierwsze niewystarczające, a po drugie powoduje kłopoty, gdy sterownik SIO podejmie "samowolną" próbę powtórzenia zadanej operacji (co robi zawsze, gdy nadejdzie negatywne potwierdzenie).

Dlatego serwer plików powinien wszystko potwierdzać pozytywnie, zapisywać kod błędu do bloku statusu i liczyć na to, że program-klient odczyta go w następnym kroku. Negatywne potwierdzenie powinno nastąpić tylko wtedy, gdy komenda inicjująca jest nieprawidłowa, tzn. bajty DAUX1/2 wykazują niewłaściwy (zbyt duży) rozmiar bloku parametrów lub nieznany numer wersji protokołu. Poza tym serwer powinien postępować zgodnie ze specyfikacją SIO, a zwłaszcza ignorować bloki z błędną sumą kontrolną.

Tabela funkcji

Zdefiniowanych jest tu 21 funkcji realizujących różne operacje na systemie plików. W rzeczywistości są to wewnętrzne funkcje kernela SpartaDOS X 4.43.

FnoNazwaPrzebieg operacjiUwagi
$00 (0)FREAD
  1. P przesyła 4 bajty parametrów, kolejno: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2. Dwa ostatnie zawierają kolejno młodszy i starszy bajt wielkości bufora (faux4/5 w SpartaDOS X, ICBUFL i ICBUFL+1 w CIO Atari OS).
  2. S odczytuje 4 bajty statusu: bajt nr 0 jest ignorowany, bajt nr 1 zawiera ewentualny kod błędu lub $01, dwa ostatnie bajty zawierają "proponowaną" przez serwer plików wielkość bufora. Program-klient musi się zgodzić na tę "propozycję".
  3. R odczytuje blok danych o wynegocjowanej wielkości.
  4. S odczytuje 4 bajty statusu: bajt nr 1 zawiera kod błędu lub $01 w przypadku powodzenia.

Jest to operacja odczytu bloku danych z pliku (lub katalogu) uprzednio otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

Objaśnień może wymagać narzucanie programowi-klientowi wielkości bufora przez serwer plików. Dzieje się to tylko wtedy, kiedy serwer plików stwierdza, że blok danych (plik) jest krótszy niż zadeklarowany przez klienta bufor. W każdym innym przypadku serwer "zgadza się" na wielkość zadeklarowaną przez klienta.

Ta operacja wymaga po stronie Atari ustawienia dużej wartości timeout (DTIMLO), w granicach 22-25 jednostek.

Przesyłanie w ten sposób niewielkich porcji danych (np. pojedynczych bajtów) jest bardzo nieefektywne, program-klient powinien tego typu operacje buforować.

$01 (1)FWRITE
  1. P przesyła 4 bajty parametrów, kolejno: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2. Dwa ostatnie zawierają kolejno młodszy i starszy bajt wielkości bufora (faux4/5 w SpartaDOS X, ICBUFL i ICBUFL+1 w CIO Atari OS).
  2. S odczytuje 4 bajty statusu: bajt nr 0 jest ignorowany, bajt nr 1 zawiera ewentualny kod błędu lub 1, dwa ostatnie bajty zawierają "proponowaną" przez serwer plików wielkość bufora. Program-klient musi się zgodzić na tę "propozycję".
  3. R zapisuje blok danych o wynegocjowanej wielkości.
  4. S odczytuje 4 bajty statusu: bajt nr 1 zawiera kod błędu lub 1 w przypadku powodzenia.

Analogicznie do FREAD, jest to operacja zapisu bloku danych do pliku uprzednio otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

SIO2BSD jako serwer plików nie przewiduje bezpośrednich zapisów do katalogów, próba wykonania takiej operacji skończy się błędem nr 146.

Inaczej niż w przypadku FREAD, serwer plików zawsze zgadza się na deklarowaną wielkość bufora. Protokół FWRITE jest kopią FREAD po to, żeby program-klient mógł obsłużyć obie operacje jednym podprogramem.

Podobnie jak FREAD, FWRITE wymaga po stronie Atari ustawienia dużej wartości timeout (DTIMLO), w granicach 22-25 jednostek.

Przesyłanie w ten sposób niewielkich porcji danych (np. pojedynczych bajtów) jest bardzo nieefektywne, program-klient powinien tego typu operacje buforować.

$02 (2)FSEEK
  1. P przesyła 5 bajtów parametrów: parbuf.fno, parbuf.handle, parbuf.f1, parbuf.f2, parbuf.f3. Trzy ostatnie zawierają nową pozycję w pliku, z zakresu od 0 do 16777215.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.

Ustawienie bieżącej pozycji odczytu i zapisu dla pliku (lub katalogu) otwartego przez FOPEN. Ta pozycja jest to numer bajtu w pliku, który zostanie odczytany lub zapisany jako następny. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

Dla plików otwartych do zapisu lub wymiany danych operacja powinna się zawsze udać. Dla plików otwartych do odczytu próba ustawienia pozycji odczytu poza końcem (wielkość + 1) powinna dawać błąd nr 166.

$03 (3)FTELL
  1. P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.
  3. R odczytuje 3 bajty zawierające wartość pozycji, z zakresu od 0 do 16777215.

Odczytanie bieżącej pozycji odczytu i zapisu dla pliku (lub katalogu) otwartego przez FOPEN. Ta pozycja jest to numer bajtu w pliku, który zostanie odczytany lub zapisany jako następny. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

Końcowy odczyt statusu jest pomijany, gdyż ta operacja nie może się nie udać.

$04 (4)FILELENG
  1. P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji.
  3. R odczytuje 3 bajty zawierające wielkość wskazanego pliku, z zakresu od 0 do 16777215.

Odczytanie wielkości pliku (lub katalogu) otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

Końcowy odczyt statusu jest pomijany, gdyż ta operacja nie może się nie udać.

$05 (5)--Funkcja zarezerwowana.
$06 (6)FNEXT
  1. P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle
  2. R odczytuje 24 bajty danych: status końcowy + wpis katalogowy w formacie SpartaDOS

Odczytanie następnego wpisu katalogu otwartego uprzednio od odczytu przez FOPEN lub FFIRST. W parbuf.handle znajduje się uchwyt pliku zwrócony przez funkcję otwierającą. Pozostałe parametry (maska plików, atrybuty poszukiwane) wg tego, co zadano funkcji otwierającej.

W zwróconym wpisie katalogowym bajty nr 1 i 2 (wskaźnik do mapy sektorów pliku) są, jako bez znaczenia, zawsze wyzerowane.

W przypadku, kiedy nie ma więcej wpisów pasujących do zadanych kryteriów, status jest ustawiany na 136 (EOF), a zamiast wpisu katalogowego zwracane są 23 zera.

$07 (7)FCLOSE
  1. P przesyła 2 bajty parametrów: parbuf.fno, parbuf.handle

Zamknięcie pliku (lub katalogu) otwartego przez FOPEN. W parbuf.handle znajduje się uchwyt pliku zwrócony przez FOPEN.

Statusy są ignorowane, gdyż w systemie operacyjnym Atari ta operacja nie może się nie udać.

$08 (8)INIT
  1. P przesyła 1 bajt parametru: parbuf.fno
  2. S odczytuje 4 bajty statusu: ostatni bajt zawiera proponowany przez serwer plików, alternatywny kod identyfikacyjny urządzenia (CDEVIC), reszta jest ignorowana

Inicjowanie komunikacji z serwerem plików. Klient powinien wykonać tę funkcję raz po załadowaniu programu obsługującego protokół DOS2DOS i następny raz przy każdym ciepłym resecie.

W odpowiedzi serwer plików zamyka wszystkie bieżąco otwarte pliki, inicjuje się do stanu początkowego i ustawia proponowany kod alternatywny identyfikacyjny urządzenia w bloku statusu. Program-klient może zignorować tę propozycję (serwer musi się odzywać zawsze jako CDEVIC=$6F). W przypadku jej uwzględnienia przesłany kod identyfikacyjny CDEVIC należy rozbić na wartość DUNIT i DDEVIC wg wzorów:

  • DDEVIC = (CDEVIC & 0xf0) + 1
  • DUNIT = CDEVIC & 0x0f
$09 (9)FOPEN
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji (np. błąd 170)
  3. R odczytuje 24 bajty danych: uchwyt pliku plus 23 bajty wpisu katalogowego (w formacie SpartaDOS) pliku, który jest otwierany
  4. S odczytuje 4 bajty statusu: bajt nr 1 zawiera końcowy status operacji

Procedura otwarcia wskazanego pliku. Z parametrów przesyłanych przez P parbuf.handle i parbuf.names są ignorowane.

Uchwyt zwrócony przez R jest wartością z zakresu od 1 do 15, arbitralnie wybraną przez serwer i identyfikującą plik przy późniejszym wywoływaniu, jako parbuf.handle.

W zwróconym wpisie katalogowym bajty nr 1 i 2 (wskaźnik do mapy sektorów pliku) są, jako bez znaczenia, zawsze wyzerowane.

$0a (10)FFIRST

Patrz "Uwagi"

Funkcja otwiera wskazany katalog od odczytu a następnie zwraca zawarty w nim pierwszy wpis katalogowy pasujący do zadanych kryteriów (maska plików, maska atrybutów poszukiwanych).

W bieżącej implementacji, dla zaoszczędzenia pamięci po stronie Atari, FFIRST zrealizowano jako sekwencję wywołań FOPEN i FNEXT. Z tego powodu serwer plików nie ma potrzeby odróżniać tej funkcji od FOPEN. Kod serwera może jedynie chcieć (na własny użytek) poprawić przesłaną przez Atari wartość parbuf.fmode, która przy FFIRST często wynosi $04 zamiast $14.

$0b (11)RENAME
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Zmiana nazwy pliku lub katalogu. Wpisy do zmiany wyszukiwane są w katalogu parbuf.path przy użyciu maski parbuf.name, a nowa nazwa powstaje przez kombinację maski parbuf.names z nazwą pasującą do maski parbuf.name (tj. znaki z tej nazwy są wstawiane w te miejsca, na których w parbuf.names są znaki '?'). parbuf.fatr1 decyduje, czy zmiana nazwy będzie dotyczyła plików czy katalogów. Reszta parametrów (oprócz parbuf.fno) jest ignorowana.

Jeśli plik o nazwie docelowej już istnieje w katalogu, operacja jest przerywana z błędem nr 151. Jeśli nie da się znaleźć pliku źródłowego, błąd ma numer 170.

Zmieniane są wszystkie wpisy, które spełniają podane kryteria.

$0c (12)REMOVE
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Skasowanie pliku. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1, parbuf.name, parbuf.path. Reszta jest ignorowana.

Kasowane są wszystkie pliki, których wpisy spełniają podane kryteria.

$0d (13)CHMOD
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Zmiana atrybutów wskazanego pliku. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1 (poszukiwane atrybuty), parbuf.fatr2 (nowe atrybuty), parbuf.name, parbuf.path. Reszta jest ignorowana.

Zmieniane są wszystkie wpisy, które spełniają podane kryteria.

$0e (14)MKDIR
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Utworzenie katalogu. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.f1-f6 (data i czas dla katalogu), parbuf.name, parbuf.path. Reszta jest ignorowana.

$0f (15)RMDIR
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0.
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Skasowanie (pustego) podkatalogu. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.fatr1, parbuf.name, parbuf.path. Reszta jest ignorowana.

$10 (16)CHDIR
  1. P przesyła cały blok parametrów, tj. 35 bajtów plus wszystkie znaki, jakie są w parbuf.path plus bajt o wartości 0
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

Zmiana katalogu bieżącego. Brane są pod uwagę następujące parametry: parbuf.fno, parbuf.name, parbuf.path. Reszta jest ignorowana.

$11 (17)GETCWD
  1. P przesyła 1 bajt parametru: parbuf.fno
  2. R odczytuje 64 bajty danych: ścieżkę w postaci tekstowej, w formacie SpartaDOS, zakończoną bajtem o wartości 0

Odczytanie ścieżki do katalogu bieżącego. Odczyt statusu można pominąć, ta operacja nie może się nie udać.

$12 (18)SETBOOT Patrz "Uwagi".

Ta funkcja służy do wskazania pliku, który zostanie uruchomiony podczas odczytu wstępnego przy starcie systemu. Ponieważ protokół DOS2DOS w bieżącej wersji nie przewiduje "bootowania" plików binarnych, SETBOOT pozostaje obecnie niezaimplementowane.

$13 (19)GETDFREE
  1. P przesyła 1 bajt parametru: parbuf.fno
  2. R odczytuje 64 bajty danych: tablicę dfree.

Odczyt informacji o dysku. Informacje ten podane są w formacie wymaganym przez bibliotekę I/O SpartaDOS X:

static uchar dfree[64] =
{
       0x21,            /* nr wersji formatu */
       0x00, 0x00,      /* wskaźnik do katalogu głównego */
       0xff, 0xff,      /* całkowita liczba sektorów */
       0xff, 0xff,      /* liczba wolnych sektorów */
       0x00,            /* wielkość VTOC w sektorach */
       0x00, 0x00,      /* numer początkowego sektora VTOC */
       0x00, 0x00,      /* numer pierwszego wolnego sektora plików */
       0x00, 0x00,      /* numer =="== katalogów */
       ' ',' ',' ',' ',' ',' ',' ',' ',  /* nazwa "dysku" */
       0x00,            /* liczba ścieżek */
       0x01,            /* zakodowana wielkość sektora */
       0x80,            /* nr wersji */
       0x00, 0x02,      /* odkodowana wielkość sektora */
       0x00, 0x00,      /* liczba wpisów w sektorze mapy pliku */
       0x01,            /* liczba sektorów na klaster */
       0x00, 0x00,      /* nr sekwencyjny i losowy */
       0x00, 0x00,      /* wskaźnik ustawiany przez SETBOOT */
       0x00,            /* znacznik zabezpieczenia przed zapisem */
       0,0,0,0,0,0,0,0, /* bajty zarezerwowane */
       0,0,0,0,0,0,0,0,
       0,0,0,0,0,0,0,0,
       0,0,0,0,0
};

Jak widać, jedyną konkretną informacją jest tu "nazwa dysku" (volume name), która zostanie wyświetlona przez SpartaDOS w listingu katalogu. Spacje zastępowane są nazwą ustawioną przez użytkownika (przy użyciu CHVOL), lub, gdy nic nie zostało ustawione, przez tekst "PCLink x" - ten ostatni znak jest zastępowany numerem urządzenia (przekazanym w młodszym półbajcie DAUX2) zwiększonym o $40 (czyli urządzenie nr 1 = 'A' itd.)

Odczyt statusów można pominąć, ta operacja nie może się nie udać.

$14 (20)CHVOL
  1. P przesyła 23 bajty parametrów: od parbuf.fno do parbuf.name (włącznie)
  2. S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

CHVOL ustawia "nazwę dysku" dla danego urządzenia, jaka się będzie pojawiać w listingach katalogów (w linii "Volume: ") oraz będzie zwracana przez GETDFREE. Zmiana nazwy powinna być permanentna, tzn. restart serwera plików nie powinien powodować powrotu do nazwy defaultowej. W SIO2BSD 1.09 nazwa urządzenia jest przechowywana w "głównym" katalogu przydzielonym urządzeniu: zawiera ją plik .PCLINK.VOLUME.LABEL (może się on nazywać dowolnie, byleby nie był widoczny po stronie Atari).

Z przesłanego bloku parametrów ważne są tylko parbuf.fno i pierwszych 8 znaków parbuf.name, reszta danych jest ignorowana.

Personal tools