diff options
author | Richard Purdie <rpurdie@linux.intel.com> | 2010-09-01 15:08:09 +0100 |
---|---|---|
committer | Richard Purdie <rpurdie@linux.intel.com> | 2010-09-01 15:08:45 +0100 |
commit | caab7fc509bf27706ff3248689f6afd04225cfda (patch) | |
tree | f832f656c91502303968fcee1aae382b9f713626 /handbook | |
parent | 232ef8430e2cfbf6eee54f602dc74b9986e3997f (diff) | |
download | poky-caab7fc509bf27706ff3248689f6afd04225cfda.tar.gz |
Drop chroot usage as its not well used, tested and is broken
Signed-off-by: Richard Purdie <rpurdie@linux.intel.com>
Diffstat (limited to 'handbook')
-rw-r--r-- | handbook/development.xml | 42 |
1 files changed, 0 insertions, 42 deletions
diff --git a/handbook/development.xml b/handbook/development.xml index 4f36c7aa82..3bcf40506c 100644 --- a/handbook/development.xml +++ b/handbook/development.xml | |||
@@ -241,48 +241,6 @@ | |||
241 | </para> | 241 | </para> |
242 | </section> | 242 | </section> |
243 | 243 | ||
244 | <section id="platdev-appdev-chroot"> | ||
245 | <title>Developing externally in a chroot</title> | ||
246 | <para> | ||
247 | If you have a system that matches the architecture of the Poky machine you're using, | ||
248 | such as qemux86, you can run binaries directly from the image on the host system | ||
249 | using a chroot combined with tools like <ulink url='http://projects.o-hand.com/xephyr'>Xephyr</ulink>. | ||
250 | </para> | ||
251 | <para> | ||
252 | Poky has some scripts to make using its qemux86 images within a chroot easier. To use | ||
253 | these you need to install the poky-scripts package or otherwise obtain the | ||
254 | <filename>poky-chroot-setup</filename> and <filename>poky-chroot-run</filename> scripts. | ||
255 | You also need Xephyr and chrootuid binaries available. To initialize a system use the setup script: | ||
256 | </para> | ||
257 | <para> | ||
258 | <literallayout class='monospaced'> | ||
259 | # poky-chroot-setup <qemux86-rootfs.tgz> <target-directory> | ||
260 | </literallayout> | ||
261 | </para> | ||
262 | <para> | ||
263 | which will unpack the specified qemux86 rootfs tarball into the target-directory. | ||
264 | You can then start the system with: | ||
265 | </para> | ||
266 | <para> | ||
267 | <literallayout class='monospaced'> | ||
268 | # poky-chroot-run <target-directory> <command> | ||
269 | </literallayout> | ||
270 | </para> | ||
271 | <para> | ||
272 | where the target-directory is the place the rootfs was unpacked to and command is | ||
273 | an optional command to run. If no command is specified, the system will drop you | ||
274 | within a bash shell. A Xephyr window will be displayed containing the emulated | ||
275 | system and you may be asked for a password since some of the commands used for | ||
276 | bind mounting directories need to be run using sudo. | ||
277 | </para> | ||
278 | <para> | ||
279 | There are limits as to how far the the realism of the chroot environment extends. | ||
280 | It is useful for simple development work or quick tests but full system emulation | ||
281 | with QEMU offers a much more realistic environment for more complex development | ||
282 | tasks. Note that chroot support within Poky is still experimental. | ||
283 | </para> | ||
284 | </section> | ||
285 | |||
286 | <section id="platdev-appdev-insitu"> | 244 | <section id="platdev-appdev-insitu"> |
287 | <title>Developing in Poky directly</title> | 245 | <title>Developing in Poky directly</title> |
288 | <para> | 246 | <para> |