[aadk-commits] qwell: trunk r115 - /trunk/README

[aadk-commits at lists.digium.com]

Author: qwell
Date: Tue Jan  2 10:56:59 2007
New Revision: 115

URL: http://svn.digium.com/view/aadk?view=rev&rev=115
Log:
Add known limitations from README that was on CD.

Clarify reasoning behind disabling embedded modules, and explain
that you only have to disable them if you've previously enabled them.

Modified:
    trunk/README

Modified: trunk/README
URL: http://svn.digium.com/view/aadk/trunk/README?view=diff&rev=115&r1=114&r2=115
==============================================================================
--- trunk/README (original)
+++ trunk/README Tue Jan  2 10:56:59 2007
@@ -42,13 +42,9 @@
 about missing files such as autoconf.h, Makefile, or potentially others.
 
 Step 4: Building Asterisk
-Run the "build-asterisk" script from within the scripts directory.  When the
-"Asterisk Module Selection" screen appears, be sure to deselect/disable (see
-note below) all module types under 'Module Embedding', and press 'x' to save.
+Run the "build-asterisk" script from within the scripts directory.
 If you are making incremental changes, you may run the "rebuild-asterisk"
 and/or "rebuild-asterisk-gui" scripts instead to save a bit of time.
-Please note: Initially we required module embedding to be *enabled*.  We can
-now use shared modules, and doing so greatly improves RAM usage/efficiency.
 
 Step 5: Building disk image (pass 2)
 Run the "build-image" script.  This will create the distribution image.
@@ -56,3 +52,36 @@
 Step 6: Preparing /tftpboot/ directory.
 Run the "build-tftp" script.  This will place the distribution and u-boot
 image in /tftpboot/ where it is suitable for download into the appliance.
+
+
+
+Known Limitations
+=================
+
+1) The uClinux distribution build process requires that 'gawk' be
+present on the host computer. If your Linux distribution provides GNU
+awk but does not provide a symlink or copy of the awk binary named
+'gawk', please create a symlink in some suitable location in the
+search path.
+
+2) Your host system will require the 'texinfo' package to be
+installed, because various parts of the uClinux distribution use the
+'makeinfo' tool to produce man pages and other documentation files.
+
+3) Your host system will require the 'genromfs' package to be
+installed, in order to build a romfs uImage.  This is the new default
+filesystem that we use, and we recommend that others use it as well.
+
+4) The MultiMediaCard slot on the S800i is currently non-functional;
+placing an card into this slot will cause any installed S110M or S400M
+(FXS) modules to be non-operational.
+
+5) Previously when running the build-asterisk script, we recommended that
+users enable Module Embedding for all asterisk modules in menuselect.
+This has changed - we no longer recommend doing this, for RAM efficiency.
+If you have previously enabled Module Embedding, we recommend that you
+disable it for most/all modules.  If the size of the asterisk binary grows
+beyond a byte boundary (512k, 1mb, 2mb, etc) (plus any overhead), it
+will require a larger chunk of contiguous memory to load.  This can
+potentially lead to an issue where the memory gets fragmented enough that
+it simply cannot be run anymore.