2 .TH lclint 1 "A tool for statically checking C programs"
5 lclint \- A tool for statically checking C programs
13 is a tool for statically checking C programs. With minimal effort, LCLint can
14 be used as a better lint(1).
15 If additional effort is invested adding annotations to programs, LCLint can
16 perform stronger checks than can be done by any standard lint.
27 These flags control directories and files used by LCLint. They may be used from the
28 command line or in an options file, but may not be used as control comments in the
29 source code. Except where noted. they have the same meaning preceded by \- or +.
32 .BI \-tmpdir " directory"
33 Set directory for writing temp files. Default is /tmp/.
37 Add directory to path searched for C include files. Note there is no space after the I,
38 to be consistent with C preprocessor flags.
42 Add directory to path search for .lcl specification files.
46 Load options file <file>. If this flag is used from the command line, the default ~/.lclintrc file is
47 not loaded. This flag may be used in an options file to load in another options file.
51 Prevents the default options files (./.lclintrc and ~/.lclintrc) from being loaded. (Setting
52 -nof overrides +nof, causing the options files to be loaded normally.)
55 .BI \-systemdirs " directories"
56 Set directories for system files (default is "/usr/include"). Separate directories with colons (e.g.,
57 "/usr/include:/usr/local/lib"). Flag settings propagate to files in a system directory. If
58 -systemdirerrors is set, no errors are reported for files in system directories.
63 These flags are used to define or undefine pre-processor constants.
64 The -I<directory> flag is also passed to the C pre-processor.
67 .BI \-D " initializer"
68 Passed to the C pre-processor.
71 .BI \-U " initializer"
72 Passed to the C pre-processor
76 These flags control the creation and use of libraries.
80 Save state in <file> for loading. The default extension .lcd is added if <file> has no extension.
84 Load state from <file> (created by -dump). The default extension .lcd is added if <file> has no
85 extension. Only one library file may be loaded.
87 By default, the standard library is loaded if the -load flag is not used to load a user library. If no user library is
88 loaded, one of the following flags may be used to select a different standard library. Precede the flag by + to
89 load the described library (or prevent a library from being loaded using nolib). See Apppendix F for
90 information on the provided libraries.
94 Do not load any library. This prevents the standard library from being loaded.
98 Use the ANSI standard library (selected by default).
102 Use strict version of the ANSI standard library.
106 Use the POSIX standard library.
109 .B \-posix-strict-lib
110 Use the strict version of the POSIX standard library.
114 Use UNIX version of standard library.
118 Use the strict version of the UNIX standard library.
123 These flags control what additional information is printed by LCLint. Setting +<flag> causes the described
124 information to be printed; setting -<flag> prevents it. By default, all these flags are off.
128 Send error messages to standard error (instead of standard out).
132 Show a summary of all errors reported and suppressed. Counts of suppressed errors are not
133 necessarily correct since turning a flag off may prevent some checking from being done to save
134 computation, and errors that are not reported may propagate differently from when they are
139 Show file names are they are processed.
143 Show list of uses of all external identifiers sorted by number of uses.
147 Display number of lines processed and checking time.
151 Display distribution of where checking time is spent.
155 Suppress herald and error count. (If quiet is not set, LCLint prints out a herald with version
156 information before checking begins, and a line summarizing the total number of errors reported.)
160 Print out the standard library filename and creation information.
163 .BI \-limit " number"
164 At most <number> similar errors are reported consecutively. Further errors are suppressed, and a
165 message showing the number of suppressed messages is printed.
170 Normally, LCLint will expect to report no errors. The exit status will be success (0) if no errors are reported,
171 and failure if any errors are reported. Flags can be used to set the expected number of reported errors.
172 Because of the provided error suppression mechanisms, these options should probably not be used for final
173 checking real programs but may be useful in developing programs using make.
177 Exactly <number> code errors are expected. LCLint will exit with failure exit status unless
178 <number> code errors are detected.
182 These flags control how messages are printed. They may be set at the command line, in options files, or
183 locally in syntactic comments. The linelen and limit flags may be preceded by + or - with the same meaning;
184 for the other flags, + turns on the describe printing and - turns it off. The box to the left of each flag gives its
189 Show column number where error is found. Default: +
193 Show name of function (or macro) definition containing error. The function name is printed once
194 before the first message detected in that function. Default: +
198 Show all possible alternate types (see Section 8.2.2). Default: -
201 .B \-paren-file-format
202 Use file(line) format in messages.
206 Provide hints describing an error and how a message may be suppressed for the first error
207 reported in each error class. Default: +
211 Provide hints for all errors reported, even if the hint has already been displayed for the same error
215 .BI \-linelen " number"
216 Set length of maximum message line to <number> characters. LCLint will split messages longer
217 than <number> characters long into multiple lines. Default: 80
220 .B Mode Selector Flags
222 Mode selects flags set the mode checking flags to predefined values. They provide a quick coarse-grain way
223 of controlling what classes of errors are reported. Specific checking flags may be set after a mode flag to
224 override the mode settings. Mode flags may be used locally, however the mode settings will override specific
225 command line flag settings. A warning is produced if a mode flag is used after a mode checking flag has been
228 These are brief descriptions to give a general idea of what each mode does. To see the complete flag settings
229 in each mode, use lclint -help modes. A mode flag has the same effect when used with either + or -.
233 Weak checking, intended for typical unannotated C code. No modifies checking, macro checking,
234 rep exposure, or clean interface checking is done. Return values of type int may be ignored. The
235 types bool, int, char and user-defined enum types are all equivalent. Old style declarations are
240 The default mode. All checking done by weak, plus modifies checking, global alias checking, use all
241 parameters, using released storage, ignored return values or any type, macro checking,
242 unreachable code, infinite loops, and fall-through cases. The types bool, int and char are distinct.
243 Old style declarations are reported.
247 Moderately strict checking. All checking done by standard, plus must modification checking, rep
248 exposure, return alias, memory management and complete interfaces.
252 Absurdly strict checking. All checking done by checks, plus modifications and global variables
253 used in unspecified functions, strict standard library, and strict typing of C operators. A special
254 reward will be presented to the first person to produce a real program that produces no errors with
259 Improve this manpage :-)
262 If you need to get in contact with the authors send email to
264 mailto:lclint-bug@cs.virginia.edu
269 http://lclint.cs.virginia.edu