Changeset f71cbd0 in rtems-libbsd

Timestamp:

Jul 6, 2016, 2:06:54 PM (5 years ago)

Author:

Christian Mauderer <Christian.Mauderer@…>

Branches:

b96abfd647154f10ea8f7fac68e25676636eded5, debc0aed8b9bef9996b8ec0ae7a70b0b41912e27, 68e79b6d187fe09b0a6f3f1d22c69b4121a3f76e, freebsd-9.3, 33bfaee89aa71d2252eb48d6b9a9ec17183faced

Children:

f1941b2

Parents:

df222eb

git-author:

Christian Mauderer <Christian.Mauderer@…> (07/06/16 14:06:54)

git-committer:

Christian Mauderer <Christian.Mauderer@…> (08/02/16 08:58:02)

Message:

libbsd.txt: Add guide for user space tools.

File:

• libbsd.txt (modified) (1 diff)

libbsd.txt

@@ -760 +760 @@
 measure on how much of a file differs from the original FreeBSD source. The
 lower the value the more transparent the source file it.
+
+== Porting of user space utilities
+
+The theory behind the described method is to put all BSS and initialized data
+objects into a named section. This section then will be saved before the code is
+executed and restored after it has finished. This method limits to a single
+threaded execution of the application but minimizes the necessary changes to the
+original FreeBSD code.
+
+. Import and commit the unchanged source files like described above.
+. Add the files to the libbsd.py and build them.
+. Use nm on the generated object files to find out which objects are initialized
+  (either in BSS -- type b or B -- or in the initialized data segment -- type d
+  or D). An example call could look like follows:
+  `arm-rtems4.12-nm build/arm-rtems4.12-xilinx_zynq_a9_qemu/freebsd/contrib/pf/pfctl/pfctl.c.10.o | grep ' [DdbB] '`
+. Check the sources for everything that can be made const. This type of patches
+  should go back to the upstream FreeBSD sources.
+. Check the sources for every global variable that can be made static. This type
+  of patches should go back to the upstream FreeBSD sources.
+. Move static variables out of functions. This patches should also go upstream.
+. Create one `xxx-data.h` file per c module. This header should contain
+  declarations for the remaining initialized objects matching the original
+  declarations but adding a section attribute. The section name has to match the
+  name of the RTEMS_LINKER_RWSET defined further below. For an example look at
+  `freebsd/contrib/pf/pfctl/pfctl-data.h`.
+. Include the header files at the end of the corresponding c files.
+. Add a rtems_bsd_command_xxx wrapper function to the c file containing the main
+  function. For an example look at `rtems_bsd_command_pfctl(...)` in
+  `freebsd/contrib/pf/pfctl/pfctl.c`.
+. Create one compilable commit.
 
 == Initialization of the BSD Library