aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorHolger Hans Peter Freyther <zecke@selfish.org>2009-08-11 05:29:06 +0200
committerHolger Hans Peter Freyther <zecke@selfish.org>2009-08-11 09:57:15 +0200
commit3b920ca03db2392b542c1fc80505228ae43b14fb (patch)
tree1831bf12bee5b62082e6a69068f3080e8aca22c0 /docs
parent08020ed71ffccfd2893ba869e73e3a169a5ae068 (diff)
downloadopenembedded-3b920ca03db2392b542c1fc80505228ae43b14fb.tar.gz
openembedded-3b920ca03db2392b542c1fc80505228ae43b14fb.tar.bz2
openembedded-3b920ca03db2392b542c1fc80505228ae43b14fb.zip
usermanual: Only advertize using shlibs for external toolchains
Using shlibs and ASSUME_SHLIBS should be everything we need to get proper dependencies into packages. This section should get more work and the external-poky-toolchain approach should be copied to simplify this task.
Diffstat (limited to 'docs')
-rw-r--r--docs/usermanual/chapters/common_use_cases.xml24
1 files changed, 10 insertions, 14 deletions
diff --git a/docs/usermanual/chapters/common_use_cases.xml b/docs/usermanual/chapters/common_use_cases.xml
index 8000f5f1d3..241eb5318b 100644
--- a/docs/usermanual/chapters/common_use_cases.xml
+++ b/docs/usermanual/chapters/common_use_cases.xml
@@ -379,20 +379,16 @@ NOTE: Couldn't find shared library provider for libm.so.6
</screen>
<para>OpenEmbedded tries to automatically add run-time dependencies
- (RDEPENDS) to the package. It uses the <emphasis><link
- linkend="shlibs">shlibs</link></emphasis> system to do add them, in this
- case it was not able to find packages providing these libraries as they
- are prebuilt. This means they will not be added to the RDEPENDS of the
- just created package. The result can be fatal. If you use OpenEmbedded
- to create images you will end up with a image without a libc being
- installed. This will lead to a fatal failure. To workaround this issue
- you could create a package for the metadata to install every needed
- library and use ${BOOTSTRAP_EXTRA_RDEPENDS} to make sure this package is
- installed when creating images.</para>
-
- <para>However, the correct way to resolve this is to provide explicit
- mapping using ASSUME_SHLIBS variable. For example, for the libraries
- above (partial):
+ (RDEPENDS) to generated packages. It is inspecting binaries and
+ libraries and uses the <emphasis><link linkend="shlibs">shlibs</link>
+ </emphasis> system to do add dependencies for the linked libaries,
+ however in this case it was not able to find packages providing these
+ libraries as they were prebuilt.
+ </para>
+
+ <para>One way to resolve this problem is to provide an explicit mapping
+ using the ASSUME_SHLIBS variable in a config file <filename>local.conf</filename>.
+ For example, for the libraries above (partial):
<screen>
ASSUME_SHLIBS = "libqtopia2.so.2:qtopia2_2.4 libc.so.6:libc"
</screen>