NAME

       sb2-logz - sb2 log postprocessing tool

SYNOPSIS

       sb2-logz [options] < logfile

DESCRIPTION

       sb2-logz  reads  logs  created  by  scratchbox2 and writes summaries (the log files can be
       really huge, and manually digging out information from  them  might  be  a  time-consuming
       task).

       Logs are produced when sb2 is executed with -d (debug) or -L options (e.g. "-L info")

OPTIONS

       -b     no  blacklist:  do  not  ignore log lines from functions like __xstat() (there is a
              built-in blacklist, which tries to minimize "noise" caused by various libraries and
              scratchbox2 itself)

       -B fn1,fn2,..
              blacklist funcions fn1,fn2,..: ignore lines generated by the listed library calls.

       -d level
              debug mode, for debugging the script itself.

       -h     show help text.

       -i     print  details  about  'disabled'  pathnames  (unmodifed paths, because mapping was
              momentarily disabled)

       -l     print long details (affects output of -i,-m,-r,-p etc)

       -m     print details about mapped pathnames (src->dest)

       -N     print all 'notice' messages

       -p     print details about passed pathnames ('passed path' = not mapped)

       -r     print reversed mappings (dest->src)

       -s     print process statistics

       -v     verbose mode, prints dots while reading input etc.

       -P file.dot
              write process diagram to file.dot (postprocess  it  with  'dot',  e.g.  'dot  -Tpdf
              file.dot >file.pdf'

       -E file.dot
              write  execution  diagram  to  file.dot (postprocess it with 'dot', e.g. 'dot -Tpdf
              file.dot >file.pdf'

       -A acct-file
              Read process accounting information from acct-file (enhances output of -P and -E)'

BUGS

       Option -A requires an accounting log, which has to be activated separately.  Generation of
       accounting   information   typically  requires  super-user  privileges  (or  CAP_SYS_PACCT
       capability on Linux).  This is an system-level restriction, and not fault of  scratchbox2.
       However, sb2-logz has some limitations: Correlating information from the accounting log is
       based on process ids, and the heuristics may fail if there were really many processes; The
       -P,  -E  and  -A  options may be less useful for longer runs. Best results are achieved if
       process accounting is switched on just before the  scratchbox2  session  is  created,  and
       switched off afterwards - and there is nothing else running on the host at the same time.

SEE ALSO

       sb2(1), sb2-config(1), sb2-init(1), acct(2), dot(1) ( dot belongs to the graphviz package)

AUTHOR

       Lauri Aarnio