.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH HTTPDIRFS "1" "September 2023" "HTTPDirFS version 1.2.5" "User Commands"
.SH NAME
HTTPDirFS \- mount HTTP directory as a virtual filesystem
.SH DESCRIPTION
usage: ./httpdirfs [options] URL mountpoint
.SS "general options:"
.TP
\fB\-\-config\fR
Specify a configuration file
.TP
\fB\-o\fR opt,[opt...]
Mount options
.TP
\fB\-h\fR  \fB\-\-help\fR
Print help
.TP
\fB\-V\fR  \fB\-\-version\fR
Print version
.SS "HTTPDirFS options:"
.TP
\fB\-u\fR  \fB\-\-username\fR
HTTP authentication username
.TP
\fB\-p\fR  \fB\-\-password\fR
HTTP authentication password
.TP
\fB\-P\fR  \fB\-\-proxy\fR
Proxy for libcurl, for more details refer to
https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html
.TP
\fB\-\-proxy\-username\fR
Username for the proxy
.TP
\fB\-\-proxy\-password\fR
Password for the proxy
.TP
\fB\-\-proxy\-cacert\fR
Certificate authority for the proxy
.TP
\fB\-\-cache\fR
Enable cache (default: off)
.TP
\fB\-\-cache\-location\fR
Set a custom cache location
(default: "${XDG_CACHE_HOME}/httpdirfs")
.TP
\fB\-\-cacert\fR
Certificate authority for the server
.TP
\fB\-\-dl\-seg\-size\fR
Set cache download segment size, in MB (default: 8)
Note: this setting is ignored if previously
cached data is found for the requested file.
.TP
\fB\-\-max\-seg\-count\fR
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.
.TP
\fB\-\-max\-conns\fR
Set maximum number of network connections that
libcurl is allowed to make. (default: 10)
.TP
\fB\-\-retry\-wait\fR
Set delay in seconds before retrying an HTTP request
after encountering an error. (default: 5)
.TP
\fB\-\-user\-agent\fR
Set user agent string (default: "HTTPDirFS")
.TP
\fB\-\-no\-range\-check\fR
Disable the build\-in check for the server's support
for HTTP range requests
.TP
\fB\-\-insecure\-tls\fR
Disable licurl TLS certificate verification by
setting CURLOPT_SSL_VERIFYHOST to 0
.TP
\fB\-\-single\-file\-mode\fR
Single file mode \- rather than mounting a whole
directory, present a single file inside a virtual
directory.
.IP
For mounting a Airsonic / Subsonic server:
.TP
\fB\-\-sonic\-username\fR
The username for your Airsonic / Subsonic server
.TP
\fB\-\-sonic\-password\fR
The password for your Airsonic / Subsonic server
.TP
\fB\-\-sonic\-id3\fR
Enable ID3 mode \- this present the server content in
Artist/Album/Song layout
.TP
\fB\-\-sonic\-insecure\fR
Authenticate against your Airsonic / Subsonic server
using the insecure username / hex encoded password
scheme
.SS "FUSE options:"
.TP
\fB\-d\fR   \fB\-o\fR debug
enable debug output (implies \fB\-f\fR)
.TP
\fB\-f\fR
foreground operation
.TP
\fB\-s\fR
disable multi\-threaded operation
.TP
\fB\-o\fR allow_other
allow access to other users
.TP
\fB\-o\fR allow_root
allow access to root
.TP
\fB\-o\fR auto_unmount
auto unmount on process termination
.TP
\fB\-o\fR nonempty
allow mounts over non\-empty file/dir
.HP
\fB\-o\fR default_permissions enable permission checking by kernel
.TP
\fB\-o\fR fsname=NAME
set filesystem name
.TP
\fB\-o\fR subtype=NAME
set filesystem type
.TP
\fB\-o\fR large_read
issue large read requests (2.4 only)
.TP
\fB\-o\fR max_read=N
set maximum size of read requests
.TP
\fB\-o\fR hard_remove
immediate removal (don't hide files)
.TP
\fB\-o\fR use_ino
let filesystem set inode numbers
.TP
\fB\-o\fR readdir_ino
try to fill in d_ino in readdir
.TP
\fB\-o\fR direct_io
use direct I/O
.TP
\fB\-o\fR kernel_cache
cache files in kernel
.TP
\fB\-o\fR [no]auto_cache
enable caching based on modification times (off)
.TP
\fB\-o\fR umask=M
set file permissions (octal)
.TP
\fB\-o\fR uid=N
set file owner
.TP
\fB\-o\fR gid=N
set file group
.TP
\fB\-o\fR entry_timeout=T
cache timeout for names (1.0s)
.TP
\fB\-o\fR negative_timeout=T
cache timeout for deleted names (0.0s)
.TP
\fB\-o\fR attr_timeout=T
cache timeout for attributes (1.0s)
.TP
\fB\-o\fR ac_attr_timeout=T
auto cache timeout for attributes (attr_timeout)
.TP
\fB\-o\fR noforget
never forget cached inodes
.TP
\fB\-o\fR remember=T
remember cached inodes for T seconds (0s)
.TP
\fB\-o\fR nopath
don't supply path if not necessary
.TP
\fB\-o\fR intr
allow requests to be interrupted
.TP
\fB\-o\fR intr_signal=NUM
signal to send on interrupt (10)
.TP
\fB\-o\fR modules=M1[:M2...]
names of modules to push onto filesystem stack
.TP
\fB\-o\fR max_write=N
set maximum size of write requests
.TP
\fB\-o\fR max_readahead=N
set maximum readahead
.TP
\fB\-o\fR max_background=N
set number of maximum background requests
.TP
\fB\-o\fR congestion_threshold=N
set kernel's congestion threshold
.TP
\fB\-o\fR async_read
perform reads asynchronously (default)
.TP
\fB\-o\fR sync_read
perform reads synchronously
.TP
\fB\-o\fR atomic_o_trunc
enable atomic open+truncate support
.TP
\fB\-o\fR big_writes
enable larger than 4kB writes
.TP
\fB\-o\fR no_remote_lock
disable remote file locking
.TP
\fB\-o\fR no_remote_flock
disable remote file locking (BSD)
.HP
\fB\-o\fR no_remote_posix_lock disable remove file locking (POSIX)
.TP
\fB\-o\fR [no_]splice_write
use splice to write to the fuse device
.TP
\fB\-o\fR [no_]splice_move
move data while splicing to the fuse device
.TP
\fB\-o\fR [no_]splice_read
use splice to read from the fuse device
.PP
Module options:
.PP
[iconv]
.TP
\fB\-o\fR from_code=CHARSET
original encoding of file names (default: UTF\-8)
.TP
\fB\-o\fR to_code=CHARSET
new encoding of the file names (default: ANSI_X3.4\-1968)
.PP
[subdir]
.TP
\fB\-o\fR subdir=DIR
prepend this directory to all paths (mandatory)
.TP
\fB\-o\fR [no]rellinks
transform absolute symlinks to relative
.PP
libcurl SSL engine: OpenSSL/3.0.11
FUSE library version: 2.9.9
using FUSE kernel interface version 7.19
.SH "SEE ALSO"
The full documentation for
.B HTTPDirFS
is maintained as a Texinfo manual.  If the
.B info
and
.B HTTPDirFS
programs are properly installed at your site, the command
.IP
.B info HTTPDirFS
.PP
should give you access to the complete manual.