mirror of
https://github.com/narrrl/proton-drive-linux.git
synced 2026-11-04 00:47:00 +01:00
nvrl
988b78e810
The first simulation runs found ten open bugs. They are documented here and not fixed yet, as phase 0 of docs/MILESTONE-3.0.0.md changes no behaviour. The runs count each one and end the seed where the mount leaves the model behind. - B122: a rename across folders fails with EIO when the source folder holds the new name. - B123: a second write open on a file just written fails with EIO. - B124: after a replacing rename fails, the file it was replacing is gone from the mount. - B125: a folder made offline fails with EIO once its listing is invalidated. - B126: a file created offline under a name an offline rename freed lands as a conflict copy. - B127: a file created offline lands twice when the answer to its upload is lost. - B128: a file created offline over one deleted offline can be lost. - B129: a file deleted or replaced while its create is on the wire stays on Drive. - B130: a read of a file that a remote change invalidates can hang the daemon. The event sync blocks a runtime worker in inval_inode on the read's page lock. Nothing then drives the runtime's timers, which the read's fetch is waiting for. - B131: a write to a file whose create could not be read back lands as a conflict copy. The create's op is retired before the read-back, so a failed read-back leaves the tree on the placeholder's mtime and no revision id.
Documentation
For users
| Page | What it covers |
|---|---|
| Installation | Packages, building from source, first sign-in, updating and uninstalling |
| User guide | My files, available offline, synced folders, conflicts, Photos, sharing, Trash and versions, Computers, the search launcher, the tray |
| Command-line reference | Every pdfs command, grouped by task, and scripting with --json |
| Configuration | config.json, environment variables, file locations, the systemd service |
| Troubleshooting | Diagnosing problems, common symptoms, starting over, reporting a bug |
| Recovering on a new computer | What survives a lost machine and how to restore your synced folders |
| Changelog | What changed in each release |
For contributors
| Page | What it covers |
|---|---|
| Development guide | Building, running and debugging from source; releasing |
| Architecture | Crates, read and write paths, sync engine, control protocol, threads, threat model |
| Testing | Unit tests and the FUSE acceptance suite |
| Translating | Adding and updating translations |
| Roadmap | Planned work and verification still owed |
| Bug ledger | Every tracked defect with its analysis and status |
| UI/UX plan | Design audit and notes behind the 2.x desktop app |
Also see CONTRIBUTING.md and SECURITY.md in the repository root.