embuildstats(1)
NAME
embuildstats - report tool to see an overview of your Emdebian builds
SYNOPSIS
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]]
[[-p] | [--pager]]
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]]
{-c|--csv}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]]
{-x|--xml}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]]
{-w|--html}
embuildstats [[-a] | [--arch]] [[-v] | [--verbose]] [[-q] | [--quiet]]
{-l|--lintian}
DESCRIPTION
embuildstats checks your Emdebian work directory for emdebianised
packages, build logs, .changes files and upload data and prepares a
simple report. By default, the report is piped through sensible-pager
but CSV, XML and HTML formats are also available.
For more detailed information on a particular package, use emsource
--status PACKAGE.
For information on which source packages have new versions available,
use emtargetcmp.
Although error messages use the same colour output as other scripts in
emdebian-tools, the report itself does not. If you would prefer
alternative formats for the report, please ask (or submit a patch).
- The report columns (or tags) describe (left to right):
- 1. Package name (source) in alphabetical order.
- 2. Total number of emdebian patch files (including emdebian.*.patch
and debian-patch.*.patch files). (Until Debian has a working
implementation for translation packages - tdebs - the majority of
these patches are to create the locale packages.) - 3. List of versions built with emdebuild. These versions are not necessarily successful builds, embuildstats just checks for the presence of a build log for this column. (See column 5.)
- 4. List of versions built successfully with empdebuild (within an
Emdebian chroot). These versions should be suitable for automated
building. embuildstats checks for the presence of a build log and a .changes file for the same Emdebian version. - 5. List of versions with a .changes file for an Emdebian version. These are successful builds by emdebuild.
- 6. List of versions of .changes files uploaded and the timestamp of the upload.
COMMANDS
- -p|--pager
- Produce a tabular report and pipe to sensible-pager. Press ´q´ to quit. This is the default but the output cannot be redirected.
- -c|--csv
Produce a report of comma separated values to STDOUT. The number of patch files is not included. Redirect to a file if preferred.
"xdemineur"," 2.1.1-10em1"," 2.1.1-10em1"," 2.1.1-10em1 Tue Nov 27 20:13:58 2007"- -x|--xml
Produce an XML report to STDOUT. The number of patch files is not included. Redirect to a file if preferred.
<?xml version="1.0"?>
<stats>
<package>
<name>package name</name>
<build>emdebuild version list</build>
<changes>empdebuild version list</changes>
<uploads>uploaded version with date</name>- </package>
<package>
<name>package name</name>
<build>emdebuild version list</build>
<changes>empdebuild version list</changes>
<uploads>uploaded version with date</name> - </package>
- </stats>
- -w|--html
Produce a tabular report in HTML and print to STDOUT. Redirect to a file if preferred. (This is the same format as --pager wrapped in a basic HTML page and using <pre> for the table itself. - -l|--lintian
Identify the latest .changes file for each build and use lintian to check the packages against Emdebian Policy. - This can take a lot of time and work, even on a fast machine, depending on how many packages you have built locally.
OPTIONS
- -a|--arch ARCH
- Produce a report for a specific architecture, overriding any
dpkg-cross default. - -v|--verbose
be verbose - currently only used if there are errors. - -q|--quiet
be quiet (error messages only). - -h|--help
print the usage message and exit. - --version
print the usage message and exit.
FILES
embuildstats uses your Emdebian work directory as the base for all searches. emdebuild stats are expected to be derived from $WORK/trunk/ and empdebuild stats are expected to be derived from the $WORK/pbuilder/result/ hierarchy. $WORK itself is defined by debconf for emdebian-tools or ~/.apt-cross/emsource.
AUTHOR
embuildstats was written by Neil Williams <codehelp@debian.org>.
This manual page was written by Neil Williams <codehelp@debian.org>
SEE ALSO
See also emdebuild (1), empdebuild (1), emsource (1), emtargetcmp (1), dpkg-cross (1), emdebian-tools (1).
AUTHOR
Emdebian
- Neil Williams
- Author.