Projects / fusedav

git clone https://molodetz.nl/retoor/fusedav.git copy

Files

fusedav

Author: retoor retoor@molodetz.nl

WebDAV filesystem client for Linux using FUSE3. Mounts remote WebDAV servers as local directories.

Architecture

+------------------+ +----------------+ +------------------+
| Local Apps | | FUSE Layer | | WebDAV Server |
| (ls, cp, vim) | --> | (libfuse3) | --> | (Nextcloud, |
| | | | | Apache, etc) |
+------------------+ +----------------+ +------------------+
 |
 +-----+-----+
 | |
 +--------+ +---------+
 | Cache | | libcurl |
 +--------+ +---------+

Features

• RFC 4918 WebDAV protocol support
• FUSE3 filesystem interface
• Metadata and directory caching with configurable TTL
• HTTP Basic authentication
• HTTPS with certificate verification
• Range requests for partial file reads
• Thread-safe operations

Dependencies

• libfuse3 (FUSE filesystem library)
• libcurl (HTTP client with HTTPS support)
• libxml2 (XML parsing for WebDAV responses)
• pthread (POSIX threads)

Installation

Debian/Ubuntu:

sudo apt install libfuse3-dev libcurl4-openssl-dev libxml2-dev build-essential pkg-config

Fedora/RHEL:

sudo dnf install fuse3-devel libcurl-devel libxml2-devel gcc make pkg-config

Arch Linux:

sudo pacman -S fuse3 curl libxml2 base-devel pkg-config

Build

make

Usage

./fusedav --url https://example.com/dav/ --mount-point /mnt/webdav

Options

| Option | Description | |--------|-------------| | -u, --url URL | WebDAV server URL (required) | | -m, --mount-point PATH | Local mount point directory (required) | | -U, --username USER | HTTP Basic auth username | | -p, --password PASS | HTTP Basic auth password | | -c, --cache-ttl MS | Cache TTL in milliseconds (default: 30000) | | -t, --timeout SEC | Request timeout in seconds (default: 10) | | -f, --foreground | Run in foreground | | -d, --debug | Enable debug output | | -h, --help | Show help |

Examples

Mount with authentication:

./fusedav --url https://cloud.example.com/remote.php/dav/files/user/ \
 --username user \
 --password secret \
 --mount-point /mnt/cloud

Mount with custom cache settings:

./fusedav --url https://webdav.example.com/ \
 --mount-point /mnt/dav \
 --cache-ttl 60000 \
 --timeout 30

Debug mode:

./fusedav --url https://example.com/dav/ \
 --mount-point /mnt/dav \
 --debug

Unmounting

fusermount -u /mnt/webdav

Or if mounted as root:

sudo umount /mnt/webdav

Limitations

• No WebDAV Class 2 locking (concurrent writes may conflict)
• No symlink or extended attribute support
• Authentication credentials visible in process list
• Sequential write assumption (random writes fetch entire file first)

Security Notes

• Credentials passed via command line are visible in ps output
• Consider using environment variables for sensitive data
• SSL certificate verification is enabled by default
• Input paths are validated to prevent directory traversal

Error Codes

| HTTP Status | POSIX Error | |-------------|-------------| | 404 Not Found | ENOENT | | 403 Forbidden | EACCES | | 401 Unauthorized | EACCES | | 405 Method Not Allowed | ENOTSUP | | 409 Conflict | EEXIST | | 507 Insufficient Storage | ENOSPC | | 5xx Server Error | EIO |

License

MIT

Files