home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Distributions / ucb / 2.11BSD / README < prev    next >
Text File  |  1992-08-29  |  19KB  |  487 lines
  1.     This release incorporates all fixes and changes made since the
  2.     release of 2.10.1BSD in January 1989 as well as several missing
  3.     pieces of 4.3BSD (the namei cache, tmscp driver, long filenames,
  4.     etc.)
  5.  
  6. Bug reports, technical questions:
  7.  
  8.     Report bugs using the standard sendbug format (see bugfiler(1))
  9.     WITH AN INDEX LINE OF "2.11BSD".
  10.     General questions can be directed to Steven Schultz at 
  11.     sms@wlv.iipo.gtegsc.com.  At this time, contact by phone is not 
  12.     available due to a high degree of travel.  If you're really desperate, 
  13.     print out a hardcopy example of the problem, and carefully mark your 
  14.     place with a picture of your favorite president, preferably a large 
  15.     denomination.  Send it to me.
  16.  
  17.     Bug fixes will be posted to comp.bugs.2bsd.
  18.     Archives may be requested from Steven Schultz by electronic mail.  
  19.  
  20.     For an explanation of how unsupported this release is, read the 
  21.     the remainder of this and the "changes" document, and keep
  22.     in mind that this activity is not what pays the mortgage each month.
  23.  
  24. Credit where it's due:
  25.  
  26.     Paul Taylor of SUNY Oswego for volunteering to put 2.11BSD on
  27.     his 11/73's back when it was known as 2.10.2SMS and fighting the 
  28.     beta test problems, proofreading and critiqueing the documentation.  
  29.     Terry Kennedy of St. Peter's College for final testing on a 11/70 and 
  30.     for putting together an 11/73 for me.  Bob Karlicek of AT&T for 
  31.     loaning me his 11/73 (on the basis of an Internet developed 
  32.     acquaintance) to develop the TMSCP driver and related standalone 
  33.     support.
  34.     
  35. Steven Schultz  sms@wlv.iipo.gtegsc.com
  36. Paul Taylor     taylor@oswego.oswego.edu
  37. Terry Kennedy   terry@spcvxa.spc.edu
  38. Bob Karlicek    rfkjr@mhuxo.att.com
  39.  
  40. In general:
  41.     - The system hasn't been fit onto a non-separate I&D or machine
  42.       without a floating point processor in a long time.  Lots of overlay
  43.       schemes need to be worked out; the floating point simulator in
  44.       the kernel hasn't been tested; sendmail won't run on a non-separate
  45.       machine, so bin/mail and ucb/Mail have to auto-configure not to
  46.       use sendmail; csh is overlaid now even on a separate I&D machine,
  47.       /lib/cpp is pushing the limit to handle all the #define'ing that
  48.       is required to compile the kernel...
  49.  
  50.       It is not anticipated the split I&D restriction will ever be lifted.
  51.       The historical trend is for systems and programs to increase in
  52.       size, not decrease.
  53.  
  54. Kernel:
  55.     - Profiling hasn't been looked at in years.  It won't work as it is
  56.       because the supervisor mode has been allocated to the networking code.
  57.  
  58.     - The networking is very stable.  The DEQNA, DEUNA, DELUA, Interlan,
  59.       3Com, PRONET, ACC LH/DH-11 drivers are known to work;  others will
  60.       require some work.  Diffs are provided in /sys/OTHERS for the
  61.       VAX Excelan EXOS 204 driver.   The XNS code is ported, but has
  62.       to my knowledge never been compiled or tested.  The residual PUP
  63.       support has been removed (as it was in 4.3BSD).  SL/IP works but
  64.       can hang and not restart when you run out of CLISTs.  It would
  65.       probably be a good idea to increase CLISTs to the maximum when
  66.       running SL/IP.  
  67.  
  68.       The DEQNA driver is a fresh port from 4.3BSD and is more stable
  69.       and much less susceptible to hanging than the old version.
  70.  
  71.       Don't even THINK of using TRAILERS on *ANY* of the machines in your 
  72.       LAN.  In many cases the trailer code has been ifdef'd/commented out 
  73.       from 2.11BSD drivers, in other cases the trailer code has simply 
  74.       been ripped out.  In any case, the current drivers drop trailer
  75.       packets and increment the input packet error count.
  76.  
  77.     - The rtp call is wrong, any superuser call to turn off rtp will
  78.       turn it off, even if it's not the process itself requesting to
  79.       have its special status revoked.  The whole 'rtp' call should
  80.       probably go away.  As far as i know it has never been tested with
  81.       the present kernel and probably doesn't work.
  82.  
  83.     - There should be some way to monitor which overlays you're
  84.       switching between to aid in determining the best overlay scheme
  85.       for your kernel.
  86.  
  87.     - 2.10.X has not been made to run on the PRO series machines.  See
  88.       sys/OTHERS/PRO for more details and some helpful diffs.  The
  89.       OTHERS directory is quite useful, as it contains many other
  90.       versions of various drivers and such things.
  91.  
  92.     - The directory /sys/vaxif contains the source for the VAX networking 
  93.       drivers.  This is an excellent reference for adding new drivers and 
  94.       fixing current ones.
  95.  
  96. Applications:
  97.     In some of the major source subdirectories you'll see, variously,
  98.     subdirectories named OLD and PORT.  The OLD directories contain
  99.     old 2.9BSD versions of software which were kept around for
  100.     porting purposes.  The PORT directories contain 4.3BSD code that
  101.     we didn't have time to port, but felt should be ported eventually.
  102.  
  103.     Due to the amount of software ported from 4.3BSD (and the Internet)
  104.     the number of PORT directories has been cut down in order to fit
  105.     the distribution on two 1600bpi tapes.  Many of the sources not included
  106.     are available from INTERNET archive sites, others will have to be
  107.     acquired from a friendly 4.3BSD site.
  108.  
  109.     There are only four OLD directories present in the system:  
  110.     /usr/include/OLD, /usr/src/include/OLD (two .h files for support of 
  111.     'ps'), /sys/pdpstand/OLD (unused standalone programs) and
  112.     /usr/src/new/OLD where the 2.9BSD remnants are kept.
  113.  
  114.     - User level gprof profiling has not been implemented.  It should
  115.       be doable, just hasn't been time to do it.  Regular profiling
  116.       seems to be working fine however.
  117.  
  118.     - Lint hasn't been ported yet; the old version is in an unknown
  119.       state.  (it doesn't work)
  120.  
  121.     - Ucb/sysline compiles but doesn't run.  not a big loss really
  122.       unless you have a 25 line terminal.
  123.  
  124.     - Ucb/systat hasn't been ported.  but should be pretty easy EXCEPT
  125.       for the '-vmstat' display, much of the information there is simply
  126.       not applicable.
  127.  
  128.     - The acucntrl program in the usr.bin/uucp directory doesn't work.
  129.       It sets flags properly in the kernel, but the tty drivers don't
  130.       pay any attention to them.  See /sys/OTHERS/acucntrl for a fix
  131.       and comments.  The temptation was to simply adopt the 4.3BSD
  132.       soft-carrier mechanism and modify autoconfig to pass flags to
  133.       the driver.  For now the old method has been left in place.
  134.  
  135.     - The PDP-11 lisp hasn't been converted over to the new system
  136.       calling protocol; it's a fairly straightforward, mechanical
  137.       process, though.  You can find it in /usr/src/new/OLD/lisp11.tar.Z
  138.  
  139.     - Most of the applications under /usr/src/new have been tested
  140.       and work properly.  However, a large number of the 4.3BSD new
  141.       directory remains to be ported ...
  142.  
  143.     - Only some of the games have been tested.  Most compile, but ...
  144.  
  145.  
  146. Man pages:
  147.  
  148.   The 4.3BSD-tahoe manual page system remains inplace from 2.10.1BSD.  
  149.   Manual page source is generally contained under /usr/src/man.  Only 
  150.   preformatted manual pages are stored under /usr/man.  The script 
  151.   /usr/man/manroff is used to help format manual pages.  Man(1) has been 
  152.   modified accordingly.  I'm not happy with this setup, it broke a
  153.   symmetry i liked, but ...
  154.  
  155.   Because the 14 character limit on file name lengths has been lifted
  156.   there are no manual page files whose names required truncation.
  157.  
  158. The man program will automatically truncate any names over MAXNAMLEN-2, but
  159. since MAXNAMLEN is now 63 this should never be a problem unless manual
  160. page filename lengths take on the attribute of a novella.
  161.  
  162. The following manual pages are NOT in 2.10BSD but ARE in 4.3BSD:
  163.  
  164.     dbx.1          gprof.1        symorder.1          vlp.1
  165.     fp.1          liszt.1        systat.1
  166.  
  167.     ad.4          dn.4            kg.4          uda.4
  168.     autoconf.4      drum.4        mt.4          up.4
  169.     crl.4          ex.4            np.4          ut.4
  170.     ct.4          fl.4            pcl.4          uu.4
  171.     ddn.4          hdh.4            ps.4          va.4
  172.     dmf.4          ik.4            vp.4          dmz.4
  173.     ix.4          tu.4
  174.  
  175.     stab.5
  176.  
  177.     config.8      fasthalt.8        restore.8
  178.  
  179.  
  180. The following manual pages are NOT in 4.3BSD but ARE in 2.10BSD:
  181.  
  182.     mkdep.1          nslookup.1
  183.  
  184.     fetchi.2      gldav.2        nostk.2          rtp.2
  185.     fperr.2          lock.2        phys.2          ucall.2
  186.  
  187.     l3tol.3          loadav.3        strcasecmp(3)
  188.     ldfps.3          ltol3.3        strncasecmp(3)
  189. (since block numbers of files are no longer 3 bytes long, the l3tol and ltol3
  190.  routines are historical dregs)
  191.  
  192.     br.4          ram.4            rp.4          xp.4
  193.     dr.4          rk.4            si.4
  194.     dvhp.4          rl.4            sri.4
  195.     ra.4          rm.4            swap.4
  196.  
  197.     dtab.5           stack.5        tzfile.5
  198.  
  199.     bj.6          ttt.6            warp.6          words.6
  200.     moo.6
  201.  
  202.     hostname.7
  203.  
  204.     autoconfig.8      restor.8
  205.  
  206.  
  207. The following manual pages DIFFER between 2.10BSD and 4.3BSD:
  208.  
  209.     adb.1          f77.1            man.1          px.1
  210.     nm.1              pxp.1         as.1          ld.1
  211.     pi.1              pxref.1        cc.1          lisp.1
  212.     pix.1          make.1        ps.1
  213.  
  214.     adjtime.2      ptrace.2        sigpause.2          write.2
  215.     getitimer.2      read.2        sigreturn.2
  216.     getrusage.2      setitimer.2        sigsetmask.2
  217.     profil.2      sigblock.2        sigvec.2
  218. (differences in the sig* man pages consist of substituting 'long' for 'int')
  219.  
  220.     bstring.3      gethostbyname.3   resolver.3          usleep.3
  221.     compat-sys5.3      inet.3        setjmp.3          vlimit.3
  222.     ctime.3          mktemp.3        signal.3          vtimes.3
  223.     execl.3          printf.3        string.3
  224.     rand.3              ualarm.3
  225.  
  226.     acc.4          dz.4            inet.4f          null.4
  227.     arp.4p          ec.4            intro.4          pty.4
  228.     bk.4          en.4            intro.4n          qe.4
  229.     cons.4          hk.4            lo.4          rx.4
  230.     css.4          hp.4            lp.4          tb.4
  231.     de.4          ht.4            mem.4          tm.4
  232.     dh.4          hy.4            mtio.4          ts.4
  233.     dhu.4          il.4            ns.4f          tty.4
  234.     dmc.4          imp.4            nsip.4          vv.4
  235.     tmscp.4
  236.  
  237.     a.out.5          core.5        dump.5          resolver.5
  238.     fs.5
  239.  
  240.     bcd.6          chess.6
  241.  
  242.     mailaddr.7
  243.  
  244.     bad144.8      dump.8        icheck.8          quot.8
  245.     badsect.8      dumpdir.8        mkfs.8          reboot.8
  246.     clri.8          fastboot.8        named.8          rxformat.8
  247.     crash.8          fsck.8        ncheck.8          savecore.8
  248.     dcheck.8      halt.8        newfs.8
  249. =======================================================================
  250. The original README file as distributed with 2.10.1BSD
  251. =======================================================================
  252. Please see the file /ERRATA for distribution errata notices.
  253.  
  254. Bug reports, technical questions:
  255.     Please, if possible, report bugs using the standard sendbug format
  256.     (see bugfiler(1)) WITH AN INDEX LINE OF "2.10BSD" and e-mail it to
  257.     uunet!ucbvax!bugs or bugs@ucbvax.berkeley.edu.  General questions
  258.     can be directed to Keith Bostic at one of the e-mail addresses below;
  259.     if that's not possible, he may be contacted at 415-642-4948.  If
  260.     you're really desperate, print out a hardcopy example of the problem,
  261.     and carefully mark your place with a picture of your favorite
  262.     president, preferably in a large denomination.  Send it to us.  All
  263.     bug fixes will be posted to comp.bugs.2bsd; archives may be requested
  264.     from Keith Bostic by electronic mail.  For a detailed explanation
  265.     of how unsupported this release is, read the kernel changes document.
  266.  
  267. Credit where it's due:
  268.     Cyrus Rahman, of Duke University, is responsible for much of the
  269.     work done on various applications for 2.10.1, as well as for making
  270.     us do select(2) and adjtime(2) correctly.  Steven Schultz, of
  271.     Contel Federal Systems, did the original port of the supervisor
  272.     space networking, as well as much of the debugging.
  273.  
  274. Keith Bostic    {uunet!bostic, bostic@ucbvax.berkeley.edu}
  275. Casey Leedom    {uunet!ucbvax!vangogh!casey, casey@vangogh.berkeley.edu}
  276. Cyrus Rahman    {dukempd!cr@mcnc.org}
  277. Steven Schultz    {sms@etn-wlv.eaton.com}
  278.  
  279.  
  280. In general:
  281.     - The system hasn't been fit onto a non-separate I&D or machine
  282.       without a floating point processor in a long time.  Lots of overlay
  283.       schemes need to be worked out; the floating point simulator in
  284.       the kernel hasn't been tested; sendmail won't run on a non-separate
  285.       machine, so bin/mail and ucb/Mail have to auto-configure not to
  286.       use sendmail; -DNONSEP needs to be passed up and down the make
  287.       files (or better yet, the new environment inheritance feature of
  288.       make should be used to pull out the environment variable MACHDEFS
  289.       and SEPFLAG);
  290.       ...
  291.  
  292.       The reason this hasn't been done now is, as always, lack of
  293.       time.
  294.  
  295. Kernel:
  296.     - Profiling hasn't been looked at in well over a year.  It
  297.       probably doesn't work.
  298.  
  299.     - The networking is stable.  The DEQNA, DEUNA, DELUA, Interlan
  300.       and 3Com drivers are known to work; the PRONET and others will
  301.       require some work.  Diffs are provided in /sys/OTHERS for the
  302.       VAX Excelan EXOS 204 driver. TCP/IP is in place and working;
  303.       XNS has been ported, but will contain more bugs than the mainstream
  304.       networking.  PUP hasn't even been looked at.  SLIP works, but
  305.       can hang and not restart when you run out of CLISTs.  DON'T EVEN
  306.       THINK OF USING TRAILERS on *ANY* of the machines in your LAN.
  307.  
  308.     - The rtp call is wrong, any superuser call to turn off rtp will
  309.       turn it off, even if it's not the process itself requesting to
  310.       have its special status revoked.  Probably need 3 defines:
  311.  
  312.         #define RTP_ON        1    /* turn it on */
  313.         #define RTP_OFF        2    /* turn it off if I set it */
  314.         #define RTP_FORCE_OFF    3    /* turn off everyone's */
  315.  
  316.       If rtp(2) gets RPT_FORCE_OFF, it should find the process and
  317.       turn off the stuff, if necessary; question is if rtpp is the
  318.       flag that everyone checks for the existence of a run-time
  319.       process.
  320.  
  321.     - There should be some way to monitor which overlays you're
  322.       switching between to aid in determining the best overlay scheme
  323.       for your kernel.  Alternatively, and more correctly, gprof
  324.       should be implemented for the kernel.
  325.  
  326.     - The device number is not currently included in the buffer
  327.       hashing function, and probably should be.
  328.  
  329.     - 2.10 has not been made to run on the PRO series machines.  See
  330.       sys/OTHERS/PRO for more details and some helpful diffs.  The
  331.       OTHERS directory is quite useful, as it contains many other
  332.       versions of various drivers and such things.
  333.  
  334.     - A new directory has been added, /sys/vaxif, which contains the
  335.       source for the VAX networking drivers.  This is an excellent
  336.       reference for adding new drivers and fixing current ones.
  337.  
  338. Applications:
  339.     In each of the major source subdirectories you'll see, variously,
  340.     subdirectories named OLD and PORT.  The OLD directories contain
  341.     old 2.9BSD versions of software which were kept around for
  342.     porting purposes.  The PORT directories contain 4.3BSD code that
  343.     we didn't have time to port, but felt should be ported eventually.
  344.  
  345.     - User level gprof profiling has not been implemented.  It should
  346.       be doable, we just haven't had time to do it.  Regular profiling
  347.       seems to be working fine however.
  348.  
  349.     - Lint hasn't been ported yet; the old version is in an unknown
  350.       state.
  351.  
  352.     - Ucb/sysline compiles but doesn't run.
  353.  
  354.     - Ucb/systat hasn't been ported, but should be pretty easy.
  355.  
  356.     - The acucntrl program in the usr.bin/uucp directory doesn't work.
  357.       It sets flags properly in the kernel, but the tty drivers don't
  358.       pay any attention to them.  See /sys/OTHERS/acucntrl for a fix
  359.       and our comments on it.
  360.  
  361.     - The PDP-11 lisp hasn't been converted over to the new system
  362.       calling protocol; it's a fairly straightforward, mechanical
  363.       process, though.  You can find it in new/PORT/lisp11.
  364.  
  365.     - Most of the applications under /usr/src/new have been tested
  366.       and work properly.  However, a large number of the 4.3BSD new
  367.       directory remains to be ported ...
  368.  
  369.     - Only some of the games have been tested.  Most compile, but ...
  370.  
  371.  
  372. Man pages:
  373.  
  374.   The new 4.3BSD-tahoe manual page system has been set up.  Manual page
  375. source is generally contained under /usr/src/man.  Only preformatted
  376. manual pages are stored under /usr/man.  The script /usr/man/manroff is
  377. used to help format manual pages.  Man(1) has been modified accordingly
  378. ...
  379.  
  380.   Because of the 14 character limit on file name lengths, the names of the
  381. following manual pages have been changed:
  382.  
  383.     Old name        New name
  384.     --------        --------
  385.     getdtablesize(2)    getdtabsize(2)
  386.  
  387.     getdiskbyname(3)    getdiskbynam(3)
  388.     gethostbyaddr(3)    gethostbyadd(3)
  389.     gethostbyname(3)    gethostbynam(3)
  390.     getprotobyname(3)    getprotobyna(3)
  391.     getprotobynumber(3)    getprotobynu(3)
  392.     getservbyname(3)    getservbynam(3)
  393.     getservbyport(3)    getservbypor(3)
  394.     inet_makeaddr(3)    inet_makeadd(3)
  395.  
  396.     miscellaneous(7)    miscellaneou(7)
  397.  
  398. The man program will automatically truncate any names over MAXNAMLEN-2
  399. (leaving room for the ".x" extension), so this should be transparent (at
  400. least until we run into names which aren't unique within the first 12
  401. characters ...
  402.  
  403. The following manual pages are NOT in 2.10BSD but ARE in 4.3BSD:
  404.  
  405.     dbx.1          gprof.1        symorder.1          vlp.1
  406.     fp.1          liszt.1        systat.1
  407.  
  408.     ad.4          dn.4            kg.4          uda.4
  409.     autoconf.4      drum.4        mt.4          up.4
  410.     crl.4          ex.4            np.4          ut.4
  411.     ct.4          fl.4            pcl.4          uu.4
  412.     ddn.4          hdh.4            ps.4          va.4
  413.     dmf.4          ik.4            tmscp.4          vp.4
  414.     dmz.4          ix.4            tu.4
  415.  
  416.     stab.5
  417.  
  418.     config.8      fasthalt.8        mklost+found.8    restore.8
  419.  
  420.  
  421. The following manual pages are NOT in 4.3BSD but ARE in 2.10BSD:
  422.  
  423.     mkdep.1          nslookup.1
  424.  
  425.     fetchi.2      gldav.2        nostk.2          rtp.2
  426.     fperr.2          lock.2        phys.2          ucall.2
  427.  
  428.     l3tol.3          loadav.3        strcasecmp(3)
  429.     ldfps.3          ltol3.3        strncasecmp(3)
  430.  
  431.     br.4          ram.4            rp.4          xp.4
  432.     dr.4          rk.4            si.4
  433.     dvhp.4          rl.4            sri.4
  434.     ra.4          rm.4            swap.4
  435.  
  436.     dtab.5           stack.5        tzfile.5
  437.  
  438.     bj.6          ttt.6            warp.6          words.6
  439.     moo.6
  440.  
  441.     hostname.7
  442.  
  443.     autoconfig.8      mklost.8        restor.8
  444.  
  445.  
  446. The following manual pages DIFFER between 2.10BSD and 4.3BSD:
  447.  
  448.     adb.1          f77.1            man.1          px.1
  449.     ar.1          file.1        nm.1          pxp.1
  450.     as.1          ld.1            pi.1          pxref.1
  451.     cc.1          lisp.1        pix.1          ranlib.1
  452.     date.1          make.1        ps.1          w.1
  453.  
  454.     adjtime.2      ptrace.2        sigpause.2          write.2
  455.     getitimer.2      read.2        sigreturn.2
  456.     getrusage.2      setitimer.2        sigsetmask.2
  457.     profil.2      sigblock.2        sigvec.2
  458.  
  459.     bstring.3      gethostbyname.3   resolver.3          usleep.3
  460.     compat-sys5.3      inet.3        setjmp.3          vlimit.3
  461.     ctime.3          mktemp.3        signal.3          vtimes.3
  462.     execl.3          printf.3        string.3
  463.     getenv.3      rand.3        ualarm.3
  464.  
  465.     acc.4          dz.4            inet.4f          null.4
  466.     arp.4p          ec.4            intro.4          pty.4
  467.     bk.4          en.4            intro.4n          qe.4
  468.     cons.4          hk.4            lo.4          rx.4
  469.     css.4          hp.4            lp.4          tb.4
  470.     de.4          ht.4            mem.4          tm.4
  471.     dh.4          hy.4            mtio.4          ts.4
  472.     dhu.4          il.4            ns.4f          tty.4
  473.     dmc.4          imp.4            nsip.4          vv.4
  474.  
  475.     a.out.5          core.5        dump.5          resolver.5
  476.     ar.5          dir.5            fs.5
  477.  
  478.     bcd.6          chess.6
  479.  
  480.     mailaddr.7
  481.  
  482.     bad144.8      dump.8        icheck.8          quot.8
  483.     badsect.8      dumpdir.8        mkfs.8          reboot.8
  484.     clri.8          fastboot.8        named.8          rxformat.8
  485.     crash.8          fsck.8        ncheck.8          savecore.8
  486.     dcheck.8      halt.8        newfs.8
  487.