[libfuse-fs]: add rootless doc support #242
Conversation
Signed-off-by: Luxian <[email protected]>
There was a problem hiding this comment.
Pull Request Overview
This PR adds rootless execution support and documentation for the libfuse-fs project. The main focus is enabling non-root users to run FUSE filesystems by documenting the capability-granting process and changing the default mount mode from privileged to unprivileged.
Key Changes:
- Changed default mount mode from privileged to unprivileged in passthrough example
- Added comprehensive documentation for rootless execution with
setcapinstructions - Created automation scripts for running passthrough and overlay filesystem demos
- Updated version and license format in Cargo.toml
Reviewed Changes
Copilot reviewed 6 out of 8 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
project/libfuse-fs/script/run_passthrough.sh |
New bash script automating passthrough filesystem demo setup and execution |
project/libfuse-fs/script/run_overlayfs.sh |
New bash script automating overlay filesystem demo setup and execution |
project/libfuse-fs/examples/passthrough.rs |
Changed default mount mode to unprivileged and added debug logging initialization |
project/libfuse-fs/README.md |
Added rootless execution documentation, updated example commands, and corrected example binary names |
project/libfuse-fs/Cargo.toml |
Version bump and standardized license format |
project/libfuse-fs/.gitignore |
Added target directory to ignore list |
| tracing_subscriber::fmt::init(); | ||
| debug!("Starting passthrough filesystem with args: {:?}", args); |
There was a problem hiding this comment.
The debug! macro is used before its import is visible. The code needs use tracing::debug; or similar import statement to compile successfully.
| # Build the example first | ||
| cargo build --example passthrough | ||
|
|
||
| # Grant capabilities for rootless operation |
There was a problem hiding this comment.
The relative path ../target/debug/examples/passthrough assumes the command is run from a specific directory. Should document from which directory this command should be executed (likely the project root or libfuse-fs directory).
| # Grant capabilities for rootless operation | |
| # Grant capabilities for rootless operation | |
| # Run this command from the project/libfuse-fs directory (crate root) |
Signed-off-by: Ricky-Daxia <[email protected]>
2 participants
No description provided.