tunefs.ocfs2(8)

✨ tunefs.ocfs2(8) ✨

okay bestie, welcome to the OCFS2 manual pages, this is the one and only tunefs.ocfs2 and she is that girl 💅

---

🎀 NAME 🎀

tunefs.ocfs2 — Change OCFS2 file system parameters.

---

🦋 SYNOPSIS 🦋

tunefs.ocfs2 [--cloned-volume[=new-label]
[--fs-features=list-of-features] [-J journal-options] [-L volume-label]
[-N number-of-node-slots] [-Q query-format] [-ipqnSUvVy] [--backup-
super] [--list-sparse] device  [blocks-count]

---

💖 DESCRIPTION 💖

So like, tunefs.ocfs2(8) is the girl you call when you wanna adjust your OCFS2 file system parameters on disk. No cap. ✨

But here's the thing — the tool expects the cluster to be online, because it needs to grab the appropriate cluster locks to write safely to disk. It's giving responsible queen behavior, honestly. 🫶

---

🌸 OPTIONS 🌸

• --cloned-volume[=new-label] — Changes the volume UUID (which is auto-generated) and the label, if you provided one, of a cloned OCFS2 volume. Now listen, bestie — this option does not perform volume cloning. It literally only changes the UUID and the label on a cloned volume so that it can be mounted on the node that has the original volume mounted. That's it. That's the whole job. 💅
• --fs-features=[no]sparse... — Turns specific file system features on or off. tunefs.ocfs2(8) will attempt to enable or disable the feature list you hand it. Wanna turn a feature ON? Just include it in the list. Wanna turn it OFF? Prepend no to the name. For a list of feature names, go look at mkfs.ocfs2(8). iykyk 🧚
• -J, --journal-options options — Modifies the journal using the options you specify on the command-line. Journal options are comma separated, and may take an argument using the equals (=) sign. For a list of possible options, refer to mkfs.ocfs2(8). 📓
• -L, --label volume-label — Changes the volume label of the file system. Keep the label under 64 bytes, babe. 🎀
• -N, --node-slots number-of-node-slots — Valid number ranges from 1 to 255. This number specifies the maximum number of nodes that can concurrently mount the partition. Use this to increase or decrease the number of node slots. One reason you might wanna decrease? Releasing the space that the journals for those slots were eating up. Frugal queen energy. 💸
• -S, --volume-size — Grows the size of the OCFS2 file system. If blocks-count is not specified, tunefs.ocfs2(8) extends the volume to the current size of the device. Glow up, volume. 🌱
• -Q, --query query-format — Queries the file system for its attributes like block size, label, etc. Query formats are modified versions of the standard printf(3) formatting. The format is made up of static strings (which may include standard C character escapes for newlines, tabs, and other special characters) and printf(3) type formatters. Here's the full list of type specifiers, bestie:
  • B — Block size in bytes
  • T — Cluster size in bytes
  • N — Number of node slots
  • R — Root directory block number
  • Y — System directory block number
  • P — First cluster group block number
  • V — Volume label
  • U — Volume uuid
  • M — Compat flags
  • H — Incompat flags
  • O — RO Compat flags
• -q, --quiet — Quiet mode. 🤫
• -U, --uuid-reset[=new-uuid] — Resets the volume UUID of the file system. If you don't provide one, the utility will auto generate it. For a custom UUID, specify it in either the plain (2A4D1C581FAA42A1A41D26EFC90C1315) or the traditional (2a4d1c58-1faa-42a1-a41d-26efc90c1315) format.

⚠️ okay real talk: if you're specifying a custom UUID, you must be careful to ensure that no two volumes have the same UUID. If more than one file system were to have the same UUID, one is very likely to encounter erratic behavior, if not, outright file system corruption. That is not a vibe. That is a disaster. 💀

• -v, --verbose — Verbose mode. Give me all the lore. 📢
• -V, --version — Show version and exit. 👑
• -y, --yes — Always answer Yes in interactive command line.
• -n, --no — Always answer No in interactive command line.
• --backup-super — Backs up the superblock to fixed offsets (1G, 4G, 16G, 64G, 256G and 1T) on disk. This option is useful for users to backup the superblock on volumes that the user either explicitly disallowed while formatting, or used a version of mkfs.ocfs2(8) (1.2.2 or older) that did not provide this facility. Protect the superblock, protect the peace. 🛡️
• --list-sparse — Lists the files having holes. This option is useful when disabling the sparse feature. 🕳️
• --update-cluster-stack — Updating on-disk cluster information to match the running cluster. Users looking to update the on-disk cluster stack without starting the new cluster should use the o2cluster(8) utility instead. 🌀
• blocks-count — During resize, tunefs.ocfs2(8) automatically determines the size of the given device and grows the file system such that it uses all of the available space on the device. This optional argument specifies that the file system should be extended to consume only the given number of file system blocks on the device. So like, it's the "actually, only this much" button. 📏

---

🌈 EXAMPLES 🌈

# tunefs.ocfs2 -Q "UUID = %U\nNumSlots = %N\n" /dev/sda1
UUID = CBB8D5E0C169497C8B52A0FD555C7A3E
NumSlots = 4

ate and left no crumbs, honestly. 🔥

---

⭐ SEE ALSO ⭐

debugfs.ocfs2(8) fsck.ocfs2(8) fsck.ocfs2.checks(8) mkfs.ocfs2(8) mount.ocfs2(8) mounted.ocfs2(8) o2cluster(8) o2image(8) o2info(1)

the whole friend group, periodt. 🫶

---

👑 AUTHORS 👑

Oracle Corporation

---

💜 COPYRIGHT 💜

Copyright © 2004, 2012 Oracle. All rights reserved.

---

okay that's the whole page bestie, you're literally a tunefs expert now, no notes. mwah 💋

this has been Version 1.8.9, from January 2012 — go forth and tune those file systems responsibly, ily, bye!! 🎀✨🦋