fuseftp 0.1.0

Mount FTP servers as local filesystems
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# fuseftp

A Rust library for mounting FTP servers as FUSE filesystems.

## Usage

```rust
use fuseftp::{ServerConfig, FtpFilesystem};
use fuser::{MountOption, Session};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = ServerConfig {
        host: "ftp.example.com".into(),
        ..Default::default()
    };

    let fs = FtpFilesystem::connect(&config)?;
    let options = [MountOption::RW];
    let mut session = Session::new(fs, "/mnt/ftp", &options)?;
    session.run()?;
    Ok(())
}
```

The `Session::run()` call blocks until the filesystem is unmounted.

## Features

| Feature | Default | Description |
|---------|---------|-------------|
| `tls` | Yes | Enables TLS support via [suppaftp](https://crates.io/crates/suppaftp)'s `native-tls` feature. |
| `clap` | No | Enables `clap` derives for config types (used by fuseftp-cli). |

### Default (with TLS)

```toml
[dependencies]
fuseftp = "0.1"
```

### Without TLS

```toml
[dependencies]
fuseftp = { version = "0.1", default-features = false }
```

## Limitations

- **File Permissions**: Changing file permissions requires support for
  `SITE CHMOD`. This command is available on most Unix-based servers but not on
  Windows-based servers, where permissions must be managed through the operating
  system directly.

- **Symbolic Links**: Creating symbolic links requires support for
  `SITE SYMLINK`, which is non-standard and only available on some servers.
  Additionally, paths containing spaces are not supported because the FTP
  protocol has no standard quoting mechanism for `SITE` command arguments.

- **Hard Links**: Hard links are not supported by the FTP protocol.

## Related Crates

- [fuseftp-cli](https://crates.io/crates/fuseftp-cli) - Command-line interface
- [fuseftp-mount-helper](https://crates.io/crates/fuseftp-mount-helper) - mount(8) integration

## License

MIT or Apache-2.0