aboutsummaryrefslogtreecommitdiff
path: root/pdebuild-user-mode-linux.1
blob: 83bc92bf5108aa930d538bbcdbbd693a1df66370 (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
.TH "pdebuild\-user\-mode\-linux" 1 "2005 Jul 10" "Debian" "pbuilder"
.SH NAME
pdebuild\-user\-mode\-linux \- pbuilder\-user\-mode\-linux way of doing debuild
.SH SYNOPSIS
.BI "pdebuild\-user\-mode\-linux [" "pdebuild\-user\-mode\-linux options" "] \-\- [" "pbuilder\-user\-mode\-linux options" "]"
.PP
.SH "DESCRIPTION"
A convenience program for 
.B pbuilder\-user\-mode\-linux
which invokes pbuilder after obtaining appropriate root privilate 
in a Debian source directory.
One must be inside the source tree containing the
.B debian
directory, in order to make it work.

.SH "PDEBUILD OPTIONS"
.TP

.BI "\-\-buildsourceroot [" "fakeroot" "]"
The command used to gain root privilege for 
invoking dpkg-buildpackage

.TP
.BI "\-\-auto\-debsign"

Invoke debsign at the end of pdebuild process.

.TP
.BI "\-\-debsign\-k [" "key-id" "]"

Pass 
.B "\-k"
option to debsign to specify which keyid to sign.

.TP
.BI "\-\-buildresult [" "Directory for build results" "]"

The place which build result is stored.

.TP
.BI "\-\-configfile [" "Extra config file to use" "]"

The configuration file is used, but not passed on to 
.BR "pbuilder\-user\-mode\-linux" .

.TP
.BI "\-\-debbuildopts [" "options to pass to dpkg\-buildpackage" "]"

The space-delimited list of options are passed to dpkg\-buildpackage.
This option overrides pbuilder option 
.B "\-\-debbuildopts"

.TP
.BI "\-\-use\-pdebuild\-internal"
Uses a different implementation of pdebuild, which calls clean and build inside 
the chroot, using bind-mounts.

.B "pdebuild\-internal"
tries to run debian/rules clean inside the chroot.
To achieve the goal, the working directory is passed on inside the chroot,
in the form of bind-mounting and
.B debuild 
is run.

This option will not protect the working directory and its parent directories 
from the build scripts.

.TP
.BI "\-\- [" "pbuilder options" "]"

After the 
.B "\-\-"
symbol, an arbitrary number of pbuilder options can be specified.
See pbuilder-user-mode-linux.1 for full list of options.


There is an exception that
.B "\-\-buildresult"
needs to be specified as pdebuild option before the 
.B "\-\-"
to be effective.

.SH "FILES"
.TP
.I "/etc/pbuilderrc"
The configuration file for pbuilder\-user\-mode\-linux, used in pdebuild\-user\-mode\-linux.

.TP
.I "/usr/share/pbuilder/pbuilderrc"
The default configuration file for pbuilder\-user\-mode\-linux, used in pdebuild\-user\-mode\-linux.

.TP
.I "${HOME}/.pbuilderrc"
Configuration file for pbuilder\-user\-mode\-linux, used in pdebuild\-user\-mode\-linux,
overrides what is written in
.B /etc/pbuilderrc

.SH "AUTHOR"
Initial coding, and main maintenance is done by 
Junichi Uekawa <dancer@debian.org>.

The homepage is available at
.B "\%http://www.netfort.gr.jp/~dancer/software/pbuilder.html"

.SH "SEE ALSO"
.RI "pbuilder\-user\-mode\-linux (" 1 "), "
.RI "pbuilderrc (" 5 "), "
.RI "pbuilder\-uml.conf (" 5 ") "