GNOME-DISKS(1)

📦
version 46.1 · 2 versions
  • 46.1 · alpine 3.24, arch rolling, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 40.2 · centos-stream 9
, in alpine 3.24, arch rolling, centos-stream 10, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GNOME-DISKS(1) 💖

okay bestie, so this is the gnome-disk-utility page, section 1 of the manual — yes, the fancy section for user commands, we love that for us ✨

🎀 NAME 🎀

gnome-disks — it's the GNOME Disks application, bestie. that's the whole name. iconic.

✨ SYNOPSIS ✨

gnome-disks [OPTIONS]

short, sweet, slays 💅

🦋 DESCRIPTION 🦋

so gnome-disks is literally just the command that launches the GNOME Disks application. and what does Disks do?? it gives you a way to inspect, format, partition and configure disks and block devices. all of it. the whole vibe. 🔥

now here's the tea: the Disks application is single-instance. what does that mean, you ask? it means that if the app isn't already running when you invoke the gnome-disks command, it'll get launched — and then your command invocation blocks until the application exits. like, it's just standing there. waiting. respectfully. 😭

but if there's already an instance running?? then the existing application instance gets used instead, and the gnome-disks command exits immediately. boom, done, no waiting. periodt.

🌸 OPTIONS 🌸

here's everything it understands, no cap:

  • --block-device DEVICE — switches to the Disks application and selects the block device given by DEVICE (for example, /dev/sda). like, you point at it and Disks goes "oh THAT one" 💅
  • --block-device DEVICE --format-device [--xid WINDOW-ID] — shows the "Format Volume" dialog for the block device given by DEVICE (for example, /dev/sdb1). and if WINDOW-ID is given, it makes the dialog transient to the given XID. (transient = it knows who its parent window is, basically. very attached. very main character energy 🫶)
  • --restore-disk-image FILE — shows the "Restore Disk Image" dialog for the file given by FILE (for example, /home/user/Downloads/SuperOS.iso) and prompts the user to choose a disk to restore the image unto. yes, "unto". the manpage said it, not me. 😌
  • -h, --help — prints a short help text and exits. the classic. the og. we all know her. ✨
fr fr, watch those DEVICE and FILE placeholders — swap in your actual paths, don't just type the word "DEVICE" and get confused when nothing happens 💀

👑 AUTHOR 👑

written by David Zeuthen <zeuthen@gmail.com> with a lot of help from many others. shoutout to the whole squad, we appreciate you 🫶🌈

💀 BUGS 💀

please send bug reports to either the distribution bug tracker or the upstream bug tracker at:

https://gitlab.gnome.org/GNOME/gnome-disk-utility/-/issues/

don't suffer in silence bestie, tell the maintainers 🙈

⭐ SEE ALSO ⭐

go read those too, iykyk 📚✨

okay that's the whole page, you ate that 🍓 this was brought to you by GNOME, dated March 2013 — yes it's giving vintage but she still serves 💜 bye bestie, go format something responsibly!! 💖🎀🦋

📦 where this page comes from