aboutsummaryrefslogtreecommitdiff
path: root/pbuilder-uml.conf.5
blob: edc14e0d60b0d3b0b3a2bc8fe7924d47bebcd08c (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 "pbuilder-uml.conf" 5 "2003 Jan 8" "Debian" "pbuilder"
.SH NAME
pbuilder-uml.conf \- configuration file for user-mode-linux port of pbuilder
.SH DESCRIPTION
.B "/etc/pbuilder/pbuilder-uml.conf" 
contains default values used in 
.B pbuilder-user-mode-linux
program invocation.

.SH "FORMAT"
.TP
.BI "MY_ETH0=" "tuntap,,,192.168.0.2"
Configures ethernet setting used for booting linux.
See how rootstrap boots your system, and copy that.

Specify
.B "--eth0=slirp,12345,/usr/bin/slirp-fullbolt"
to use the slirp connection.

.TP 
.BI "UML_IP=" "192.168.0.3"
IP address to use for guest OS.

This can be set to
.B "dhcp"
for obtaining IP address through DHCP.

.TP 
.BI "UML_NETMASK" "=255.255.255.0"
Guest OS netmask

.TP 
.BI "UML_NETWORK" "=192.168.0.0"
Guest OS network

.TP 
.BI "UML_BROADCAST" "=255.255.255.255"
Guest OS broadcast

.TP 
.BI "UML_GATEWAY" "=192.168.0.1"
Guest OS gateway

.TP 
.BI "PBUILDER_UML_IMAGE=" "${HOME}/uml-image"
Guest OS file system image.

.TP 
.BI "UML_MOUNT_TMPFS="  "no"
Whether to mount tmpfs inside the guest image.
This is probably mostly useless.

.TP 
.BI "BUILDPLACE=" "${HOME}/tmp/"
The location which build will take place.
.B pbuilder-user-mode-linux
will place temporary COW files to there.
The user running UML needs to be able to access that directory.

.TP 
.BI "UML_MEM=" "128"
The amount of memory allowed for UML.
Give more value to here.

.TP 
.BI "UML_HOSTNAME=" "uml-host"
The hostname for the UML.

The hostname should be available in 
.B /etc/hosts
so that 
.B "hostname -f "
will be able to return the FQDN.

.TP 
.BI "UML_BUILDRESULT=" "/directory/of/build/result"
The directory where build result of pbuilder-user-mode-linux 
is stored.

.TP
.BI "ROOTSTRAP_IMAGESIZE=" "size-in-megabytes"
The size, in MB, of the disk iamge to create. Defaults to 1000.

.SH "NOTES"

It is advised to set 
.B "APTCACHEHARDLINK"
to
.I no
in 
.BR "~/.pbuilderrc" .
see
.B "pbuilderrc(5)"
for details.

.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 "FILES"
.I "/etc/pbuilder/pbuilder-uml.conf, ${HOME}/.pbuilderrc"
.SH "SEE ALSO"
.RI "pbuilder-user-mode-linux(" 1 "), "
.RI "pbuilder(" 8 "), "
.RI "pbuilderrc(" 5 "), "
.RI "pdebuild(" 1 ")"