266 lines
5.8 KiB
Groff
266 lines
5.8 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.1.
|
|
.TH HTTPDIRFS "1" "August 2021" "HTTPDirFS version 1.2.3" "User Commands"
|
|
.SH NAME
|
|
HTTPDirFS \- manual page for HTTPDirFS version 1.2.3
|
|
.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\-\-cache\fR
|
|
Enable cache (default: off)
|
|
.TP
|
|
\fB\-\-cache\-location\fR
|
|
Set a custom cache location
|
|
(default: "${XDG_CACHE_HOME}/httpdirfs")
|
|
.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/1.1.1k
|
|
FUSE library version: 2.9.9
|
|
fusermount3 version: 3.10.3
|
|
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.
|