libc/inet: set path to resolver file via CPP

[uclinux-h8/uClibc.git] / docs / PORTING

diff --git a/docs/PORTING b/docs/PORTING
index 5c1a398..cadb323 100644 (file)
--- a/docs/PORTING
+++ b/docs/PORTING
@@ -10,8 +10,8 @@ you are hacking on.
 - add ARCH to the 'Target Architecture' list in extra/Configs/Config.in
 - Initially you will want to disable shared libraries, since making
    the shared library loader work requires you first have basic architecture
-   support working.  Thus you should add HAVE_NO_SHARED and ARCH_HAS_NO_LDSO
-   to Config.ARCH's TARGET_ARCH
+   support working.  Thus you should add ARCH_HAS_NO_SHARED and
+   ARCH_HAS_NO_LDSO to Config.ARCH's TARGET_ARCH
 
 ====================
 === libc sysdeps ===
@@ -27,7 +27,7 @@ you are hacking on.
   the funcion __uClibc_main() which takes these parameters:
    __uClibc_main(main(), argc, argv, _init(), _fini())
   Initially if you wish to make things easier on yourself, you can disable the
-  UCLIBC_CTOR_DTOR option and just set those two arguments to NULL
+  UCLIBC_CTOR_DTOR option and just set the init/fini arguments to NULL.
   glibc generally stores this function in libc/sysdeps/ARCH/elf/start.S
 
 - create these additional files in ARCH/bits/
@@ -65,6 +65,11 @@ TODO: nptl / linuxthreads / linuxthreads.old
 ====================
 === ldso sysdeps ===
 ====================
+- elf.h - presumably you've already taught binutils all about the random ELF
+  relocations your arch needs, so now you need to make sure the defines exist
+  for uClibc.  make sure the EM_### define exists and all of the R_###_###
+  reloc defines.
+
 - enable ldso/shared options in your extra/Configs/Config.ARCH file
 - you will need to create the following files in ldso/ldso/ARCH/
   dl-debug.h  dl-startup.h  dl-syscalls.h  dl-sysdep.h  elfinterp.c  resolve.S
@@ -115,3 +120,19 @@ TODO: nptl / linuxthreads / linuxthreads.old
   - clean up after call
   - jump to function address now stored in PLT
   glibc stores this function in libc/sysdeps/ARCH/dl-trampoline.S
+
+- utils/ldd.c - if you want support for ldso cache files (spoiler: you do),
+  then you'll need to teach ldd a little.  generally, the fallback code
+  should be smart and "just work", but you should be explicit.  just pop
+  it open and add an appropriate ifdef for your arch and set MATCH_MACHINE()
+  and ELFCLASSM.  there are plenty examples and you're (hopefully) smart.
+
+====================
+===  Misc Cruft  ===
+====================
+- utils/readelf.c - not really needed generally speaking, but might as well
+  add your arch to the giant EM_* list (describe_elf_hdr)
+
+- MAINTAINERS - presumably you're going to submit this code back to mainline
+  and since you're the only one who cares about this arch (right now), you
+  should add yourself to the toplevel MAINTAINERS file.  do it.