[rtems-docs commit] user: Add a migration chapter
Chris Johns
chrisj at rtems.org
Thu Mar 12 21:23:38 UTC 2020
Module: rtems-docs
Branch: master
Commit: 4726207d91e0dd32e63c9f74377de29937737ff5
Changeset: http://git.rtems.org/rtems-docs/commit/?id=4726207d91e0dd32e63c9f74377de29937737ff5
Author: Chris Johns <chrisj at rtems.org>
Date: Thu Mar 12 18:04:25 2020 +1100
user: Add a migration chapter
This is a start with the hope we collect useful pieces to aid porting.
Please add to this.
Closes #3895
---
user/index.rst | 2 +
user/migration/index.rst | 17 ++++++++
user/migration/v4_11-to-v5.rst | 96 ++++++++++++++++++++++++++++++++++++++++++
3 files changed, 115 insertions(+)
diff --git a/user/index.rst b/user/index.rst
index 98a01cf..7b584c5 100644
--- a/user/index.rst
+++ b/user/index.rst
@@ -42,6 +42,8 @@ RTEMS User Manual (|version|).
testing/index
tracing/index
+ migration/index
+
tools/index
rsb/index
diff --git a/user/migration/index.rst b/user/migration/index.rst
new file mode 100644
index 0000000..76012b5
--- /dev/null
+++ b/user/migration/index.rst
@@ -0,0 +1,17 @@
+.. SPDX-License-Identifier: CC-BY-SA-4.0
+
+.. Copyright (C) 2020 Chris Johns
+
+.. index:: Migration
+
+.. _Migration:
+
+Changing Versions
+*****************
+
+Follow the sections provide support help when migratiing applications
+from one version of RTEMS to a new version.
+
+.. toctree::
+
+ v4_11-to-v5
diff --git a/user/migration/v4_11-to-v5.rst b/user/migration/v4_11-to-v5.rst
new file mode 100644
index 0000000..4329771
--- /dev/null
+++ b/user/migration/v4_11-to-v5.rst
@@ -0,0 +1,96 @@
+.. SPDX-License-Identifier: CC-BY-SA-4.0
+
+.. Copyright (C) 2020 Chris Johns
+
+.. _Migration_4_11_to_5:
+
+RTEMS 4.11 to RTEMS 5
+=====================
+
+This section provides helpful information when migrating from RTEMS 4.11 to
+RTEMS 5.
+
+Configuration
+-------------
+
+A number of configurations macros have moved as a result of internal changes in
+RTEMS. Some of these will produce a warning indicating the new configuration
+setings you need to define. If you need to run an application on RTEMS 4.11 and
+RTEMS 5 the following code exmaple shows how to conditionally define the
+settings. The example is:
+
+.. code-block:: c
+
+ #include <rtems.h>
+
+ #if __RTEMS_MAJOR__ < 5
+ #define CONFIGURE_MAXIMUM_FIFOS 10
+ #define CONFIGURE_MAXIMUM_PIPES 10
+ #else
+ #define CONFIGURE_IMFS_ENABLE_MKFIFO
+ #endif
+
+ #define MAX_FILE_DESCRIPTORS 200
+ #if __RTEMS_MAJOR__ < 5
+ #define CONFIGURE_LIBIO_MAXIMUM_FILE_DESCRIPTORS MAX_FILE_DESCRIPTORS
+ #else
+ #define CONFIGURE_MAXIMUM_FILE_DESCRIPTORS MAX_FILE_DESCRIPTORS
+ #endif
+
+Networking
+----------
+
+The following code samples provides a simple way to initialise and start
+networking with the BSD Library's (``libbsd``) networking stack. The simplest
+method to configure the networking stack is to provide a :file:`/etc/rc,conf`
+file on your target. If your target has no non-volatile media for a file system
+create the :file:`rc.conf` file each time your application starts.
+
+The :file:`rc.conf` support in ``libbsd`` provides a number of needed support
+settings. We recommend you search for FreeBSD and ``rc.conf`` to view the
+available online documentation that FreeBSD provides.
+
+In this example the network interface is ``cgem0``, replace with your
+interface name.
+
+.. code-block:: c
+
+ static const char* rc_conf =
+ "# /etc/rc.conf\n" \
+ "hostname=\"rtems5-libbsd\"\n" \
+ "ifconfig_cgem0=\"inet 10.1.2.3 netmask 255.255.255.0 rxcsum txcsum\"\n" \
+ "ifconfig_cgem0_alias0=\"ether 00:80:81:82:83:84\"\n" \
+ "defaultrouter=\"10.1.2.1\"\n" \
+ "telnetd_enable=\"YES\"\n";
+
+ void start_network(void)
+ {
+ FILE *rc;
+ int r;
+
+ /*
+ * Initialise libbsd.
+ */
+ rtems_bsd_initialize();
+
+ /*
+ * Create the /etc/rc,conf, assume /etc exists.
+ */
+ rc = fopen("/etc/rc.conf", "w");
+ if (rc_conf == NULL) {
+ printf("error: cannot create /etc/rc.conf\n");
+ exit(1);
+ }
+
+ fprintf(rc, rc_conf);
+ fclose(rc);
+
+ /*
+ * Arguments are timeout and trace
+ */
+ r = rtems_bsd_run_etc_rc_conf(30, false);
+ if (r < 0) {
+ printf("error: loading /etc/rc.conf failed: %s\n",strerror(errno));
+ exit(1);
+ }
+ }
More information about the vc
mailing list