---
name: "rootcling"
section: "1"
platform: "linux"
package: "root"
version: "6.40.04-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rootcling"
---

# rootcling(1)

## SYNOPSIS

usage: rootcling \[-f F\] \[-v V\] \[-v0 V0\] \[-v1 V1\] \[-v2 V2\] \[-v3 V3\] \[-v4 V4\]\
                  \[-m M\] \[-rmf RMF\] \[-rml RML\] \[-split SPLIT\] \[-s S\]\
                  \[-multiDict MULTIDICT\] \[-inlineInputHeader INLINEINPUTHEADER\]\
                  \[-interpreteronly INTERPRETERONLY\]\
                  \[-noIncludePaths NOINCLUDEPATHS\] \[-excludePath EXCLUDEPATH\]\
                  \[--lib-list-prefix LIB\_LIST\_PREFIX\]

## DESCRIPTION

This program generates the dictionaries needed for performing I/O of classes.

## OPTIONS

- \-f

  Overwrite an existing output file

-

  The output file must have the .cxx, .C, .cpp, .cc or .cp extension.

-

  - \-v

  Display all messages

- \-v0

  Display no messages at all

- \-v1

  Display only error messages

- \-v2

  Display error and warning messages (default).

- \-v3

  Display error, warning and note messages

- \-v4

  Display all messages

-

  - \-m

  Specify absolute or relative path Clang pcm file to be loaded

-

  The pcm file (module) produced by this invocation of rootcling

-

  will not include any of the declarations already included in the

-

  pcm files loaded via -m.  There can be more than one -m

-

  - \-rmf

  Rootmap file name

-

  Name of the rootmap file. In order to be picked up by ROOT it must

-

  have .rootmap extension

-

  - \-rml

  Rootmap library name

-

  Specify the name of the library which contains the autoload keys. This

-

  switch can be specified multiple times to autoload several libraries in

-

  presence of a particular key

-

  - \-split

  Split the dictionary

-

  Split the dictionary in two, putting the ClassDef functions in a separate

-

  file

-

  - \-s

  Target library name

-

  The flag -s must be followed by the name of the library that will

-

  contain the object file corresponding to the dictionary produced by

-

  this invocation of rootcling.

-

  The name takes priority over the one specified for the rootmapfile.

-

  The name influences the name of the created pcm:

-

     1\) If it is not specified, the pcm is called libINPUTHEADER\_rdict.pcm

-

     2\) If it is specified, the pcm is called libTARGETLIBRARY\_rdict.pcm

-

        Any "liblib" occurence is transformed in the expected "lib"

-

     3\) If this is specified in conjunction with --multiDict, the output is

-

        libTARGETLIBRARY\_DICTIONARY\_rdict.pcm

-

  - \-multiDict

  Enable support for multiple pcms in one library

-

  Needs the -s flag. See its documentation.

-

  - \-inlineInputHeader

  Add the argument header to the code of the dictionary

-

  This allows the header to be inlined within the dictionary

-

  - \-interpreteronly

  No IO information in the dictionary

-

  - \-noIncludePaths

  Do not store the headers' directories in the dictionary

-

  Instead, rely on the environment variable $ROOT\_INCLUDE\_PATH at runtime

-

  - \-excludePath

  Specify a path to be excluded from the include paths

-

  specified for building this dictionary

-

  - \--lib-list-prefix

  Specify libraries needed by the header files parsed

-

  This feature is used by ACliC (the automatic library generator).

-

  Rootcling will read the content of xxx.in for a list of rootmap files (see

-

  rlibmap). Rootcling will read these files and use them to deduce a list of

-

  libraries that are needed to properly link and load this dictionary. This

-

  list of libraries is saved in the first line of the file xxx.out; the

-

  remaining lines contains the list of classes for which this run of

-

  rootcling produced a dictionary

-