hubicfuse(8)

📦 version 3.0.1, in ubuntu jammy

💖 hubicfuse(8) — the manual page, but make it a vibe 💖

okay so bestie, welcome to hubicfuse(8), straight out of the System Manager's Manual. yes it's a section 8 page. yes it's about mounting stuff. no it is not boring, sit down, we're doing this 💅

✨ NAME ✨

hubicfuse — mount hubiC storage. that's it. that's the whole name section. she's concise, she's iconic 👑

✨ SYNOPSIS ✨

hubicfuse <mountpoint> [options]

literally just hand her a mountpoint and some options and she goes 🦋

✨ DESCRIPTION ✨

hubicfuse gives you access to hubiC storage through a mountpoint, and the way it does that is with FUSE. so like, your cloud storage? it's just... there. in your filesystem. main character behaviour fr fr 🫶

✨ OPTIONS ✨

hubicfuse accepts the following general options, and yes we're listing all of them, no skipping, we don't do that here:

  • -h, --help — shows you a help message. when in doubt, ask for help, that's growth 🌸
  • -V, --version — prints out which version of hubicfuse you're running. slay, know your build 💜
  • -d — turns on debug input. heads up: this implies -f ⚠️
  • -f — starts hubicfuse in the foreground, so she stays right there with you instead of wandering off 🙈
  • -s — disables multi-threaded operation. one track mind, one thread, no cap 💀
  • -o <option> — adds an option. you can repeat this as many times as you need, stack 'em up like bracelets ✨ (peep fuse(8) for the details on what options exist)

✨ CONFIGURATION ✨

okay so hubicfuse needs some configuration settings to run. you can either pass them in as mount options, or just store them in the .hubicfuse file in the user's home directory 🏠. either way works, pick your fighter.

🌸 the required settings (non-negotiable bestie) 🌸

  • client_id — the Hubic client identifier. you get this from https://hubic.com/home/browser/developers/ — go get it, it's yours 💖
  • client_secret — the Hubic client secret. it comes along with the identifier, they're a package deal 🎀
  • refresh_token — the authentication token. you get this one using the hubic_token script, which lives in /usr/share/hubicfuse ⭐

🦋 the optional settings (if you're feeling extra) 🦋

  • cache_timeout — how many seconds directories get kept in the cache (600 by default)
  • verify_ssl — true or false to turn SSL certificate verification on or off (it's enabled by default)
  • segment_size — the size to use when creating DLOs (1073741824 by default, that's 1GB)
  • segment_above — the file size where she starts using segments (2147483648 by default, that's 2GB)
  • storage_url — the storage URL for other tenants to view the container
  • container — the public container to expose via the given storage_url
  • temp_dir — the directory used for storing temporary files
  • get_extended_metadata — true or false to enable or disable downloading file attributes (that's detailed time, owner, permissions). heads up: enabling this means reduced performance, so choose wisely 😭
  • curl_verbose — true or false to enable or disable detailing debugging information on curl requests. warning: this produces lots of output, it's giving firehose 💀
  • curl_progress_state — true or false to enable or disable progress information on curl requests. mostly useful for debugging 🔍
  • cache_statfs_timeout — the number of seconds to cache requests to statfs (that's cloud statistics). set it to 0 to disable ⭐
  • debug_level — 0, 1 or 2 to specify how verbose the debugging gets, working together with the -d command-line switch (0 selects minimal verbosity)
  • enable_chmod — true to enable chmod support on FUSE
  • enable_chown — true to enable chown support on FUSE

✨ SEE ALSO ✨

  • fuse(8) — go read her too, she's the whole foundation 💜

✨ AUTHORS ✨

hubicfuse was written by Pascal Obry, Tim Dysinger, Chris Wedgwood, Nick Craig-Wood, Dillon Amburgey, Manfred Touron, David Brownlee, Mike Lundy, justinb, Matt Greenway and Dan Cristian. absolute legends, every single one 👑

this manual page was adapted from the program usage information by Stephen Kitt, for the Debian GNU/Linux system (but may be used by others). periodt 🫶

and that's the whole page bestie!! 💖 this was hubicfuse(8) from the System Manager's Manual, dated October 17, 2016 — yeah she's an older queen but she still slays ✨🌸 go mount something, you got this 🎀

📦 where this page comes from