summaryrefslogtreecommitdiffstats
path: root/README.commands
diff options
context:
space:
mode:
authorRichard Purdie <richard@openedhand.com>2008-02-26 11:41:20 +0000
committerRichard Purdie <richard@openedhand.com>2008-02-26 11:41:20 +0000
commit18a758b9e99641207883c81cb7862a8737eb0682 (patch)
tree0981494a839dbd38369de6ad420357a4545c3e7f /README.commands
parentb2bdf19d90f9ac43a576076a408fb6104db4e5be (diff)
downloadpoky-18a758b9e99641207883c81cb7862a8737eb0682.tar.gz
README*: Update after addition of manual
git-svn-id: https://svn.o-hand.com/repos/poky/trunk@3867 311d38ba-8fff-0310-9ca6-ca027cbcb966
Diffstat (limited to 'README.commands')
-rw-r--r--README.commands106
1 files changed, 0 insertions, 106 deletions
diff --git a/README.commands b/README.commands
deleted file mode 100644
index c84eefad99..0000000000
--- a/README.commands
+++ /dev/null
@@ -1,106 +0,0 @@
1 Using Poky - Poky Commands
2 ==========================
3
4Bitbake
5=======
6
7Bitbake is the tool at the heart of poky and is responsible for parsing the
8metadata, generating a list of tasks from it and then executing them. To see a
9list of the options it supports look at "bitbake --help".
10
11The most common usage is "bitbake <packagename>" where <packagename> is the name
12of the package you wish to build. This often equates to the first part of a .bb
13filename so to run the matchbox-desktop_1.2.3.bb file, you might type "bitbake
14matchbox-desktop. Several different versions of matchbox-desktop might exist
15and bitbake will choose the one selected by the distribution configuration.
16Bitbake will also try to execute any dependent tasks first so before building
17matchbox-desktop it would build a cross compiler and glibc if not already built.
18
19
20Bitbake - Package Tasks
21=======================
22
23Any given package consists of a set of tasks, in most cases the series is fetch,
24unpack, patch, configure, compile, install, package, package_write and build.
25The default task is "build" and any tasks this depends on are built first hence
26the standard bitbake behaviour. There are some tasks such as devshell which are
27not part of the default build chain. If you wish to run such a task you can use
28the "-c" option to bitbake e.g. "bitbake matchbox-desktop -c devshell".
29
30If you wish to rerun a task you can use the force option "-f". A typical usage
31case might look like:
32
33% bitbake matchbox-desktop
34[change some source in the WORKDIR for example]
35% bitbake matchbox-desktop -c compile -f
36% bitbake matchbox-desktop
37
38which would build matchbox-desktop, then recompile it. The final command reruns
39all tasks after the compile (basically the packaging tasks) since bitbake will
40notice the the compile has been rerun and hence the other tasks also need to run
41again.
42
43You can view a list of tasks in a given package by running the listtasks task
44e.g. "bitbake matchbox-desktop -c listtasks".
45
46
47Bitbake - Dependency Graphs
48===========================
49
50Sometimes it can be hard to see why bitbake wants to build some other packages
51before a given package you've specified. "bitbake matchbox-desktop -g" will
52create a task-depends.dot file in the current directory. This shows which
53packages and tasks depend on which other packages and tasks and it useful for
54debugging purposes.
55
56
57Bitbake - Advanced Usage
58========================
59
60Debug output from bitbake can be seen with the "-D" option and can sometimes
61give more information about what bitbake is doing and/or why. Each -D options
62increases the logging level, the most common usage being "-DDD".
63
64If you really want to build a specific .bb file, you can use the form "bitbake
65-b somepath/somefile.bb". Note that this will not check the dependencies so this
66option should only be used when you know the dependencies already exist. You can
67specify fragments of the filename and bitbake will see if it can find a unique
68match.
69
70The -e option will dump the resulting environment for either the configuration
71(no package specified) or for a specific package when specified with the -b
72option.
73
74The -k option will cause bitbake to try and continue even if a task fails. It
75can be useful for world or unattended builds.
76
77The -s option lists all the versions of packages that bitbake will use.
78
79
80Bitbake - More Information
81==========================
82
83See the bitbake user manual at: http://bitbake.berlios.de/manual/
84
85QEMU
86====
87
88Running images built by poky under qemu is possible within the poky environment
89through the "runqemu" command. It has the form:
90
91runqemu MACHINE IMAGETYPE ZIMAGE IMAGEFILE
92
93where:
94
95MACHINE - the machine to emulate (qemux86, qemuarm, spitz, akita)
96IMAGETYPE - the type of image to use (nfs or ext2)
97ZIMAGE - location of the kernel binary to use
98IMAGEFILE - location of the image file to use
99(common options are in brackets)
100
101MACHINE is mandatory, the others are optional.
102
103This assumes a suitable qemu binary is available with support for a given
104machine. For further information see scripts/poky-qemu.README.
105
106 Copyright (C) 2006-2007 OpenedHand Ltd.