aboutsummaryrefslogtreecommitdiff
path: root/pbuilder-uml.conf.5
blob: 29b48158611e699312a5d4d34a19c974a8400e12 (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
.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.

.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 
.B "pbuilderrc(5)"

.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 ")"