home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / file / NeXT-ls.README < prev    next >
Encoding:
Text File  |  1989-11-13  |  2.5 KB  |  60 lines
  1. A shlib-free ls for anonymous FTP
  2. ---------------------------------
  3.  
  4. Effective with NeXT Release 1.0, most executables are linked with
  5. shared libraries.  This is in general a good thing, as it makes
  6. executables much smaller, reduces physical memory requirements,
  7. and facilitates code sharing.  Unfortunately, this "breaks"
  8. anonymous FTP, since ftpd depends on an external ls image to
  9. implement the LIST and NLST commands.  Anonymous ftp runs
  10. chrooted to ~ftp for security reasons, but this makes /usr/shlib
  11. unavailable.  One approach is to duplicate /usr/shlib/libsys_s_B.shlib
  12. under ~ftp.  This consumes approximately half a megabyte of disk
  13. space, and isn't really "shareable" as intended.  Since NeXT does
  14. not provide a self-sufficient ls, I've provided my own based on
  15. the redistributable ls 5.32 sources distributed by uunet.uu.net
  16. and gatekeeper.dec.com.
  17.  
  18. This was harder than it "should" be:
  19.  
  20. 1) I had to fix inexcusable bugs in Berkeley's code.  This is the
  21. "Nth" one of their programs I've seen that hands bad pointers to
  22. free().  I'm convinced that free() is a no-op on Berkeley's
  23. development systems ... after all, it's all "virtual" memory,
  24. "we" don't "really" have to "free" anything.  Bozos.
  25.  
  26. 2) The code that implements the -f option is hopelessly broken.
  27. At one point a function that takes no arguments (dodir) is called
  28. with a string.  As written, ls requires an argument with -f
  29. (which /bin/ls does not), which it then ignores (which it isn't
  30. supposed to).  Since this is not really needed for anonymous FTP,
  31. I have NOT fixed this.  This does preclude this version from
  32. being a full ls replacement, since it has some niceties, like
  33. better error messages.
  34.  
  35. 3) The code assumed that printf() returns the number of
  36. characters actually output.  This is not the case for NeXT 1.0
  37. (or for "true" 4.3).  It is, however, true for SunOS, HP/UX,
  38. A/UX, ...  The fix makes some horrible assumptions.
  39.  
  40. 4) stat() counts blocks in 512-byte increments, but ls thinks in
  41. terms of 1K blocks.  I put in a lot of /2s that I don't feel
  42. particularly good about, instead of doing something intelligent
  43. like calling statfs() to find out what's really going on.
  44.  
  45. 5) There were some functional differences between the versions,
  46. I've attempted to make things look as much as possible like the
  47. old one.
  48.  
  49. 6) The "new" BSD is going to look a lot more like System V.
  50.    You'll see what I mean...
  51.  
  52. >>> ALL changes are under #if[n]def NeXT conditionals except in
  53. the Makefile.
  54.  
  55.  
  56. Eric P. Scott
  57. San Francisco State University
  58. <eps@sutro.sfsu.edu>
  59. 11/13/1989
  60.