DOKK / manpages / debian 12 / httpdirfs / httpdirfs.1.en

HTTPDirFS - mount HTTP directory as a virtual filesystem

usage: ./httpdirfs [options] URL mountpoint

Specify a configuration file
Mount options
Print help
Print version

HTTP authentication username
HTTP authentication password
Proxy for libcurl, for more details refer to
Username for the proxy
Password for the proxy
Certificate authority for the proxy
Enable cache (default: off)
Set a custom cache location (default: "${XDG_CACHE_HOME}/httpdirfs")
Certificate authority for the server
Set cache download segment size, in MB (default: 8) Note: this setting is ignored if previously cached data is found for the requested file.
Set maximum number of download segments a file can have. (default: 128*1024) With the default setting, the maximum memory usage per file is 128KB. This allows caching files up to 1TB in size using the default segment size.
Set maximum number of network connections that libcurl is allowed to make. (default: 10)
Set delay in seconds before retrying an HTTP request after encountering an error. (default: 5)
Set user agent string (default: "HTTPDirFS")
Disable the build-in check for the server's support for HTTP range requests
Disable licurl TLS certificate verification by setting CURLOPT_SSL_VERIFYHOST to 0
Single file mode - rather than mounting a whole directory, present a single file inside a virtual directory.
For mounting a Airsonic / Subsonic server:
The username for your Airsonic / Subsonic server
The password for your Airsonic / Subsonic server
Enable ID3 mode - this present the server content in Artist/Album/Song layout
Authenticate against your Airsonic / Subsonic server using the insecure username / hex encoded password scheme

enable debug output (implies -f)
foreground operation
disable multi-threaded operation
allow access to other users
allow access to root
auto unmount on process termination
allow mounts over non-empty file/dir

-o default_permissions enable permission checking by kernel

set filesystem name
set filesystem type
issue large read requests (2.4 only)
set maximum size of read requests
immediate removal (don't hide files)
let filesystem set inode numbers
try to fill in d_ino in readdir
use direct I/O
cache files in kernel
enable caching based on modification times (off)
set file permissions (octal)
set file owner
set file group
cache timeout for names (1.0s)
cache timeout for deleted names (0.0s)
cache timeout for attributes (1.0s)
auto cache timeout for attributes (attr_timeout)
never forget cached inodes
remember cached inodes for T seconds (0s)
don't supply path if not necessary
allow requests to be interrupted
signal to send on interrupt (10)
names of modules to push onto filesystem stack
set maximum size of write requests
set maximum readahead
set number of maximum background requests
set kernel's congestion threshold
perform reads asynchronously (default)
perform reads synchronously
enable atomic open+truncate support
enable larger than 4kB writes
disable remote file locking
disable remote file locking (BSD)

-o no_remote_posix_lock disable remove file locking (POSIX)

use splice to write to the fuse device
move data while splicing to the fuse device
use splice to read from the fuse device

Module options:


original encoding of file names (default: UTF-8)
new encoding of the file names (default: ANSI_X3.4-1968)


prepend this directory to all paths (mandatory)
transform absolute symlinks to relative

libcurl SSL engine: OpenSSL/3.0.8 FUSE library version: 2.9.9 using FUSE kernel interface version 7.19

The full documentation for HTTPDirFS is maintained as a Texinfo manual. If the info and HTTPDirFS programs are properly installed at your site, the command

info HTTPDirFS

should give you access to the complete manual.

February 2023 HTTPDirFS version 1.2.5