home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_300 / 348_01 / z80autil.c < prev   
Encoding:
C/C++ Source or Header  |  1991-04-30  |  14.4 KB  |  549 lines
  1. /*
  2.  
  3. This module contains the following utility packages:
  4.  
  5.     1)  symbol table building and searching
  6.  
  7.     2)  opcode and operator table searching
  8.  
  9.     3)  listing file output
  10.  
  11.     4)  hex file output
  12.  
  13.     5)  error flagging
  14. */
  15.  
  16. /*  Get global goodies:  */
  17.  
  18. #include "z80a.h"
  19.  
  20. /*  Make sure that MSDOS compilers using the large memory model know    */
  21. /*  that calloc() returns pointer to char as an MSDOS far pointer is    */
  22. /*  NOT compatible with the int type as is usually the case.        */
  23.  
  24. char *calloc();
  25.  
  26. /*  Get access to global mailboxes defined in Z80F.C:            */
  27.  
  28. extern char errcode, line[], title[], sub_tit[];
  29. extern int eject, listhex, code, listok;
  30. extern unsigned address, bytes, errors, listleft, obj[], pagelen;
  31.  
  32. /*  The symbol table is a binary tree of variable-length blocks drawn    */
  33. /*  from the heap with the calloc() function.  The root pointer lives    */
  34. /*  here:                                */
  35.  
  36. static SYMBOL *sroot = NULL;
  37.  
  38. /*  Add new symbol to symbol table.  Returns pointer to symbol even if    */
  39. /*  the symbol already exists.  If there's not enough memory to store    */
  40. /*  the new symbol, a fatal error occurs.                */
  41.  
  42. SYMBOL *new_symbol(nam)
  43. char *nam;
  44. {
  45.     SCRATCH int i;
  46.     SCRATCH SYMBOL **p, *q;
  47.     void fatal_error();
  48.  
  49.     for (p = &sroot; (q = *p) && (i = strcmp(nam,q -> sname)); )
  50.     p = i < 0 ? &(q -> left) : &(q -> right);
  51.     if (!q) {
  52.     if (!(*p = q = (SYMBOL *)calloc(1,sizeof(SYMBOL) + strlen(nam))))
  53.         fatal_error(SYMBOLS);
  54.     strcpy(q -> sname,nam);
  55.     }
  56.     return q;
  57. }
  58.  
  59. /*  Look up symbol in symbol table.  Returns pointer to symbol or NULL    */
  60. /*  if symbol not found.                        */
  61.  
  62. SYMBOL *find_symbol(nam)
  63. char *nam;
  64. {
  65.     SCRATCH int i;
  66.     SCRATCH SYMBOL *p;
  67.  
  68.     for (p = sroot; p && (i = strcmp(nam,p -> sname));
  69.     p = i < 0 ? p -> left : p -> right);
  70.     return p;
  71. }
  72.  
  73. /*  Opcode table search routine.  This routine pats down the opcode    */
  74. /*  table for a given opcode and returns either a pointer to it or    */
  75. /*  NULL if the opcode doesn't exist.                    */
  76. /*  NOTE: THIS TABLE MUST BE IN ALPHA ORDER!                */
  77.  
  78. OPCODE *find_code(nam)
  79. char *nam;
  80. {
  81.     OPCODE *bsearch();
  82.  
  83.     static OPCODE opctbl[] = {
  84.     { S_OP + INDEX,            0x88,    "ADC"    },
  85.     { ONE_ARG_L2,            0xED4A,    "ADCHL"    },
  86.     { ONE_ARG,            0xCE,    "ADCI"    },
  87.     { S_OP + INDEX,            0x80,    "ADD"    },
  88.     { L_OP,                0x09,    "ADDHL"    },
  89.     { ONE_ARG,            0xC6,    "ADDI"    },
  90.     { ONE_ARG_L2,            0xDD09,    "ADDIX"    },
  91.     { ONE_ARG_L2,            0xFD09,    "ADDIY"    },
  92.     { S_OP + INDEX,            0xA0,    "AND"    },
  93.     { ONE_ARG,            0xE6,    "ANDI"    },
  94.     { BIT + INDEX,            0xCB40,    "BIT"    },
  95.     { L_ARG2,            0xCD,    "CALL"    },
  96.     { CALL,                0xCD,    "CALLC"    },
  97.     { NO_ARG,            0x3F,    "CCF"    },
  98.     { S_OP + INDEX,            0xB8,    "CMP"    },
  99.     { ONE_ARG,            0xFE,    "CMPI"    },
  100.     { PSEUDO,            CODE,    "CODE"    },
  101.     { S_OP + INDEX,            0xB8,    "CP"    },
  102.     { NO_ARG_L,            0xEDA9,    "CPDEC"    },
  103.     { NO_ARG_L,            0xEDB9,    "CPDR"    },
  104.     { NO_ARG_L,            0xEDA1,    "CPINC"    },
  105.     { NO_ARG_L,            0xEDB1,    "CPIR"    },
  106.     { NO_ARG,            0x2F,    "CPL"    },
  107.     { PSEUDO,            CSECT,    "CSECT"    },
  108.     { PSEUDO,            DS,    "DA"    },
  109.     { NO_ARG,            0x27,    "DAA"    },
  110.     { PSEUDO,            DW,    "DAC"    },
  111.     { PSEUDO,            DB,    "DATA"    },
  112.     { PSEUDO,            DB,    "DBC"    },
  113.     { PSEUDO,            DB,    "DC"    },
  114.     { S_OP + 0x0300 + INDEX,    0x05,    "DEC"    },
  115.     { L_OP + INDEX,            0x0B,    "DEC16"    },
  116.     { NO_ARG,            0xF3,    "DI"    },
  117.     { JREL,                0x10,    "DJNZ"    },
  118.     { NO_ARG,            0xFB,    "EI"    },
  119.     { PSEUDO + ISIF,        ELSE,    "ELS"    },
  120.     { PSEUDO,            END,    "END"    },
  121.     { PSEUDO + ISIF,        ENDIF,    "ENF"    },
  122.     { PSEUDO,            EQU,    "EQU"    },
  123.     { NO_ARG,            0x08,    "EXAFAF"},
  124.     { NO_ARG,            0xEB,    "EXDEHL"},
  125.     { NO_ARG,            0xE3,    "EXSPHL"},
  126.     { NO_ARG_L,            0xDDE3,    "EXSPIX"},
  127.     { NO_ARG_L,            0xFDE3,    "EXSPIY"},
  128.     { NO_ARG,            0xD9,    "EXX"    },
  129.     { NO_ARG,            0x76,    "HALT"    },
  130.     { PSEUDO + ISIF,        IF,    "IF"    },
  131.     { NO_ARG_L,            0xED46,    "IM0"    },
  132.     { NO_ARG_L,            0xED56,    "IM1"    },
  133.     { NO_ARG_L,            0xED5E,    "IM2"    },
  134.     { ONE_ARG,            0xDB,    "IN"    },
  135.     { S_OP + 0x0300 + INDEX,    0x04,    "INC"    },
  136.     { L_OP + INDEX,            0x03,    "INC16"    },
  137.     { NO_ARG_L,            0xEDAA,    "INDEC"    },
  138.     { NO_ARG_L,            0xEDBA,    "INDR"    },
  139.     { NO_ARG_L,            0xEDA2,    "ININC"    },
  140.     { NO_ARG_L,            0xEDB2,    "INIR"    },
  141.     { XIO,                0xED40,    "INPUT"    },
  142.     { JUMP,                0xC3,    "JP"    },
  143.     { JREL,                0x18,    "JR"    },
  144.     { JREL,                0x18,    "JREL"    },
  145.     { L_ARG2,            0xC3,    "JUMP"    },
  146.     { ONE_ARG_L + INDEX,        0xE9,    "JUMPI"    },
  147.     { MOV + INDEX,            0x40,    "LD"    },
  148.     { L_ARG_L + INDEX,        0x2A,    "LD16"    },
  149.     { L_ARG2,            0x3A,    "LDA"    },
  150.     { NO_ARG,            0x0A,    "LDABC"    },
  151.     { NO_ARG,            0x1A,    "LDADE"    },
  152.     { NO_ARG_L,            0xED57,    "LDAI"    },
  153.     { NO_ARG_L,            0xED5F,    "LDAR"    },
  154.     { NO_ARG,            0x02,    "LDBCA"    },
  155.     { NO_ARG,            0x12,    "LDDEA"    },
  156.     { NO_ARG_L,            0xEDA8,    "LDDEC"    },
  157.     { NO_ARG_L,            0xEDB8,    "LDDR"    },
  158.     { ONE_ARG + 0x0300 + INDEX,    0x06,    "LDI"    },
  159.     { L_ARG + INDEX,        0x01,    "LDI16"    },
  160.     { NO_ARG_L,            0xED47,    "LDIA"    },
  161.     { NO_ARG_L,            0xEDA0,    "LDINC"    },
  162.     { NO_ARG_L,            0xEDB0,    "LDIR"    },
  163.     { NO_ARG_L,            0xED4F,    "LDRA"    },
  164.     { ONE_ARG_L + INDEX,        0xF9,    "LDSP"    },
  165.     { PSEUDO,            LIST,    "LIST"    },
  166.     { PSEUDO,            NCODE,    "NCODE"    },
  167.     { NO_ARG_L,            0xED44,    "NEG"    },
  168.     { NO_ARG,            0x00,    "NOP"    },
  169.     { S_OP + INDEX,            0xB0,    "OR"    },
  170.     { PSEUDO,            ORG,    "ORG"    },
  171.     { ONE_ARG,            0xF6,    "ORI"    },
  172.     { ONE_ARG,            0xD3,    "OUT"    },
  173.     { NO_ARG_L,            0xEDAB,    "OUTDEC"},
  174.     { NO_ARG_L,            0xEDBB,    "OUTDR"    },
  175.     { NO_ARG_L,            0xEDA3,    "OUTINC"},
  176.     { NO_ARG_L,            0xEDB3,    "OUTIR"    },
  177.     { XIO,                0xED41,    "OUTPUT"},
  178.     { PSEUDO,            PAGE,    "PAG"    },
  179.     { PSEUDO,            PAGT,    "PAGT"    },
  180.     { L_OP + INDEX,            0xC1,    "POP"    },
  181.     { L_OP + INDEX,            0xC5,    "PUSH"    },
  182.     { BIT + INDEX,            0xCB80,    "RES"    },
  183.     { RETURN,            0xC9,    "RET"    },
  184.     { NO_ARG_L,            0xED4D,    "RETI"    },
  185.     { NO_ARG_L,            0xED45,    "RETN"    },
  186.     { NO_ARG,            0xC9,    "RETURN"},
  187.     { ROTATE + INDEX,        0xCB10,    "RL"    },
  188.     { NO_ARG,            0x17,    "RLA"    },
  189.     { PSEUDO,            RLC,    "RLC"    },
  190.     { NO_ARG,            0x07,    "RLCA"    },
  191.     { NO_ARG_L,            0xED6F,    "RLD"    },
  192.     { ROTATE + INDEX,        0xCB00,    "ROLC"    },
  193.     { ROTATE + INDEX,        0xCB18,    "RR"    },
  194.     { NO_ARG,            0x1F,    "RRA"    },
  195.     { ROTATE + INDEX,        0xCB08,    "RRC"    },
  196.     { NO_ARG,            0x0F,    "RRCA"    },
  197.     { NO_ARG_L,            0xED67,    "RRD"    },
  198.     { RESTART,            0xC7,    "RST"    },
  199.     { S_OP + INDEX,            0x98,    "SBC"    },
  200.     { ONE_ARG_L2,            0xED42,    "SBCHL"    },
  201.     { ONE_ARG,            0xDE,    "SBCI"    },
  202.     { NO_ARG,            0x37,    "SCF"    },
  203.     { PSEUDO,            SET,    "SET"     },
  204.     { BIT + INDEX,            0xCBC0,    "SETB"    },
  205.     { PSEUDO,            SKP,    "SKP"   },
  206.     { ROTATE + INDEX,        0xCB40,    "SLA"    },
  207.     { ROTATE + INDEX,        0xCB48,    "SRA"    },
  208.     { ROTATE + INDEX,        0xCB38,    "SRL"    },
  209.     { L_ARG_L2 + INDEX,        0x22,    "ST16"    },
  210.     { L_ARG2,            0x32,    "STA"    },
  211.     { S_OP + INDEX,            0x90,    "SUB"    },
  212.     { ONE_ARG,            0xD6,    "SUBI"    },
  213.     { PSEUDO,            TITL,    "TTL"    },
  214.     { PSEUDO,            TYP,    "TYP"   },
  215.     { PSEUDO,            ULIST,    "ULIST" },
  216.     { PSEUDO,            URLC,    "URLC"  },
  217.     { PSEUDO,            INCL,    "USE"   },
  218.     { S_OP + INDEX,            0xA8,    "XOR"    },
  219.     { ONE_ARG,            0xEE,    "XORI"    }
  220.     };
  221.  
  222.     return bsearch(opctbl,opctbl + (sizeof(opctbl) / sizeof(OPCODE)),nam);
  223. }
  224.  
  225. /*  Operator table search routine.  This routine pats down the        */
  226. /*  operator table for a given operator and returns either a pointer    */
  227. /*  to it or NULL if the opcode doesn't exist.                */
  228. /*    MUST BE IN ALPHA ORDER!                        */
  229.  
  230. OPCODE *find_operator(nam)
  231. char *nam;
  232. {
  233.     OPCODE *bsearch();
  234.  
  235.     static OPCODE oprtbl[] = {
  236.     { BINARY + OPR,            SIZE,        "."    },
  237.     { REG,                A,        "A"    },
  238.     { REG,                AF,        "AF"    },
  239.     { BINARY + LOG1  + OPR,        AND,        "AND"    },
  240.     { REG,                B,        "B"    },
  241.     { REG,                BC,        "BC"    },
  242.     { MIX,                C,        "C"    },
  243.     { REG,                D,        "D"    },
  244.     { REG,                DE,        "DE"    },
  245.     { REG,                E,        "E"    },
  246.     { CON,                Z,        "EQ"    },
  247.     { BINARY + RELAT + OPR,        GE,        "GE"    },
  248.     { BINARY + RELAT + OPR,        '>',        "GT"    },
  249.     { REG,                H,        "H"    },
  250.     { UNARY  + UOP3  + OPR,        HIGH,        "HIGH"    },
  251.     { REG,                HL,        "HL"    },
  252.     { REG + INDEX,            X,        "IX"    },
  253.     { REG + INDEX,            Y,        "IY"    },
  254.     { REG,                L,        "L"    },
  255.     { BINARY + RELAT + OPR,        LE,        "LE"    },
  256.     { UNARY  + UOP3  + OPR,        LOW,        "LOW"    },
  257.     { BINARY + RELAT + OPR,        '<',        "LT"    },
  258.     { MIX,                M,        "M"    },
  259.     { BINARY + MULT  + OPR,        MOD,        "MOD"    },
  260.     { CON,                NC,        "NC"    },
  261.     { CON,                NZ,        "NE"    },
  262.     { UNARY  + UOP2  + OPR,        NOT,        "NOT"    },
  263.     { CON,                NZ,        "NZ"    },
  264.     { BINARY + LOG2  + OPR,        OR,        "OR"    },
  265.     { CON,                P,        "P"    },
  266.     { CON,                PE,        "PE"    },
  267.     { CON,                PO,        "PO"    },
  268.     { BINARY + MULT  + OPR,        SHL,        "SHL"    },
  269.     { BINARY + MULT  + OPR,        SHR,        "SHR"    },
  270.     { REG,                SP,        "SP"    },
  271.     { BINARY + LOG2  + OPR,        XOR,        "XOR"    },
  272.     { CON,                Z,        "Z"    }
  273.     };
  274.  
  275.     return bsearch(oprtbl,oprtbl + (sizeof(oprtbl) / sizeof(OPCODE)),nam);
  276. }
  277.  
  278. static OPCODE *bsearch(lo,hi,nam)
  279. OPCODE *lo, *hi;
  280. char *nam;
  281. {
  282.     SCRATCH int i;
  283.     SCRATCH OPCODE *chk;
  284.  
  285.     for (;;) {
  286.     chk = lo + (hi - lo) / 2;
  287.     if (!(i = ustrcmp(chk -> oname,nam))) return chk;
  288.     if (chk == lo) return NULL;
  289.     if (i < 0) lo = chk;
  290.     else hi = chk;
  291.     };
  292. }
  293.  
  294. static int ustrcmp(s,t)
  295. char *s, *t;
  296. {
  297.     SCRATCH int i;
  298.  
  299.     while (!(i = toupper(*s++) - toupper(*t)) && *t++);
  300.     return i;
  301. }
  302.  
  303. /*  Buffer storage for line listing routine.  This allows the listing    */
  304. /*  output routines to do all operations without the main routine    */
  305. /*  having to fool with it.                        */
  306.  
  307. static FILE *list = NULL;
  308.  
  309. /*  Listing file open routine.  If a listing file is already open, a    */
  310. /*  warning occurs.  If the listing file doesn't open correctly, a    */
  311. /*  fatal error occurs.  If no listing file is open, all calls to    */
  312. /*  lputs() and lclose() have no effect.                */
  313.  
  314. void lopen(nam)
  315. char *nam;
  316. {
  317.     FILE *fopen();
  318.     void fatal_error(), warning();
  319.  
  320.     if (list) warning(TWOLST);
  321.     else if (!(list = fopen(nam,"w"))) fatal_error(LSTOPEN);
  322.     return;
  323. }
  324.  
  325. /*  Listing file line output routine.  This routine processes the    */
  326. /*  source line saved by popc() and the output of the line assembler in    */
  327. /*  buffer obj into a line of the listing.  If the disk fills up, a    */
  328. /*  fatal error occurs.                            */
  329.  
  330. void lputs()
  331. {
  332.     SCRATCH int i, j;
  333.     SCRATCH unsigned *o;
  334.     void check_page(), fatal_error();
  335.  
  336.     if (list) {
  337.         if (!listok) return;
  338.     i = bytes;  o = obj;
  339.     do {
  340.         fprintf(list,"%c  ",errcode);
  341.         if (listhex) {
  342.         fprintf(list,"%04X  ",address);
  343.         for (j = 4; j; --j) {
  344.             if (i) { --i;  ++address;  fprintf(list," %02X",*o++); }
  345.             else fprintf(list,"   ");
  346.         }
  347.         }
  348.         else fprintf(list,"%18s","");
  349.         fprintf(list,"   %s",line);  strcpy(line,"\n");
  350.         check_page();
  351.         if (ferror(list)) fatal_error(DSKFULL);
  352.     } while (listhex && i);
  353.     }
  354.     return;
  355. }
  356.  
  357. /*  Listing file close routine.  THe symbol table is appended to the    */
  358. /*  listing in alphabetic order by symbol name, and the listing file is    */
  359. /*  closed.  If the disk fills up, a fatal error occurs.        */
  360.  
  361. static int col = 0;
  362.  
  363. void lclose()
  364. {
  365.     void fatal_error(), list_sym();
  366.  
  367.     if (list) {
  368.     if (sroot) {
  369.         list_sym(sroot);
  370.         if (col) fprintf(list,"\n");
  371.     }
  372.     if (errors) fprintf(list,"\n%d Error(s)",errors);
  373.     else fprintf(list,"\nNo Errors");
  374.     fprintf(list,"\f");
  375.     if (ferror(list) || fclose(list) == EOF) fatal_error(DSKFULL);
  376.     }
  377.     return;
  378. }
  379.  
  380. static void list_sym(sp)
  381. SYMBOL *sp;
  382. {
  383.     void check_page();
  384.  
  385.     if (sp) {
  386.     list_sym(sp -> left);
  387.     fprintf(list,"%04X,%04X  %-10s",sp -> valu,((sp -> len) ? sp -> len : 2),sp -> sname);
  388.     if (col = ++col % SYMCOLS) fprintf(list,"    ");
  389.     else {
  390.         fprintf(list,"\n");
  391.         if (sp -> right) check_page();
  392.     }
  393.     list_sym(sp -> right);
  394.     }
  395.     return;
  396. }
  397.  
  398. static void check_page()
  399. {
  400.     if (pagelen && !--listleft) eject = TRUE;
  401.     if (eject) {
  402.     eject = FALSE;  listleft = pagelen;  fprintf(list,"\f");
  403.     if (title[0]) { 
  404.         fprintf(list,"\n%s\n",title);  listleft -= 4;
  405.         if (sub_tit[0])    {
  406.             fprintf(list,"%s\n\n",sub_tit);
  407.         } else fprintf(list,"\n\n");
  408.     }
  409.     }
  410.     return;
  411. }
  412.  
  413. /*  Buffer storage for hex output file.  This allows this module to    */
  414. /*  do all of the required buffering and record forming without the    */
  415. /*  main routine having to fool with it.                */
  416.  
  417. static FILE *hex = NULL;
  418. static unsigned cnt = 0;
  419. static unsigned addr = 0;
  420. static unsigned sum = 0;
  421. static unsigned buf[HEXSIZE];
  422.  
  423. /*  Hex file open routine.  If a hex file is already open, a warning    */
  424. /*  occurs.  If the hex file doesn't open correctly, a fatal error    */
  425. /*  occurs.  If no hex file is open, all calls to hputc(), hseek(), and    */
  426. /*  hclose() have no effect.                        */
  427.  
  428. void hopen(nam)
  429. char *nam;
  430. {
  431.     FILE *fopen();
  432.     void fatal_error(), warning();
  433.  
  434.     if (hex) warning(TWOHEX);
  435.     else if (!(hex = fopen(nam,"w"))) fatal_error(HEXOPEN);
  436.     return;
  437. }
  438.  
  439. /*  Hex file write routine.  The data byte is appended to the current    */
  440. /*  record.  If the record fills up, it gets written to disk.  If the    */
  441. /*  disk fills up, a fatal error occurs.                */
  442.  
  443. void hputc(c)
  444. unsigned c;
  445. {
  446.     void record();
  447.  
  448.     if (hex) {
  449.         if (code) {
  450.             buf[cnt++] = c;
  451.         if (cnt == HEXSIZE) record(0);
  452.     }
  453.     }
  454.     return;
  455. }
  456.  
  457. /*  Hex file address set routine.  The specified address becomes the    */
  458. /*  load address of the next record.  If a record is currently open,    */
  459. /*  it gets written to disk.  If the disk fills up, a fatal error    */
  460. /*  occurs.                                */
  461.  
  462. void hseek(a)
  463. unsigned a;
  464. {
  465.     void record();
  466.  
  467.     if (hex) {
  468.         if (code) {
  469.             if (cnt) record(0);
  470.         addr = a;
  471.     }
  472.     }
  473.     return;
  474. }
  475.  
  476. /*  Hex file close routine.  Any open record is written to disk, the    */
  477. /*  EOF record is added, and file is closed.  If the disk fills up, a    */
  478. /*  fatal error occurs.                            */
  479.  
  480. void hclose()
  481. {
  482.     void fatal_error(), record();
  483.  
  484.     if (hex) {
  485.     if (cnt) record(0);
  486.     record(1);
  487.     if (fclose(hex) == EOF) fatal_error(DSKFULL);
  488.     }
  489.     return;
  490. }
  491.  
  492. static void record(typ)
  493. unsigned typ;
  494. {
  495.     SCRATCH unsigned i;
  496.     void fatal_error(), putb();
  497.  
  498.     putc(':',hex);  putb(cnt);  putb(high(addr));
  499.     putb(low(addr));  putb(typ);
  500.     for (i = 0; i < cnt; ++i) putb(buf[i]);
  501.     putb(low(-sum));  putc('\n',hex);
  502.  
  503.     addr += cnt;  cnt = 0;
  504.  
  505.     if (ferror(hex)) fatal_error(DSKFULL);
  506.     return;
  507. }
  508.  
  509. static void putb(b)
  510. unsigned b;
  511. {
  512.     static char digit[] = "0123456789ABCDEF";
  513.  
  514.     putc(digit[b >> 4],hex);
  515.     putc(digit[b & 0x0f],hex);
  516.     sum += b;  return;
  517. }
  518.  
  519. /*  Error handler routine.  If the current error code is non-blank,    */
  520. /*  the error code is filled in and the    number of lines with errors    */
  521. /*  is adjusted.                            */
  522.  
  523. void error_s(code)
  524. char code;
  525. {
  526.     if (errcode == ' ') { errcode = code;  ++errors; }
  527.     return;
  528. }
  529.  
  530. /*  Fatal error handler routine.  A message gets printed on the stderr    */
  531. /*  device, and the program bombs.                    */
  532.  
  533. void fatal_error(msg)
  534. char *msg;
  535. {
  536.     printf("Fatal Error -- %s\n",msg);
  537.     exit(-1);
  538. }
  539.  
  540. /*  Non-fatal error handler routine.  A message gets printed on the    */
  541. /*  stderr device, and the routine returns.                */
  542.  
  543. void warning(msg)
  544. char *msg;
  545. {
  546.     printf("Warning -- %s\n",msg);
  547.     return;
  548. }
  549.