net: Add a function to dump TCP's hash table
[akaros.git] / Documentation / glibc.txt
index ea5d901..c4ffee1 100644 (file)
@@ -83,6 +83,15 @@ Putting it in the -ros/sys/ folder did it (though ultimately I didn't want the
 change).  The point is, sysdeps doesn't mirror and override the main tree for
 all files - it is behind some others in the search/include path.
 
+Another situation requiring a change outside of the sysdeps directory was
+sunrpc/netname.c.  I wanted to change the functions (stub out the ones that
+used NSS).  Adding the sysdep worked, but it turns out that *both* the sysdep
+netname.c and the original sunrpc/netname.c were being compiled.  The root
+cause seems to be compat-netname.os.  There are make rules in sunrpc to
+generate some compatibility routines.  Grep for rpc-compat-routines.os.  The
+rule seems to ignore sysdeps and just use the normal C file - in this case
+netname.c.
+
 Subdirs
 --------------------------
 As a note, these 'subdirectories' are the "primary folders" (i.e. addons),
@@ -184,6 +193,14 @@ Tips, Questions, and Misc Notes
   shared vs static, and it can get complicated with start.c, tls.c, etc.
 - What things in one file rely heavily on another file?  Are there non-obvious
   gotchas?  (yes, and no one documented them).
+- Is the build failing without any clear error messages?  Scroll up a lot, and
+  there may be messages farther up (like a hundred+ lines up).  I've had some
+  gcc stage2 builds that fail with no obvious issue in the short term console
+  output, but the real error is much higher.  Some aspect of the build system
+  will continue on failures and only fail much later, after building other
+  packages.
+- Note that libstdc++ is a subpart of gcc, built during stage2, and has its
+  own configure script and settings.
 
 Ghetto Things (Feel free to fix them):
 --------------------------