gfs2_convert(8)

📦 version 3.5.1, in debian bookworm, opensuse-leap 16.0, ubuntu jammy, ubuntu noble

✨ gfs2_convert ✨

okay bestie, gather round, because this is one of those gfs2_convert(8) pages from the System Manager's Manual and it's genuinely a glow-up story: we're taking your crusty old GFS1 filesystem and giving it GFS2 main character energy 💅

🎀 NAME 🎀

gfs2_convert — convert a GFS1 filesystem to GFS2

🌸 SYNOPSIS 🌸

gfs2_convert [OPTION]... DEVICE

💖 DESCRIPTION 💖

gfs2_convert is the tool that takes a filesystem from GFS1 to GFS2. It's giving transformation arc, no cap.

But before you even think about it, two things are non-negotiable, bestie:

  • You must have checked and fixed that GFS1 filesystem for errors using fsck.gfs2 first.
  • You must back the filesystem up before attempting the conversion.
⚠️ The convert process is irreversible. Like, no undo, no take-backs, no "not me accidentally". And any error encountered during the conversion can result in the abrupt termination of the program and, consequently, an unusable filesystem 😭

The NOTES section below has more tea on this. Read it. Fr fr.

✨ OPTIONS ✨

  • -h — Help. This prints out the proper command line usage syntax. 🫶
  • -q — Quiet. Print less information while running. Shhh, lowkey mode.
  • -n — No to all questions. Just no. Every time. 🚫
  • -V — Print program Version information only. Prints out the current version name. That's the whole vibe, nothing else.
  • -v — Verbose operation. Print more information while running. Yap mode: enabled 💬
  • -y — Yes to all questions. By specifying this option, gfs2_convert will not prompt before making changes. Consent pre-granted, so it just goes. 🔥

🌈 EXAMPLE 🌈

gfs2_convert /dev/vg0/lvol0

This will convert the Global File System on the block device "/dev/vg0/lvol0" to gfs2 format. Slay. ✨

🦋 NOTES 🦋

If gfs2_convert is interrupted for some reason other than a conversion failure, DO NOT run fsck.gfs2 on this partially converted filesystem. Do not. Put it down. 🙈

When this happens, reissue the gfs2_convert command on the partially converted filesystem to complete the conversion process. That's the move, periodt.

The GFS2 filesystem does not support Context-Dependent Path Names (CDPNs). gfs2_convert identifies such CDPNs and replaces them with empty directories with the same name. The administrator can use bind mounts on these directories to get the same effect as CDPNs. Iconic workaround behavior, honestly. 👑

When converting full or nearly full filesystems, it is possible that there won't be enough space available to fit all the GFS2 filesystem data structures. In such cases, the size of all the journals is reduced uniformly such that everything fits in the available space. Squeeze, adjust, fit. 💜

okay that's the whole page bestie, you're so ready. this was gfs2_convert(8) from the System Manager's Manual — the version line at the bottom is just gfs2_convert(8) itself, and there's no date on it, so that's genuinely all we've got. go forth and convert responsibly 🌸🫶✨

📦 where this page comes from