Skip to content

Commit c380277

Browse files
authored
Rename 'Virtual Drives' to 'Virtual Directory Entries'
1 parent ed6d05a commit c380277

1 file changed

Lines changed: 10 additions & 10 deletions

File tree

en/services/ftp.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -508,21 +508,21 @@ The sequence of operations is:
508508
509509
The GSC should create a timeout after the `RemoveDirectory` command is sent and resend the message as needed (and [described above](#timeouts)).
510510
511-
## Virtual Drives (Directory Alias)
511+
## Virtual Directory Entries (Directory Alias)
512512
513-
MAVFTP supports the concept of "standard" virtual drives for storing particular types of data in a flight-stack-independent and file-system-independent location.
513+
MAVFTP supports the concept of "standard" virtual directories for storing particular types of data in a flight-stack-independent and file-system-independent location.
514514
This allows a GCS to provision or fetch data without having to know how or where it is stored in the target component.
515515
516516
::: info
517517
MAVFTP represents storage on a remote component as a single entity accessible via a directory structure that the protocol exposes.
518518
In order to represent multiple physical drives supported by the component, such as "c" or "d" drives, these can be abstracted to this structure.
519-
Similarly, in order to support virtual drives, components must abstract the syntax that indicates the drive, and map it to their physical file system(s).
519+
Similarly, in order to support virtual directories, components must abstract the syntax that indicates their location, and map it to their physical file system(s).
520520
:::
521521
522-
In the [MAVLink FTP URL Scheme](#mavlink-ftp-url-scheme) a virtual drive is specified using the `@<drive>` prefix, such as `@MAV_LOG` for log files.
522+
In the [MAVLink FTP URL Scheme](#mavlink-ftp-url-scheme) a virtual directory is specified using the `@<directory>` prefix, such as `@MAV_LOG` for log files.
523523
When encoded in the [FILE_TRANSFER_PROTOCOL](#FILE_TRANSFER_PROTOCOL) this prefix should be prepended when a path is being specified.
524524
For example, when [Listing a directory](#list_directory) the request might encode `data[0]` as `@MAV_LOG/path_in_log/`, and the recipient would be expected to map this to the underlying file system.
525-
If the full path including drive is not known, the recipient would NAK with [FileNotFound](#error_codes) (this is just another "not found" error case).
525+
If the full path including virtual directory is not known, the recipient would NAK with [FileNotFound](#error_codes) (this is just another "not found" error case).
526526
527527
The following standard directory locations are defined:
528528
@@ -559,17 +559,17 @@ The CRC32 algorithm used by MAVLink FTP is described in [MAVLink CRCs](../guide/
559559
Resources to be downloaded using MAVLink FTP can be referenced using the following URL-like format:
560560
561561
```txt
562-
mftp://[;comp=<id>][/@<drive>]/<path>
562+
mftp://[;comp=<id>][/@<directory>]/<path>
563563
```
564564

565565
Where:
566566

567-
- `path`: the location of the resource on the target component and virtual drive.
567+
- `path`: the location of the resource on the target component and/or in the virtual directory.
568568
- `id`: target _component ID_ of the component hosting the resource.
569569
The `;comp=<id>` part is optional (if omitted, the resource is downloaded from the current component).
570570
It should be specified if the request must be redirected
571-
- `drive`: A [virtual drive](#virtual-drives-directory-alias) on the target source.
572-
The `@<drive>` part is optional (if omitted, the resource is downloaded from the "normal" drive).
571+
- `directory`: A [virtual directory](#virtual-directory-entries-directory-alias) on the target source.
572+
The `@<directory>` part is optional (if omitted, the resource is downloaded from the "normal" directory path).
573573

574574
For example:
575575

@@ -590,6 +590,6 @@ For example:
590590
- A GCS wanting to download a log might use
591591

592592
```txt
593-
## FTP resource '2024.log' from @MAV_LOG virtual drive
593+
## FTP resource '2024.log' from @MAV_LOG virtual directory
594594
mftp:///@MAV_LOG/2024.log
595595
```

0 commit comments

Comments
 (0)