httpdirfs(1)

mount HTTP directory as a virtual filesystem

Section 1 httpdirfs bookworm source

Description

HTTPDIRFS

NAME

HTTPDirFS - mount HTTP directory as a virtual filesystem

DESCRIPTION

usage: ./httpdirfs [options] URL mountpoint

general options:

--config

Specify a configuration file

-o opt,[opt...]

Mount options

-h --help

Print help

-V --version

Print version

HTTPDirFS options:

-u --username

HTTP authentication username

-p --password

HTTP authentication password

-P --proxy

Proxy for libcurl, for more details refer to https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html

--proxy-username

Username for the proxy

--proxy-password

Password for the proxy

--proxy-cacert

Certificate authority for the proxy

--cache

Enable cache (default: off)

--cache-location

Set a custom cache location (default: "${XDG_CACHE_HOME}/httpdirfs")

--cacert

Certificate authority for the server

--dl-seg-size

Set cache download segment size, in MB (default: 8) Note: this setting is ignored if previously cached data is found for the requested file.

--max-seg-count

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.

--max-conns

Set maximum number of network connections that libcurl is allowed to make. (default: 10)

--retry-wait

Set delay in seconds before retrying an HTTP request after encountering an error. (default: 5)

--user-agent

Set user agent string (default: "HTTPDirFS")

--no-range-check

Disable the build-in check for the server’s support for HTTP range requests

--insecure-tls

Disable licurl TLS certificate verification by setting CURLOPT_SSL_VERIFYHOST to 0

--single-file-mode

Single file mode - rather than mounting a whole directory, present a single file inside a virtual directory.

For mounting a Airsonic / Subsonic server:

--sonic-username

The username for your Airsonic / Subsonic server

--sonic-password

The password for your Airsonic / Subsonic server

--sonic-id3

Enable ID3 mode - this present the server content in Artist/Album/Song layout

--sonic-insecure

Authenticate against your Airsonic / Subsonic server using the insecure username / hex encoded password scheme

FUSE options:

-d -o debug

enable debug output (implies -f)

	-f		foreground operation
	-s		disable multi-threaded operation

-o allow_other

allow access to other users

-o allow_root

allow access to root

-o auto_unmount

auto unmount on process termination

-o nonempty

allow mounts over non-empty file/dir

-o default_permissions enable permission checking by kernel

-o fsname=NAME

set filesystem name

-o subtype=NAME

set filesystem type

-o large_read

issue large read requests (2.4 only)

-o max_read=N

set maximum size of read requests

-o hard_remove

immediate removal (don’t hide files)

-o use_ino

let filesystem set inode numbers

-o readdir_ino

try to fill in d_ino in readdir

-o direct_io

use direct I/O

-o kernel_cache

cache files in kernel

-o [no]auto_cache

enable caching based on modification times (off)

-o umask=M

set file permissions (octal)

-o uid=N

set file owner

-o gid=N

set file group

-o entry_timeout=T

cache timeout for names (1.0s)

-o negative_timeout=T

cache timeout for deleted names (0.0s)

-o attr_timeout=T

cache timeout for attributes (1.0s)

-o ac_attr_timeout=T

auto cache timeout for attributes (attr_timeout)

-o noforget

never forget cached inodes

-o remember=T

remember cached inodes for T seconds (0s)

-o nopath

don’t supply path if not necessary

-o intr

allow requests to be interrupted

-o intr_signal=NUM

signal to send on interrupt (10)

-o modules=M1[:M2...]

names of modules to push onto filesystem stack

-o max_write=N

set maximum size of write requests

-o max_readahead=N

set maximum readahead

-o max_background=N

set number of maximum background requests

-o congestion_threshold=N

set kernel’s congestion threshold

-o async_read

perform reads asynchronously (default)

-o sync_read

perform reads synchronously

-o atomic_o_trunc

enable atomic open+truncate support

-o big_writes

enable larger than 4kB writes

-o no_remote_lock

disable remote file locking

-o no_remote_flock

disable remote file locking (BSD)

-o no_remote_posix_lock disable remove file locking (POSIX)

-o [no_]splice_write

use splice to write to the fuse device

-o [no_]splice_move

move data while splicing to the fuse device

-o [no_]splice_read

use splice to read from the fuse device

Module options:

[iconv]
-o from_code=CHARSET

original encoding of file names (default: UTF-8)

-o to_code=CHARSET

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

[subdir]
-o subdir=DIR

prepend this directory to all paths (mandatory)

-o [no]rellinks

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