1rootcling(1)                General Commands Manual               rootcling(1)
2
3
4

SYNOPSIS

6       usage: rootcling [-f F] [-v V] [-v0 V0] [-v1 V1] [-v2 V2] [-v3 V3] [-v4
7       V4]
8                        [-m M] [-rmf RMF] [-rml RML] [-split SPLIT] [-s S]
9                        [-multiDict MULTIDICT]  [-inlineInputHeader  INLINEIN‐
10       PUTHEADER]
11                        [-interpreteronly INTERPRETERONLY]
12                        [-noIncludePaths     NOINCLUDEPATHS]     [-excludePath
13       EXCLUDEPATH]
14                        [--lib-list-prefix LIB_LIST_PREFIX]
15
16

DESCRIPTION

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

OPTIONS

22       -f     Overwrite an existing output file
23
24              The  output file must have the .cxx, .C, .cpp, .cc or .cp exten‐
25              sion.
26
27       -v     Display all messages
28
29       -v0    Display no messages at all
30
31       -v1    Display only error messages
32
33       -v2    Display error and warning messages (default).
34
35       -v3    Display error, warning and note messages
36
37       -v4    Display all messages
38
39       -m     Specify absolute or relative path Clang pcm file to be loaded
40
41              The pcm file (module) produced by this invocation of rootcling
42
43              will not include any of the declarations already included in the
44
45              pcm files loaded via -m.  There can be more than one -m
46
47       -rmf   Rootmap file name
48
49              Name of the rootmap file. In order to be picked up  by  ROOT  it
50              must
51
52              have .rootmap extension
53
54       -rml   Rootmap library name
55
56              Specify  the  name  of  the  library which contains the autoload
57              keys. This
58
59              switch can be  specified  multiple  times  to  autoload  several
60              libraries in
61
62              presence of a particular key
63
64       -split Split the dictionary
65
66              Split the dictionary in two, putting the ClassDef functions in a
67              separate
68
69              file
70
71       -s     Target library name
72
73              The flag -s must be followed by the name  of  the  library  that
74              will
75
76              contain the object file corresponding to the dictionary produced
77              by
78
79              this invocation of rootcling.
80
81              The name takes priority over the one specified for the  rootmap‐
82              file.
83
84              The name influences the name of the created pcm:
85
86                 1)  If  it  is  not  specified,  the  pcm is called libINPUT‐
87              HEADER_rdict.pcm
88
89                 2) If  it  is  specified,  the  pcm  is  called  libTARGETLI‐
90              BRARY_rdict.pcm
91
92                    Any  "liblib"  occurence  is  transformed  in the expected
93              "lib"
94
95                 3) If this is specified in conjunction with --multiDict,  the
96              output is
97
98                    libTARGETLIBRARY_DICTIONARY_rdict.pcm
99
100       -multiDict
101              Enable support for multiple pcms in one library
102
103              Needs the -s flag. See its documentation.
104
105       -inlineInputHeader
106              Add the argument header to the code of the dictionary
107
108              This allows the header to be inlined within the dictionary
109
110       -interpreteronly
111              No IO information in the dictionary
112
113       -noIncludePaths
114              Do not store the headers' directories in the dictionary
115
116              Instead,  rely on the environment variable $ROOT_INCLUDE_PATH at
117              runtime
118
119       -excludePath
120              Specify a path to be excluded from the include paths
121
122              specified for building this dictionary
123
124       --lib-list-prefix
125              Specify libraries needed by the header files parsed
126
127              This feature is used by ACliC (the automatic library generator).
128
129              Rootcling will read the content of xxx.in for a list of  rootmap
130              files (see
131
132              rlibmap). Rootcling will read these files and use them to deduce
133              a list of
134
135              libraries that are needed to properly link and load this dictio‐
136              nary. This
137
138              list  of  libraries  is  saved  in  the  first  line of the file
139              xxx.out; the
140
141              remaining lines contains the list of classes for which this  run
142              of
143
144              rootcling produced a dictionary
145
146                                                                  rootcling(1)