HTTPFS2(1)

📦
version 0.1.4 · 3 versions
, in debian bookworm, ubuntu jammy

💖 HTTPFS2 — the manual page, but make it cute 💖

okay bestie, sit down, hydrate, because we're talking about httpfs2(1) today and she is lowkey iconic. yes the name in the header is HTTPFS2(1) and yes this whole page is about her. let's go 🦋

✨ NAME ✨

httpfs2 — mount a file from a http server into the filesystem

🌸 SYNOPSIS 🌸

httpfs2 [OPTIONS] URL FUSE-OPTIONS httpfs2_ssl [OPTIONS] URL
FUSE-OPTIONS

like. that's the whole vibe. options, a URL, FUSE options, and also there's httpfs2_ssl in there doing her own little thing. slay 💅

🎀 DESCRIPTION 🎀

so httpfs2 is a FUSE based filesystem for mounting http or https URLS as files in the filesystem. literally just. a URL. as a file. main character energy fr fr ✨

now here's the tea: there is no notion of listable directories in http, so only a single URL can be mounted. no folders, no browsing, just one URL holding it down. and the server must be able to send byte ranges — that's non-negotiable, no cap.

👑 OPTIONS 👑

  • -c console — attempt to use the file ior device console for output after fork. the default is /dev/console. (yes, "ior device" — that's what it says, i'm not editing her 💀)
  • -f — do not fork, stay in foreground. she's clingy like that, we love her 🫶
  • -t timeout — use a different timeout for connections. default is '30’s.
  • URL — the url should specify the protocol as http or https, and it may specify basic authentication username and password. currently special characters like whitespace are not handled, so the URL cannot contain them. here's a sample URL, look at her:
http://user:password@server.com/dir/file
  • FUSE-OPTIONS — these options are passed straight to the FUSE library. at the very least the mount point should be specified. don't forget the mount point bestie, i'm begging 😭

⭐ EXIT STATUS ⭐

  • 0 — successfully connected to the server ✅
  • other — failure (url parsing error, server error, FUSE setup error). heads up though: some FUSE errors may happen only after the process forks, so they will not be returned in the exit value. sneaky. 🙈

💀 BUGS 💀

the process can be stopped by typing ^Z on the terminal, which may not be desirable under some circumstances. so like. careful with that one, bestie. not me accidentally suspending my mount 💅

💜 AUTHORS 💜

  • Miklos Szeredi <miklos@szeredi.hu>
  • hmb marionraven at users.sourceforge.net
  • Michal Suchanek <hramrach@centrum.cz>

the girlies (and guys) who built her. we stan. 👑

🌈 COPYING 🌈

free use of this software is granted under the terms of the GNU General Public License (GPL). free is free, periodt.

🧚 AUTHOR 🧚

Michal Suchanek <hramrach@centrum.cz> Author.

okay that's the whole page, you ate that. this version is dated 03/10/2017 and lives in the HTTPFS2(1) section of the manual — go forth and mount responsibly, ily 🎀✨💖

📦 where this page comes from