diff --git a/README.md b/README.md index b7c3383..b1c3aad 100644 --- a/README.md +++ b/README.md @@ -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