2
.\" sbuild.1 - the *roff document processor source for the sbuild manual
4
.\" This file is part of Debian GNU/Linux's prepackaged version of wanna-build.
5
.\" Copyright (C) 1998 James Troup <james@nocrew.org>.
7
.\" This program is free software; you can redistribute it and/or modify
8
.\" it under the terms of the GNU General Public License as published by
9
.\" the Free Software Foundation; either version 2 of the License , or
10
.\" (at your option) any later version.
12
.\" This program is distributed in the hope that it will be useful,
13
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
14
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
.\" GNU General Public License for more details.
17
.\" You should have received a copy of the GNU General Public License
18
.\" along with this program; see the file COPYING. If not, write to
19
.\" the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
21
.TH sbuild 1 .\" "Command Manual" 1998-11-17 "November 17, 1998"
23
sbuild \- build debian packages from source
26
[ \-a/\-\-add-depends=<dependency-line> ] [ \-A/\-\-arch\-all ]
27
[ \-b/\-\-batch] [\-d/\-\-dist=<distribution> ] [ \-D/\-\-debug ]
28
[ \-f/\-\-force-depends=<dependency-line> ]
29
[ \-m/\-\-maintainer=<maintainer> ]
30
[ \-e/\-\-uploader=<uploader> ]
31
[ \-e/\-\-keyid=<key> ]
32
[ \-\-purge=<mode>] [\-s/\-\-source ] [ \-v/\-\-verbose ]
33
[ \-\-make\-binNMU=<entry> ]
35
package-to-build_x.y-z(.dsc) [ ... ]
37
This man page documents current stock sbuild. There is a major fork in
38
wanna-build sources also available which is adapted to buildd daemon needs.
40
\fBsbuild\fR rebuilds Debian binary packages from the corresponding Debian
41
source. It is similar to dbuild and debbuild, but, unlike them, it
42
knows about source dependencies.
44
\fBsbuild\fR can fetch the Debian source over a network or it
45
can use locally available source.
47
\fBsbuild\fR mails the build logs to a user. It is configured by the
48
configuration files /etc/sbuild.conf and ~/.sbuildrc. An example
49
sbuildrc is available in
50
/usr/share/doc/sbuild/examples/. \fBsbuild\fR will not run without a valid
53
Optionally, source dependencies are read from /var/lib/sbuild/source-dependencies-*; see that
54
file for more information on source-dependencies. Also see README.Debian.
56
You can build either using a local package with its .dsc file or a remote one by
57
specifying an explicit dpkg version.
59
Note: \fBsbuild\fR must be run in the directory (~/build/ by
60
default) with the chroot-{stable,testing,unstable} symlink to the
61
chroot or it will do the build in the base install which is not what
65
.IR \-a , "--add-depends=<dependency-line>"
66
This option adds some source dependency information for a package. It
67
can be given more than one time with accumulating effect. The argument
68
is a line of source dependencies in the same format as in
69
\fI/var/lib/sbuild/source-dependencies\fR. The given dependencies are appended to
70
the src-deps from source-dependencies-* files or package src-deps, resp.
72
.IR \-A , "--arch-all"
73
Also build Architecture: all packages, i.e. use dpkg-buildpackage -b
77
Operate in batchmode, i.e. write a build-progess file during execution
78
and files on shutdown to faciliate a clean restart.
80
.IR \-d , "--distribution=<distribution>"
81
Fetch source packages from specified distribution.
83
.IR \-f , "--force-depends=<dependency-line>"
84
This option overrides source dependency information for a package. It
85
can be given more than one time with accumulating effect. The argument
86
is a line of source dependencies in the same format as in
87
\fI/var/lib/sbuild/source-dependencies\fR.
92
.IR \-m , "--maintainer=<maintainer>"
93
Passed to dpkg-genchanges and is used to set the Maintainer: field in the .changes file(s).
95
.IR \-e , "--uploader=<maintainer>"
96
Passed to dpkg-genchanges and is used to set the Changed-by: field in the .changes file(s).
98
.IR \-k , "--keyid=<maintainer>"
99
Passed to dpkg-genchanges and is used to set the key to sign the .changes file(s).
100
Default is not using any key.
103
Do not create a package log file in the $log_dir directory and no
104
build log file, but print everything to stdout. Also do not send any
107
.IR \-p , "--purge=<mode>"
108
\fImode\fR decides if to delete the build directory. Possible values
109
are \fBalways\fR, \fBnever\fR, and \fBsuccessful\fR.
112
Also build source package, i.e. use dpkg-buildpackage without -B. This
113
also switches on --purge=never.
115
.IR \-v , "--verbose"
116
Be verbose, i.e. all information goes to stdout as well as to the log files.
118
.IR "--make-binNMU=<entry>"
119
With this option, \fBsbuild\fR will create a new changelog entry in
120
debian/changelog of every package built. The version number will be in
121
the format for binary-only NMUs (three dotted parts in the Debian
122
revision); the maintainer is set to the maintainer name configured for
123
\fBsbuild\fR. The \fIentry\fR parameter will be used as a changelog
124
entry after a fixed one "Binary-only non-maintainer upload for ARCH --
125
no source changes". Please note that the versions in the
126
\fIpackage-to-build\fR arguments still have to be the unmodified
127
(non-NMU ones) so that sources can be found. The version number in log
128
files and mails will be modified by \fBsbuild\fR automatically.
129
.SH ENVIRONMENT VARIABLES
130
The following environment variables are used by \fBsbuild\fR:
132
The home directory of the user.
136
A URL for a Debian source distribution; generated by sbuild for scripts in source-dependencies.
138
A URL for a Debian binary distribution; generated by sbuild for scripts in source-dependencies.
140
/etc/sbuild.conf - global configuration, maintained by the sbuild maintainer
142
~/.sbuildrc - user specific configuration
145
Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de>
148
\fBsbuild\fR is based on debbuild, written by James Troup <james@nocrew.org>
149
and has been modified by Ben Collins <bcollins@debian.org> and Ryan
150
Murray <rmurray@debian.org>.
153
.BR update-sourcedeps(1)