SCONS-TIME(1)                                                    SCONS-TIME(1)



NNAAMMEE
       scons-time - generate and display SCons timing information

SSYYNNOOPPSSIISS
       ssccoonnss--ttiimmee _s_u_b_c_o_m_m_a_n_d [ _o_p_t_i_o_n_s...  ] [ _a_r_g_u_m_e_n_t_s...  ]

   GGeenneerraattiinngg TTiimmiinngg IInnffoorrmmaattiioonn
       ssccoonnss--ttiimmee  rruunn  [--hhnnqqvv]  [----aaeeggiiss==_P_R_O_J_E_C_T] [--ff _F_I_L_E] [----nnuummbbeerr==_N_U_M_B_E_R]
       [----oouuttddiirr==_O_U_T_D_I_R]    [--pp    _S_T_R_I_N_G]    [----ppyytthhoonn==_P_Y_T_H_O_N]    [--ss    _D_I_R]
       [----ssccoonnss==_S_C_O_N_S] [----ssvvnn==_U_R_L] [_A_R_G_U_M_E_N_T_S]

   EExxttrraaccttiinngg FFuunnccttiioonn TTiimmiinnggss
       ssccoonnss--ttiimmee   ffuunncc   [--hh]   [----cchhddiirr==_D_I_R]   [--ff   _F_I_L_E]   [----ffmmtt==_F_O_R_M_A_T]
       [----ffuunncc==_N_A_M_E] [--pp _S_T_R_I_N_G] [--tt _N_U_M_B_E_R] [----ttiittllee== TTIITTLLEE] [_A_R_G_U_M_E_N_T_S]

   EExxttrraaccttiinngg MMeemmoorryy SSttaattiissttiiccss
       ssccoonnss--ttiimmee mmeemm [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp  _S_T_R_I_N_G]
       [----ssttaaggee==_S_T_A_G_E] [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [_A_R_G_U_M_E_N_T_S]

   EExxttrraaccttiinngg OObbjjeecctt CCoouunnttss
       ssccoonnss--ttiimmee  oobbjj [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp _S_T_R_I_N_G]
       [----ssttaaggee==_S_T_A_G_E] [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [_A_R_G_U_M_E_N_T_S]

   EExxttrraaccttiinngg EExxeeccuuttiioonn TTiimmeess
       ssccoonnss--ttiimmee ttiimmee [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp _S_T_R_I_N_G]
       [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [----wwhhiicchh==_W_H_I_C_H] [_A_R_G_U_M_E_N_T_S]

   HHeellpp TTeexxtt
       ssccoonnss--ttiimmee hheellpp _S_U_B_C_O_M_M_A_N_D [...]

DDEESSCCRRIIPPTTIIOONN
       The  ssccoonnss--ttiimmee  command runs an SCons configuration through a standard
       set of profiled timings and can extract and graph information from  the
       resulting  profiles  and  log files of those timings.  The action to be
       performed by the ssccoonnss--ttiimmee script is specified by  a  subcommand,  the
       first  argument on the command line.  See the SSUUBBCCOOMMMMAANNDDSS section below
       for information about the operation of specific subcommands.

       The basic way to use ssccoonnss--ttiimmee is to run the ssccoonnss--ttiimmee rruunn subcommand
       (possibly  multiple times) to generate profile and log file output, and
       then use one of the other subcommands to display the  results  captured
       in  the  profiles  and  log files for a particular kind of information:
       function timings (the ssccoonnss--ttiimmee ffuunncc subcommand),  total  memory  used
       (the ssccoonnss--ttiimmee mmeemm subcommand), object counts (the ssccoonnss--ttiimmee oobbjj sub-
       command) and overall execution time (the ssccoonnss--ttiimmee  ttiimmee  subcommand).
       Options  exist to place and find the profiles and log files in separate
       directories, to generate the output in a format suitable  for  graphing
       with the ggnnuupplloott(1) program, and so on.

       There  are  two basic ways the ssccoonnss--ttiimmee rruunn subcommand is intended to
       be used to gather timing statistics for a configuration.  One is to use
       the  ----ssvvnn==  option to test a configuration against a list of revisions
       from the SCons Subversion repository.  This will generate a profile and
       timing  log  file  for every revision listed with the ----nnuummbbeerr== option,
       and can be used to look at the impact of commited changes to the  SCons
       code base on a particular configuration over time.

       The  other  way is to profile incremental changes to a local SCons code
       base during a development cycle--that is, to look  at  the  performance
       impact  of  changes you're making in the local tree.  In this mode, you
       run the ssccoonnss--ttiimmee rruunn subcommand _w_i_t_h_o_u_t the ----ssvvnn== option,  in  which
       case  it  simply  looks  in  the profile/log file output directory (the
       current directory by default) and automatically figures  out  the  _n_e_x_t
       run  number for the output profile and log file.  Used in this way, the
       development cycle goes something like: make  a  change  to  SCons;  run
       ssccoonnss--ttiimmee  rruunn  to  profile  it against a specific configuration; make
       another change to SCons; run ssccoonnss--ttiimmee rruunn again to profile it; etc.

OOPPTTIIOONNSS
       The ssccoonnss--ttiimmee command only supports a few global options:

       -h, --help
              Displays the global help text and exits, identical to the ssccoonnss--
              ttiimmee hheellpp subcommand.

       -V, --version
              Displays the ssccoonnss--ttiimmee version and exits.

       Most  functionality  is controlled by options to the individual subcom-
       mands.  See the next section for information about  individual  subcom-
       mand options.

SSUUBBCCOOMMMMAANNDDSS
       The ssccoonnss--ttiimmee command supports the following individual subcommands.

   TThhee ffuunncc SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee   ffuunncc   [--hh]   [----cchhddiirr==_D_I_R]   [--ff   _F_I_L_E]   [----ffmmtt==_F_O_R_M_A_T]
       [----ffuunncc==_N_A_M_E] [--pp _S_T_R_I_N_G] [--tt _N_U_M_B_E_R] [----ttiittllee== TTIITTLLEE] [_A_R_G_U_M_E_N_T_S]

       The ssccoonnss--ttiimmee ffuunncc subcommand displays timing information for  a  spe-
       cific  Python  function within SCons.  By default, it extracts informa-
       tion about the __mmaaiinn() function, which  includes  the  Python  profiler
       timing for all of SCons.

       The  ssccoonnss--ttiimmee  ffuunncc  subcommand  extracts function timing information
       from all the specified file arguments, which should be Python  profiler
       output  files.  (Normally, these would be **..pprrooff files generated by the
       ssccoonnss--ttiimmee rruunn subcommand, but they can actually be  generated  by  any
       Python  profiler  invocation.)  All file name arguments will be globbed
       for on-disk files.

       If no arguments are specified, then function timing information will be
       extracted  from  all  **..pprrooff files, or the subset of them with a prefix
       specified by the --pp option.

       Options include:

       -C DIRECTORY, --chdir=DIRECTORY
              Changes to the specified _D_I_R_E_C_T_O_R_Y before looking for the speci-
              fied files (or files that match the specified patterns).

       -f FILE, --file=FILE
              Reads configuration information from the specified _F_I_L_E.

       -fmt=FORMAT, --format=FORMAT
              Reports  the  output  in the specified _F_O_R_M_A_T.  The formats cur-
              rently supported are aasscciiii (the default) and ggnnuupplloott.

       --func=NAME
              Extracts timings for the specified function _N_A_M_E.   The  default
              is  to report cumulative timings for the __mmaaiinn() function, which
              contains the entire SCons run.

       -h, --help
              Displays help text for the ssccoonnss--ttiimmee ffuunncc subcommand.

       -p STRING, --prefix=STRING
              Specifies the prefix string for profiles from which  to  extract
              function  timing  information.   This will be used to search for
              profiles if no arguments are specified on the command line.

       -t NUMBER, --tail=NUMBER
              Only extracts function timings from the last _N_U_M_B_E_R files.

   TThhee hheellpp SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee hheellpp _S_U_B_C_O_M_M_A_N_D [...]  The hheellpp subcommand prints help  text
       for  any  other  subcommands  listed  as later arguments on the command
       line.

   TThhee mmeemm SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee mmeemm [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp  _S_T_R_I_N_G]
       [----ssttaaggee==_S_T_A_G_E] [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [_A_R_G_U_M_E_N_T_S]

       The ssccoonnss--ttiimmee mmeemm subcommand displays how much memory SCons uses.

       The  ssccoonnss--ttiimmee mmeemm subcommand extracts memory use information from all
       the specified file arguments, which should be files  containing  output
       from  running  SCons  with the ----ddeebbuugg==mmeemmoorryy option.  (Normally, these
       would be **..lloogg files generated by the ssccoonnss--ttiimmee rruunn subcommand.)   All
       file name arguments will be globbed for on-disk files.

       If  no  arguments  are  specified,  then  memory  information  will  be
       extracted from all **..lloogg files, or the subset of  them  with  a  prefix
       specified by the --pp option.


       -C DIR, --chdir=DIR
              Changes to the specified _D_I_R_E_C_T_O_R_Y before looking for the speci-
              fied files (or files that match the specified patterns).

       -f FILE, --file=FILE
              Reads configuration information from the specified _F_I_L_E.

       -fmt=FORMAT, --format=FORMAT
              Reports the output in the specified _F_O_R_M_A_T.   The  formats  cur-
              rently supported are aasscciiii (the default) and ggnnuupplloott.

       -h, --help
              Displays help text for the ssccoonnss--ttiimmee mmeemm subcommand.

       -p STRING, --prefix=STRING
              Specifies  the prefix string for log files from which to extract
              memory usage information.  This will be used to search  for  log
              files if no arguments are specified on the command line.

       --stage=STAGE
              Prints  the  memory used at the end of the specified _S_T_A_G_E: pprree--
              rreeaadd (before the SConscript files are read), ppoosstt--rreeaadd ,,  (after
              the  SConscript  files  are read), pprree--bbuuiilldd (before any targets
              are built) or ppoosstt--bbuuiilldd (after any targets are built).   If  no
              ----ssttaaggee option is specified, the default behavior is ppoosstt--bbuuiilldd,
              which reports the final amount of memory used  by  SCons  during
              each run.

       -t NUMBER, --tail=NUMBER
              Only reports memory statistics from the last _N_U_M_B_E_R files.

   TThhee oobbjj SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee  oobbjj [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp _S_T_R_I_N_G]
       [----ssttaaggee==_S_T_A_G_E] [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [_A_R_G_U_M_E_N_T_S]

       The ssccoonnss--ttiimmee oobbjj subcommand displays how many objects of  a  specific
       named type are created by SCons.

       The ssccoonnss--ttiimmee oobbjj subcommand extracts object counts from all the spec-
       ified file arguments, which should  be  files  containing  output  from
       running SCons with the ----ddeebbuugg==ccoouunntt option.  (Normally, these would be
       **..lloogg files generated by the ssccoonnss--ttiimmee rruunn subcommand.)  All file name
       arguments will be globbed for on-disk files.

       If  no  arguments  are  specified, then object counts will be extracted
       from all **..lloogg files, or the subset of them with a prefix specified  by
       the --pp option.

       -C DIR, --chdir=DIR
              Changes to the specified _D_I_R_E_C_T_O_R_Y before looking for the speci-
              fied files (or files that match the specified patterns).

       -f FILE, --file=FILE
              Reads configuration information from the specified _F_I_L_E.

       -fmt=FORMAT, --format=FORMAT
              Reports the output in the specified _F_O_R_M_A_T.   The  formats  cur-
              rently supported are aasscciiii (the default) and ggnnuupplloott.

       -h, --help
              Displays help text for the ssccoonnss--ttiimmee oobbjj subcommand.

       -p STRING, --prefix=STRING
              Specifies  the prefix string for log files from which to extract
              object counts.  This will be used to search for log files if  no
              arguments are specified on the command line.

       --stage=STAGE
              Prints  the object count at the end of the specified _S_T_A_G_E: pprree--
              rreeaadd (before the SConscript files are read), ppoosstt--rreeaadd ,,  (after
              the  SConscript  files  are read), pprree--bbuuiilldd (before any targets
              are built) or ppoosstt--bbuuiilldd (after any targets are built).   If  no
              ----ssttaaggee option is specified, the default behavior is ppoosstt--bbuuiilldd,
              which reports the final object count during each run.

       -t NUMBER, --tail=NUMBER
              Only reports object counts from the last _N_U_M_B_E_R files.

   TThhee rruunn SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee rruunn [--hhnnqqvv] [----aaeeggiiss==_P_R_O_J_E_C_T]  [--ff  _F_I_L_E]  [----nnuummbbeerr==_N_U_M_B_E_R]
       [----oouuttddiirr==_O_U_T_D_I_R]    [--pp    _S_T_R_I_N_G]    [----ppyytthhoonn==_P_Y_T_H_O_N]    [--ss    _D_I_R]
       [----ssccoonnss==_S_C_O_N_S] [----ssvvnn==_U_R_L] [_A_R_G_U_M_E_N_T_S] The ssccoonnss--ttiimmee  rruunn  subcommand
       is  the basic subcommand for profiling a specific configuration against
       a version of SCons.

       The configuration to be tested is specified  as  a  list  of  files  or
       directories  that will be unpacked or copied into a temporary directory
       in which SCons will be invoked.  The ssccoonnss--ttiimmee rruunn  subcommand  under-
       stands  file suffixes like ..ttaarr, ..ttaarr..ggzz, ..ttggzz and ..zziipp and will unpack
       their contents into a temporary directory.  If more than  one  argument
       is  specified,  each  one will be unpacked or copied into the temporary
       directory "on top of" the previous  archives  or  directories,  so  the
       expectation  is  that multiple specified archives share the same direc-
       tory layout.

       Once the file or directory arguments are unpacked or copied to the tem-
       porary directory, the ssccoonnss--ttiimmee rruunn subcommand runs the requested ver-
       sion of SCons against the configuration three times:

       Startup
              SCons is run with the ----hheellpp option so that just the  SConscript
              files are read, and then the default help text is printed.  This
              profiles just the perceived "overhead" of starting up SCons  and
              processing the SConscript files.

       Full build
              SCons is run to build everything specified in the configuration.
              Specific targets to be passed in on the command  l  ine  may  be
              specified  by  the  ttaarrggeettss keyword in a configuration file; see
              below for details.

       Rebuild
              SCons is run again on the same  just-built  directory.   If  the
              dependencies in the SCons configuration are correct, this should
              be an up-to-date, "do nothing" rebuild.

       Each invocation captures the output log file and a profile.

       The ssccoonnss--ttiimmee rruunn subcommand supports the following options:

       --aegis=PROJECT
              Specifies the Aegis _P_R_O_J_E_C_T from which the version(s)  of  ssccoonnss
              being  timed  will be extracted.  When ----aaeeggiiss is specified, the
              ----nnuummbbeerr==_N_U_M_B_E_R option specifies  delta  numbers  that  will  be
              tested.   Output from each invocation run will be placed in file
              names that match the Aegis  delta  numbers.   If  the  ----nnuummbbeerr==
              option  is  not  specified, then the default behavior is to time
              the tip of the specified _P_R_O_J_E_C_T.

       -f FILE, --file=FILE
              Reads configuration information from the specified  _F_I_L_E.   This
              often  provides  a  more  convenient  way to specify and collect
              parameters associated with a specific timing configuration  than
              specifying them on the command line.  See the CCOONNFFIIGGUURRAATTIIOONN FFIILLEE
              section below  for  information  about  the  configuration  file
              parameters.

       -h, --help
              Displays help text for the ssccoonnss--ttiimmee rruunn subcommand.

       -n, --no-exec
              Do  not execute commands, just printing the command-line equiva-
              lents of what would  be  executed.   Note  that  the  ssccoonnss--ttiimmee
              script  actually executes its actions in Python, where possible,
              for portability.  The commands displayed are UNIX _e_q_u_i_v_a_l_e_n_t_s of
              what it's doing.

       --number=NUMBER
              Specifies  the  run  number  to  be used in the names of the log
              files and profile outputs generated by this run.

              When used in conjuction with the ----aaeeggiiss==_P_R_O_J_E_C_T option,  _N_U_M_B_E_R
              specifies  one  or more comma-separated Aegis delta numbers that
              will  be  retrieved  automatically  from  the  specified   Aegis
              _P_R_O_J_E_C_T.

              When used in conjuction with the ----ssvvnn==_U_R_L option, _N_U_M_B_E_R speci-
              fies one or more  comma-separated  Subversion  revision  numbers
              that will be retrieved automatically from the Subversion reposi-
              tory at the specified _U_R_L.  Ranges of delta or revision  numbers
              may be specified be separating two numbers with a hyphen (--).

       Example:
              % scons-time run --svn=http://scons.tigris.org/svn/trunk --num=1247,1249-1252 .

       -p STRING, --prefix=STRING
              Specifies  the prefix string to be used for all of the log files
              and profiles generated by this run.  The default is derived from
              the  first specified argument: if the first argument is a direc-
              tory, the default prefix is the name of the  directory;  if  the
              first argument is an archive (tar or zip file), the default pre-
              fix is the the base name of the archive, that is,  what  remains
              after stripping the archive suffix (..ttggzz, ..ttaarr..ggzz or ..zziipp).

       --python=PYTHON
              Specifies  a  path  to  the Python executable to be used for the
              timing runs.  The default is to use the same  Python  executable
              that is running the ssccoonnss--ttiimmee command itself.

       -q, --quiet
              Suppresses display of the command lines being executed.

       -s DIR, --subdir=DIR
              Specifies  the  name of directory or subdirectory from which the
              commands should be executed.  The default is XXX

       --scons=SCONS
              Specifies a path to the SCons script to be used for  the  timing
              runs.  The default is XXX

       --svn=URL, --subversion=URL
              Specifies  the  _U_R_L  of the Subversion repository from which the
              version(s) of ssccoonnss being timed will be extracted.   When  ----ssvvnn
              is specified, the ----nnuummbbeerr==_N_U_M_B_E_R option specifies revision num-
              bers that will be tested.  Output from each invocation run  will
              be  placed in file names that match the Subversion revision num-
              bers.  If the  ----nnuummbbeerr==  option  is  not  specified,  then  the
              default behavior is to time the HHEEAADD of the specified _U_R_L.

       -v, --verbose
              Displays  the  output from individual commands to the screen (in
              addition to capturing the output in log files).

   TThhee ttiimmee SSuubbccoommmmaanndd
       ssccoonnss--ttiimmee ttiimmee [--hh] [----cchhddiirr==_D_I_R] [--ff _F_I_L_E] [----ffmmtt==_F_O_R_M_A_T] [--pp _S_T_R_I_N_G]
       [--tt _N_U_M_B_E_R] [----ttiittllee==_T_I_T_L_E] [----wwhhiicchh==_W_H_I_C_H] [_A_R_G_U_M_E_N_T_S]

       The  ssccoonnss--ttiimmee  ttiimmee  subcommand  displays  SCons  execution  times as
       reported by the ssccoonnss ----ddeebbuugg==ttiimmee option.

       The ssccoonnss--ttiimmee ttiimmee subcommand extracts SCons timing from all the spec-
       ified file arguments, which should be files containing output from run-
       ning SCons with the ----ddeebbuugg==ttiimmee option.   (Normally,  these  would  be
       **..lloogg files generated by the ssccoonnss--ttiimmee rruunn subcommand.)  All file name
       arguments will be globbed for on-disk files.

       If no arguments are specified, then execution timings will be extracted
       from  all **..lloogg files, or the subset of them with a prefix specified by
       the --pp option.

       -C DIR, --chdir=DIR
              Changes to the specified _D_I_R_E_C_T_O_R_Y before looking for the speci-
              fied files (or files that match the specified patterns).

       -f FILE, --file=FILE
              Reads configuration information from the specified _F_I_L_E.

       -fmt=FORMAT, --format=FORMAT
              Reports  the  output  in the specified _F_O_R_M_A_T.  The formats cur-
              rently supported are aasscciiii (the default) and ggnnuupplloott.

       -h, --help
              Displays help text for the ssccoonnss--ttiimmee ttiimmee subcommand.

       -p STRING, --prefix=STRING
              Specifies the prefix string for log files from which to  extract
              execution timings.  This will be used to search for log files if
              no arguments are specified on the command line.

       -t NUMBER, --tail=NUMBER
              Only reports object counts from the last _N_U_M_B_E_R files.

       --which=WHICH
              Prints the execution time for the specified _W_H_I_C_H  value:  ttoottaall
              (the  total  execution  time), SSCCoonnssccrriippttss (total execution time
              for the SConscript files themselves), SSCCoonnss (exectuion  time  in
              SCons  code  itself) or ccoommmmaannddss (execution time of the commands
              and other actions used to build targets).  If no ----wwhhiicchh  option
              is  specified,  the default behavior is ttoottaall, which reports the
              total execution time for each run.

CCOONNFFIIGGUURRAATTIIOONN FFIILLEE
       Various ssccoonnss--ttiimmee subcommands can read information  from  a  specified
       configuration  file when passed the --ff or ----ffiillee options.  The configu-
       ration file is actually executed as a Python  script.   Setting  Python
       variables in the configuration file controls the behavior of the ssccoonnss--
       ttiimmee script more  conveniently  than  having  to  specify  command-line
       options  or  arguments  for  every  run,  and  provides  a handy way to
       "shrink-wrap" the necessary information for producing  (and  reporting)
       consistent timing runs for a given configuration.

       aaeeggiiss  The Aegis executable for extracting deltas.  The default is sim-
              ply aaeeggiiss.

       aaeeggiiss__pprroojjeecctt
              The Aegis project from which deltas should  be  extracted.   The
              default  is whatever is specified with the ----aaeeggiiss== command-line
              option.

       aarrcchhiivvee__lliisstt
              A list of archives (files or directories) that will be copied to
              the  temporary  directory in which SCons will be invoked.  ..ttaarr,
              ..ttaarr..ggzz, ..ttggzz and ..zziipp files will have their  contents  unpacked
              in  the  temporary directory.  Directory trees and files will be
              copied as-is.

       iinniittiiaall__ccoommmmaannddss
              A list of commands that will be executed before the actual timed
              ssccoonnss runs.  This can be used for commands that are necessary to
              prepare the source tree-for example,  creating  a  configuration
              file that should not be part of the timed run.

       kkeeyy__llooccaattiioonn
              The  location  of the key on Gnuplot graphing information gener-
              ated with the ----ffoorrmmaatt==ggnnuupplloott option.  The  default  is  bboottttoomm
              lleefftt.

       pprreeffiixx The  file name prefix to be used when running or extracting tim-
              ing for this configuration.

       ppyytthhoonn The path name of the Python executable to be used  when  running
              or  extracting  information for this configuration.  The default
              is the same version of Python used to run the SCons

       ssccoonnss  The path name of the SCons script to be  used  when  running  or
              extracting  information  for this configuration.  The default is
              simply ssccoonnss.

       ssccoonnss__ffllaaggss
              The ssccoonnss flags used when running SCons to collect timing infor-
              mation.   The  default  value  is  ----ddeebbuugg==ccoouunntt  ----ddeebbuugg==mmeemmoorryy
              ----ddeebbuugg==ttiimmee ----ddeebbuugg==mmeemmooiizzeerr.

       ssccoonnss__lliibb__ddiirr

       ssccoonnss__wwrraappppeerr

       ssttaarrttuupp__ttaarrggeettss

       ssuubbddiirr The subdirectory of the project into which the ssccoonnss--ttiimmee script
              should change before executing the SCons commands to time.

       ssuubbvveerrssiioonn__uurrll
              The Subversion URL from

       ssvvnn    The  subversion  executable used to check out revisions of SCons
              to be timed.  The default is simple ssvvnn.

       ssvvnn__ccoo__ffllaagg

       ttaarr

       ttaarrggeettss
              A string containing the targets that should be added to the com-
              mand  line  of  every  timed  ssccoonnss  run.   This  can be used to
              restrict what's being timed to a subset of the  full  build  for
              the configuration.

       ttaarrggeettss00

       ttaarrggeettss11

       ttaarrggeettss22

       ttiittllee

       uunnzziipp

       vveerrbboossee

       vveerrttiiccaall__bbaarrss

   EExxaammppllee
       Here  is  an  example  ssccoonnss--ttiimmee configuration file for a hypothetical
       sample project:

              # The project doesn't use SCons natively (yet), so we're
              # timing a separate set of SConscript files that we lay
              # on top of the vanilla unpacked project tarball.
              arguments = ['project-1.2.tgz', 'project-SConscripts.tar']

              # The subdirectory name contains the project version number,
              # so tell scons-time to chdir there before building.
              subdir = 'project-1.2'

              # Set the prefix so output log files and profiles are named:
              #     project-000-[012].{log,prof}
              #     project-001-[012].{log,prof}
              # etc.
              prefix = 'project'

              # The SConscript files being tested don't do any SConf
              # configuration, so run their normal ./configure script
              # before we invoke SCons.
              initial_commands = [
                  './configure',
              ]

              # Only time building the bin/project executable.
              targets = 'bin/project'

              # Time against SCons revisions of the branches/core branch
              subversion_url = 'http://scons.tigris.org/svn/scons/branches/core'

EENNVVIIRROONNMMEENNTT
       The ssccoonnss--ttiimmee script uses the following environment variables:

       PPRREESSEERRVVEE
              If this value is set, the ssccoonnss--ttiimmee script will _n_o_t remove  the
              temporary directory or directories in which it builds the speci-
              fied configuration or downloads a specific version of SCons.

SSEEEE AALLSSOO
       ggnnuupplloott(1), ssccoonnss(1)


AAUUTTHHOORRSS
       Steven Knight <knight at baldmt dot com>



                                  March 2008                     SCONS-TIME(1)
