Homepage von Michael Pieper
BeOS Programme
PalmBeach
PSION Link Protokollbeschreibung
RFSV Protokollbeschreibung

RFSV-Kommando FOPEN


Kommandobeschreibung

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!


Senderichtung (Kommando) im Schnittstellenformat

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

Empfangsrichtung (Ergebnis) im Schnittstellenformat

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.

Kommandobeschreibung

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!
OPEN 00 00Datei öffnen
CREATE 00 01Datei neu erstellen
REPLACE 00 02Datei ersetzen
APPEND 00 03Datei anhängen
UNIQUE 00 04Datei exclusiv öffnen
FSTREAM 00 00Zugriff auf eine binär Datei
FSTREAM_TEXT 00 10Zugriff auf eine Textdatei
FTEXT 00 20Beliebiger Zugriff auf eine Textdatei
FDIR 00 30Beliebiger Zugriff auf ein Verzeichnis
FFORMAT 00 40Device formatieren
FDEVICE 00 50Beliebiger Zugriff auf die Devices
FNODE 00 60Beliebiger Zugriff auf eine NodeNameList
FUPDATE 01 00Lesen und Schreiben erlaubt
FRANDOM 02 00Beliebige Positionierung möglich
FSHARE 04 00File can be shared
Filename ab 1 Byte 0-terminierter String Es ist der Dateiname zu übermitteln, der geöffnet werden soll.

Ergebnisbeschreibung

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:
NO_ERROR 00 00 0 Kein Fehler aufgetreten
E_FILE_NXIST ff df -33 Datei existiert nicht
E_FILE_NAME ff da -38 Dateiname ungültig
E_FILE_DEVICE ff d7 -41 Das Laufwerk ist ungütig
E_FILE_DIR ff d6 -42 Ein Unterverzeichnis des Pfades ist nicht existent.
Du kannst Dir alle definierten Fehlermeldungen anschauen.
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

Letzte Änderung 04.04.1999 von Michael Pieper