summaryrefslogtreecommitdiffstats
path: root/documentation/adt-manual/adt-intro.xml
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2012-12-07 17:19:36 -0600
committerRichard Purdie <richard.purdie@linuxfoundation.org>2012-12-11 16:15:24 +0000
commit3bcdba62b186c554033357bb50de0b20d115a54d (patch)
treeabc1731f63ac3faeec778c39e45344d61c3d7949 /documentation/adt-manual/adt-intro.xml
parent205c7961f31fced8f42a8fc483618ed3d54dc109 (diff)
downloadpoky-3bcdba62b186c554033357bb50de0b20d115a54d.tar.gz
documentation: adt-manual - Removed all trailing whitespace.
(From yocto-docs rev: c1c271c0404dff9ed49597a4582a56def8237dd7) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/adt-manual/adt-intro.xml')
-rw-r--r--documentation/adt-manual/adt-intro.xml128
1 files changed, 64 insertions, 64 deletions
diff --git a/documentation/adt-manual/adt-intro.xml b/documentation/adt-manual/adt-intro.xml
index d8527b3aef..fcbceb4de1 100644
--- a/documentation/adt-manual/adt-intro.xml
+++ b/documentation/adt-manual/adt-intro.xml
@@ -6,44 +6,44 @@
6<title>Introduction</title> 6<title>Introduction</title>
7 7
8<para> 8<para>
9 Welcome to the Yocto Project Application Developer's Guide. 9 Welcome to the Yocto Project Application Developer's Guide.
10 This manual provides information that lets you begin developing applications 10 This manual provides information that lets you begin developing applications
11 using the Yocto Project. 11 using the Yocto Project.
12</para> 12</para>
13 13
14<para> 14<para>
15 The Yocto Project provides an application development environment based on 15 The Yocto Project provides an application development environment based on
16 an Application Development Toolkit (ADT) and the availability of stand-alone 16 an Application Development Toolkit (ADT) and the availability of stand-alone
17 cross-development toolchains and other tools. 17 cross-development toolchains and other tools.
18 This manual describes the ADT and how you can configure and install it, 18 This manual describes the ADT and how you can configure and install it,
19 how to access and use the cross-development toolchains, how to 19 how to access and use the cross-development toolchains, how to
20 customize the development packages installation, 20 customize the development packages installation,
21 how to use command line development for both Autotools-based and Makefile-based projects, 21 how to use command line development for both Autotools-based and Makefile-based projects,
22 and an introduction to the Eclipse Yocto Plug-in. 22 and an introduction to the Eclipse Yocto Plug-in.
23</para> 23</para>
24 24
25<section id='adt-intro-section'> 25<section id='adt-intro-section'>
26 <title>The Application Development Toolkit (ADT)</title> 26 <title>The Application Development Toolkit (ADT)</title>
27 27
28 <para> 28 <para>
29 Part of the Yocto Project development solution is an Application Development 29 Part of the Yocto Project development solution is an Application Development
30 Toolkit (ADT). 30 Toolkit (ADT).
31 The ADT provides you with a custom-built, cross-development 31 The ADT provides you with a custom-built, cross-development
32 platform suited for developing a user-targeted product application. 32 platform suited for developing a user-targeted product application.
33 </para> 33 </para>
34 34
35 <para> 35 <para>
36 Fundamentally, the ADT consists of the following: 36 Fundamentally, the ADT consists of the following:
37 <itemizedlist> 37 <itemizedlist>
38 <listitem><para>An architecture-specific cross-toolchain and matching 38 <listitem><para>An architecture-specific cross-toolchain and matching
39 sysroot both built by the OpenEmbedded build system, which uses Poky. 39 sysroot both built by the OpenEmbedded build system, which uses Poky.
40 The toolchain and sysroot are based on a metadata configuration and extensions, 40 The toolchain and sysroot are based on a metadata configuration and extensions,
41 which allows you to cross-develop on the host machine for the target hardware. 41 which allows you to cross-develop on the host machine for the target hardware.
42 </para></listitem> 42 </para></listitem>
43 <listitem><para>The Eclipse IDE Yocto Plug-in.</para></listitem> 43 <listitem><para>The Eclipse IDE Yocto Plug-in.</para></listitem>
44 <listitem><para>The Quick EMUlator (QEMU), which lets you simulate target hardware. 44 <listitem><para>The Quick EMUlator (QEMU), which lets you simulate target hardware.
45 </para></listitem> 45 </para></listitem>
46 <listitem><para>Various user-space tools that greatly enhance your application 46 <listitem><para>Various user-space tools that greatly enhance your application
47 development experience.</para></listitem> 47 development experience.</para></listitem>
48 </itemizedlist> 48 </itemizedlist>
49 </para> 49 </para>
@@ -52,13 +52,13 @@
52 <title>The Cross-Toolchain</title> 52 <title>The Cross-Toolchain</title>
53 53
54 <para> 54 <para>
55 The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger 55 The cross-toolchain consists of a cross-compiler, cross-linker, and cross-debugger
56 that are used to develop user-space applications for targeted hardware. 56 that are used to develop user-space applications for targeted hardware.
57 This toolchain is created either by running the ADT Installer script, a toolchain installer 57 This toolchain is created either by running the ADT Installer script, a toolchain installer
58 script, or through a 58 script, or through a
59 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> that 59 <ulink url='&YOCTO_DOCS_DEV_URL;#build-directory'>Build Directory</ulink> that
60 is based on your metadata 60 is based on your metadata
61 configuration or extension for your targeted device. 61 configuration or extension for your targeted device.
62 The cross-toolchain works with a matching target sysroot. 62 The cross-toolchain works with a matching target sysroot.
63 </para> 63 </para>
64 </section> 64 </section>
@@ -67,10 +67,10 @@
67 <title>Sysroot</title> 67 <title>Sysroot</title>
68 68
69 <para> 69 <para>
70 The matching target sysroot contains needed headers and libraries for generating 70 The matching target sysroot contains needed headers and libraries for generating
71 binaries that run on the target architecture. 71 binaries that run on the target architecture.
72 The sysroot is based on the target root filesystem image that is built by 72 The sysroot is based on the target root filesystem image that is built by
73 the OpenEmbedded build system Poky and uses the same metadata configuration 73 the OpenEmbedded build system Poky and uses the same metadata configuration
74 used to build the cross-toolchain. 74 used to build the cross-toolchain.
75 </para> 75 </para>
76 </section> 76 </section>
@@ -79,24 +79,24 @@
79 <title>Eclipse Yocto Plug-in</title> 79 <title>Eclipse Yocto Plug-in</title>
80 80
81 <para> 81 <para>
82 The Eclipse IDE is a popular development environment and it fully supports 82 The Eclipse IDE is a popular development environment and it fully supports
83 development using the Yocto Project. 83 development using the Yocto Project.
84 When you install and configure the Eclipse Yocto Project Plug-in into 84 When you install and configure the Eclipse Yocto Project Plug-in into
85 the Eclipse IDE, you maximize your Yocto Project experience. 85 the Eclipse IDE, you maximize your Yocto Project experience.
86 Installing and configuring the Plug-in results in an environment that 86 Installing and configuring the Plug-in results in an environment that
87 has extensions specifically designed to let you more easily develop software. 87 has extensions specifically designed to let you more easily develop software.
88 These extensions allow for cross-compilation, deployment, and execution of 88 These extensions allow for cross-compilation, deployment, and execution of
89 your output into a QEMU emulation session. 89 your output into a QEMU emulation session.
90 You can also perform cross-debugging and profiling. 90 You can also perform cross-debugging and profiling.
91 The environment also supports a suite of tools that allows you to perform 91 The environment also supports a suite of tools that allows you to perform
92 remote profiling, tracing, collection of power data, collection of 92 remote profiling, tracing, collection of power data, collection of
93 latency data, and collection of performance data. 93 latency data, and collection of performance data.
94 </para> 94 </para>
95 95
96 <para> 96 <para>
97 For information about the application development workflow that uses the Eclipse 97 For information about the application development workflow that uses the Eclipse
98 IDE and for a detailed example of how to install and configure the Eclipse 98 IDE and for a detailed example of how to install and configure the Eclipse
99 Yocto Project Plug-in, see the 99 Yocto Project Plug-in, see the
100 "<ulink url='&YOCTO_DOCS_DEV_URL;#adt-eclipse'>Working Within Eclipse</ulink>" section 100 "<ulink url='&YOCTO_DOCS_DEV_URL;#adt-eclipse'>Working Within Eclipse</ulink>" section
101 of the Yocto Project Development Manual. 101 of the Yocto Project Development Manual.
102 </para> 102 </para>
@@ -106,19 +106,19 @@
106 <title>The QEMU Emulator</title> 106 <title>The QEMU Emulator</title>
107 107
108 <para> 108 <para>
109 The QEMU emulator allows you to simulate your hardware while running your 109 The QEMU emulator allows you to simulate your hardware while running your
110 application or image. 110 application or image.
111 QEMU is made available a number of ways: 111 QEMU is made available a number of ways:
112 <itemizedlist> 112 <itemizedlist>
113 <listitem><para>If you use the ADT Installer script to install ADT, you can 113 <listitem><para>If you use the ADT Installer script to install ADT, you can
114 specify whether or not to install QEMU.</para></listitem> 114 specify whether or not to install QEMU.</para></listitem>
115 <listitem><para>If you have downloaded a Yocto Project release and unpacked 115 <listitem><para>If you have downloaded a Yocto Project release and unpacked
116 it to create a 116 it to create a
117 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> and 117 <ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink> and
118 you have sourced 118 you have sourced
119 the environment setup script, QEMU is installed and automatically 119 the environment setup script, QEMU is installed and automatically
120 available.</para></listitem> 120 available.</para></listitem>
121 <listitem><para>If you have installed the cross-toolchain 121 <listitem><para>If you have installed the cross-toolchain
122 tarball and you have sourcing the toolchain's setup environment script, QEMU 122 tarball and you have sourcing the toolchain's setup environment script, QEMU
123 is also installed and automatically available.</para></listitem> 123 is also installed and automatically available.</para></listitem>
124 </itemizedlist> 124 </itemizedlist>
@@ -129,38 +129,38 @@
129 <title>User-Space Tools</title> 129 <title>User-Space Tools</title>
130 130
131 <para> 131 <para>
132 User-space tools are included as part of the distribution. 132 User-space tools are included as part of the distribution.
133 You will find these tools helpful during development. 133 You will find these tools helpful during development.
134 The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust. 134 The tools include LatencyTOP, PowerTOP, OProfile, Perf, SystemTap, and Lttng-ust.
135 These tools are common development tools for the Linux platform. 135 These tools are common development tools for the Linux platform.
136 <itemizedlist> 136 <itemizedlist>
137 <listitem><para><emphasis>LatencyTOP:</emphasis> LatencyTOP focuses on latency 137 <listitem><para><emphasis>LatencyTOP:</emphasis> LatencyTOP focuses on latency
138 that causes skips in audio, 138 that causes skips in audio,
139 stutters in your desktop experience, or situations that overload your server 139 stutters in your desktop experience, or situations that overload your server
140 even when you have plenty of CPU power left. 140 even when you have plenty of CPU power left.
141 You can find out more about LatencyTOP at 141 You can find out more about LatencyTOP at
142 <ulink url='http://www.latencytop.org/'></ulink>.</para></listitem> 142 <ulink url='http://www.latencytop.org/'></ulink>.</para></listitem>
143 <listitem><para><emphasis>PowerTOP:</emphasis> Helps you determine what 143 <listitem><para><emphasis>PowerTOP:</emphasis> Helps you determine what
144 software is using the most power. 144 software is using the most power.
145 You can find out more about PowerTOP at 145 You can find out more about PowerTOP at
146 <ulink url='https://01.org/powertop/'></ulink>.</para></listitem> 146 <ulink url='https://01.org/powertop/'></ulink>.</para></listitem>
147 <listitem><para><emphasis>OProfile:</emphasis> A system-wide profiler for Linux 147 <listitem><para><emphasis>OProfile:</emphasis> A system-wide profiler for Linux
148 systems that is capable of profiling all running code at low overhead. 148 systems that is capable of profiling all running code at low overhead.
149 You can find out more about OProfile at 149 You can find out more about OProfile at
150 <ulink url='http://oprofile.sourceforge.net/about/'></ulink>.</para></listitem> 150 <ulink url='http://oprofile.sourceforge.net/about/'></ulink>.</para></listitem>
151 <listitem><para><emphasis>Perf:</emphasis> Performance counters for Linux used 151 <listitem><para><emphasis>Perf:</emphasis> Performance counters for Linux used
152 to keep track of certain types of hardware and software events. 152 to keep track of certain types of hardware and software events.
153 For more information on these types of counters see 153 For more information on these types of counters see
154 <ulink url='https://perf.wiki.kernel.org/'></ulink> and click 154 <ulink url='https://perf.wiki.kernel.org/'></ulink> and click
155 on “Perf tools.”</para></listitem> 155 on “Perf tools.”</para></listitem>
156 <listitem><para><emphasis>SystemTap:</emphasis> A free software infrastructure 156 <listitem><para><emphasis>SystemTap:</emphasis> A free software infrastructure
157 that simplifies information gathering about a running Linux system. 157 that simplifies information gathering about a running Linux system.
158 This information helps you diagnose performance or functional problems. 158 This information helps you diagnose performance or functional problems.
159 SystemTap is not available as a user-space tool through the Eclipse IDE Yocto Plug-in. 159 SystemTap is not available as a user-space tool through the Eclipse IDE Yocto Plug-in.
160 See <ulink url='http://sourceware.org/systemtap'></ulink> for more information 160 See <ulink url='http://sourceware.org/systemtap'></ulink> for more information
161 on SystemTap.</para></listitem> 161 on SystemTap.</para></listitem>
162 <listitem><para><emphasis>Lttng-ust:</emphasis> A User-space Tracer designed to 162 <listitem><para><emphasis>Lttng-ust:</emphasis> A User-space Tracer designed to
163 provide detailed information on user-space activity. 163 provide detailed information on user-space activity.
164 See <ulink url='http://lttng.org/ust'></ulink> for more information on Lttng-ust. 164 See <ulink url='http://lttng.org/ust'></ulink> for more information on Lttng-ust.
165 </para></listitem> 165 </para></listitem>
166 </itemizedlist> 166 </itemizedlist>