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