Michael Piepers homepage
BeOS Programs
PalmBeach
PSION Link Protocol description
RFSV Protocol description

RFSV command CHANGEDIR

Description of command

To change the command CHANGEDIR used around the path. By this command an implementation does not need to know, how the separator is constituted in a hierarchical file system.

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!


Transmission direction (command) in the interface format

The instruction CHANGEDIR has two different developments. In the first version it has a parameter fewer. The parameter "Ordnername" is "Mode" dependent on the parameter;. Is the value of "Mode" CD_SUBDIR (00 03), then the second version is used.

The first version serves to change into the ROOT directory, or into the parent list.

Header PLP RFSV-CHANGEDIR version 1 Footer CRC
16 10 02 32 03 02 01 Command
26 00
Size
23 00
Mode
01 00
Path name
"REM::M:\TEMP"
10 03 12 34

The second version is used, if it is to be more deeply changed into a directory.

Header PLP RFSV-CHANGEDIR version 2 Footer CRC
16 10 02 32 03 02 01 Command
26 00
Size
23 00
Mode
03 00
Path name
"REM::M:\TEMP"
File name
"ABD"
10 03 12 34

Receipt direction (result) in the interface format

A valid response takes place with the command RESPONSE and returns the delivery an error code, as well as the path, which developed from the directory change.

Header PLP RFSV-RESPONSE Footer CRC
16 10 02 33 02 03 01 Command
2a 00
Size
25 00
Result
00 00
Path name
"REM::M:\TEMP\ABD"
10 03 12 34
boldValues represent fixed of values, which are used accurately in such a way!
italicValues represent examples, which have a different meaning on the basis the instruction.

Description of command

The command CHANGEDIR consists of 5 information units. These have the following meanings:

Length in byte possible values Meaning
Command 2 byte 00 26 (fixed) The command identifier has always the same value!
Size 2 byte variable Since the path name with is transmitted, the value of the length of the path name, needed here, depends! The final 0-Byte is to be considered with the length.
Mode 2 byte variable The mode indicates, how the new directory is to be calculated.
CD_ROOT 00 00Into the highest directory change.
CD_PARENT00 01One directory level upward change.
CD_SUBDIR 00 02Into the directory change, which is indicated by file name.
Path name 1 byte or more 0-terminated string The path name is to be transmitted, from which is to be changed.
File name 1 byte or more 0-terminated string This parameter exists only, if it is "Mode" CD_SUBDIR. This parameter indicates the file, into which is to be changed.

Description of result

The command CHANGEDIR is answered with RESPONSE. This supplies an error code as result and in case of success a path name, which to the corresponds to target path after CHANGEDIR would have been also executed.

Length in byte possible values Meaning
Command 2 byte 00 2a (fixed) The command identifier has always the same value!
Size 2 byte variable The length depends on the returned the delivery path name.
Result 2 byte variable The result can obtain the following values:
NO_ERROR 00 00No error occurred
You can look at all defined errorvalues.
Path name 2 byte 0-terminated string The path name is supplied, which would develop after the change, if it is executed as indicated in the command. This file must not exist!

Michael Piepers homepage
BeOS Programs
PalmBeach
PSION Link Protocol description
RFSV Protocol description


Last modification Oct 03 1999 by Michael Pieper