aboutsummaryrefslogtreecommitdiff
path: root/pdebuild-user-mode-linux.1
blob: 2402c446764de3ffdece434b11869fc2acccefa7 (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
.TH "pdebuild-user-mode-linux" 1 "2004 Jul 29" "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 "--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 ") "