rdelaage
/
httpdirfs
mirror of https://github.com/fangfufu/httpdirfs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update README.md

This commit is contained in:
Fufu Fang 2018-07-24 06:03:48 +01:00
parent 37576f5e68
commit e2d23dbdcd
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
README.md
View File

@ -5,13 +5,19 @@ Have you ever wanted to mount those HTTP directory listings as if it was a parti
The performance of the program is excellent, due to the use of curl-multi interface. HTTP connections are reused, and HTTP pipelining is used when available. I haven't benchmarked it, but I feel this is faster than ``rclone mount``.
## Usage
./httpdirfs -f $URL $YOUR_MOUNT_POINT
./httpdirfs -f -s $URL $YOUR_MOUNT_POINT
An example URL would be [Debian CD Image Server](https://cdimage.debian.org/debian-cd/). The ``-f`` flag keeps the program in the foreground, which is useful for monitoring which URL the filesystem is visiting.
You have to run the program in single-threaded mode by passing in the ``-s`` flag, otherwise libcurl will crash.
## The Technical Details
I noticed that most HTTP directory listings don't provide the file size for the web page itself. I suppose this makes perfect sense, as they are generated on the fly. Whereas the actual files have got file sizes. So the listing pages can be treated as folders, and the rest are files.
This program downloads the HTML web pages/files using [libcurl](https://curl.haxx.se/libcurl/), then parses the listing pages using [Gumbo](https://github.com/google/gumbo-parser), and presents them using [libfuse](https://github.com/libfuse/libfuse)
## Warning / Help needed
I would love to not having to pass the ``-s`` flag to FUSE. I have no idea how to do so. If you have any ideas, please open an issue request.
## LICENSE
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by