diff options
4 files changed, 125 insertions, 115 deletions
diff --git a/doc/book-enea-linux-user-guide/doc/application_development.xml b/doc/book-enea-linux-user-guide/doc/application_development.xml index 0e2edf4..a94c422 100644 --- a/doc/book-enea-linux-user-guide/doc/application_development.xml +++ b/doc/book-enea-linux-user-guide/doc/application_development.xml | |||
@@ -156,7 +156,7 @@ MODULE_LICENSE("GPL");</programlisting> | |||
156 | <para>This example will show how to generate a recipe from the existing | 156 | <para>This example will show how to generate a recipe from the existing |
157 | application code and Makefile, edit the recipe in order to provide an | 157 | application code and Makefile, edit the recipe in order to provide an |
158 | installation path for the application, build the recipe, and deploy the | 158 | installation path for the application, build the recipe, and deploy the |
159 | output on a target, or create a DEB package from the recipe and install | 159 | output on a target, or create a RPM package from the recipe and install |
160 | the package.</para> | 160 | the package.</para> |
161 | 161 | ||
162 | <orderedlist> | 162 | <orderedlist> |
@@ -266,16 +266,16 @@ Parsing recipes..done. | |||
266 | NOTE: Successfully deployed | 266 | NOTE: Successfully deployed |
267 | <SDK_dir>/tmp/work/<arch>-enea-linux/my-hello-recipe/1.0-r0/image</programlisting> | 267 | <SDK_dir>/tmp/work/<arch>-enea-linux/my-hello-recipe/1.0-r0/image</programlisting> |
268 | 268 | ||
269 | <para>As an alternative you can create a DEB package:</para> | 269 | <para>As an alternative you can create a RPM package:</para> |
270 | 270 | ||
271 | <programlisting>$ devtool package my-hello-recipe | 271 | <programlisting>$ devtool package my-hello-recipe |
272 | ... | 272 | ... |
273 | NOTE: Your packages are in <SDK_dir>/tmp/deploy/deb</programlisting> | 273 | NOTE: Your packages are in <SDK_dir>/tmp/deploy/deb</programlisting> |
274 | 274 | ||
275 | <para>Then copy the DEB package on the target and install it using | 275 | <para>Then copy the RPM package on the target and install it using |
276 | dpkg:</para> | 276 | rpm:</para> |
277 | 277 | ||
278 | <programlisting># dpkg -i my-hello-recipe-1.0-r0.1.<arch>.deb</programlisting> | 278 | <programlisting># rpm -i my-hello-recipe-1.0-r0.1.<arch>.rpm</programlisting> |
279 | </listitem> | 279 | </listitem> |
280 | </orderedlist> | 280 | </orderedlist> |
281 | </section> | 281 | </section> |
diff --git a/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml index 21d0cb9..b747b2e 100644 --- a/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml +++ b/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml | |||
@@ -39,8 +39,8 @@ | |||
39 | </listitem> | 39 | </listitem> |
40 | 40 | ||
41 | <listitem> | 41 | <listitem> |
42 | <para><emphasis>deb</emphasis> directory - this directory contains all | 42 | <para><emphasis>rpm</emphasis> directory - this directory contains all |
43 | the packages included in the distribution in deb format, which can be | 43 | the packages included in the distribution in rpm format, which can be |
44 | installed using the package manager.</para> | 44 | installed using the package manager.</para> |
45 | </listitem> | 45 | </listitem> |
46 | </itemizedlist> | 46 | </itemizedlist> |
diff --git a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml index f354399..077935a 100644 --- a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml +++ b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml | |||
@@ -3,72 +3,70 @@ | |||
3 | <title>Using Eclipse</title> | 3 | <title>Using Eclipse</title> |
4 | 4 | ||
5 | <section id="install_eclipse"> | 5 | <section id="install_eclipse"> |
6 | <title>Installing Eclipse</title> | 6 | <title>Installing Oxygen Eclipse IDE</title> |
7 | |||
8 | <para> | ||
9 | <note> | ||
10 | Yocto Eclipse Plugins are discontinued and the last Yocto version that provides them | ||
11 | is Yocto 2.5. | ||
12 | </note> | ||
13 | </para> | ||
14 | |||
15 | <para>Installation and configuration of the Eclipse Oxygen IDE should be done following the | ||
16 | <ulink url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">Yocto | ||
17 | Project Application Development and the Extensible Software Development Kit | ||
18 | (eSDK)</ulink> documentation, Chapter 5. | ||
19 | Instructions provided in Chapter 5.2.1.1 are no longer valid, so, please follow the | ||
20 | steps below in order to install Eclipse Oxygen: | ||
21 | </para> | ||
7 | 22 | ||
8 | <para>For instructions on how to install Eclipse Oxygen, please refer to | 23 | <orderedlist> |
9 | the <ulink | ||
10 | url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">Yocto | ||
11 | Project Software Development Kit (SDK) Developer's Guide</ulink>, chapter | ||
12 | 4.3.2.1. Although the instructions listed there currently, refer to the | ||
13 | Neon release of Eclipse, the same steps still apply to the Oxygen release, | ||
14 | with some small differences:</para> | ||
15 | |||
16 | <itemizedlist> | ||
17 | <listitem> | 24 | <listitem> |
18 | <para>In <emphasis role="bold">step 1</emphasis> from chapter | 25 | <para>Download Eclipse Oxygen archive from this link, by selecting the correct architecture:<ulink |
19 | 4.3.2.1.1, the URL for downloading Eclipse should be <ulink | 26 | url="https://www.eclipse.org/downloads/packages/release/oxygen/2/eclipse-ide-cc-developers"> |
20 | url="http://www.eclipse.org/oxygen">http://www.eclipse.org/oxygen</ulink> | 27 | https://www.eclipse.org/downloads/packages/release/oxygen/2/eclipse-ide-cc-developers</ulink> |
21 | instead.</para> | 28 | (i.e. <filename>eclipse-cpp-oxygen-2-linux-gtk-x86_64.tar.gz</filename>). |
29 | </para> | ||
22 | </listitem> | 30 | </listitem> |
23 | 31 | ||
24 | <listitem> | 32 | <listitem> |
25 | <para>In <emphasis role="bold">step 3</emphasis> from chapter | 33 | <para>Decompress the Eclipse archive in your home directory and start the IDE: |
26 | 4.3.2.1.2, the correct option in the drop-down menu should look like: | 34 | <programlisting> |
27 | <emphasis>Oxygen - | 35 | $ tar xf ~/Downloads/eclipse-cpp-oxygen-2-linux-gtk-x86_64.tar.gz -C ~/ |
28 | http://download.eclipse.org/releases/oxygen</emphasis>.</para> | 36 | $ ~/eclipse/eclipse |
37 | </programlisting> | ||
38 | </para> | ||
29 | </listitem> | 39 | </listitem> |
30 | 40 | ||
31 | <listitem> | 41 | <listitem> |
32 | <para>In <emphasis role="bold">step 5</emphasis> from chapter | 42 | <para>Proceed to Chapter 5.2.1.2 in the Yocto documentation and configure Eclipse with |
33 | 4.3.2.1.2, under the category <emphasis role="bold">Mobile and Device | 43 | Oxygen. |
34 | Development</emphasis>, select <emphasis role="bold">C/C++ GDB | 44 | </para> |
35 | Hardware Debugging</emphasis> as well.</para> | ||
36 | </listitem> | 45 | </listitem> |
37 | </itemizedlist> | 46 | |
47 | </orderedlist> | ||
48 | |||
49 | <para> | ||
50 | <note> | ||
51 | For compatibility reasons, only use JDK version 1.8 on your host. | ||
52 | </note> | ||
53 | </para> | ||
38 | </section> | 54 | </section> |
39 | 55 | ||
40 | <section id="install_yocto"> | 56 | <section id="install_yocto"> |
41 | <title>Installing Yocto Plug-ins</title> | 57 | <title>Installing Yocto Plug-ins</title> |
42 | 58 | ||
43 | <para>Retrieve the archive containing the Yocto Plug-ins from the Enea | ||
44 | Linux release location and save it on your local machine. The archive file | ||
45 | has the following format: | ||
46 | <filename>org.yocto.sdk-<release>-<date>-archive.zip</filename>.</para> | ||
47 | |||
48 | <para>To install the Yocto Plugins in Eclipse, follow the instructions in | 59 | <para>To install the Yocto Plugins in Eclipse, follow the instructions in |
49 | <ulink | 60 | <ulink |
50 | url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">chapter | 61 | url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#oxygen-setting-up-the-eclipse-ide"> |
51 | 4.3.2.1.3.2</ulink>. of the Yocto Manual, starting with <emphasis | 62 | Yocto Project Application Development and the Extensible Software Development Kit |
52 | role="bold">step 8</emphasis>. In <emphasis role="bold">step 12</emphasis> | 63 | (eSDK)</ulink> documentation, Chapter 5.2.1.3. |
53 | use the local archive that you downloaded previously.</para> | 64 | </para> |
54 | 65 | <para> | |
55 | <para>To make sure that all required packages have been installed, go to | 66 | You have the option of installing pre-built plugins from the Yocto Project Eclipse |
56 | the menu <emphasis role="bold">Help > Install New Software > Eclipse | 67 | update site (Chapter 5.2.1.3.1) or to install the plugins using the latest source code |
57 | version</emphasis>, and select the version you use (e.g. Oxygen), to add | 68 | (Chapter 5.2.1.3.2). We recommend for the first installation the use of pre-built plugins. |
58 | any missing packages. You can also check what packages are currently | 69 | </para> |
59 | installed by pressing the <emphasis role="bold">What is Already | ||
60 | Installed?</emphasis> link, as seen below.</para> | ||
61 | |||
62 | <mediaobject> | ||
63 | <imageobject role="fo"> | ||
64 | <imagedata align="center" contentwidth="600" | ||
65 | fileref="images/install_new_sw.svg" /> | ||
66 | </imageobject> | ||
67 | |||
68 | <imageobject role="html"> | ||
69 | <imagedata align="center" fileref="images/install_new_sw.png" /> | ||
70 | </imageobject> | ||
71 | </mediaobject> | ||
72 | </section> | 70 | </section> |
73 | 71 | ||
74 | <section id="eclipse_remote_connection"> | 72 | <section id="eclipse_remote_connection"> |
@@ -221,10 +219,10 @@ root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</p | |||
221 | <tip> | 219 | <tip> |
222 | <para>More details on how to configure the cross-compiler can be found | 220 | <para>More details on how to configure the cross-compiler can be found |
223 | in the <ulink | 221 | in the <ulink |
224 | url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html"><emphasis>Yocto | 222 | url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html">Yocto |
225 | Project Software Development Kit (SDK) Developer's Guide | 223 | Project Application Development and the Extensible Software Development Kit |
226 | 2.5</emphasis></ulink>. Change the Yocto version in the link if | 224 | (eSDK)</ulink>. |
227 | needed.</para> | 225 | </para> |
228 | 226 | ||
229 | <para>There is also a good cheat sheet available in Eclipse, under | 227 | <para>There is also a good cheat sheet available in Eclipse, under |
230 | <emphasis role="bold">Help > Cheat Sheets > Yocto Project > | 228 | <emphasis role="bold">Help > Cheat Sheets > Yocto Project > |
@@ -674,7 +672,7 @@ root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</p | |||
674 | role="bold">Browse</emphasis> button and select a location on | 672 | role="bold">Browse</emphasis> button and select a location on |
675 | the remote target. You need an active TCF connection to the | 673 | the remote target. You need an active TCF connection to the |
676 | target for the <emphasis role="bold">Browse</emphasis> button to | 674 | target for the <emphasis role="bold">Browse</emphasis> button to |
677 | work (see chapter <emphasis role="bold">Setting up a TCF | 675 | work (see Chapter <emphasis role="bold">Setting up a TCF |
678 | Connection from Eclipse</emphasis>). Note that you need to | 676 | Connection from Eclipse</emphasis>). Note that you need to |
679 | specify the path including the filename.</para> | 677 | specify the path including the filename.</para> |
680 | </listitem> | 678 | </listitem> |
diff --git a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml index a68f7da..a6a0ed6 100644 --- a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml +++ b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml | |||
@@ -702,31 +702,31 @@ $ devtool runqemu kvm enea-image-standard nographic slirp </programlisting> | |||
702 | image in a consistent way, e.g. to install, upgrade, or delete packages | 702 | image in a consistent way, e.g. to install, upgrade, or delete packages |
703 | considering the dependencies. The package management systems supported by | 703 | considering the dependencies. The package management systems supported by |
704 | Enea Linux are described in this section. More information about PMS can | 704 | Enea Linux are described in this section. More information about PMS can |
705 | be found in the Yocto 2.5 document <ulink | 705 | be found in the Yocto 2.7 document <ulink |
706 | url="http://www.yoctoproject.org/docs/2.5/mega-manual/mega-manual.html">Yocto | 706 | url="http://www.yoctoproject.org/docs/2.7/mega-manual/mega-manual.html">Yocto |
707 | Project Mega Manual</ulink>. If needed replace the Yocto version in the | 707 | Project Mega Manual</ulink>. If needed replace the Yocto version in the |
708 | link.</para> | 708 | link.</para> |
709 | 709 | ||
710 | <section id="apt_pktmgmt"> | 710 | <section id="rpm_pktmgmt"> |
711 | <title>APT Package Management (DEB Packages)</title> | 711 | <title>RPM Package Management (RPM Packages)</title> |
712 | 712 | ||
713 | <para>Enea Linux provides DEB packages on <ulink | 713 | <!-- <para>Enea Linux provides RPM packages on <ulink |
714 | url="http://linux.enea.com/EneaLinux8.0/">linux.enea.com</ulink> site, | 714 | url="http://linux.enea.com/EneaLinux8.0/">linux.enea.com</ulink> site, |
715 | in directory | 715 | in directory |
716 | <literal><literal><release>/<target>/deb</literal>/</literal>.</para> | 716 | <literal><literal><release>/<target>/rpm</literal>/</literal>.</para> |
717 | --> | ||
718 | <para>The application for performing runtime package management of RPM | ||
719 | packages on the target is called <filename>rpm</filename>.</para> | ||
717 | 720 | ||
718 | <para>The application for performing runtime package management of DEB | 721 | <para>Use the <literal>rpm</literal> command to install, upgrade, or |
719 | packages on the target is called <filename>apt-get</filename>.</para> | 722 | remove packages. Before using any rpm options that require network |
720 | |||
721 | <para>Use the <literal>apt-get</literal> command to install, upgrade, or | ||
722 | remove packages. Before using any apt-get options that require network | ||
723 | access, please check that the network is configured and working | 723 | access, please check that the network is configured and working |
724 | properly.</para> | 724 | properly.</para> |
725 | 725 | ||
726 | <para>The <literal>apt-get</literal> command is by default included in | 726 | <para>The <literal>rpm</literal> command is by default included in |
727 | Enea Linux images.</para> | 727 | Enea Linux images.</para> |
728 | 728 | ||
729 | <section id="apt_config"> | 729 | <!--<section id="apt_config"> |
730 | <title>Configuring</title> | 730 | <title>Configuring</title> |
731 | 731 | ||
732 | <para>APT relies on the concept of repositories in order to find | 732 | <para>APT relies on the concept of repositories in order to find |
@@ -742,73 +742,85 @@ $ devtool runqemu kvm enea-image-standard nographic slirp </programlisting> | |||
742 | # echo "deb [trusted=yes] http://server-address/path/to/the/package/directory ./" | \ | 742 | # echo "deb [trusted=yes] http://server-address/path/to/the/package/directory ./" | \ |
743 | tee -a /etc/apt/sources.list.d/repos.list</programlisting> | 743 | tee -a /etc/apt/sources.list.d/repos.list</programlisting> |
744 | 744 | ||
745 | <para>Run <literal>apt-get update</literal> to fetch information from | 745 | <para>Run <literal>createrepo --><!--update path_to_repo</literal> to fetch information from |
746 | the new repository:</para> | 746 | the new repository:</para> |
747 | 747 | ||
748 | <programlisting># apt-get update</programlisting> | 748 | <programlisting># createrepo --><!--update repo</programlisting> |
749 | </section>--> | ||
750 | |||
751 | <section id="rpm_preparation"> | ||
752 | <title>Preparation</title> | ||
753 | |||
754 | <para>RPM packages need to first be downloaded on target. | ||
755 | <programlisting># wget https://rpmfind.net/linux/fedora/linux/development/rawhide/Everything/ | ||
756 | aarch64/os/Packages/v/vim-common-8.1.2120-1.fc32.aarch64.rpm</programlisting> | ||
757 | They can be copied either from public maintained repositories or from locally maintained collections of useful RPMs. | ||
758 | <programlisting># wget http://linux.enea.com/RPM/aarch64/vim-common-7.4.481-r0.0.aarch64.rpm</programlisting> | ||
759 | </para> | ||
760 | |||
761 | <para> | ||
762 | RPM is also identifying and checking for package dependencies. It warns if the package can not be installed correctly and lists what needs to be done. | ||
763 | </para> | ||
764 | |||
749 | </section> | 765 | </section> |
750 | 766 | ||
751 | <section id="apt_install"> | 767 | <section id="rpm_install"> |
752 | <title>Installing</title> | 768 | <title>Installing</title> |
753 | 769 | ||
754 | <para>DEB packages typically have file names like | 770 | <para>RPM packages typically have file names like |
755 | foo-1.0.1-r0.0_arm64.deb The file name includes the package name | 771 | foo-1.0.1-r0.0_arm64.rpm The file name includes the package name |
756 | (foo), version (1.0.1), revison (r0.0), and architecture (arm64). To | 772 | (foo), version (1.0.1), revison (r0.0), and architecture (arm64). To |
757 | install a package, log in as root and type the following command at a | 773 | install a package, log in as root and type the following command at a |
758 | shell prompt:</para> | 774 | shell prompt:</para> |
759 | 775 | ||
760 | <programlisting># apt-get install foo</programlisting> | 776 | <programlisting># rpm -i vim-common-8.1.1017-r0.0.aarch64.rpm |
777 | user.notice [RPM][351]: Transaction ID 5d836e00 started | ||
778 | user.notice [RPM][351]: install vim-common-8.1.1017-r0.0.aarch64: success | ||
779 | user.notice [RPM][351]: install vim-common-8.1.1017-r0.0.aarch64: success | ||
780 | user.notice [RPM][351]: Transaction ID 5d836e00 finished: 0</programlisting> | ||
761 | 781 | ||
762 | <para>The <literal>apt-get install</literal> command will install one | ||
763 | or more packages in the system.</para> | ||
764 | </section> | 782 | </section> |
765 | 783 | ||
766 | <section id="apt_upgrade"> | 784 | <section id="rpm_upgrade"> |
767 | <title>Upgrading</title> | 785 | <title>Upgrading</title> |
768 | 786 | ||
769 | <para>The <literal>apt-get upgrade</literal> command will upgrade one | 787 | <para>The <literal>rpm -U</literal> command will upgrade one |
770 | or more packages which are currently installed in the system. If no | 788 | or more packages which are currently installed in the system. |
771 | packages are given, all installed packages will be checked.</para> | 789 | </para> |
772 | 790 | ||
773 | <programlisting># apt-get upgrade foo</programlisting> | 791 | <programlisting># rpm -U vim-common-8.1.1518-r0.0.aarch64.rpm |
792 | user.notice [RPM][346]: Transaction ID 5d836d54 started | ||
793 | user.notice [RPM][346]: erase vim-common-8.1.1017-r0.0.aarch64: success | ||
794 | user.notice [RPM][346]: install vim-common-8.1.1518-r0.0.aarch64: success | ||
795 | user.notice [RPM][346]: erase vim-common-8.1.1017-r0.0.aarch64: success | ||
796 | user.notice [RPM][346]: install vim-common-8.1.1518-r0.0.aarch64: success | ||
797 | user.notice [RPM][346]: Transaction ID 5d836d54 finished: 0</programlisting> | ||
774 | </section> | 798 | </section> |
775 | 799 | ||
776 | <section id="apt_rm"> | 800 | <section id="rpm_rm"> |
777 | <title>Removing</title> | 801 | <title>Removing</title> |
778 | 802 | ||
779 | <para>The <literal>apt-get remove</literal> command will remove one or | 803 | <para>The <literal>rpm -e</literal> command will remove the |
780 | more packages which are currently installed in the system. | 804 | package which is currently installed in the system. |
781 | Example:</para> | 805 | Example:</para> |
782 | 806 | ||
783 | <programlisting># apt-get remove ptest-runner | 807 | <programlisting># rpm -e vim-common |
784 | Reading package lists... Done | 808 | user.notice [RPM][350]: Transaction ID 5d836dc9 started |
785 | Building dependency tree | 809 | user.notice [RPM][350]: erase vim-common-8.1.1518-r0.0.aarch64: success |
786 | Reading state information... Done | 810 | user.notice [RPM][350]: erase vim-common-8.1.1518-r0.0.aarch64: success |
787 | The following packages were automatically installed and are no longer required: | 811 | user.notice [RPM][350]: Transaction ID 5d836dc9 finished: 0 |
788 | libc6-dbg libc6-dev libc6-extra-nss libc6-thread-db libcidn1 | ||
789 | linux-libc-headers-dev | ||
790 | Use 'apt autoremove' to remove them. | ||
791 | The following packages will be REMOVED: | ||
792 | ptest-runner | ||
793 | 0 upgraded, 0 newly installed, 1 to remove and 0 not upgraded. | ||
794 | After this operation, 0 B of additional disk space will be used. | ||
795 | Do you want to continue? [Y/n] y | ||
796 | (Reading database ... 5766 files and directories currently installed.) | ||
797 | Removing ptest-runner (2.0.2+git0+6d2872116c-r0.0) ... | ||
798 | </programlisting> | 812 | </programlisting> |
799 | </section> | 813 | </section> |
800 | 814 | ||
801 | <section id="pm_searching"> | 815 | <section id="rpm_searching"> |
802 | <title>Searching</title> | 816 | <title>Searching</title> |
803 | 817 | ||
804 | <para>The <literal>apt-cache search</literal> allows searching for the | 818 | <para>The <literal>rpm -q</literal> allows searching for the |
805 | given expressions in the name, summary and description of known | 819 | given expressions in the name, summary and description of known |
806 | packages. Example:</para> | 820 | packages. Example:</para> |
807 | 821 | ||
808 | <programlisting># apt-cache search ptest-runner | 822 | <programlisting># rpm -q vim-common |
809 | ptest-runner - A C program to run all installed ptests | 823 | vim-common-8.1.1017-r0.0.aarch64</programlisting> |
810 | ptest-runner-dbg - A C program to run all installed ptests - Debugging files | ||
811 | ptest-runner-dev - A C program to run all installed ptests - Development files</programlisting> | ||
812 | </section> | 824 | </section> |
813 | </section> | 825 | </section> |
814 | </section> | 826 | </section> |