1 check_rtime(1ONBLD) illumos Build Tools check_rtime(1ONBLD)
2
3
4
5 NAME
6 check_rtime - check ELF runtime attributes
7
8 SYNOPSIS
9 check_rtime [-imosv] [-D depfile | -d depdir] [-E errfile] [-e exfile]
10 [-f listfile] [-I infofile] [-w outdir] file | dir, ...
11
12 DESCRIPTION
13 check_rtime attempts to check a number of ELF runtime attributes for
14 consistency with common build rules. These checks involve running
15 ldd(1) and elfdump(1) against a family of dynamic objects. A dynamic
16 object can be defined explicitly as a file or multiple dynamic objects
17 can be located under the directory dir.
18
19 check_rtime is typically called from nightly(1ONBLD) when the -r option
20 is in effect. In this case the dynamic objects under the associated
21 proto area ($ROOT) are checked. check_rtime can also be run standalone
307 by the objects name. This output style is more terse, but is more
308 appropriate for sorting and diffing with previous build results.
309
310 -s Determine whether .stabs sections exist.
311
312 -v Provide version definition information. Each symbol defined by the
313 object is printed along with the version it is assigned to.
314
315 -w outdir
316 Interpret the paths of all input and output files relative to
317 outdir.
318
319 EXCEPTION FILE FORMAT
320 Exceptions to the rules enforced by check_rtime are specified using an
321 exception file. The -e option is used to specify an explicit exception
322 file. Otherwise, if used in an activated workspace, the default
323 exception file is $CODEMGR_WS/exception_list/check_rtime if that file
324 exists. If not used in an activated workspace, or if
325 $CODEMGR_WS/exception_list/check_rtime does not exist, check_rtime will
326 use /opt/onbld/etc/exception_list/check_rtime as a fallback default
327 exception file. To run check_rtime without applying exceptions,
328 specify -e with a value of /dev/null.
329
330 A '#' character at the beginning of a line, or at any point in a line
331 when preceded by whitespace, introduces a comment. Empty lines, and
332 lines containing only comments, are ignored by check_rtime. Exceptions
333 are specified as space separated keyword, and perl(1) regular
334 expression:
335
336 keyword perl-regex
337
338 Since whitespace is used as a separator, the regular expression cannot
339 itself contain whitespace. Use of the \s character class to represent
340 whitespace within the regular expression is recommended. Before the
341 perl regular expression is used, constructs of the form MACH(dir) are
342 expanded into a regular expression that matches the directory given, as
343 well as any 64-bit architecture subdirectory that might be present
344 (i.e. amd64, sparcv9). For instance, MACH(lib) will match any of the
345 following:
346
347 lib
348 lib/amd64
349 lib/sparcv9
480 The release version number of the environment being built.
481
482 ERROR CONDITIONS
483 Inspection of an object with ldd(1) assumes it is compatible with the
484 machine on which check_rtime is being run. Incompatible objects such
485 as a 64-bit object encountered on a 32-bit system, or an i386 object
486 encountered on a sparc system, can not be fully inspected. These
487 objects are displayed as:
488
489 foo: has wrong class or data encoding
490
491 FILES
492 $CODEMGR_WS/exception_list/check_rtime
493 /opt/onbld/etc/exception_list/check_rtime
494
495 SEE ALSO
496 crle(1), elfdump(1), find_elf(1ONBLD), ldd(1), ld.so.1(1), mcs(1).
497
498
499
500 09 March 2010 check_rtime(1ONBLD)
|
1 CHECK_RTIME(1ONBLD) illumos Build Tools CHECK_RTIME(1ONBLD)
2
3
4
5 NAME
6 check_rtime - check ELF runtime attributes
7
8 SYNOPSIS
9 check_rtime [-imosv] [-D depfile | -d depdir] [-E errfile] [-e exfile]
10 [-f listfile] [-I infofile] [-w outdir] file | dir, ...
11
12 DESCRIPTION
13 check_rtime attempts to check a number of ELF runtime attributes for
14 consistency with common build rules. These checks involve running
15 ldd(1) and elfdump(1) against a family of dynamic objects. A dynamic
16 object can be defined explicitly as a file or multiple dynamic objects
17 can be located under the directory dir.
18
19 check_rtime is typically called from nightly(1ONBLD) when the -r option
20 is in effect. In this case the dynamic objects under the associated
21 proto area ($ROOT) are checked. check_rtime can also be run standalone
307 by the objects name. This output style is more terse, but is more
308 appropriate for sorting and diffing with previous build results.
309
310 -s Determine whether .stabs sections exist.
311
312 -v Provide version definition information. Each symbol defined by the
313 object is printed along with the version it is assigned to.
314
315 -w outdir
316 Interpret the paths of all input and output files relative to
317 outdir.
318
319 EXCEPTION FILE FORMAT
320 Exceptions to the rules enforced by check_rtime are specified using an
321 exception file. The -e option is used to specify an explicit exception
322 file. Otherwise, if used in an activated workspace, the default
323 exception file is $CODEMGR_WS/exception_list/check_rtime if that file
324 exists. If not used in an activated workspace, or if
325 $CODEMGR_WS/exception_list/check_rtime does not exist, check_rtime will
326 use /opt/onbld/etc/exception_list/check_rtime as a fallback default
327 exception file.
328
329 To run check_rtime without applying exceptions, specify -e with a value
330 of /dev/null.
331
332 A '#' character at the beginning of a line, or at any point in a line
333 when preceded by whitespace, introduces a comment. Empty lines, and
334 lines containing only comments, are ignored by check_rtime. Exceptions
335 are specified as space separated keyword, and perl(1) regular
336 expression:
337
338 keyword perl-regex
339
340 Since whitespace is used as a separator, the regular expression cannot
341 itself contain whitespace. Use of the \s character class to represent
342 whitespace within the regular expression is recommended. Before the
343 perl regular expression is used, constructs of the form MACH(dir) are
344 expanded into a regular expression that matches the directory given, as
345 well as any 64-bit architecture subdirectory that might be present
346 (i.e. amd64, sparcv9). For instance, MACH(lib) will match any of the
347 following:
348
349 lib
350 lib/amd64
351 lib/sparcv9
482 The release version number of the environment being built.
483
484 ERROR CONDITIONS
485 Inspection of an object with ldd(1) assumes it is compatible with the
486 machine on which check_rtime is being run. Incompatible objects such
487 as a 64-bit object encountered on a 32-bit system, or an i386 object
488 encountered on a sparc system, can not be fully inspected. These
489 objects are displayed as:
490
491 foo: has wrong class or data encoding
492
493 FILES
494 $CODEMGR_WS/exception_list/check_rtime
495 /opt/onbld/etc/exception_list/check_rtime
496
497 SEE ALSO
498 crle(1), elfdump(1), find_elf(1ONBLD), ldd(1), ld.so.1(1), mcs(1).
499
500
501
502 March 9, 2010 CHECK_RTIME(1ONBLD)
|