.TH dosopn 3TUK
.SH NAME
dosopn,dosrde,getde,dosnxt - Bereitstellen von DCP-Dateiinformationen
.SH SYNTAX
.nf
\fBint\fR \fBdosopn\fR(\fIpath\fR,\fIdiscp\fR,\fIstatp\fR)
    \fBchar\fR *\fIpath\fR;
    \fBstruct dosdisc\fR *\fIdiscp\fR;
    \fBstruct dostat\fR *\fIstatp\fR;

\fBint\fR \fBdosrde\fR(\fIfd\fR,\fIfn\fR,\fIdnum\fR,\fIadr\fR,\fIstatp\fR)
    \fBint\fR \fIfd\fR;
    \fBchar\fR *\fIfn\fR;
    \fBint\fR \fIdnum\fR;
    \fBlong\fR \fIadr\fR;
    \fBstruct dostat\fR *\fIstatp\fR;

\fBint\fR \fBgetde\fR(\fIfd\fR,\fIstatp\fR)
    \fBint\fR \fIfd\fR;
    \fBstruct dostat\fR *\fIstatp\fR;

\fBunsigned\fR \fBdosnxt\fR(\fIfd\fR,\fIfirst\fR,\fIfat1\fR,\fIfatlen\fR)
    \fBint\fR \fIfd\fR;
    \fBunsigned\fR \fIfirst\fR,\fIfat1\fR;
    \fBint\fR \fIfatlen\fR;
.fi
.SH BESCHREIBUNG
.TP 10
.B dosopn
Durchmustert eine DCP-Verzeichnis-Hierarchie
nach der DCP-Datei \fIpath\fR und es wird eine Struktur \fBdostat\fR, 
die im File
.in +10
dos.h
.in -10
definiert ist, mit den Dateiparametern belegt.Rueckkehrwerte sind
1, wenn gefunden, 0 falls nicht gefunden und -1 bei Lesefehler.
.B dosopn 
benutzt die Funktion \fBdosrde\fR.
.TP
.B dosrde
Durchmustert das Verzeichnis, welches auf dem Datentraeger
\fIfd\fR ab der Adresse \fIadr\fR mit maximal \fIdnum\fR Eintraegen steht, nach dem
Eintrag \fIfn\fR. Wird dieser gefunden, so belegt die Funktion eine
Struktur \fBdostat\fR mit den gueltigen Dateiparametern.
.TP
.B getde
Liesst auf dem Datentraeger \fIfd\fR einen 
32-Byte Verzeichniseintrag, wertet ihn aus und gibt die
Informationen an eine Struktur \fBdostat\fR weiter. Vor dem
Aufruf muss der Bytezaehler des Geraetefiles auf das erste
Byte des Eintrages zeigen. Rueckgabewerte sind 1 bei
ordnungsgemaesser Abarbeitung, 0 falls kein gueltiger Eintrag
mehr im Verzeichnis steht und -1 bei Lesefehler.
.TP 
.B dosnxt
Liefert die Nummer des naechsten Clusters einer Datei, die
auf dem Datentraeger \fIfd\fR steht und deren aktuelle Clusternummer \fIfirst\fR
ist. Dabei gibt \fIfat1\fR die Adresse der ersten FAT an und \fIfatlen\fR
spezifiziert 12 bzw. 16 Bit lange FAT-Eintraege. Ist der aktuelle
Cluster bereits der letzte einer Datei, so gibt \fBdosnxt\fR den Wert
0 zurueck.
.SH SIEHE AUCH
dos.h,dosdev(3TUK)