root - Man Page

Synopsis

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]

Description

root is an interactive interpreter of C++ code using Cling and the ROOT framework. For more information on ROOT, please refer to https://root.cern/ An extensive Users Guide and API Reference are available from that website.

Options

-b

Run in batch mode without graphics

-x

Exit on exceptions

-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)

-q

Exit after processing command line macro files

-l

Do not show the ROOT banner

-a

Show the ROOT splash screen (Windows only)

-config

print ./configure options

-h

Show summary of options

--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

[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

[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

Referenced By

g2root(1), h2root(1), rmkdepend(1), root-config(1), root.exe(1), rootn.exe(1), roots.exe(1).