home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / c / comp-faq.zip / COMP-FAQ next >
Text File  |  1993-01-27  |  63KB  |  1,638 lines
  1.  
  2.  
  3.  
  4.         FREQUENTLY ASKED QUESTIONS ABOUT COMPILING KHOROS
  5.  
  6.         date last updated: Sept 25, 1992
  7.                        Sept 28, 1992
  8.                       fixed A3, A6, A9, Q28, added Q29
  9.                    Oct  03, 1992
  10.                       added new Q1, Q2, Q4, Q5, Q6, 
  11.                       scooted other #'s down
  12.                    Oct  27, 1992
  13.                       added Q35 - Q37
  14.  
  15.                 ( Please Read!  Please Redistribute! )
  16.  
  17.                 ( Also - Please See the General Khoros FAQ )
  18.  
  19.         Contents:  Questions 1 - 37
  20.  
  21.                    * installing Khoros on IBM RS6000, 386/486, HP
  22.            * compiling Khoros with shared libraries
  23.            * compiling Khoros with X11R5
  24.            * Makefiles, Imakefiles (compiling new programs)
  25.            * compiling with/without FORTRAN
  26.            * compiling with gcc
  27.            * and more!
  28.  
  29.  
  30. ----------  Installing Khoros on various architectures -----
  31.  
  32. Q1.  What machines does Khoros currently run on?
  33.  
  34. Q2.  I have machine X running operating system Y (not listed in A1).
  35.      Has anyone ported Khoros to this architecture?
  36.  
  37. Q3.  I want to install Khoros on an IBM RS/6000 workstation
  38.      running under AIX x.x {and am getting error messages from the
  39.      C compiler} {and would like more info} {has anybody done this}
  40.      {are binaries available}?.
  41.  
  42. Q4.  I want to install Khoros on a 386/486 machine {and am getting 
  43.      error messages from the C compiler} {and would like more info} 
  44.      {has anybody done this} {are binaries available}?.
  45.  
  46. Q5.  I want to install Khoros on an HP under HP-UX x.x {9000/s370, 
  47.      s400, s800, or s700}.  {and am getting error messages from the 
  48.      C compiler} {and would like more info} {has anybody done this} 
  49.      {are binaries available}?.
  50.  
  51. Q6.  I want to install Khoros on a Convex,  under ConvexOS x.x
  52.      {and am getting error messages from the C compiler} {and 
  53.      would like more info} {has anybody done this} {are binaries available}?.
  54.  
  55. Q7.  Can I run Khoros on my PC? Is Khoros available for PC's running DOS?
  56.  
  57. Q8.  Is there a port of Khoros for a VMS system?
  58.  
  59.  
  60. -----------  Compiling with shared libraries -----
  61.  
  62. Q9.  What are shared libraries?  Does Khoros work with shared libraries?  
  63.      What are the advantages/disadvantages of using shared libraries?
  64.      Should I compile Khoros with shared libraries?
  65.  
  66. Q10. Why do I get unresolved references when I compile Khoros with
  67.      shared libraries on a SUN4?
  68.  
  69. Q11. When compiling shared, I get a large set of errors from
  70.      the loader listed in my make.World file, as in:
  71.  
  72.         rm -f vadd
  73.         cc -o vadd vadd.o  -L/home/holst/khoros/lib -L/mnt/elocal/lang/SC1.0
  74.         -O -Bdynamic -lghost  -lvexpr  -lnum_anal  -ldspl  -lformat
  75.         -lgeo_surf  -lvipl  -lvutils  -lvmath  -lvrast  -lvgparm  -lverror
  76.         -ltiff  -lm -ll -ldl
  77.         ld: Undefined symbol
  78.            _cg_
  79.            _zgedi_
  80.            _zgeco_
  81.            _zgesl_
  82.            _zsvdc_
  83.            _ch_
  84.            _dgesl_
  85.            _dgefa_
  86.            _e_wsfe
  87.            _pow_ii
  88.            _s_wsFe
  89.            _s_stop
  90.         *** Error code 2
  91.         install in ./vipl/arith_binary/vadd done
  92.         make: Warning: Target `install' not remade because of errors
  93.  
  94. Q12. I am compiling [some xvroutine] against X11R5 with shared libraries.
  95.      The linker produces this error message:
  96.  
  97.      ld: /lib/libXaw.sa.5.0(sharedlib.o): _formWidgetClass: multiply defined
  98.          /lib/libXaw.sa.5.0(sharedlib.o): _labelWidgetClass: multiply defined
  99.      *** Error code 2
  100.      make: Fatal error: Command failed for target `{xvroutine}'
  101.  
  102. Q13. I am having problems using cantata (or other xvroutine)
  103.      after recently compiling on a SUN with shared libraries.  I get the
  104.      error message:
  105.  
  106.      Warning: Widget class VendorShell version mismatch (recompilation needed):
  107.        widget 11004 vs. intrinsics 11003.
  108.      Warning: Widget class Form version mismatch (recompilation needed):
  109.        widget 11004 vs. intrinsics 11003.
  110.  
  111.  
  112. Q14. Warpimage {or other xvroutine} did not compile after on a SUN4
  113.      architecture with static libraries;  in fact, it made the cc compiler
  114.      segmentation fault and core dump!  What happened?
  115.  
  116.  
  117. Q15. Khoros compiled ok under shared libraries.  However, when I try to
  118.      use the programs, I get messages that say:
  119.      lib{something}.so.1 not found
  120.  
  121. ------------  Compiling with X11R5 -----
  122.  
  123. Q16. Can I compile Khoros with X11R5?
  124.  
  125. Q17. I am compiling Khoros with MIT's X11R5.  When linking xvroutines
  126.      (cantata, editimage, etc), the compiler tells me that
  127.      _viewportWidgetClass is multiply defined.  What's the problem?
  128.  
  129.  
  130. ------------  Makefiles, Imakefiles (compiling new programs) -----
  131.  
  132. Q18. I don't want to compile Khoros source, but I want to compile
  133.      my own programs so I need the libraries. How can I obtain the
  134.      Khoros libraries?
  135.  
  136. Q19. I am trying to compile an xvroutine, and when I run make install
  137.      I get the error:
  138.      installing in ./{xvroutine}...
  139.      Make:  Don't know how to make {KHOROS_HOME}/lib/libdisplay.a.
  140.      Stop.
  141.      *** Error code 1
  142.  
  143. Q20. I want to link a {vroutine/xvroutine} for dbx.
  144.  
  145. Q21. I want my {vroutine/xvroutine} to use some specific 
  146.      include files and special libraries.
  147.  
  148. Q22. Is there a way to get ghostwriter to automatically generate 
  149.      the Makefile so that it will look for other include directories 
  150.      and libraries?
  151.  
  152. ------------  Compiling With gcc -----
  153.  
  154. Q23. I'm having a problem with gcc:
  155.  
  156.      % gcc test.c -I/usr/local/include -I$KHOROS_HOME/include
  157.  
  158.      In file included from KHOROS_HOME/include/vinclude.h:128,
  159.      from test.c:3:
  160.      KHOROS_HOME/include/vdefines.h:219: conflicting types for `malloc'
  161.      /usr/local/{...}/include/malloc.h:41: previous declaration of `malloc'
  162.      KHOROS_HOME/include/vdefines.h:223: conflicting types for `calloc'
  163.      /usr/local/{...}/include/malloc.h:39: previous declaration of `calloc
  164.  
  165. Q24. I noticed in the make.World file is that a few files are compiled 
  166.      using 'cc', while some others are compilied using 'gcc'. Is this normal? 
  167.      Also, there were messages like: 
  168.      gcc: file path prefix `dynamic' never used
  169.  
  170.  
  171. ------------  Compiling With/Without FORTRAN -----
  172.  
  173. Q25. Do I HAVE to have FORTRAN to compile Khoros?  Which Khoros programs
  174.      will I miss out on if I don't compile with FORTRAN?
  175.  
  176. Q26. How do I compile the Khoros system without FORTRAN?
  177.  
  178. Q27. I don't have a FORTRAN compiler, but I need the Khoros programs that
  179.      use FORTRAN.  What can I do?
  180.  
  181. Q28. I am writing a {vroutine/xvroutine} in which I need to make a call
  182.      from my C code to a FORTRAN subroutine.  How do I do this?
  183.  
  184. Q29. I am setting up my *.cf configuration file in preparation for compiling
  185.      Khoros.  How do I find out what libraries the linker expects in order
  186.      to link C code against FORTRAN, in order to provide the proper
  187.      libraries for the ForSysLibs option?
  188.  
  189. ------------  Miscellaneous -----
  190.  
  191. Q30. I seem to be having some trouble getting Khoros working on our Sun 3.
  192.      I have tried executing {cantata, editimage, etc}  {journal playbacks},
  193.      but I keep getting the error "ld.so: libXaw.so.4: not found".
  194.  
  195. Q31. Since RPC isn't implemented yet, I defined UseSunRPC as NO in my 
  196.      sun.cf file. Compiling phantomd results in the following message:
  197.           ld: Undefined
  198.           _sunrpc_tempnam
  199.           _sunrpc_gethostname
  200.  
  201. Q32. On Sun3, OS 4.1.1, a segmentation fault results when cantata is run.
  202.  
  203. Q33. During the compile of Khoros, I get this error message:
  204.          /: write failed, file system is full
  205.          compiler(iropt) error:  write_irfile: No space left on device
  206.  
  207. Q34. I am trying to compile a {toolbox, new program, etc}, but "make"
  208.      keeps giving me error messages that say:
  209.  
  210.      make: Fatal error:
  211.      Don't know how to make target `{KHOROS_HOME}/lib/lib{something}.a
  212.  
  213. Q35. Where in the Khoros Manual is the documentation relating to installation
  214.      of programs in Khoros?
  215.  
  216. Q36. How does one selectively fix a program and recompile it without doing
  217.      the whole installation process again?
  218.  
  219. Q37. When I try to compile dzresp, dfilter, mat2viff, etc., I get 
  220.      unresolved symbols for _dspl_parse, _format_parse, and _vexpr_parse.
  221.      Where do I find these routines?
  222.  
  223. ===============================================================================
  224.  
  225. ===========   Installing Khoros on Various Architectures ======================
  226.  
  227.    Q1.  What machines does Khoros currently run on?
  228.  
  229.    A1.  Khoros 1.0 compiles on the following machines (MIT X unless
  230.         otherwise noted):
  231.  
  232.         ApolloDN10000      OS 10.3, Fortran 10.8, cc 6.8
  233.         CRAY YMP's, XMP's, Cray II's running UNICOS 6.0, and 6.1.
  234.         DEC   5000/3100    Ultrix 4.2, mips cc 2.0, DEC f77 V3.0-2
  235.         DEC   Vax 3600     Ultrix 4.1, cc1.37.1
  236.         HP    9000/*       HP-UX 7.05, HP-UX 8.05
  237.         IBM   RS/6000      AIX v3.1
  238.         OMRON Luna88k      Mach 2.5, gcc 1.37, f77 1.8.5
  239.         NeXT  68030,40     MACH 2.0, gcc 1.37, Absoft f77 2.0, Pensoft X
  240.         SGI   All          OS 3.3.2, OS 4.0, X11 1.2, f77 3.3
  241.         SUN   SPARCstations, SUN4   SUN OS 4.1.1, f77 1.4.5
  242.         SUN   SUN3/        SUN OS 4.1.1, f77 1.3.1, gcc 1.39/2.0
  243.  
  244.         As of Patch 5, increased support was added for:
  245.  
  246.         Convex C220, running ConvexOS 9.1 with standard C compiler
  247.         MacII running A/UX 2.0.1 using gcc-1.39 as C compiler.
  248.         DG Aviion running DG/UX 4.3 (thanks to Bob Clark)
  249.         Intel 386/486 running Interactive Unix  (thanks to Maurizio Davini)
  250.         Luna 88K running Mach 2.0  (thanks to Ping-Kang Hsiung & Hideo Noro)
  251.  
  252.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  253.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  254.  
  255.    Q2.  I have machine X running operating system Y (not listed in A1).
  256.         Has anyone ported Khoros to this architecture?
  257.  
  258.    A2.  Currently, Khoros is being / has been ported by various people
  259.         in the Khoros user community to a variety of architectures,
  260.         including the Alliant VFX/2800, Apollo 425T, Convex C220,
  261.         DG Aviion, Fujitsu VP2200/10, IBM RS6000, Integraph
  262.         Interpro, MacII, Sony 3710, and some 386/486 machines.
  263.  
  264.         At this time, these platforms are not directly supported by the
  265.         Khoros group.  For more details, you may mail to
  266.         danielle@bullwinkle.eece.unm.edu; she is compiling a list of Khoros
  267.         ports, and can give you the information that she has so far.
  268.  
  269.         If YOU have done a port of Khoros to machine X running operating
  270.         system Y, she would very much appreciate a letter from you,
  271.         specifying:
  272.  
  273.            1) your name and place of employment (phone number optional)
  274.            2) your return email address
  275.            3) which version of Khoros you ported,
  276.            4) which machine /operating system you ported to
  277.            5) comments you might like to make.
  278.  
  279.         If you *do not* want to be contacted by other Khoros users, simply
  280.         say so and your name / email address will not be released.
  281.  
  282.  
  283.  
  284.  
  285.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  286.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  287.  
  288.  
  289.    Q3.  I want to install KHOROS on an IBM RS/6000 workstation
  290.     running under AIX x.x {and am getting error messages from the 
  291.         C compiler} {and would like more info} {has anybody done this}
  292.     {are binaries available}?.
  293.  
  294.    A3.  The Khoros group at UNM cannot help you directly with compiler errors
  295.         from the RS/6000, as they do not have an RS/6000 to test on.  However, 
  296.         binaries are available from an ftp site in Italy (thanks, Maurizio!) 
  297.         and advice from Nagarajan Ramesh has proven valuable to many:
  298.  
  299.         (1) Maurizio Davini (mau@ipifidpt.difi.unipi.it)
  300.  
  301.             Has ported Khoros 1.0 P5 to the IBM RS6000 running AIX 3.2;
  302.  
  303.             He has an official ftp site in Pisa, Italy, which includes the
  304.             Khoros source & system distribution, plus binaries for the
  305.             IBM RS6000 and Interactive Unix 2.2.1, available via anonymous ftp:
  306.  
  307.             address   = ipifidpt.difi.unipi.it (131.114.8.130)
  308.                  ftp  = anonymous (ftp)
  309.               passwd  = user@machine
  310.             directory = /pub/khoros
  311.             binaries  = /pub/khoros/bin/RS6000
  312.  
  313.         The khoros distribution is available also under our gopher server
  314.         ipifidpt.difi.unipi.it port 70
  315.  
  316.         (2) Nagarajan Ramesh (nagraj@watson.ibm.com)
  317.  
  318.             Has ported Khoros 1.0 P5 to IBM RS/6000 running AIX 3.1.5.
  319.             Has these comments for compiling on the RS6000 with AIX 3.1.5:
  320.  
  321.             "I substituted the bsd compiler for the 'cc' compile command, and
  322.             it works.  To do this you have to modify  your /etc/xlc.cfg file by
  323.             including the following stanza - EXACTLY THE WAY IT IS.
  324.  
  325.             bsdcc:  use             = DEFLT
  326.                     crt             = /lib/crt0.o
  327.                     mcrt            = /lib/mcrt0.o
  328.                     gcrt            = /lib/gcrt0.o
  329.                     libraries       = -lbsd, -lc
  330.                     proflibs        = -L/lib/profiled,-L/usr/lib/profiled
  331.                     options         = -H512,-T512, -qlanglvl=extended, -qnoro,
  332.                                       -D_BSD, -D_NONSTD_TYPES, -D_NO_PROTO,
  333.                                       -D_BSD_INCLUDES, -bnodelcsect,
  334.                                       -U__STR__, -U__MATH__
  335.  
  336.             Then, define a symbollic link from /bin/bsdcc to /bin/xlc.
  337.             You also have to change the 'cc' to 'bsdcc' in the ibm.cf file."
  338.  
  339.  
  340.  
  341.         (3) In addition, the following people have ported Khoros 1.0 P5
  342.             to IBM RS/6000 running AIX 3.2, and have been willing to answer
  343.             questions in the past:
  344.  
  345.             * Roque Donizete De Oliveira (oliveria@caen.engin.umich.edu)
  346.             * Edmond Mesrobian (edmond@cs.ucla.edu)
  347.             * Nick Kisseberth (nkissebe@delphi.beckman.uiuc.edu)
  348.  
  349.  
  350.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  351.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  352.  
  353.     Q4.  I want to install KHOROS on a 386/486 machine {and am getting 
  354.      error messages from the C compiler} {and would like more info} 
  355.      {has anybody done this} {are binaries available}?.
  356.  
  357.     A4.  (1) Scott Wilson (swilson@chama.eece.unm.edu)
  358.  
  359.             Khoros 1.0 P5 to Intel 486 based platform running Interactive
  360.             Unix System V/386 Release 3.2, Version 3.0. All software was
  361.             stock Interactive except  for the use of gcc2.2.2 as a compiler
  362.             and f2c to handle the fortran code.
  363.  
  364.             He is providing the Khoros 1.0 P5 on the main Khoros server.
  365.  
  366.             address   = pprg.eece.unm.edu (129.24.24.10)
  367.                  ftp  = anonymous (ftp)
  368.               passwd  = user@machine
  369.             directory = /pub/khoros
  370.             binaries  = /pub/khoros/bin/bin486
  371.             libraries = /pub/khoros/bin/lib486
  372.  
  373.  
  374.         (2) Maurizio Davini (mau@ipifidpt.difi.unipi.it)
  375.  
  376.             Khoros 1.0 to Interactive unix 386 2.2.1, using gcc 1.40 ,f2c
  377.             and X386 (the public domain version X11r4 of T.Roell).
  378.  
  379.             He is providing the Khoros 1.0 P5 binaries for Interactive
  380.             Unix 2.2.1, plus binaries for IBM RS6000 running AIX 3.2 via
  381.             anonymous ftp:
  382.  
  383.             address   = ipifidpt.difi.unipi.it (131.114.8.130)
  384.                  ftp  = anonymous (ftp)
  385.               passwd  = user@machine
  386.             directory = /pub/khoros
  387.             binaries  = /pub/khoros/bin/ISC-2.2.1
  388.                         /pub/khoros/bin/RS6000
  389.  
  390.             In the directory 386ix, you can also find the X11R4,
  391.             fortran compiler, and math library he used to compile Khoros.
  392.             For more information, please contact Maurizio.
  393.  
  394.  
  395.         (3) Dominic Richens (dominic@shamin.genie.uottawa.ca or
  396.                              richens@panda1.uottawa.ca)
  397.  
  398.             Khoros 1.0 P5 to HP Vectra RS-25C (386 box) running
  399.             SCO System V 3.2.2 ODT 1.1.
  400.  
  401.             He is providing the Khoros 1.0 P5 system with shell scripts
  402.             and patches needed to build Khoros under SCO ODT 1.1
  403.             via anonymous ftp:
  404.  
  405.             address   = popeye.genie.uottawa.ca (137.122.20.3)
  406.                  ftp  = anonymous (ftp)
  407.               passwd  = user@machine
  408.             directory = /pub/khoros
  409.  
  410.  
  411.         (4) Ulrich Breuer (breuer@pool.informatik.rwth-aachen.de)
  412.  
  413.             Used Maurizio Davini's port of Khoros 1.0 P5 as a starting point,
  414.             in order to port Khoros 1.0 P5 to 386ix running ISC Version 2.2 with
  415.             gcc-2.2.2 and no fortran.
  416.  
  417.             His configuration file, as well as a summary of the changes
  418.             necessary for doing the port may be obtained from Danielle Argiro
  419.             (danielle@chama.eece.unm.edu), or directly from him.
  420.  
  421.  
  422.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  423.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  424.  
  425.     Q5.  I want to install Khoros on an HP {9000/s370, s400, s800, or s700}.
  426.      {and am getting error messages from the C compiler} {and would like 
  427.      more info} {has anybody done this} {are binaries available}?.
  428.      
  429.     A5.  (answer thanks to Konstantinos Konstaninides, Hewlett-Packard 
  430.           Laboratories, Palo Alto, CA, kk@hpkronos.hpl.hp.com)
  431.  
  432.      Binaries are not available for the HP, but you should be able to
  433.      compile quite easily provided you have the complete C compiler
  434.      and a Fortran compiler.  To port khoros 1 patch 5 to HP-UX on an 
  435.      HP9000/s370, s400, s800, or s700, the following steps were taken.
  436.      
  437.      1. Get the Xaw and Xmu libraries and include files
  438.         from hpcvaaz.cv.hp.com:~ftp/pub/MitX11R4/libs.s300.Z (or libs.s800.Z
  439.         for the snakes) using anonymous ftp.
  440.      
  441.         As an alternative, you can also get the X11R5 libraries from
  442.         ~ftp/pub/MitX11R5 (same machine). This is probably the preferred
  443.         approach if you want to use X11 shared libraries.
  444.      
  445.         Uncompress and untar them into your favorite directory.
  446.      
  447.         NOTE: Don't mix those binaries with HP binaries in /usr/lib/X11R4
  448.         and the include files with include files in /usr/include/X11R4.
  449.         Unpredictable core dumbs may happen!
  450.         Instead use /usr/local/X11R4 or /usr/lib/X11R5 or whatever else
  451.         you like.
  452.      
  453.         (Ignore this step if you already have somehow the above
  454.         include files and libraries in your system.)
  455.      
  456.      2. Edit src/xvroutines/Lib/xvforms/Imakefile
  457.         Remove:
  458.         #define UnsharedObjs
  459.         UNSHAREDOBJS =\
  460.                 init.o
  461.      
  462.        and include init.o with the other objects.
  463.      
  464.      3. Edit $KHOROS_HOME/repos/config/imake_conf/hp.cf
  465.         and $KHOROS_HOME/repos/config/imake_conf/Lib/hpLib.rules
  466.      
  467.        as shown in the diffs file below
  468.        The changes fix the following problems:
  469.        a) Strip automatically the binaries (-s)
  470.        b) On the s700 solve the "too much defining" error message. (-Wp,..)
  471.        c) Include the appropriate Fortran libraries in the linking
  472.            of C code, since some khoros libraries use FORTRAN routines too.
  473.        d) Eliminate the -Dxxxx in f77 calls (with Shared Libraries).
  474.        e) Point to the correct place for the X11 Libraries
  475.        f) Install libraries with mode 555 (otherwise code with shared 
  476.                 libraries will not run)
  477.      
  478.      4. Depending on when you got your code you may want
  479.          a) get the fixed src/dspl/Lib/ldfilter.c routine
  480.            posted in the network. (4/9/92)
  481.          b) rm khoros/src/dspl/Lib/poly_yacc.c
  482.          (b) solves a linker problem on the s400.
  483.      
  484.      5. Run installit. Everything should compile with no problems.
  485.         After the compilation do
  486.      - ----------------------
  487.      
  488.      1. edit bin/kinstall_csh, and replace "mail -s" with "mailx -s"
  489.      2. You may want to edit bin/prnmanual
  490.         (Even if you don't have troff or groff, but you have a postscript 
  491.             printer, you can still print the man pages. Only set up the printer 
  492.             command and always accept the default answers. It should print the 
  493.             existing xxxxx.ps files)
  494.      
  495.  
  496.     -------------Diffs----------------
  497.  
  498. *** hp.cf.orig    Fri Apr 10 10:44:33 1992
  499. - --- hp.cf    Fri Apr 10 10:44:33 1992
  500. ***************
  501. *** 7,15 ****
  502.    */
  503.   
  504.   
  505. ! #define OSName                 HP-UX 8.05
  506.   #define OSMajorVersion         8
  507. ! #define OSMinorVersion         5
  508.   
  509.   #define SystemV                YES
  510.   
  511. - --- 7,15 ----
  512.    */
  513.   
  514.   
  515. ! #define OSName                 HP-UX 8.07
  516.   #define OSMajorVersion         8
  517. ! #define OSMinorVersion         7
  518.   
  519.   #define SystemV                YES
  520.   
  521. ***************
  522. *** 76,87 ****
  523.   #define InstallCmd $(SCRIPTSRC)/bsdinst.sh
  524.   #define BaseName /bin/basename
  525.   
  526.   #ifdef hp9000s800
  527. ! #   define StandardDefines        -DSYSV
  528.   #   define OptimizedCDebugFlags   +O1
  529.   #else
  530.   #  if OSMajorVersion == 8
  531. ! #      define StandardDefines        -DSYSV
  532.   #  else
  533.   #       define StandardDefines    -Wc,-Nd4000,-Ns4300,-Ne700,-Np300 -DSYSV -D_BSD -Drindex=strrchr -Dindex=strchr
  534.   #  endif
  535. - --- 76,88 ----
  536.   #define InstallCmd $(SCRIPTSRC)/bsdinst.sh
  537.   #define BaseName /bin/basename
  538.   
  539. + #define InstLibFlags -m 0555
  540.   #ifdef hp9000s800
  541. ! #   define StandardDefines        -s -Wp,-H512000 -DSYSV
  542.   #   define OptimizedCDebugFlags   +O1
  543.   #else
  544.   #  if OSMajorVersion == 8
  545. ! #  define StandardDefines         -s -DSYSV
  546.   #  else
  547.   #       define StandardDefines    -Wc,-Nd4000,-Ns4300,-Ne700,-Np300 -DSYSV -D_BSD -Drindex=strrchr -Dindex=strchr
  548.   #  endif
  549. ***************
  550. *** 89,98 ****
  551.   
  552.   #if OSMajorVersion == 8
  553.   #  if defined (hp9000s300) || defined (hp9000s400)
  554. ! #    define SysLibs -lBSD -lmalloc -lm -ll
  555.   #    define ForSysLibs -lFext -lF77 -lI77
  556.   #  else
  557. ! #    define SysLibs -lBSD -lmalloc -lm -ll
  558.   #    define ForSysLibs -lcl -lfsys
  559.   #  endif
  560.   #else
  561. - --- 90,99 ----
  562.   
  563.   #if OSMajorVersion == 8
  564.   #  if defined (hp9000s300) || defined (hp9000s400)
  565. ! #    define SysLibs -lBSD -lmalloc -lm -ll -lIO77
  566.   #    define ForSysLibs -lFext -lF77 -lI77
  567.   #  else
  568. ! #    define SysLibs -lBSD -lmalloc -lm -ll -lcl
  569.   #    define ForSysLibs -lcl -lfsys
  570.   #  endif
  571.   #else
  572. ***************
  573. *** 100,106 ****
  574. - --- 101,114 ----
  575.   #   define ForSysLibs -lFext -lF77 -lI77
  576.   #endif
  577.   
  578. + #define XLibDir  /usr/local/x11r4/lib.s300
  579. + #define XIncludes -I/usr/local/x11r4
  580.   /*
  581. + #define XLibDir  /usr/lib/X11R5
  582. + #define XIncludes -I/usr/include/X11R5
  583. + */
  584. + 
  585. + /*
  586.    * The Shared libaries for HP may not be complete.  We do not
  587.    * have an HP. This Lib/hpLib.rules is a guess at how hp
  588.    * shared libs should be made. Please mail and changes
  589. ***************
  590. *** 108,114 ****
  591.    * update for the next version. 
  592.    */
  593.   
  594. ! #define HasSharedLibraries NO
  595.   
  596.   #if HasSharedLibraries
  597.   #  define SharedLibRev 1.1                /* Use Khoros revision number */
  598. - --- 116,122 ----
  599.    * update for the next version. 
  600.    */
  601.   
  602. ! #define HasSharedLibraries YES
  603.   
  604.   #if HasSharedLibraries
  605.   #  define SharedLibRev 1.1                /* Use Khoros revision number */
  606. *** Lib/hpLib.rules.or    Mon Apr  6 13:38:05 1992
  607. - --- Lib/hpLib.rules    Mon Apr  6 13:38:05 1992
  608. ***************
  609. *** 73,81 ****
  610.                                       @@\
  611.   .f.o:                                    @@\
  612.       $(RM) $@ shared/$@                        @@\
  613. !     $(FC) -c $(SHAREDCODEDEF) $(SHLIBDEF) $(FLIBFLAGS) $*.f        @@\
  614.       $(MV) $*.o shared/$*.o                        @@\
  615. !     $(FC) -c $(SHLIBDEF) $(FLIBFLAGS) $*.f                @@\
  616.                                                                         @@\
  617.   clean::                                @@\
  618.       -@if [ -d shared ]; then echo " $(RM) shared/?*.o"; \        @@\
  619. - --- 73,81 ----
  620.                                       @@\
  621.   .f.o:                                    @@\
  622.       $(RM) $@ shared/$@                        @@\
  623. !     $(FC) -c $(FLIBFLAGS) $*.f                    @@\
  624.       $(MV) $*.o shared/$*.o                        @@\
  625. !     $(FC) -c $(FLIBFLAGS) $*.f                    @@\
  626.                                                                         @@\
  627.   clean::                                @@\
  628.       -@if [ -d shared ]; then echo " $(RM) shared/?*.o"; \        @@\
  629.  
  630.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  631.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  632.  
  633.    Q6.  I want to install Khoros on a Convex,  under ConvexOS x.x
  634.         {and am getting error messages from the C compiler} {and 
  635.         would like more info} {has anybody done this} {are binaries available}?.
  636.  
  637.    A6.  (answer thanks to Tait Cyrus, CONVEX Computer Corp., Colorado 
  638.      Springs, CO, cyrus@convex.com) 
  639.  
  640.     Binaries for the Convex are not available;  however, building
  641.         Khoros 1.0 P5 on the Convex is quite easy.  The following is a 
  642.     convex.cf file which may be used for compiling Khoros under 
  643.     ConvexOS 9.1.
  644.  
  645. /*
  646.  * convex.cf - Provided by W. Tait Cyrus (cyrus@convex.com) April. 22, 1992
  647.  * This is a configuration file for a Convex.
  648.  * Thanks to Minaz Punjani <cziup09@pluto.ulcc.ac.uk> for verifying under
  649.  *      ConvexOS 10.0.
  650.  *
  651.  * Khoros has been successfully compiled using the following:
  652.  *      ConvexOS        9.1 & 10.0
  653.  *      C               4.1, 4.3.1, and 4.3.2
  654.  *      Fortran         6.1 & 7.0 [see note below]
  655.  *      CXWindows       2.1 & 3.0
  656.  *
  657.  * SET VERSION NUMBERS BEFORE MAKING MAKEFILES
  658.  */
  659.  
  660. /*
  661.  * Set the major version number of the Fortran compiler you will be using
  662.  * in the following #define.
  663.  */
  664.  
  665. #define Convex_fc_MajorVersion 7
  666.  
  667. #if Convex_fc_MajorVersion >= 7
  668. #   define Convex_fc_lib        -llfs
  669. #else
  670. #   define Convex_fc_lib
  671. #endif
  672.  
  673. #define OSName                  ConvexOS V9.1
  674. #define OSMajorVersion          9
  675. #define OSMinorVersion          1 
  676. /*
  677.  * Uncommenting for a ConvexOS 10.0 system is not really necessary since 
  678.  * nowhere in Khoros is a check of OSMajorVersion made for 10.  The only check
  679.  * is the one below and it just checks against 8.
  680.  *
  681.  * #define OSName               ConvexOS V10.0
  682.  * #define OSMajorVersion       10
  683.  * #define OSMinorVersion       0 
  684.  */
  685.  
  686. /*
  687.  * does your machine support saber C
  688.  */
  689. #define HasSaberC               NO      /* for machines that have it */
  690.  
  691. /*
  692.  * Do you want to Compile the tiff library and tiff2viff/viff2tiff
  693.  * conversion routines? If set to NO, then the tiff library will
  694.  * not be compiled and thus no programs will link against that
  695.  * library.
  696.  */
  697.  
  698. #define UseTiff YES
  699.  
  700.  
  701. /*
  702.  * are you using gcc? if yes then set HasGcc to YES
  703.  */
  704. #define HasGcc                  NO
  705.  
  706. #define SystemV                 NO
  707. #define HasVoidSignalReturn     YES
  708. #define StandardDefines         -DXAW_BC
  709. #define VersionNumber           2.0
  710. #define HasFortran              YES
  711. #define FortranCmd              /usr/convex/fc
  712. #define HasPutenv               NO
  713. #define HasBsearch              YES
  714. #define HasVFork                YES
  715. #define HasTempnam              NO
  716. #define HasBsdTypes             YES
  717. #define HasRandom               YES
  718. #define HasDirent               NO
  719. #define HasWait3                NO
  720.  
  721. #if OSMajorVerson == 8
  722.  
  723. #   define OptimizedCDebugFlags -O3
  724. #   define InstScriptFlags      -m 0755 -g bin
  725. #   define InstManFlags         -m 0444 -g bin
  726. #   define BootstrapCFlags      -Dconvex -pcc
  727.  
  728. #   define DefaultCCOptions     -O3 -pcc
  729. #   define FortranDebugFlags    -O3
  730.  
  731. #   define ForSysLibs -lF77 -lI77 -lD77 -lmathC2 
  732.  
  733. #else  /* assuming OSMajorVersion > 8 */
  734.  
  735. #   define OptimizedCDebugFlags
  736. #   define InstScriptFlags      -m 0755 
  737. #   define InstManFlags         -m 0444
  738. #   define BootstrapCFlags      -Dconvex
  739. #   define DefaultCCOptions     -O3 -or none -fi
  740. #   define FortranFlags         -O3 -fi -or none
  741. #   define LibraryFCOptions     -O3 -fi -or none
  742. #   define ForSysLibs -lF77 -lI77 -lD77 -lmathC2 Convex_fc_lib
  743.  
  744. #endif
  745.  
  746. #define ReDefFortran NO
  747. #define UNCOMPRESSPATH /usr/local/bin/uncompress
  748. #define UseCCMakeDepend YES
  749. #define LibraryFDebugFlags -pp=fcpp1 -uo -is .
  750.  
  751. /* 
  752.  * the following is a list of data transports available for
  753.  * use within Khoros:
  754.  *      UseFile            - Standard file system transport
  755.  *      UseSockets         - bsd Sockets
  756.  *      UseSharedMem       - shared memory
  757.  *      UseSunVirMem       - sun virtual memory
  758.  *      UsePipes           - Pipes
  759.  *      UseStream          - Named pipes
  760.  *      UseSunRPC          - Sun's remote procedure call
  761.  *      UseKTLI            - sysV transport layer interface
  762.  *      UseApolloRPC       - Apollo's remote procedure call
  763.  *
  764.  * Set the data transports that you want to use to YES and
  765.  * all others to NO. normally, you should not have to
  766.  * modify this list.
  767.  * 
  768.  */
  769.  
  770. #define UseFile         YES
  771. #define UseSockets      NO
  772. #define UseSharedMem    NO
  773. #define UseSunVirMem    NO
  774. #define UsePipes        NO
  775. #define UseStream       NO
  776. #define UseSunRPC       NO
  777. #define UseKTLI         NO
  778. #define UseApolloRPC    NO
  779.  
  780. #define NormalFortranObjectRule()                                       @@\
  781. all::                                                                   @@\
  782.         $(FC) -il $(FSRCS)                                              @@\
  783.                                                                         @@\
  784. .f.o:                                                                   @@\
  785.         $(RM) $@                                                        @@\
  786.         $(FC) -c $(FLIBFLAGS) $*.f                                      @@\
  787.                                                                         @@\
  788. clean::                                                                 @@\
  789.         $(RM) *.fil
  790.  
  791.  
  792.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  793.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  794.  
  795.    Q7.  Can I run Khoros on my PC? Is Khoros available for PC's running DOS?
  796.  
  797.    A7a. The three major requirements for Khoros are: X11R4, a UNIX-type
  798.         operating system, and lots of space (min. 120-150 Meg).  Only if your
  799.         PC has these three prerequisites can you consider doing a port of
  800.         Khoros to your PC.  Successful ports of Khoros have been done for
  801.         the Mac II and various 386/486 machines that meet these requirements.    
  802.     Please see Q4 for more details on ports to the 386/486.
  803.  
  804.    A7b.    No, nor are there plans to make Khoros available for PC's
  805.     running DOS as of yet.  The design changes necessary for
  806.     completing such a task would be so extensive as to make the
  807.     attempt unworkable at this time.
  808.  
  809.  
  810.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  811.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  812.  
  813.    Q8.  Is there a port of Khoros for a VMS system?
  814.  
  815.    A8.  No.  The software depends heavily on system functions that are
  816.         unique to Unix-based operating systems.
  817.  
  818.  
  819.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  820.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  821.  
  822. ================  Compile With Shared Libraries ===============================
  823.  
  824.    Q9.  What are shared libraries?  Does Khoros work with shared libraries?
  825.         What are the advantages/disadvantages of using shared libraries?
  826.     Should I compile Khoros with shared libraries?
  827.  
  828.    A9a. Shared libraries are a mechanism implemented by some operating 
  829.     systems (SUN, HP, DG Aviion, etc)  that allow a significant savings
  830.     of disk space by allowing programs to link against any necessary
  831.     libraries at runtime rather than at compile time.  Since the libraries
  832.     are not compiled into the program's executable, each program that
  833.     is compiled with shared libraries takes up much less space. 
  834.  
  835.    A9b. Yes. You can compile Khoros with/for shared libraries.
  836.         If you are compiling shared, make sure that your machine.cf
  837.         configuration file has the symbol HasSharedLibraries set to YES.
  838.  
  839.    A9c. The advantage, of course, is savings on disk space.  The disadvantage
  840.         is that because libraries must be linked in at runtime, you will
  841.     experience a lag in startup time of programs.  The disk space savings,
  842.     like amount of the extra time at startup, will vary with machine 
  843.     architecture, operating system implementation, and other factors.
  844.  
  845.    A9d. That depends on your position with respect to the tradeoffs.  
  846.     If you are short on disk space, using shared libraries may be the 
  847.     answer to your problems.  If you have plenty of disk space to waste, 
  848.     you may want to go ahead and compile statically so that programs 
  849.     run faster.  
  850.  
  851.     Some excerpts of mail from Khoros users who have reported disk savings 
  852.     due to shared libraries follow (thanks, guys, for the info):
  853.  
  854.     "I've just brought Khoros up with shared libraries under
  855.      DG/UX 5.4 (DG AViiON).  However, the size savings seems quite
  856.      a bit less than I was expecting...Anyway, there is a net disk 
  857.      savings of 22.2MB, some 27MB (from 86MB to 59MB) in bin and about
  858.      4.7MB in lib).        -- Steve"  
  859.  
  860.     "I don't know about the savings, but do know the sizes with SUN
  861.      shared libs.  (patchlevel 5) Bin: 24Mb Lib: 9.2Mb, with 3.7Mb shared 
  862.      libs.  I recall needing approx. 80-90 Mb for bin without shared libs 
  863.      (for patch level 2).   -- Klamer"
  864.  
  865.     "I got 7 MB of libraries and about 20 MB of executables on a 
  866.      SPARCstation running {shared libs}. I would have to expect 63 MB of 
  867.      executables + 21 MB of librares and objects when not using shared 
  868.      code - it saved about 40 - 50 MB...  -- Kritt"
  869.  
  870.     "Here are my numbers for khoros patch 5: bin 9.3 MB, lib 9.1 MB
  871.      The lib contains BOTH shared and archive libs. Thus, making khoros 
  872.      shared gives 9.3 MB bins + 4.5 MB libs = 13.8 MB...  Not long ago I 
  873.      had an unstrip'ed code of patch 4 that took (read my lips) 165 MB!!   
  874.      -- Peder"
  875.  
  876.  
  877.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  878.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  879.  
  880.    Q10. Why do I get unresolved references when I compile Khoros with
  881.         shared libraries on a SUN4?
  882.  
  883.    A10. If you are compiling on a SUN4 under 4.1.1 and have installed
  884.         the loader (ld) program patch, or you are compiling on a SUN4
  885.         under 4.1.2 you must compile Khoros statically. Make sure
  886.         you set HasSharedLibraries to NO in the sun.cf file.
  887.  
  888.         The ld program under 4.1.1 (with the patch) and under 4.1.2
  889.         requires that all references in the libraries be resolved. So,
  890.         this means that every Khoros routine will need to load against
  891.         all the libraries. This is not reasonable for Khoros, and the
  892.         size of the shared executables after loading against all the
  893.         libraries are not significantly smaller than if they were
  894.         loaded statically.
  895.  
  896.  
  897.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  898.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  899.  
  900.    Q11. When compiling shared, I get a large set of errors from
  901.         the loader listed in my make.World file, as in:
  902.  
  903.         rm -f vadd
  904.         cc -o vadd vadd.o  -L/home/holst/khoros/lib -L/mnt/elocal/lang/SC1.0
  905.         -O -Bdynamic -lghost  -lvexpr  -lnum_anal  -ldspl  -lformat
  906.         -lgeo_surf  -lvipl  -lvutils  -lvmath  -lvrast  -lvgparm  -lverror
  907.         -ltiff  -lm -ll -ldl
  908.         ld: Undefined symbol
  909.            _cg_
  910.            _zgedi_
  911.            _zgeco_
  912.            _zgesl_
  913.            _zsvdc_
  914.            _ch_
  915.            _dgesl_
  916.            _dgefa_
  917.            _e_wsfe
  918.            _pow_ii
  919.            _s_wsFe
  920.            _s_stop
  921.         *** Error code 2
  922.         install in ./vipl/arith_binary/vadd done
  923.         make: Warning: Target `install' not remade because of errors
  924.  
  925.    A11. This is the behavior of the loader in Sun OS 4.1.2. It
  926.         insists on resolving everything in linpack, and since that
  927.         version of linpack does not appear to be fully consistent
  928.         (i.e. those routines are reference but not defined), you get
  929.         these error messages.
  930.         To solve the problem, you may:
  931.  
  932.         * use the (pre ld patch) loader of 4.1.1.
  933.  
  934.       suggestion, to use something like:
  935.           lrwxrwxrwx  1 root            8 Jun 10 11:04 /usr/bin/ld -> ld.4.1.1
  936.           -rwxr-xr-x  1 root       156161 Mar  5 15:46 /usr/bin/ld.4.1.1*
  937.           -rwxr-xr-x  1 root       156161 Oct 23  1991 /usr/bin/ld.4.1.2*
  938.       so that you can switch between the two loaders easily.
  939.  
  940.         * add stub routines to linpack (like extern void zgeco_() {} )
  941.  
  942.         * in $KHOROS_HOME/repos/config/imake_conf/sun.cf,
  943.           change:
  944.         #  define DefaultCCOptions -Bdynamic
  945.         #  define LibraryLdOptions -assert pure-text
  946.       to:
  947.         #  define DefaultCCOptions -Bdynamic -Qoption ld -assert -Qoption ld
  948.               nodefinitions
  949.             #  define LibraryLdOptions -assert nodefinitions
  950.  
  951.  
  952.         If you are compiling on a SUN4 under 4.1.1 and have installed
  953.         the loader (ld) program patch, you must either follow the solutions 
  954.     given above, or  compile statically.
  955.  
  956.  
  957.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  958.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  959.  
  960.  
  961.    Q12. I am compiling [some xvroutine] against X11R5 with shared libraries.
  962.         The linker produces this error message:
  963.  
  964.     ld: /lib/libXaw.sa.5.0(sharedlib.o): _formWidgetClass: multiply defined
  965.             /lib/libXaw.sa.5.0(sharedlib.o): _labelWidgetClass: multiply defined
  966.         *** Error code 2
  967.         make: Fatal error: Command failed for target `{xvroutine}'
  968.  
  969.    A12. You will need to change Form.c in 
  970.         $KHOROS_HOME/src/xvroutines/Lib/xvutils.
  971.  
  972.     Try changing line 137 from:
  973.         WidgetClass formWidgetClass = (WidgetClass)&formClassRec;
  974.     to:
  975.         static WidgetClass formWidgetClass = (WidgetClass)&formClassRec;
  976.  
  977.     And, in the file Label.c in $KHOROS_HOME/src/xvroutines/Lib/xvutils,
  978.     Try changing line 140 from:
  979.         WidgetClass labelWidgetClass = (WidgetClass)&labelClassRec;
  980.     to:
  981.         static WidgetClass labelWidgetClass = (WidgetClass)&labelClassRec;
  982.  
  983.     Recompile the xvutils library, and recompile the xvroutine.
  984.  
  985.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  986.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  987.  
  988.    Q13. I am having problems using cantata (or other xvroutine)
  989.         after recently compiling on a SUN with shared libraries.  I get the
  990.         error message:
  991.      Warning: Widget class VendorShell version mismatch (recompilation needed):
  992.        widget 11004 vs. intrinsics 11003.
  993.      Warning: Widget class Form version mismatch (recompilation needed):
  994.        widget 11004 vs. intrinsics 11003.
  995.  
  996.    A13. Your LD_LIBRARY_PATH environment variable that you use to compile
  997.         your object files with is different than your run time environment.
  998.  
  999.         To get a bit of information about what is going on, do:
  1000.         % ldd $KHOROS_HOME/bin/{problem program}
  1001.  
  1002.         If the path printed for Xaw and Xt is different than what is listed
  1003.         when you do:
  1004.         % printenv
  1005.         then this is the problem.  To fix it, unset LD_LIBRARY_PATH or set it
  1006.         to the correct path.
  1007.  
  1008.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1009.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1010.  
  1011.    Q14. Warpimage {or other xvroutine} did not compile after on a SUN4 
  1012.     architecture with static libraries;  in fact, it made the cc compiler 
  1013.     segmentation fault and core dump!  What happened?
  1014.  
  1015.    A14. The problem is that the Makefile that is created for warpimage has
  1016.         a line that is too long for ld to handle.  The solution is to edit
  1017.         the Makefile and delete these three lines:
  1018.  
  1019.         $(FILEFORMATLIB) \
  1020.         $(DSPLLIB) \
  1021.         $(TIFFLIB)
  1022.  
  1023.         and change the line
  1024.         $(VERRORLIB) \
  1025.         to
  1026.         $(VERRORLIB)
  1027.  
  1028.         This causes the cc line to be of a reasonable length, and warpimage
  1029.         {or other xvroutine} will now compile properly.
  1030.  
  1031.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1032.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1033.  
  1034.    Q15. Khoros compiled ok under shared libraries.  However, when I try to
  1035.         use the programs, I get messages that say:
  1036.  
  1037.         lib{something}.so.1 not found
  1038.  
  1039.    A15. The message implies that your LD_LIBRARY_PATH environment variable 
  1040.         that was used to compile the Khoros object files is different than 
  1041.         your run time environment.
  1042.  
  1043.         To get a bit of information about what is going on, do:
  1044.         % ldd $KHOROS_HOME/bin/{problem program}
  1045.  
  1046.         If the path printed for lib{something} is different than what is 
  1047.         listed when you do:
  1048.         % printenv
  1049.         then this is the problem.  To fix it, unset LD_LIBRARY_PATH or set 
  1050.         it to the correct path.
  1051.  
  1052.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1053.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1054.  
  1055. =====================   Compiling with X11R5  ================================
  1056.  
  1057.  
  1058.    Q16. Can I compile Khoros with X11R5?
  1059.  
  1060.    A16. Yes.  See Q12 for the most frequent problems when compiling 
  1061.     Khoros with X11R5.
  1062.  
  1063.  
  1064.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1065.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1066.  
  1067.    Q17. I am compiling Khoros with MIT's X11R5.  When linking xvroutines
  1068.         (cantata, editimage, etc), the compiler tells me that
  1069.         _viewportWidgetClass is multiply defined.  What's the problem?
  1070.  
  1071.    A17. This problem is due to the fact that we have our own bugged fixed
  1072.         versions of the Viewport widget.  We were hoping that R5
  1073.         would have these fixes so that we could delete them, but unfortunately
  1074.         this isn't the case.  Kim Tang provides these fixes to get around the
  1075.         problem:
  1076.  
  1077.         In $KHOROS_HOME/src/xvroutines/cantata/Viewport.c, change line 141 to:
  1078.         static WidgetClass viewportWidgetClass = (WidgetClass)&viewportClassRec;
  1079.  
  1080.  
  1081.    Q17b. ld: /lib/libXaw.sa.5.0(sharedlib.o): _formWidgetClass: multiply defined
  1082.             /lib/libXaw.sa.5.0(sharedlib.o): _labelWidgetClass: multiply defined
  1083.         *** Error code 2
  1084.         make: Fatal error: Command failed for target `{xvroutine}'
  1085.  
  1086.    A17b. see Q13.
  1087.  
  1088.  
  1089.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1090.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~
  1091.  
  1092.  
  1093. ===========  Makefiles, Imakefiles (Compiling New Programs) ===================
  1094.  
  1095.    Q18. I don't want to compile Khoros source, but I want to compile
  1096.         my own programs so I need the libraries. How can I obtain the
  1097.         Khoros libraries?
  1098.  
  1099.    A18. We distribute libraries for the SUN4, Decmips, and SGI via
  1100.         anonymous FTP:
  1101.   
  1102.            USA:                 ftp pprg.eece.unm.edu  (129.24.24.10)
  1103.         (University of  Login:  anonymous  (or ftp)
  1104.             New Mexico) Password: user_name@machine
  1105.   
  1106.         To obtain the libraries, cd to "pub/khoros/bin". You will find
  1107.         three sub-directories called libsun4, libdecmips and libsgi.
  1108.         In these sub-directories are the compressed tar files containing
  1109.         the libraries. Unpack the libraries the same way you would
  1110.         unpack the binaries. Consult the Khoros installation guide.
  1111.  
  1112.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1113.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1114.  
  1115.     Q19. I am trying to compile an xvroutine, and when I run make install
  1116.          I get the error:
  1117.          installing in ./{xvroutine}...
  1118.          Make:  Don't know how to make {KHOROS_HOME}/lib/libdisplay.a.
  1119.          Stop.
  1120.          *** Error code 1
  1121.  
  1122.     A19. Most likely, you do not have the Khoros libraries that are necessary
  1123.          to compile spectrum (and any other toolbox you may acquire).
  1124.          These libraries (*.a) would be located in $KHOROS_HOME/lib if you
  1125.          had them.  If you do not have them, you may either:
  1126.          (1) ftp them from pprg  (see Q11)
  1127.          - or -
  1128.          (2) compile the Khoros system (you must have source code for this)
  1129.  
  1130.  
  1131.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1132.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1133.  
  1134.     Q20. I want to link a {vroutine/xvroutine} for dbx.
  1135.  
  1136.     A20. In your Imakefile, add:
  1137.          CDEBUGFLAGS = -g
  1138.  
  1139.      % makemake
  1140.  
  1141.          To remake your Makefile.
  1142.  
  1143.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1144.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1145.  
  1146.     Q21. I want my {vroutine/xvroutine} to use some specific 
  1147.          include files and special libraries.
  1148.  
  1149.     A21. Suppose you have additional include files you want (relative to the
  1150.          program) in "../../include" and an extra library you want to use in
  1151.          "../../lib/libfubar.a."
  1152.  
  1153.          So in your Imakefile, you'd add:
  1154.  
  1155.          EXTRA_INCLUDES =  -I../../include
  1156.          EXTRA_LIBRARIES = ../../lib/libfubar.a
  1157.  
  1158.      % makemake 
  1159.  
  1160.      To remake your Makefile.  You can also use the absolute path, but 
  1161.      this is not a good idea if you have your program on more than one 
  1162.          architectures using NFS, as all the architectures will use the same 
  1163.      Imakefile, but the absolute path on one machine may not be the same 
  1164.          as the absolute path on the second.
  1165.  
  1166.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1167.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1168.  
  1169.    Q22.  Is there a way to get ghostwriter to automatically generate 
  1170.      the Makefile so that it will look for other include directories 
  1171.          and libraries?
  1172.  
  1173.    A22.  (answer thanks to Bradford Castallia, Planetary Image Research Lab,
  1174.           University of Arizona)
  1175.  
  1176.          You can specify site-specific libraries that should always be 
  1177.          referenced.
  1178.  
  1179.       However, for specific cases, modify the {toolbox}.def file (under
  1180.       $TOOLBOX/repos/config/imake_conf). Edit the lines containing the
  1181.       definitions of TOOLBOXINCLUDE and TOOLBOX_LIBRARIES, and you may also
  1182.       want to edit the line defining TOOLBOX_DEP_LIBRARIES to be consistent
  1183.       with the definition of TOOLBOX_LIBRARIES. For example, I have a
  1184.       toolbox for applications that access our digital filmwriter which
  1185.       requires access to a few special include files and libraries, so I have
  1186.       modified filmwriter.def thus:
  1187.       
  1188.       TOOLBOXINCLUDE = -I$(TB_NAME)/include \
  1189.                        -I/usr/local/QCR/include \
  1190.                        -I/usr/local/image/include \
  1191.                         -I/usr/local/PIRL
  1192.       
  1193.       TOOLBOX_LIBRARIES = -lfilmwriter \
  1194.                           -lQCR \
  1195.                           -lImage \
  1196.                           -lPIRL
  1197.      
  1198.          TOOLBOX_DEP_LIBRARIES = $(LIBDIR)/libfilmwriter.a \
  1199.                                /usr/local/lib/libQCR.a \
  1200.                                /usr/local/lib/libImage.a \
  1201.                                /usr/local/lib/libPIRL.a
  1202.       
  1203.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1204.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1205.  
  1206. ===================  Compiling with gcc ======================================
  1207.  
  1208.  
  1209.    Q23.  I'm having a problem with gcc:
  1210.  
  1211.       % gcc test.c -I/usr/local/include -I$KHOROS_HOME/include
  1212.  
  1213.      In file included from {KHOROS_HOME}/include/vinclude.h:128, 
  1214.      from test.c:3: 
  1215.      {KHOROS_HOME}/include/vdefines.h:219: conflicting types for `malloc' 
  1216.          /usr/local/{...}/include/malloc.h:41: previous declaration of `malloc'
  1217.          {KHOROS_HOME}/include/vdefines.h:223: conflicting types for `calloc'
  1218.          /usr/local/{...}/include/malloc.h:39: previous declaration of `calloc'
  1219.  
  1220.    A23.  In the file $KHOROS_HOME/include/vdefines.h,
  1221.      change the line:
  1222.  
  1223.      #ifndef AUX
  1224.      to:
  1225.       #if !defined(AUX) && !defined(__GNUC__)
  1226.  
  1227.      Then, in $KHOROS_HOME/src, execute 
  1228.      % make Makefiles
  1229.      % make install
  1230.  
  1231.  
  1232.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1233.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1234.  
  1235.    Q24. I noticed in the make.World file is that a few files are compiled 
  1236.         using 'cc', while some others are compilied using 'gcc'. Is this normal? 
  1237.         Also, there were messages like: 
  1238.         gcc: file path prefix `dynamic' never used
  1239.  
  1240.    A24. The -Bdynamic flag does not exist for gcc. Use -static for a static
  1241.         binary compile, as the default is to load dynamically. The -Bdynamic 
  1242.         flag was ignored and not used.
  1243.  
  1244.     It is normal that some files will be compiled with cc.  We use cc to 
  1245.         compile the bootstrap programs such as imake. However, gcc should have
  1246.         been used for all the rest of the routines.
  1247.  
  1248.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1249.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1250.  
  1251. ===================  Compiling With/Without FORTRAN ==========================
  1252.  
  1253.    Q25. Do I HAVE to have FORTRAN to compile Khoros?  Which Khoros programs
  1254.         will I miss out on if I don't compile with FORTRAN?
  1255.  
  1256.    A25. No, you don't have to have FORTRAN to compile Khoros, although there
  1257.         are some Khoros programs that use it.  If you don't compile with
  1258.         FORTRAN, you will NOT be able to run the following programs, nor will
  1259.     you be able to make calls to any of their associated library routines:  
  1260.  
  1261.     Program         Library Call
  1262.         -------         ------------
  1263.     * warpimage
  1264.     * vbilinco     (lvbilinco)
  1265.     * vpolyco    (lvpolyco)
  1266.     * vsvpsf    (lvsvpsf)
  1267.     * vblse        (lvblse)
  1268.     * vfft        (lvfft)
  1269.     * dmusic    (ldmusic)
  1270.     * dminorm    (ldminorm)
  1271.     * dacorr    (ldacorr)
  1272.     * dxcorr    (ldxcorr)
  1273.     * dconvo    (ldconvo)
  1274.     * dfft1d    (ldfft1d)
  1275.     * difft1d    (ldifft1d)
  1276.     * minvert    (lminvert)
  1277.     * msvd        (lmsvd)
  1278.     * meigen    (lmeigen)
  1279.     * mlud        (lmlud)
  1280.     * mlse        (lmlse)
  1281.     * minfo        (lminfo)
  1282.  
  1283.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1284.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1285.  
  1286.    Q26. How do I compile the Khoros system without FORTRAN?
  1287.  
  1288.    A26. Look for the line in your configuration (*.cf) file that says,
  1289.         #define HasFortran YES
  1290.         Change it to:
  1291.         #define HasFortran NO
  1292.  
  1293.         For those compiling on a SUN architecture, note that in the sun.cf 
  1294.     file for Khoros 1.0 Patch 5, there is an INCORRECT comment:
  1295.         /*
  1296.          * does your machine have fortran? If not comment the next
  1297.          * two lines
  1298.          */
  1299.     The comment lies.  Do not comment out the lines, simply make
  1300.     sure that HasFortran is set to 'NO' (not 'no' or 'No').  
  1301.  
  1302.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1303.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1304.  
  1305.    Q27. I don't have a FORTRAN compiler, but I need the Khoros programs that
  1306.         use FORTRAN.  What can I do?
  1307.  
  1308.    A27. The public domain "f2c" FORTRAN-to-C converter can be used to produce
  1309.         C code from the FORTRAN sections of Khoros.  The "f2c" program can
  1310.         be obtained via anonymous ftp from various sites including 
  1311.     pprg.eece.unm.edu (129.24.24.10) in the directory, /pub/dist/f2c, and
  1312.     research.att.com (192.20.225.2) in the directory, /netlib.  
  1313.     Khoros programs that depend on FORTRAN code that was converted to 
  1314.     C by the f2c program dont't have their results guaranteed by the Khoros 
  1315.     group, however, at least not at this time.
  1316.  
  1317.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1318.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1319.  
  1320.    Q28. I am writing a {vroutine/xvroutine} in which I need to make a call
  1321.         from my C code to a FORTRAN subroutine/function.  How do I do this?
  1322.  
  1323.    A28. (1) Declare the FORTRAN subroutine/function, making sure you use an 
  1324.             underscore after the name, as in:
  1325.             (void) subroutine_();
  1326.             (type) function_();
  1327.  
  1328.     (2) Call the subroutine/function, remembering that when you call FORTRAN 
  1329.         from C, you must always pass values by reference (address), as in:
  1330.             int int_value, *int_array;
  1331.         (void) subroutine_(&int_value, int_array);
  1332.  
  1333.     (3) Note that 2D arrays in FORTRAN are stored in the opposite way 
  1334.         from those in C.  In C, a 2D array is stored as row by row, 
  1335.         whereas in FORTRAN a 2D array is stored column by column.  
  1336.  
  1337.     (4) Also note that the TRUE and FALSE status values returned by 
  1338.         a FORTRAN program may not be the 1 and 0 that are used by 
  1339.         convention in C.
  1340.  
  1341.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1342.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1343.  
  1344.    Q29.  I am setting up my *.cf configuration file in preparation for compiling
  1345.          Khoros.  How do I find out what libraries the linker expects in order
  1346.          to link C code against FORTRAN, in order to provide the proper
  1347.          libraries for the ForSysLibs option?
  1348.  
  1349.    A29.  You can find out what libraries the linker expects by compiling any
  1350.          available Fortran program with the [-v] option, and looking for the
  1351.          libraries specified after a [-l] that are NOT used when compiling
  1352.          C code.  Roque Donizete De Oliveria provides the example below, which
  1353.          he used in getting Khoros to compile under Ultrix 4.2:
  1354.  
  1355.         % f77 -v machar.F
  1356.         /lib/cpp -DLANGUAGE_FORTRAN -DMIPSEL -Dunix -Dmips -Dhost_mips 
  1357.            machar.F > machar.i
  1358.         /usr/lib/cmplrs/fort/decfort -o /tmp/forAAAa01710.o machar.i
  1359.         /usr/bin/cc -v /tmp/forAAAa01710.o -nocount -lUfor -lfor -lutil 
  1360.        -li -lot s -lm
  1361.         /usr/lib/cmplrs/cc/ld -G 8 -g0 -nocount /usr/lib/cmplrs/cc/crt0.o 
  1362.        -count /tmp/forAAAa01710.o -nocount -lUfor -lfor -lutil -li 
  1363.            -lots -lm -nocount -lc
  1364.         0.2u 1.7s 0:09 21% 84+285k 333+63io 17pf+0w
  1365.  
  1366.          In this case, therefore, you would specify in the ultrix.cf file:
  1367.  
  1368.          ForSysLibs: -lUfor -lfor -lutil -li -lots
  1369.  
  1370.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1371.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1372.  
  1373. ===================  Miscellaneous ============================================
  1374.  
  1375.     Q30. I seem to be having some trouble getting Khoros working on our Sun 3. 
  1376.          I have tried executing {cantata, editimage, etc}  {journal playbacks}, 
  1377.      but I keep getting the error "ld.so: libXaw.so.4: not found".
  1378.  
  1379.     A30. (answer thanks to Mike Gross, Physics Board, Univ of California)
  1380.  
  1381.      Your problem is that you have to run ldconfig to tell your system where
  1382.      your shared libraries are. The syntax is:
  1383.  
  1384.      ldconfig <directory> [<directory>] [<directory>] ...
  1385.  
  1386.      where each directory is a possible location for a *.so.* file. You
  1387.      may have to use find to figure out where all the libraries are. Try
  1388.      this out, and if it works, put the ldconfig command in /etc/rc.local,
  1389.      so that you won't lose it next time your system crashes.
  1390.  
  1391.      An alternative is to compile khoros using static libraries, but this
  1392.      will make your executables much larger.
  1393.  
  1394.  
  1395.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1396.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1397.  
  1398.     Q31.  Since the docs say that RPC isn't implemented yet, I defined 
  1399.       UseSunRPC as NO.  Compiling phantomd results in the following:
  1400.       ld: Undefined
  1401.       _sunrpc_tempnam
  1402.       _sunrpc_gethostname
  1403.  
  1404.     A31.  Suggestions:
  1405.  
  1406.       1) make sure that the SunRPC variable in 
  1407.              repos/config/imake_conf/sun.cf is set to 'NO' rather than 'no'.
  1408.  
  1409.           2) cd into src and run the "installit" script again.
  1410.                         - or -
  1411.       2) cd into src/Lib/vgparm and run:
  1412.  
  1413.             % make Makefile
  1414.             % make install
  1415.  
  1416.             You should see it recompile with a set of defines specified on 
  1417.             the compilation command.  Make sure that -DKSUNRPC option is *not*
  1418.             defined.  This is what's trying to pull in the non-existent
  1419.             Sun RPC transport.
  1420.  
  1421.          3) If you are not using shared libraries, then change directories 
  1422.             to $KHOROS_HOME/src and run:
  1423.             % make install
  1424.  
  1425.         If you are using shared libraries, simply rerunning the phantomd
  1426.         should work.
  1427.  
  1428.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1429.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1430.  
  1431.      Q32. On Sun3, OS 4.1.1, a segmentation fault results when cantata is run.
  1432.  
  1433.      The problem is that the bug is caused in the vgparm and vutils 
  1434.      library, not in the cantata program code.  
  1435.  
  1436.      In the file $KHOROS_HOME/src/Lib/vgparm/listfile.c there is a bug.
  1437.      Make the following changes to this file
  1438.     
  1439.      at line 100 change:
  1440.  
  1441.             char    character, *fullpath, entry[LENGTH], **list;
  1442.      to:
  1443.             char    character[2], *fullpath, entry[LENGTH], **list;
  1444.  
  1445.  
  1446.          and line 144 change:
  1447.  
  1448.            if ((void) fscanf(file, " %[#]", &character) == 1)
  1449.          to:
  1450.            if ((void) fscanf(file, " %[#]", character) == 1)
  1451.  
  1452.  
  1453.          and line 157 change:
  1454.  
  1455.            else if ((void)fscanf(file, "%[/]%[*]", &character, &character) == 2)
  1456.          to:
  1457.            else if ((void) fscanf(file, "%[/]%[*]", character, character) == 2)
  1458.  
  1459.  
  1460.          Then in the file $KHOROS_HOME/src/Lib/vutils/readascii.c some
  1461.      changes need to be made.
  1462.     
  1463.      at line 99 change:
  1464.  
  1465.            char    dummy[512], character;
  1466.          to:
  1467.            char    dummy[512], character[2];
  1468.  
  1469.  
  1470.          and line 128 change:
  1471.            if ((void) fscanf(file, "%[#]", &character) == 1)
  1472.          to:
  1473.            if ((void) fscanf(file, "%[#]", character) == 1)
  1474.  
  1475.  
  1476.          and line 139 change:
  1477.            else if ((void)fscanf(file, "%[/]%[*]", &character, &character) == 2)
  1478.          to:
  1479.            else if ((void)fscanf(file, "%[/]%[*]", character, character) == 2)
  1480.  
  1481.  
  1482.          there also seems to be a problem caused by the optimizer
  1483.          using -O on sun3.  It is necessary to recompile the system using -01
  1484.          which is defined as follows in your sun.cf file:
  1485.  
  1486.           #define HaveSunPatchedLd NO
  1487.           #define HasGcc NO
  1488.           #define DefaultCDebugFlags -O1          /* for programs */
  1489.           #define LibraryCDebugFlags -O1          /* for libraries */
  1490.  
  1491.          Note that a comment in sun.cf has a typing error.  The correct
  1492.          flag is -O1 (minus oh one) and not -01 (minus zero one).  
  1493.  
  1494.          Then change directory to $KHOROS_HOME/src, run "make allclean"
  1495.          and then the "installit".
  1496.  
  1497.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1498.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1499.  
  1500.    Q33.  During the compile of Khoros, I get this error message:
  1501.          /: write failed, file system is full
  1502.          compiler(iropt) error:  write_irfile: No space left on device
  1503.  
  1504.    A33.  This error is becuase you have run out of disk space in /tmp. 
  1505.          By default the C compilier uses /tmp as the place to store 
  1506.          intermediate files. To fix this, set the environment variable 
  1507.      TMPDIR to a partition with more disk space, as in:
  1508.      % setenv TMPDIR /large_tmp_dir
  1509.  
  1510.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1511.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1512.  
  1513.    Q34. I am trying to compile a {toolbox, new program, etc}, but "make"
  1514.     keeps giving me error messages that say:
  1515.  
  1516.     make: Fatal error: 
  1517.     Don't know how to make target `{KHOROS_HOME}/lib/lib{something}.a
  1518.  
  1519.    A34. It is likely that you simply don't have the Khoros libraries installed 
  1520.     on your system.  Look and see if there is a {KHOROS_HOME}/lib 
  1521.     directory, which contains a large variety of files ending in ".a".
  1522.     If this directory is missing, whoever installed Khoros probably got 
  1523.     just system & binaries.  If you want to compile anything, though, 
  1524.     you must have the Khoros libraries installed properly in 
  1525.     $KHOROS_HOME/lib.  You may obtain the Khoros libraries in one of 
  1526.     two ways:
  1527.  
  1528.        (1) for SUN4, SGI, DECMIPS, and 486 architectures, the libraries can
  1529.                be ftp'd from pprg.eece.unm.edu, in /pub/khoros/bin.  Put 
  1530.                the *.a's in $KHOROS_HOME/lib, and you will be able to compile.
  1531.  
  1532.        (2) you may acquire Khoros source code from pprg.eece.unm.edu, in
  1533.            /pub/khoros/src, and compile the Khoros system according to the
  1534.            installation guide.  The Khoros libraries will be compiled as
  1535.            part of the entire Khoros installation process.
  1536.  
  1537.  
  1538.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1539.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1540.  
  1541.    Q35. Where in the Khoros Manual is the documentation relating to 
  1542.     compilation/installation of programs in Khoros?
  1543.  
  1544.    A35. The installation guide for the Khoros system as a whole is  
  1545.         available via anonymous ftp from pprg.eece.unm.edu, in the 
  1546.     file /pub/khoros/release/install.ftp.  This is also Chapter 10
  1547.     of the Khoros Programmer's Manual.
  1548.  
  1549.     For becoming familiar with the source configuration of Khoros,
  1550.         the imake system, the tools available for compiling Khoros programs,
  1551.     adding new routines to existing libraries, creating new libraries,
  1552.     creating new programs, and maintaining Khoros on multiple architectures,
  1553.     you want Chapter 9 of the Khoros Programmer's Manual.
  1554.  
  1555.     Either of these chapters may be printed using the "prnmanual" program.
  1556.  
  1557.  
  1558.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1559.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1560.  
  1561.    Q36. How does one selectively fix a program and recompile it without doing
  1562.         the whole installation process again?
  1563.  
  1564.    A36. The process will differ if the fix is to a library on which the 
  1565.     program depends, or to the program itself.
  1566.  
  1567.     Case 1: Fix is to a library on which the program depends.
  1568.  
  1569.     a1) In the case that the fix involves adding a new file to the 
  1570.             library, copy the new file to the library.  Then execute "imkmf",
  1571.         followed by "make Makefile".
  1572.  
  1573.         a2) In the case that the fix involves over-writing an old file with a 
  1574.             new, bug-fixed file, it is generally wise to make a backup copy
  1575.             of the old file before you over-write it.  
  1576.  
  1577.      b) Now, execute, "make depend", followed by "make install".  
  1578.         This recompiles the library.
  1579.  
  1580.      c) Finally, you must recompile the program(s) which depend on the
  1581.             library.  
  1582.  
  1583.         In some cases, there will be only one program that is affected.  
  1584.         For example, if the fix was in the IPL library, the DSPL library,
  1585.         or the File Formats library, it is likely that the fix will only 
  1586.         affect one program.  Find the directory in which the program is
  1587.         located, and recompile it using, "make install".
  1588.  
  1589.         In the case of the xvdisplay, xvforms, xvgraphics, and xvutils
  1590.         libraries,  all xvroutines will be affected.  
  1591.         Go to $KHOROS_HOME/src/xvroutines and execute, "make install".
  1592.  
  1593.         In other cases, the fix to the library may affect every program in
  1594.         the Khoros system.  This will be the case with fixes to the 
  1595.         verror, vexpr, vgparm, vmath, vrast, and vutils libraries.  
  1596.         After making a fix to one of these libraries, it is best to go to 
  1597.         $KHOROS_HOME/src, and do "installit" again.
  1598.  
  1599.  
  1600.     Case 2: the fix is to the program itself
  1601.  
  1602.     In this case, simply find the program in the KHOROS_HOME source tree.
  1603.  
  1604.     a1) In the case that the fix involves adding a new file to the 
  1605.             program, copy the new file to the program directory.  
  1606.         Then execute "imkmf", followed by "make Makefile".
  1607.  
  1608.         a2) In the case that the fix involves over-writing an old file with a 
  1609.             new, bug-fixed file, it is generally wise to make a backup copy
  1610.             of the old file before you over-write it.  
  1611.  
  1612.      a) Now, execute, "make depend", followed by "make install".  
  1613.         This recompiles and installs the program.
  1614.  
  1615.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1616.     ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~ ~~ ~ ~ ~ ~ ~
  1617.  
  1618.    Q37. When I try to compile dzresp, dfilter, mat2viff, etc., I get 
  1619.         unresolved symbols for _dspl_parse, _format_parse, and _vexpr_parse.
  1620.         Where do I find these routines?
  1621.  
  1622.    A37. The problem you are experiencing is the result of using GNU's version
  1623.         of the program 'sed'.  What you need to do is change your path so
  1624.         that /bin/sed or /usr/bin/sed are used and then do the following:
  1625.  
  1626.         cd $KHOROS_HOME/src/Lib/vexpr
  1627.         make clean
  1628.         cd $KHOROS_HOME/src/dspl/Lib
  1629.         make clean
  1630.         cd $KHOROS_HOME/src/file_formats/Lib
  1631.         make clean
  1632.         cd $KHOROS_HOME/src
  1633.         make install
  1634.  
  1635.  
  1636.  
  1637.  
  1638.