 |
Michael Piepers homepage | ||||
 |
BeOS Programs | ||||
|
PalmBeach | ||||
|
PSION Link Protocol description | ||||
|
RFSV Protocol description | ||||
The command FINFO requests information to a file entry. This command resembles the command FDIRREAD very much. The difference consists of the fact that; FINFO the information from entry supplies exactly. In order to receive the information, one must know also the name of the file already, because this is to be indicated as for the call. A preceding FOPEN is not necessary!
It is to be noted that; all values, which are more greater than 8 bits in reverse order will transfer. The LOW byte sent as the first over the line and only then follows the HIGH byte!
That command FINFO has always the same format. It is as a consequence built into the PLP:
| Header | PLP | RFSV FINFO | Footer | CRC | ||
|---|---|---|---|---|---|---|
| 16 10 02 | 32 03 02 01 | Command 16 00 |
Size 21 00 |
absolute file name "REM::/boot/home/psion/agenda.agn" |
10 03 | 12 34 |
A valid response takes place with the command RESPONSE and returns the delivery an error code and several file information.
The block "Fileinfo" contains all information to file/file. Whenever this section is repeated, until all entries of the directory are contained, or which is filled internal buffers! Thereby if the max. length of the PLP is exceeded, then the message is divided into several partial messages!
| Header | PLP | RFSV RESPONSE | ... | ||
|---|---|---|---|---|---|
| 16 10 02 | 33 02 03 01 | Command 2a 00 |
Size 12 00 |
Result 00 00 |
... <.../TD> |
| ... | File info. | ... | ||||
|---|---|---|---|---|---|---|
| ... ... |
Version 02 00 |
Status 21 05 |
File Size a8 02 00 00 |
Mod.Date 14 5d 6f 33 |
Reserve ff ff ff ff |
... ... |
| ... | Footer | CRC |
|---|---|---|
| ... ... |
10 03 | 12 34 |
| bold | Values represent fixed of values, which are used accurately in such a way! |
| italic | Values represent examples, which have a different meaning on the basis the command. |
The command FINFO consists of 3 information units. These have the following meanings:
| Length in byte | possible values | Meaning | |
|---|---|---|---|
| Command | 2 byte | 00 06 (fixed) | The command identifier has always the same value! |
| Size | 2 byte | variable | Ever after length of the file name is to be set this value. |
| File name | at least 1 byte | 0-terminated string | The complete path name is to be indicated, by which the information is to be queried. |
The command FINFO is answered with RESPONSE. This returns the delivery an error code and the information as result to a Directory input. If 00 00 is returned the delivery, then no error occurred.
| Length in byte | possible values | Meaning | |||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Command | 2 byte | 00 2a (fixed) | The command identifier has always the same value! | ||||||||||||||||||||||||||||||
| Size | 2 byte | 00 12 (fixed) | A block of 18 byte is always transmitted | ||||||||||||||||||||||||||||||
| Result | 2 byte | variable | The result can obtain the following values:
|
||||||||||||||||||||||||||||||
| Version | 2 byte | 00 02 | At present only the version 2 is supported. | ||||||||||||||||||||||||||||||
| Status | 2 byte | variable | Describes the status of the file or folder. The following status are possible:
|
||||||||||||||||||||||||||||||
| File Size | 4 byte | variable | The size of the file in absolute bytes is returned the delivery. | ||||||||||||||||||||||||||||||
| Modification date | 4 byte | variable | The modification date of the file is indicated in seconds since Jan 1. 1970 | ||||||||||||||||||||||||||||||
| Reserve | 4 byte | ff ff ff ff | For extensions of the log 4 bytes were kept free |
|
Michael Piepers homepage | ||||
|
BeOS Programs | ||||
|
PalmBeach | ||||
|
PSION Link Protocol description | ||||
|
RFSV Protocol description | ||||