mirror of
https://github.com/narrrl/proton-drive-linux.git
synced 2026-11-03 16:41:26 +01:00
flush answered ok at once and release synced the scratch file, but close(2) only returns what flush answers, so a full disk at close was reported to nobody. flush now syncs a handle with writes on a worker and returns ENOSPC, EDQUOT or EIO; release then finds the pages on disk instead of writing a whole file back on the dispatch loop. fsync on a descriptor opened for reading no longer fails with EBADF (B222). fallocate passed any mode through and tracked only a punched hole or growth: a zeroed range came back from the remote base at commit, and a collapse or insert corrupted the file. Unsupported modes now get EOPNOTSUPP, zeroed ranges count as written, the real errno is returned, and the state lock is not held across the syscall (B224).
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, sync issues and 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 |
| Security model | What protects your files, what is kept on this computer, what the client connects to |
| Changelog | What changed in each release |
For contributors
| Page | What it covers |
|---|---|
| Development guide | Building, running and debugging from source; common changes; releasing |
| Architecture | Crates, the local tree, read and write paths, the queue, the sync engine, the control protocol, threads, threat model |
| Testing | Unit tests, simulation runs 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 |
Also see CONTRIBUTING.md and SECURITY.md in the repository root.