DOS2DOS - Historia wersji

KMK o 09:25, 20 paź 2012

2012-10-20T09:25:10Z

← poprzednia wersja		Wersja z 20 paź 2012, 11:25
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 ==

Krótki: Aktualizacja linku do Suma kontrolna SIO

2011-05-23T23:59:04Z

Aktualizacja linku do Suma kontrolna SIO

← poprzednia wersja		Wersja z 24 maj 2011, 01:59
Linia 98:		Linia 98:
	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).		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ą [[~~CRC~~\|sumą kontrolną]].		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 ===		=== Tabela funkcji ===

KMK: /* Tabela funkcji */

2011-01-04T12:53:10Z

Tabela funkcji

← poprzednia wersja		Wersja z 4 sty 2011, 14:53
Linia 102:		Linia 102:
	=== Tabela funkcji ===		=== Tabela funkcji ===

	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.		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>

KMK: /* Tabela funkcji */

2010-12-21T20:10:35Z

Tabela funkcji

← poprzednia wersja		Wersja z 21 gru 2010, 22:10
Linia 317:		Linia 317:
	</td>		</td>
	<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 o .PCLINK.VOLUME.LABEL (może się on nazywać dowolnie, byleby nie był widoczny po stronie Atari).</p>		<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>		<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>		</td></tr>

KMK: /* Tabela funkcji */

2010-12-21T19:05:22Z

Tabela funkcji

← poprzednia wersja		Wersja z 21 gru 2010, 21:05
Linia 317:		Linia 317:
	</td>		</td>
	<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 ~~te nazwy są zapisywane~~ w "~~głównych~~" ~~katalogach przydzielonych poszczególnym urządzeniom~~: ~~nazwę~~ zawiera plik o ~~nazwie~~ .PCLINK.VOLUME.LABEL</p>		<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 o .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>		<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>		</td></tr>

KMK: /* Tabela funkcji */

2010-12-21T19:02:59Z

Tabela funkcji

← poprzednia wersja		Wersja z 21 gru 2010, 21:02
Linia 317:		Linia 317:
	</td>		</td>
	<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ć ~~jej zmiany~~. W SIO2BSD 1.09 te nazwy są zapisywane w "głównych" katalogach przydzielonych poszczególnym urządzeniom: nazwę zawiera plik o nazwie .PCLINK.VOLUME.LABEL</p>		<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 te nazwy są zapisywane w "głównych" katalogach przydzielonych poszczególnym urządzeniom: nazwę zawiera plik o nazwie .PCLINK.VOLUME.LABEL</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>		<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>		</td></tr>

KMK: /* Tabela funkcji */

2010-12-21T19:02:00Z

Tabela funkcji

← poprzednia wersja		Wersja z 21 gru 2010, 21:02
Linia 312:		Linia 312:
	<p>Odczyt statusów można pominąć, ta operacja nie może się nie udać.</p>		<p>Odczyt statusów można pominąć, ta operacja nie może się nie udać.</p>
	</td></tr>		</td></tr>
	<tr><td>$13 (19)</td><td>CHVOL</td><td>		<tr><td>$14 (20)</td><td>CHVOL</td><td>
	# P przesyła 23 bajty parametrów: od parbuf.fno do parbuf.name (włącznie)		# 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		# S odczytuje 4 bajty statusu: bajt nr 1 zawiera status operacji

KMK: /* Tabela funkcji */

2010-12-21T19:01:31Z

Tabela funkcji

← poprzednia wersja		Wersja z 21 gru 2010, 21:01
Linia 292:		Linia 292:
	0x00, 0x00, /* numer pierwszego wolnego sektora plików */		0x00, 0x00, /* numer pierwszego wolnego sektora plików */
	0x00, 0x00, /* numer =="== katalogów */		0x00, 0x00, /* numer =="== katalogów */
	'P','C','L','i','n','k',' ',' ', /* nazwa "dysku" */		' ',' ',' ',' ',' ',' ',' ',' ', /* nazwa "dysku" */
	0x00, /* liczba ścieżek */		0x00, /* liczba ścieżek */
	0x01, /* zakodowana wielkość sektora */		0x01, /* zakodowana wielkość sektora */
Linia 309:		Linia 309:
	</code>		</code>

	<p>Jak widać, jedyną konkretną informacją jest tu "nazwa dysku" (''volume name''), która zostanie wyświetlona przez SpartaDOS w listingu katalogu. ~~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>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>		<p>Odczyt statusów można pominąć, ta operacja nie może się nie udać.</p>
			</td></tr>
			<tr><td>$13 (19)</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ć jej zmiany. W SIO2BSD 1.09 te nazwy są zapisywane w "głównych" katalogach przydzielonych poszczególnym urządzeniom: nazwę zawiera plik o nazwie .PCLINK.VOLUME.LABEL</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>		</td></tr>
	</table>		</table>

Trub: /* Blok parametrów */

2010-12-21T18:15:40Z

Blok parametrów

← poprzednia wersja		Wersja z 21 gru 2010, 20:15
Linia 40:		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 */

KMK: dr. red.

2010-12-21T13:47:41Z

dr. red.

← poprzednia wersja		Wersja z 21 gru 2010, 15:47
Linia 181:		Linia 181:
	<tr><td>$08 (8)</td><td>INIT</td>		<tr><td>$08 (8)</td><td>INIT</td>
	<td>		<td>
	# P przesyła 1 ~~bajty~~ parametru: parbuf.fno		# 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		# S odczytuje 4 bajty statusu: ostatni bajt zawiera proponowany przez serwer plików, alternatywny kod identyfikacyjny urządzenia (CDEVIC), reszta jest ignorowana
	</td>		</td>
Linia 264:		Linia 264:
	<tr><td>$11 (17)</td><td>GETCWD</td>		<tr><td>$11 (17)</td><td>GETCWD</td>
	<td>		<td>
	# P przesyła ~~cały~~ 1 bajt parametru: parbuf.fno		# 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		# R odczytuje 64 bajty danych: ścieżkę w postaci tekstowej, w formacie SpartaDOS, zakończoną bajtem o wartości 0
	</td>		</td>
Linia 276:		Linia 276:
	</td></tr>		</td></tr>
	<tr><td>$13 (19)</td><td>GETDFREE</td><td>		<tr><td>$13 (19)</td><td>GETDFREE</td><td>
	# P przesyła ~~cały~~ 1 bajt parametru: parbuf.fno		# P przesyła 1 bajt parametru: parbuf.fno
	# R odczytuje 64 bajty danych: tablicę dfree.		# R odczytuje 64 bajty danych: tablicę dfree.
	</td>		</td>