root(1)

🌸 root(1) — the glow-up manual 🌸

okay bestie, listen up 💖 you just typed man 1 root (or like, you're reading this in the terminal, main character energy fr) and now you're meeting root — an interactive interpreter of C++ code using Cling and the ROOT framework. This page lives in the General Commands Manual, section 1, iykyk.

For more info on ROOT, go touch grass at https://root.cern/ 🌱 — and lowkey there's an extensive Users Guide and an API Reference waiting for you on that exact website. Like, go look. It's giving encyclopedia but make it C++.

---

✨ SYNOPSIS ✨

the way that you summon it:

usage: root [-b B] [-x X] [-e E] [-n N] [-t T] [-q Q] [-l L] [-a A]
            [-config CONFIG] [-h HELP] [--version VERSION]
            [--notebook NOTEBOOK] [--web WEB] [--web=<type> WEB=<TYPE>]
            [--web=off WEB=OFF]
            [dir] [data1.root...dataN.root] [file1.C...fileN.C]
            [file1_C.so...fileN_C.so] [anyfile1..anyfileN]

so many little boxes to fill in, so much potential 💅

---

🦋 DESCRIPTION 🦋

root is an interactive interpreter of C++ code using Cling and the ROOT framework. That's it, that's the vibe. You type C++, it just runs, no compile-edit-run cycle crying session required.

For more information on ROOT, please refer to https://root.cern/ — an extensive Users Guide and API Reference are available from that website. 🫶

---

👑 OPTIONS 👑

Every single flag, no skips, no cap:

• -b — Run in batch mode without graphics. no windows, no vibes, just ✨execution✨
• -x — Exit on exceptions. the moment something throws, we're out 🚪💨
• -e — Execute the command passed between single quotes
• -n — Do not execute logon and logoff macros as specified in .rootrc
• -t — Enable thread-safety and implicit multi-threading (IMT). multitasking queen behavior 🧚
• -q — Exit after processing command line macro files
• -l — Do not show the ROOT banner. (shy mode 🙈)
• -a — Show the ROOT splash screen (Windows only). windows girlies get the sparkle ✨
• -config — print ./configure options
• -h — Show summary of options. your lil cheat sheet 🎀
• --version — Show the ROOT version
• --notebook — Execute ROOT notebook
• --web — Use web-based display for graphics, browser, geometry 🌐
• --web=<type> — Use the specified web-based display such as chrome, firefox, qt6

For more options see the documentation of TROOT::SetWebDisplay()

• --web=off — Disable any kind of web-based display. we're going offline bestie 📴
• [dir] — if dir is a valid directory cd to it before executing
• [data1.root...dataN.root] — Open the given ROOT files; remote protocols (such as http://) are supported. yes you can be remote and mysterious 🌈
• [file1.C...fileN.C] — Execute the ROOT macro file1.C ... fileN.C

Compilation flags as well as macro arguments can be passed, see format in https://root.cern/manual/root_macros_and_shared_libraries/

• [file1_C.so...fileN_C.so] — Load and execute file1_C.so ... fileN_C.so (or .dll if on Windows)

They should be already-compiled ROOT macros (shared libraries) or:

regular user shared libraries e.g. userlib.so with a function userlib(args)

• [anyfile1..anyfileN] — All other arguments pointing to existing files will be checked to see if they are ROOT Files (checking the MIME type inside the file) and if they are not they will be handled as a ROOT macro file

---

💀 real talk though: some of these flags change what actually happens when stuff goes wrong, so don't just yeet them in because they look cute. -x and -b especially? they mean what they mean.

---

and that's the whole page, bestie — no notes, no crumbs, ate and left zero evidence 💅

This was the root(1) page from the General Commands Manual, section 1, served fresh at the bottom of every man page like a lil signature 🎀 periodt. 💖