incubator-nuttx/libs/libxx
YAMAMOTO Takashi 1ffa009c8b Revert "Don't generate .depend anymore"
This reverts commit 79af7fbf4e.

Because:

* btashton reported some issues in local builds:

  https://github.com/apache/incubator-nuttx/pull/603#issuecomment-602264860

* this might be related to the current CI breakage:

  > /bin/sh: 1: /__w/incubator-nuttx/incubator-nuttx/nuttx/tools/mkdeps: not found
2020-03-22 23:07:29 -05:00
..
.gitignore Revert "Don't generate .depend anymore" 2020-03-22 23:07:29 -05:00
Kconfig arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
Makefile Revert "Don't generate .depend anymore" 2020-03-22 23:07:29 -05:00
README.txt This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00
libxx.hxx This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00
libxx__gnu_unwind_find_exidx.cxx ELF64 support (#220) 2020-02-07 17:10:23 -06:00
libxx__gnu_unwind_find_exidx.hxx Kconfig files, binfmt/libelf, libs/libc/machin, libs/libxx: Correct libcxx exception handling by introducing the generic config(CXX_EXCEPTION and CXX_LIBSUPCXX) 2019-01-26 11:23:31 -06:00
libxx_cxa_atexit.cxx This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00
libxx_cxa_guard.cxx This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00
libxx_cxapurevirtual.cxx Remove exra whitespace from files (#189) 2020-01-31 09:24:49 -06:00
libxx_delete.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_delete_sized.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_deletea.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_deletea_sized.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_eabi_atexit.cxx This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00
libxx_new.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_newa.cxx arch: Customize the typedef of size_t instead of intptr_t 2020-02-18 07:15:19 -06:00
libxx_stdthrow.cxx This commit moves all of the libraries under a common directory called libs/. This most certainly break libcxx and uClibc++ for now. 2018-05-29 13:21:26 -06:00

README.txt

libs/libxx/README.txt
^^^^^^^^^^^^^^^^^^^^^

This directory contains a fragmentary C++ library that will allow to build
only the simplest of C++ applications.  In the deeply embedded world, that
is probably all that is necessary.  If you have a need for more extensive
C++ support, the following libraries are recommended:

 - libstdc++  (part of GCC)
 - STLport    http://www.stlport.org/
 - uClibc++   http://cxx.uclibc.org/
 - uSTL       http://ustl.sourceforge.net/

There is a version of uClibc++ that has been customized for use with NuttX.
That version that can be found in the NuttX uClibc++ GIT repository.  Refer
to the top-level uClibc++ README.txt file for installation instructions.

At present, only the following are supported here:

 - void *operator new(std::size_t nbytes);
 - void operator delete(void* ptr);
 - void operator delete[](void *ptr);
 - void __cxa_pure_virtual(void);
 - int __aeabi_atexit(void* object, void (*destroyer)(void*), void *dso_handle);
 - int __cxa_atexit(__cxa_exitfunc_t func, FAR void *arg, FAR void *dso_handle);

operator new
------------

  This operator should take a type of size_t.  But size_t has an unknown underlying
  type.  In the nuttx sys/types.h header file, size_t is typed as uint32_t
  (which is determined by architecture-specific logic).  But the C++
  compiler may believe that size_t is of a different type resulting in
  compilation errors in the operator.  Using the underlying integer type
  instead of size_t seems to resolve the compilation issues. Need to
  REVISIT this.

  Once some C++ compilers, this will cause an error:

    Problem:     "'operator new' takes size_t ('...') as first parameter"
    Workaround:  Add -fpermissive to the compilation flags