FSREMAP(8)

📦
version 0.9.4 · 2 versions
, in fedora 43

✨ FSREMAP(8) ✨

okay bestie, sit DOWN. this is fsremap, section 8 of the manual (System Administration Utilities, iykyk), and it is genuinely one of the most unhinged little tools out there. version 0.9.4, so you know it's the real deal. grab a snack, we're doing this 💅

🎀 NAME 🎀

fsremap — the manual page for fsremap 0.9.4, and honestly? it's giving legend behavior.

🌸 SYNOPSIS 🌸

fsremap [OPTION]... DEVICE LOOP-FILE [ZERO-FILE]
fsremap [OPTION]... --resume-job=JOB_ID DEVICE

🦋 DESCRIPTION 🦋

so what does it DO? fsremap replaces the contents of DEVICE with the contents of LOOP-FILE. that's it. that's the job. it writes LOOP-FILE onto DEVICE...

...even if LOOP-FILE is inside a file system that is _inside_ DEVICE. yeah. it's doing the thing where it moves the ground out from under its own feet and slays. absolutely iconic behavior, no cap. 🔥

also, quick lil heads up: mandatory arguments to long options are mandatory for short options too. so don't be out here giving short options the cold shoulder while treating the long ones like royalty. equal rights. periodt. 👑

✨ OPTIONS ✨

okay this is the part everyone skips and it's the part that MATTERS. every single one, coming right up. 💖

  • -- — end of options. treat subsequent parameters as arguments even if they start with -. like, "okay we're done with flags now, everything after this is just stuff."
  • -a, --no-questions — automatic run: do not ask any question. she just GOES. 🏃‍♀️
  • --clear=all — clear all free blocks after remapping. this is the default, and it's the chill one. 🌈
  • --clear=minimal — (DANGEROUS) clear only overwritten free blocks after remapping. bestie. read that again. DANGEROUS. 🙈
  • --clear=none — (DANGEROUS) do not clear any free blocks after remapping. also DANGEROUS. also terrifying. 😭
  • --cmd-umount=CMD — command to unmount DEVICE (default: /bin/umount).
  • --cmd-losetup=CMD — 'losetup' command (default: /sbin/losetup).
  • --color=MODE — set messages color. MODE is one of: auto (default), none, ansi. yes, aesthetics are configurable. as they should be. 💅
  • --device-mount-point=DIR — set device mount point (needed by --io=prealloc).
  • -f, --force-run — continue even if some sanity checks fail. the sanity checks are there for a REASON but okay, main character, do your thing. 😬
  • -i, --interactive — ask confirmation after analysis, before actual work. a lil "you sure?" moment. cute. 🫶
  • --io=posix — use posix I/O. this is the default, it's the comfy one. 🍓
  • --io=prealloc — use posix I/O with EXPERIMENTAL preallocated files. experimental!! we love a risky queen. ⭐
  • --io=self-test — perform in-memory self-test with random data. she's checking herself before she wrecks herself.
  • --io=test — use test I/O. Arguments are: DEVICE-LENGTH LOOP-FILE-EXTENTS FREE-SPACE-EXTENTS.
  • --loop-device=LOOP-DEVICE — loop device to disconnect (needed by --io=prealloc).
  • --loop-mount-point=DIR — set loop file mount point (needed by --io=prealloc).
  • -m, --mem-buffer=RAM_SIZE[k|M|G|T|P|E|Z|Y] — set RAM buffer size (default: autodetect). yes you can go all the way up to Z and Y. zettabytes and yottabytes. go off. 🔥
  • -n, --no-action, --simulate-run — do not actually read or write any disk block. the safest possible vibe: just pretend. 🧚
  • --questions=MODE — set interactive mode. MODE is one of:
    • no: never ask questions, abort on errors (default)
    • yes: ask questions in case of user-fixable errors
    • extra: also ask confirmation before dangerous steps
  • -q, --quiet — be quiet, print less output. 🤫
  • -qq — be very quiet, only print warnings or errors.
  • --resume-job=NUM — resume the interrupted job NUM. The only non-option argument must be DEVICE.
Do _not_ pass LOOP-FILE as argument, or you will LOSE YOUR DATA! 😭😭😭 bestie I am BEGGING you. do not. LOSE. YOUR. DATA.
  • -s, --secondary-storage=SECONDARY_SIZE[k|M|G|T|P|E|Z|Y] — set secondary storage file length (default: autodetect).
  • -t, --temp-dir=DIR — write storage and log files inside DIR (default: /var/tmp/fstransform).
  • --ui-tty=TTY — show full-text progress on tty device TTY. live progress bar moment. 👑
  • -v, --verbose — be verbose.
  • -vv — be very verbose.
  • -vvv — be incredibly verbose (warning: prints lots of output). warning: prints LOTS of output. like, a lot a lot. you have been warned. 💀
  • -xp, --exact-primary-storage=PRIMARY_SIZE[k|M|G|T|P|E|Z|Y] — set _exact_ primary storage length, or fail.

(default: autodetect)

  • -xs, --exact-secondary-storage=SECONDARY_SIZE[k|M|G|T|P|E|Z|Y] — set _exact_ secondary storage length, or fail.

(default: autodetect)

  • --x-OPTION=VALUE — set internal, undocumented option. for maintainers only. not for us, bestie. we don't touch. 🙅‍♀️
  • --help — display this help and exit. the classic.
  • --version — output version information and exit.

and that's the whole thing!! you made it, I'm so proud of you 🥹💜 go forth, read your --help, maybe do a -n dry run first, and please please please respect the --resume-job warning. no cap.

this was fsremap 0.9.4, brought to you by System Administration Utilities, dated July 2025. mwah, bye bestie!! 🎀✨🦋💖🫶👑

📦 where this page comes from