Homepage von Michael Pieper | |||||
BeOS Programme | |||||
PalmBeach | |||||
PSION Link Protokollbeschreibung | |||||
RFSV Protokollbeschreibung |
Das Kommando FOPEN wird verwendet um entweder eine Datei, einen Ordner oder ein ganzes Device zu öffnen! Um später damit arbeiten zu können, wird ein Filehandle zurückgeliefert, der bei weiteren Aktionen verwendet werden muß!
Es ist zu beachten, daß alle Werte, die größer sind als 8 Bit in umgekehrter Reihenfolge übertragen werden. Das LOW-Byte wird als erstes über die Leitung geschickt und erst dann folgt das HIGH-Byte!
Der Befehl FOPEN ist folgendermaßen in das PLP eingebaut:
Header | PLP | RFSV-FOPEN | Footer | CRC | |||
---|---|---|---|---|---|---|---|
16 10 02 | 32 03 02 01 | Kommando 00 00 |
Größe 17 00 |
Mode 05 00 |
Filename "REM::\M:\AGN\AGENDA.AGN" |
10 03 | 12 34 |
Eine gültige Antwort erfolgt mit dem Kommando RESPONSE und liefert einen Fehlercode, oder einen gültigen Filedeskriptor zurück. Nachfolgend ist ein Beispiel dargestellt, das das Filehandle 1 zurückliefert.
Header | PLP | RFSV-RESPONSE | Footer | CRC | |||
---|---|---|---|---|---|---|---|
16 10 02 | 33 02 03 01 | Kommando 2a 00 |
Größe 04 00 |
Ergebnis 00 00 |
Filehandle 01 00 |
10 03 | 12 34 |
fette | Werte stellen feste Werte dar, die exakt so verwendet werden! |
kursive | Werte stellen Beispiele dar, die anhand des Befehls eine unterschiedliche Bedeutung haben. |
Das Kommando FOPEN besteht aus 4 Informationseinheiten. Diese haben folgende Bedeutungen:
Länge in Byte | mögliche Werte | Bedeutung | ||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Kommando | 2 Byte | 00 00 (fest) | Die Kommandokennung hat immer den gleichen Wert! | |||||||||||||||||||||||||||||||||||||||||||||
Größe | 2 Byte | variabel | Da der Dateiname mit übermittelt wird, hängt der hier benötigte Wert von der Länge des Dateinamens ab! Die Länge, die hier angegeben wird, umfaßt den Bereich Mode + Filename inclusive des abschließenden 0-Bytes beim Filenamen! | |||||||||||||||||||||||||||||||||||||||||||||
Mode | 2 Byte | variabel | Der Openmodus setzt sich durch Addition der folgenden Werte zusammen!
|
|||||||||||||||||||||||||||||||||||||||||||||
Filename | ab 1 Byte | 0-terminierter String | Es ist der Dateiname zu übermitteln, der geöffnet werden soll. |
Das Kommando FOPEN wird mit einem RESPONSE beantwortet. Dieser liefert als Ergebnis einen Fehlercode und im Erfolgsfalle einen Filediskriptor zurück, der bei weiteren Zugriffen auf die Datei benützt werden muß!
Länge in Byte | mögliche Werte | Bedeutung | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Kommando | 2 Byte | 00 2a (fest) | Die Kommandokennung hat immer den gleichen Wert! | ||||||||||||||||||||
Größe | 2 Byte | 00 04 (fest) | Es werden immer 4 zsuätzliche Byte geliefert! | ||||||||||||||||||||
Ergebnis | 2 Byte | variabel | Das Ergebnis kann folgende Werte erhalten:
|
||||||||||||||||||||
Filehandle | 2 Byte | variabel | Es wird der Filehandle geliefert, mit dem erneut auf die geöffnete Datei zugegriffen werden kann. |
Homepage von Michael Pieper | |||||
BeOS Programme | |||||
PalmBeach | |||||
PSION Link Protokollbeschreibung | |||||
RFSV Protokollbeschreibung |