1
.\" Copyright © 1998 James Troup <james@nocrew.org>
2
.\" Copyright © 2006-2008 Roger Leigh <rleigh@debian.org>
4
.\" This program is free software: you can redistribute it and/or modify
5
.\" it under the terms of the GNU General Public License as published by
6
.\" the Free Software Foundation, either version 2 of the License, or
7
.\" (at your option) any later version.
9
.\" This program is distributed in the hope that it will be useful, but
10
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
11
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12
.\" General Public License for more details.
14
.\" You should have received a copy of the GNU General Public License
15
.\" along with this program. If not, see
16
.\" <http://www.gnu.org/licenses/>.
18
.TH SBUILD\-STATS 1 "\*[RELEASE_DATE]" "Version \*[VERSION]" "Debian sbuild"
20
sbuild\-stats \- display or alter database of package build times/space
23
.RB [ \-h \[or] \-\-help " \[or] " \-V \[or] \-\-version
24
.RB " \[or] " "\-a PACKAGE TIME" \[or] "\-\-add PACKAGE TIME"
25
.RB " \[or] [" \-d \[or] \-\-delete " \[or] " \-\-dump ]
26
.BR PACKAGE1 " [" PACKAGE2 " [" PACKAGE\f[BI]n\fP... ]]]
27
.RB [ \-t \[or] \-\-time " \[or] " \-s \[or] \-\-space ]
30
This man page documents the packaged version of sbuild. This version is
31
maintained by the \fBbuildd-tools\fP project developers on Alioth
32
(\f[CR]https://alioth.debian.org/projects/buildd\-tools/\fP).
34
\fBsbuild\-stats\fR displays or alters data from a database of package build
35
times or space, usually updated by sbuild. Note: sbuild\-stats was previously
36
known as avg\-pkg\-build\-time and avg\-pkg\-build\-space. When invoked with
37
the old names, the database is defaulted to either the build-time or
38
build-space database, as if the \fI\-\-time\fP or \fI\-\-space\fP options had
39
been used, respectively.
41
If no option other than the database to use is given, \fBsbuild\-stats\fR will
42
display the entire contents of the database.
44
The database files are only used if they already exist. See
45
\fIREADME.Debian\fP for more information.
53
.BR \-V ", " \-\-version
54
Print version information.
56
.BR \-a ", " "\-\-add PACKAGE TIME"
57
Add an entry for a package. <time> is in the format HH:MM:SS, where
58
hours and minutes are optional.
60
.BR \-d ", " "\-\-delete PACKAGE1" " [" PACKAGE2 " [" PACKAGE\f[BI]n\fP... ]]]
61
Remove the data for a package from the database.
63
.BR \-\-dump " [" PACKAGE1 " [" PACKAGE2 " [" PACKAGE\f[BI]n\fP... ]]]
64
Output the contents of the database in unprocessed form. If no packages are
65
given, the entire database will be output.
66
.SS Database selection
68
.BR \-t ", " "\-\-time"
69
Display build-time database.
71
.BR \-s ", " "\-\-space"
72
Display build-space database.
76
Sort the output by build time; longest build first.
77
.SH ENVIRONMENT VARIABLES
78
The following environment variables are used by \fBsbuild\-stats\fR:
80
The home directory of the user.
82
\fBsbuild\-stats\fR reads the sbuild configuration files
83
\fI/etc/sbuild/sbuild.conf\fP and \fI~/.sbuildrc\fP (if it exists) to discover
84
the location of the databases, which are usually located under
85
\fI/var/lib/sbuild\fP.
87
To view the average build time for the \fIkoffice\fP package:
89
\f[CR]% \f[CB]sbuild-stats --time koffice\fP\fP
91
koffice: 02:44:55 (1 entry, sigma 00:00:00)
93
To view the average build space for the \fIkoffice\fP package:
95
\f[CR]% \f[CB]sbuild-stats --space koffice\fP\fP
97
koffice: 1597724k (1597724k latest)
106
Copyright \[co] 2006\[en]2008 Roger Leigh <rleigh@debian.org>.
107
Copyright \[co] 1998 Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>.
112
.BR sbuild\-upgrade (1).
114
.\"# The following sets edit modes for GNU EMACS
115
.\"# Local Variables: