FUIDSHIFT(1)

📦
version 6.23 · 12 versions
, in fedora 43, fedora 44

✨ FUIDSHIFT ✨

okay bestie, buckle up, we're doing a manual page and it's literally about fuidshift — the uid/gid shifter 💅

🌸 NAME 🌸

fuidshift — uid/gid shifter. that's it, that's the name, short and iconic.

💖 DESCRIPTION 💖

🦋 Description:

UID/GID shifter — no cap, that's the whole job description.

So like, this tool lets you remap a filesystem tree, switching it from one set of UID/GID ranges to another. think of it as a glow-up for your file ownership 🎀

the way that this is mostly useful: when you're retrieving a wrongly shifted filesystem tree from a backup or from a broken system, and now you gotta remap everything — either back to the host UID/GID range (and yes, uid/gid 0 is root, keep up bestie) or over to an existing container's range. it's giving rescue mission 🫶

a range is represented as:

<u|b|g>:<first_container_id>:<first_host_id>:<size>

where:

  • u means shift uid 👑
  • g means shift gid 🌸
  • b means shift uid and gid (both, because why choose 💅)

⭐ Usage:

fuidshift <directory> <range> [<range>...] [flags]

yep, that's the shape of it. directory, then one or more ranges, then whatever flags you're feeling.

🌈 EXAMPLES 🌈

here's the moment you've all been waiting for, a real live one:

fuidshift my-dir/ b:0:100000:65536 u:10000:1000:1

look at her go ✨ shifting both uid and gid on one range and just uid on the other. obsessed.

🚩 Flags 🚩

  • -h, --help — print help. when in doubt, ask for help, that's literally self care 💖
  • -r, --reverse — perform a reverse mapping. going backwards, main character behavior 🙈
  • -t, --test — test mode, which means no change to files. a little dress rehearsal, nothing actually gets touched 🧚
  • --version — print version number. just so you know who you're dealing with 💅
lowkey important reminder bestie: -t/--test is your friend if you're nervous, because it makes no change to files at all. dry runs are self care, periodt.

okay that's the whole page, you ate it, no crumbs 🍓 this was fuidshift version 6.23, from April 2026 — mwah, bye bestie, go shift some uids 💜🦋

📦 where this page comes from