aboutsummaryrefslogtreecommitdiff
path: root/pbuilderrc.5
blob: 32454407fa500745d8569c88512f23ad2f384335 (plain)
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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
.TH "pbuilderrc" 5 "2001 Aug 25" "Debian" "pbuilder"
.SH NAME
pbuilderrc \- configuration files for personal package builder
.SH DESCRIPTION
.B "/etc/pbuilderrc" 
contains default values used in the 
.B "pbuilder"
program invocation.
.PP
The file itself is sourced by a shell script, so
it is required that the file conforms to shell script conventions.
.SH "FORMAT"
.TP
.BI "BASETGZ=" "/var/cache/pbuilder/base.tgz"
Specifies the default location for the archived 
chroot image to be created and used.
This is overridden with the option 
.BR "--basetgz" "."
.TP
.BI "EXTRAPACKAGES=" "gcc3.0-athlon-builder"
Specifies extra packages which the system should install
in the chroot on 
.BR "pbuilder create" "."
Also this is installed on
.B "pbuilder build"

.TP
.BI "export DEBIAN_BUILDARCH=" "athlon"
Uses this variable as 
.BR "DEBIAN_BUILDARCH" "."
This trick can be used for other environmental variables as well.
.TP
.BI "BUILDPLACE=" "/var/cache/pbuilder/build/"
The default place which the chroot is constructed.
.B pbuilder
will use the directory 
.BR "$BUILDPLACE$$" "."
which means, that it will use the directory and the 
PID to determine the directory to use.
This should obtain an unique directory for 
concurrent runs of pbuilder in one machine.
This is not guaranteed to happen on network shared drives,
so be aware of this fact when playing with this option
on NFS shared beowulf clusters.
Change it to something like 
.I "/var/cache/pbuilder/build/$HOSTNAME/"
when doing such a thing.

.B "pbuilder clean"
cleans up this directory.
.TP
.BI "MIRRORSITE=" "http://www.jp.debian.org/debian"
Specify the mirror site which contains the
main Debian distribution.

Note that you cannot really use
.B "file:/" 
kind of URL, because the location needs to be accessible from within
the chroot.

.TP
.BI "NONUSMIRRORSITE=" "http://www.jp.debian.org/debian-non-US"
Specify the mirror site which contains
.B "non-US"
distribution.
.TP
.BI "OTHERMIRROR=" """deb http://www.home.com/updates/ ./"""
Add other sources which you want to have added to
.B "/etc/apt/sources.list" 
here.
.TP
.BI "export http_proxy=" "http://your-proxy:8080/"
Defines the proxy for http connection.
.TP
.BI "USEPROC=" "yes"
Specify 
.B yes
when it is desired to mount
.B /proc
interface. It is usually a good idea, since there are many
software which fail miserably when there is no
.B /proc
being mounted.
.TP
.BI "BUILDRESULT=" "/var/cache/pbuilder/result/"
Specify the default directory which the build result will
be copied over to after the building.
.TP
.BI "DISTRIBUTION=" "woody"
Specify the default distribution to use.
This option affects 
.B "create" 
and 
.B "update"
but not 
.B "build"
nor 
.B "login"

.TP
.BI "APTCACHE=" "/var/cache/pbuilder/aptcache"
Specify the location that the packages downloaded by apt
should be cached.

.TP
.BI "APTCACHEHARDLINK=" "yes"
Specify using hard links in apt cache handling.

.TP
.BI "REMOVEPACKAGES=" "lilo"
Specify the packages to be removed on creation of 
.B base.tgz
Leaving lilo in the chroot is like keeping a timebomb...

.TP
.BI "HOOKDIR=" "/usr/lib/pbuilder/hooks"
Specifies the default location for the user hooks
directory. 
This is overridden with the option 
.BR "--hookdir" "."

If this is specified, hooks are searched for in
the chroot, when running 
.BR "pbuilder update" "."
If it is not defined, or is an empty string, 
hooks are not executed.

.B "pbuilder update" 
will update to this distribution, if this is specified,
unless command line option is specified to override this.

.TP
.BI "DEBEMAIL=" "Mail@Address";

If this was specified, 
.B dpkg-buildpackage
command will be passed with the necessary sponsorship option 
.B "-mMail@Address"
on building.
Overwridden with 
.B "--debemail"
command-line option.

.TP
.BI "DEBBUILDOPTS=" "-b"

The options given here will be passed on to
.BR dpkg-buildpackage .
This can be useful e.g. for binary-only builds. The command-line option
.B "--debbuildopts"
overrides any contents specified here.

.TP
.BI "BUILDSOURCEROOTCMD=" "fakeroot"

This option is used on invocation of fakeroot 
for 
.B "dpkg-buildpackage"
in 
.B "pdebuild"

.TP
.BI "PBUILDERROOTCMD=" "sudo"

This option is used on invocation of 
.B "pbuilder build"
in 
.B "pdebuild"

.TP
.BI "BUILDUSERID=" "1234"
The uid to be used inside chroot.
It should not collide with user-id outside the chroot.

.TP
.BI "BUILDUSERNAME=" "pbuilder"
The user name of the user the build will run as.
Specifying this will enable the use of fakeroot inside 
pbuilder.

Note that this will require fakeroot to be installed within
the chroot, and fakeroot will automatically be installed.
And 
.B "-rfakeroot"
will be added to
.B "DEBBUILDOPTS"

.TP
.BI "APTCONFDIR=" "/etc/apt"
Configures where the apt configuration files are copied from.
By default, this value is empty,
allowing the usual configuration options
to take effect.
Setting this variable overrides other options.


.SH "FILES"
.I "/etc/pbuilderrc"
.SH "SEE ALSO"
.RI "pbuilder (" 1 ") "