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
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.38.2.
.TH ROOTSTOCK "1" "July 2010" "rootstock 0.1.99.3" "User Commands"
.SH NAME
rootstock \- manual page for rootstock 0.1.99.3
.SH SYNOPSIS
.B rootstock
\fI-f <hostname> \fR[\fIOPTION\fR]...
.SH DESCRIPTION
Generates Ubuntu armel rootfs tarballs and/or qemu image, to be
uncompressed onto a root device.
.PP
Note that it does not set up a kernel, modules or bootloader for you.
Kernel and bootloader need to be set up in a device specific manner,
modules should be copied to the filesystem after it was uncompressed
on the target device.
.PP
It also uses a virtual machine and can take long to build your
filesystem, please be patient and make sure to have enough CPU power
on the host machine.
.SH OPTIONS
Required:
.PP
\fB\-f\fR \fB\-\-fqdn\fR <hostname>
.IP
Hostname to be used for the target system
.PP
Additional:
.PP
\fB\-l\fR \fB\-\-login\fR <login name>
.IP
Login ID of the admin user created during setup
.PP
\fB\-p\fR \fB\-\-password\fR <password>
.IP
Password of the admin user created during setup
.PP
\fB\-h\fR \fB\-\-help\fR
.IP
Display this help
.PP
\fB\-n\fR \fB\-\-fullname\fR <quoted string>
.IP
Full Name of the admin user created during setup
(default: "Ubuntu System User")
.PP
\fB\-s\fR \fB\-\-seed\fR <csv list>
.IP
List of packages to install (i.e. ubuntu\-desktop)
.PP
\fB\-i\fR \fB\-\-imagesize\fR <size>M/G
.IP
Size of the target filesystem to be created (i.e. 500M)
(default: 1G)
.PP
\fB\-g\fR \fB\-\-manifest\fR <path to file>
.IP
Manifest file with list of packages to install (one per line)
.PP
\fB\-m\fR \fB\-\-mirror\fR <url>
.IP
apt mirror to use (i.e. http://ports.ubuntu.com/ubuntu\-ports)
(default: http://ports.ubuntu.com/ubuntu\-ports)
.PP
\fB\-c\fR \fB\-\-components\fR <csv list>
.IP
Archive components
(default: main,universe)
.PP
\fB\-d\fR \fB\-\-dist\fR (jaunty or karmic)
.IP
Specify Release to build
(default: maverick)
.PP
\fB\-t\fR \fB\-\-timezone\fR <timezone>
.IP
Timezone for the system (i.e. Europe/Berlin)
(default: buildsystem timezone)
.PP
\fB\-x\fR \fB\-\-locale\fR <locale.encoding>
.IP
Language used in the installed system (i.e. en_US.UTF\-8)
(default: buildsystem locale)
.PP
\fB\-\-script\fR <filename>
.IP
Run this script at the end of the installation process
.PP
\fB\-\-serial\fR <devicename>
.IP
Create a serial tty of <devicename> inside the rootfs for login (i.e. ttyS0)
.PP
\fB\-\-doswap\fR
.IP
Do create a swapfile in tmpfs for the virtual machine
.PP
\fB\-\-swapsize\fR <size in megabyte>
.IP
Use a different size for the swapfile used by the virtual machine
(default: 256M)
.PP
\fB\-\-version\fR
.IP
Print version number
.PP
Keyboard:
.PP
\fB\-\-kblayout\fR <layout>
.IP
Keyboard layout (i.e. us)
(default: buildsystem kblayout)
.PP
\fB\-\-kbmodel\fR <model>
.IP
Keyboard model (i.e. pc105)
(default: buildsystem kbmodel)
.PP
\fB\-\-kbvariant\fR <variant>
.IP
Keyboard variant (i.e. nodeadkeys)
(default: buildsystem kbvariant)
.PP
\fB\-\-kboptions\fR <options>
.IP
Additional keyboard options
(default: buildsystem kboptions)
.PP
Output:
.PP
\fB\-\-keepimage\fR
.IP
Keep the qemu image instead of deleting it
.PP
\fB\-\-notarball\fR
.IP
Do not roll a tarball of the rootfs (autosets \fB\-\-keepimage\fR)
.PP
Extra parameters:
.PP
\fB\-q\fR \fB\-\-quiet\fR
.IP
Quiet operation, only write to log
.PP
Advanced:
.PP
\fB\-\-kernel\-image\fR <http url to kernel .deb>
.IP
install board specfic kernel package from http accessible deb package inside rootfs
.PP
\fB\-\-copy\-package\-cache\fR
.IP
save a snapshot of all packages used for a build locally to re\-use them
in a subsequent offline build with the \fB\-\-restore\-package\-cache\fR option
.PP
\fB\-\-restore\-package\-cache\fR
.IP
use precached packages from a former build run with \fB\-\-copy\-package\-cache\fR
.PP
\fB\-\-clean\-package\-cache\fR
.IP
empty the package cache of a former \fB\-\-copy\-package\-cache\fR run
.PP
\fB\-\-extra\-mirror\fR
.IP
additional mirror to use
.PP
\fB\-\-no\-root\fR
.IP
run rootstock without requiring root access (slower)
.SH EXAMPLES
Xubuntu\-Desktop (as root): rootstock \fB\-f\fR host \fB\-l\fR user \fB\-p\fR temppwd \fB\-i\fR 2G \fB\-s\fR xubuntu\-desktop
.PP
Minimal Ubuntu (as user): rootstock \fB\-f\fR host \fB\-l\fR user \fB\-p\fR temppwd \fB\-i\fR 512M \fB\-\-no\-root\fR \fB\-s\fR ubuntu\-minimal
.SH AUTHOR
Written by Oliver Grawert <ogra@canonical.com>.
.SH "REPORTING BUGS"
Report bugs at https://launchpad.net/project\-rootstock/+filebug
.SH COPYRIGHT
Copyright \(co 2009, 2010 Canonical
License: GNU GPL version 2 or later <http://gnu.org/licenses/gpl.html>.
.PP
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
|