1SCONSIGN(1)                       SCons 3.0.1                      SCONSIGN(1)
2
3
4

NAME

6       sconsign - print SCons .sconsign file information
7

SYNOPSIS

9       sconsign [options...] file [...]
10

DESCRIPTION

12       The sconsign command displays the contents of one or more .sconsign
13       files specified by the user.
14
15       By default, sconsign dumps the entire contents of the specified
16       file(s). Each entry is printed in the following format:
17
18       file: signature timestamp length implicit_dependency_1: signature
19       timestamp length implicit_dependency_2: signature timestamp length
20       action_signature [action string]
21
22       None is printed in place of any missing timestamp, bsig, or csig values
23       for any entry or any of its dependencies. If the entry has no implicit
24       dependencies, or no build action, the lines are simply omitted.
25
26       By default, sconsign assumes that any file arguments that end with a
27       .dbm suffix contains signature entries for more than one directory
28       (that is, was specified by the SConsignFile () function). Any file
29       argument that does not end in .dbm is assumed to be a traditional
30       .sconsign file containing the signature entries for a single directory.
31       An explicit format may be specified using the -f or --file= options.
32

OPTIONS

34       Various options control what information is printed and the format:
35
36       -a, --act, --action
37           Prints the build action information for all entries or the
38           specified entries.
39
40       -c, --csig
41           Prints the content signature (csig) information for all entries or
42           the specified entries.
43
44       -d DIRECTORY, --dir=DIRECTORY
45           When the signatures are being read from a .dbm file, or the -f dbm
46           or --format=dbm options are used, prints information about only the
47           signatures for entries in the specified DIRECTORY.
48
49       -e ENTRY, --entry=ENTRY
50           Prints information about only the specified ENTRY. Multiple -e
51           options may be used, in which case information about each ENTRY is
52           printed in the order in which the options are specified on the
53           command line.
54
55       -f FORMAT, --format=FORMAT
56           The file(s) to be printed are in the specified FORMAT. Legal values
57           are dbm (the DBM format used when the SConsignFile() function is
58           used) or sconsign (the default format used for an individual
59           .sconsign file in each directory).
60
61       -h, --help
62           Prints a help message and exits.
63
64       -i, --implicit
65           Prints the list of cached implicit dependencies for all entries or
66           the the specified entries.
67
68       --raw
69           Prints a pretty-printed representation of the raw Python dictionary
70           that holds build information about individual entry (both the entry
71           itself or its implicit dependencies). An entry's build action is
72           still printed in its usual format.
73
74       -r, --readable
75           Prints timestamps in a human-readable string, enclosed in single
76           quotes.
77
78       -t, --timestamp
79           Prints the timestamp information for all entries or the specified
80           entries.
81
82       -v, --verbose
83           Prints labels identifying each field being printed.
84

ENVIRONMENT

86       SCONS_LIB_DIR
87           Specifies the directory that contains the SCons Python module
88           directory (e.g. /home/aroach/scons-src-0.01/src/engine). on the
89           command line.
90

SEE ALSO

92       scons, scons User Manual, scons Design Document, scons source code.
93

AUTHORS

95       Steven Knight <knight at baldmt dot com>
96
97
98
99SCons 3.0.1                       11/14/2017                       SCONSIGN(1)
Impressum