sbsv2/raptor/notes/filter_exes.txt
author lorewang
Wed, 01 Dec 2010 16:05:36 +0800
changeset 715 e0739b8406dd
parent 674 37ee82a83d43
permissions -rw-r--r--
Specify extenal tool with path
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
674
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     1
Use the filter_exes filter to generate a set of files listing the executables
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     2
created in a build.  A separate file will be created for each layer name and
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     3
each configuration containing executable files.  The filter can be run on an
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     4
existing log file as follows:
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     5
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     6
sbs_filter --filter=filter_exes < logfile
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     7
where 'logfile' is the name of the logfile you want to analyse.
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     8
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
     9
By default it will create the files in the current directory, named
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    10
'<layer>_<config>.txt' e.g. 'layerone_armv5_urel.txt'.  If layers are not in
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    11
use (e.g. the build was not based on a system definition) the layer name used
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    12
will be 'nolayer' - e.g. 'nolayer_armv5_udeb.txt'.
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    13
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    14
The location for output files can be overridden using the 'output' argument.
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    15
To limit its operation to specified layers or configs, the 'layer' and 'config'
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    16
arguments can be supplied, multiple times if necessary:
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    17
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    18
sbs_filter --filter=filter_exes[output=mydir,layer=layerone,layer=layertwo,config=armv5_urel] < logfile
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    19
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    20
This will search for executables generated from either 'layerone' or 'layertwo'
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    21
components which were also build for armv5_urel.  The filter will record an
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    22
executable if it matches any of the layers specified and also was built for any
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    23
of the configs specified.
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    24
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    25
The files contain a list of filenames with no paths and no other information, 
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    26
for example:
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    27
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    28
HelloWorld.exe
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    29
Dummy.exe
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    30
epoc.exe
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    31
[...]
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    32
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    33
A file will only be produced if there are any filenames to go into it.  The
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    34
filter will report on any files that have been created e.g:
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    35
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    36
Wrote 242 file(s) into layerone_armv5_urel.txt
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    37
Write 45 file(s) into layertwo_armv5_urel.txt
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    38
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    39
Note that argument names may be abbreviated e.g.
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    40
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    41
sbs_filter --filter=filter_exes[o=mydir,l=layerone,c=armv5_urel] < logfile
37ee82a83d43 sbs version 2.15.3
Jon Chatten
parents:
diff changeset
    42