]> git.pond.sub.org Git - empserver/blob - src/lib/common/xundump.c
Support vertically split configuration tables (human-readable only):
[empserver] / src / lib / common / xundump.c
1 /*
2  *  Empire - A multi-player, client/server Internet based war game.
3  *  Copyright (C) 1986-2006, Dave Pare, Jeff Bailey, Thomas Ruschak,
4  *                           Ken Stevens, Steve McClure
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  *  ---
21  *
22  *  See files README, COPYING and CREDITS in the root of the source
23  *  tree for related information and legal notices.  It is expected
24  *  that future projects/authors will amend these files as needed.
25  *
26  *  ---
27  *
28  *  xundump.c: Load back xdump output
29  * 
30  *  Known contributors to this file:
31  *     Ron Koenderink, 2005
32  *     Markus Armbruster, 2005
33  */
34
35 /* FIXME normalize terminology: table/rows/columns or file/records/fields */
36
37 #include <config.h>
38
39 #include <stdio.h>
40 #include <stdlib.h>
41
42 #include <ctype.h>
43 #include <string.h>
44 #include <stdarg.h>
45 #include <time.h>
46
47 #include "file.h"
48 #include "match.h"
49 #include "nsc.h"
50 #include "optlist.h"
51 #include "prototypes.h"
52
53 static char *fname;
54 static int lineno;
55 static int human;
56 static int ellipsis;
57 static int cur_type, cur_id;
58 static void *cur_obj;
59 static int nflds;
60 static struct castr **fldca;
61 static int *fldidx;
62 static int *caflds;
63
64 static int gripe(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
65 static int deffld(int, char *, int);
66 static int defellipsis(int fldno);
67 static int chkflds(void);
68 static int setnum(int, double);
69 static int setstr(int, char *);
70 static int xunsymbol1(char *, struct symbol *, struct castr *, int);
71 static int setsym(int, char *);
72 static int mtsymset(int, long *);
73 static int add2symset(int, long *, char *);
74 static struct symbol *get_symtab(struct castr *);
75 static int xundump1(FILE *, int, struct castr *);
76 static int xundump2(FILE *, int, struct castr *);
77
78 static int
79 gripe(char *fmt, ...)
80 {
81     va_list ap;
82
83     fprintf(stderr, "%s:%d: ", fname, lineno);
84     va_start(ap, fmt);
85     vfprintf(stderr, fmt, ap);
86     va_end(ap);
87     putc('\n', stderr);
88
89     return -1;
90 }
91
92 static int
93 skipfs(FILE *fp)
94 {
95     int ch;
96
97     do {
98         ch = getc(fp);
99     } while (ch == ' ' || ch == '\t');
100
101     if (ch == '#') {
102         do {
103             ch = getc(fp);
104         } while (ch != EOF && ch != '\n');
105     }
106
107     return ch;
108 }
109
110 static int
111 getid(FILE *fp, char *buf)
112 {
113     int n;
114     if (fscanf(fp, "%1023[^#() \t\n]%n", buf, &n) != 1 || !isalpha(buf[0]))
115         return -1;
116     return n;
117 }
118
119 static char *
120 xuesc(char *buf)
121 {
122     char *src, *dst;
123     int octal_chr, n;
124
125     dst = buf;
126     src = buf;
127     while (*src) {
128         if (*src == '\\') {
129             if (sscanf(++src, "%3o%n", &octal_chr, &n) != 1 || n != 3)
130                 return NULL;
131             *dst++ = (char)octal_chr;
132             src += 3;
133         } else
134             *dst++ = *src++;
135     }
136     *dst = '\0';
137     return buf;
138 }
139
140 static int
141 xufldname(FILE *fp, int i)
142 {
143     int ch, idx;
144     char buf[1024];
145
146     ch = skipfs(fp);
147     switch (ch) {
148     case EOF:
149         return gripe("Unexpected EOF");
150     case '\n':
151         if (chkflds() < 0)
152             return -1;
153         lineno++;
154         return 0;
155     case '.':
156         if (getc(fp) != '.' || getc(fp) != '.')
157             return gripe("Junk in header field %d", i + 1);
158         if (i == 0)
159             return gripe("... not allowed in field 1");
160         if (defellipsis(i) < 0)
161             return -1;
162         ch = skipfs(fp);
163         if (ch != EOF && ch != '\n')
164             return gripe("Junk after ...");
165         ungetc(ch, fp);
166         return 1;
167     default:
168         ungetc(ch, fp);
169         if (getid(fp, buf) < 0)
170             return gripe("Junk in header field %d", i + 1);
171         ch = getc(fp);
172         if (ch != '(') {
173             ungetc(ch, fp);
174             return deffld(i, buf, -1);
175         }
176         ch = getc(fp);
177         ungetc(ch, fp);
178         if (isdigit(ch) || ch == '-' || ch == '+') {
179             if (fscanf(fp, "%d", &idx) != 1)
180                 return gripe("Malformed number in index of header field %d",
181                              i + 1);
182             if (idx < 0)
183                 return gripe("Index must not be negative in header field %d",
184                              i + 1);
185         } else {
186             if (getid(fp, buf) < 0)
187                 return gripe("Malformed index in header field %d", i + 1);
188             return gripe("Symbolic index in header field %d not yet implemented",
189                          i + 1);
190         }
191         ch = getc(fp);
192         if (ch != ')')
193             return gripe("Malformed index in header field %d", i + 1);
194         return deffld(i, buf, idx);
195     }
196 }
197
198 static int
199 xufld(FILE *fp, int i)
200 {
201     int ch;
202     char buf[1024];
203     double dbl;
204     long set;
205
206     ch = skipfs(fp);
207     switch (ch) {
208     case EOF:
209         return gripe("Unexpected EOF");
210     case '\n':
211         if (i != nflds)
212             return gripe("Field %s missing", fldca[i]->ca_name);
213         lineno++;
214         return 0;
215     case '+': case '-': case '.':
216     case '0': case '1': case '2': case '3': case '4':
217     case '5': case '6': case '7': case '8': case '9':
218         ungetc(ch, fp);
219         if (fscanf(fp, "%lg", &dbl) != 1)
220             return gripe("Malformed number in field %d", i + 1);
221         return setnum(i, dbl);
222     case '"':
223         ch = getc(fp);
224         if (ch == '"')
225             buf[0] = 0;
226         else {
227             ungetc(ch, fp);
228             if (fscanf(fp, "%1023[^\"\n]", buf) != 1 || getc(fp) != '"')
229                 return gripe("Malformed string in field %d", i + 1);
230             if (!xuesc(buf))
231                 return gripe("Invalid escape sequence in field %d",
232                              i + 1);
233         }
234         return setstr(i, buf);
235     case '(':
236         if (mtsymset(i, &set) < 0)
237             return -1;
238         for (;;) {
239             ch = skipfs(fp);
240             if (ch == EOF || ch == '\n')
241                 return gripe("Unmatched '(' in field %d", i + 1);
242             if (ch == ')')
243                 break;
244             ungetc(ch, fp);
245             if (getid(fp, buf) < 0)
246                 return gripe("Junk in field %d", i + 1);
247             if (add2symset(i, &set, buf) < 0)
248                 return -1;
249         }
250         return setnum(i, set);
251     default:
252         ungetc(ch, fp);
253         if (getid(fp, buf) < 0)
254             return gripe("Junk in field %d", i + 1);
255         if (!strcmp(buf, "nil"))
256             return setstr(i, NULL);
257         else
258             return setsym(i, buf);
259     }
260 }
261
262 static int
263 xuflds(FILE *fp, int (*parse)(FILE *, int))
264 {
265     int i, ch, res;
266
267     for (i = 0; ; i++) {
268         res = parse(fp, i);
269         if (res < 0)
270             return -1;
271         if (res == 0)
272             return i;
273         ch = getc(fp);
274         if (ch == '\n')
275             ungetc(ch, fp);
276         else if (ch != ' ' && ch != '\t')
277             return gripe("Bad field separator after field %d", i + 1);
278     }
279 }
280
281 static int
282 deffld(int fldno, char *name, int idx)
283 {
284     struct castr *ca = ef_cadef(cur_type);
285     int res;
286
287     res = stmtch(name, ca, offsetof(struct castr, ca_name),
288                      sizeof(struct castr));
289     if (res < 0)
290         return gripe("Header %s of field %d is %s", name, fldno + 1,
291                      res == M_NOTUNIQUE ? "ambiguous" : "unknown");
292     if (ca[res].ca_type != NSC_STRINGY && ca[res].ca_len != 0) {
293         if (idx < 0)
294             return gripe("Header %s requires an index in field %d",
295                          ca[res].ca_name, fldno + 1);
296         if (idx >= ca[res].ca_len)
297             return gripe("Header %s(%d) index out of bounds in field %d",
298                          ca[res].ca_name, idx, fldno + 1);
299         if (idx < caflds[res])
300             return gripe("Duplicate header %s(%d) in field %d",
301                          ca[res].ca_name, idx, fldno + 1);
302         if (idx > caflds[res])
303             return gripe("Expected header %s(%d) in field %d",
304                          ca[res].ca_name, caflds[res], fldno + 1);
305     } else {
306         if (idx >= 0)
307             return gripe("Header %s doesn't take an index in field %d",
308                          ca[res].ca_name, fldno + 1);
309         idx = 0;
310         if (caflds[res])
311             return gripe("Duplicate header %s in field %d",
312                          ca[res].ca_name, fldno + 1);
313     }
314     fldca[fldno] = &ca[res];
315     fldidx[fldno] = idx;
316     caflds[res]++;
317     return 1;
318 }
319
320 static int
321 defellipsis(int fldno)
322 {
323     struct castr *ca = ef_cadef(cur_type);
324
325     if (ca[0].ca_table != cur_type)
326         return gripe("Table %s doesn't support ...", ef_nameof(cur_type));
327     ellipsis = fldno;
328     return 0;
329 }
330
331 static int
332 chkflds(void)
333 {
334     struct castr *ca = ef_cadef(cur_type);
335     int i, len, res = 0;
336
337     if (ellipsis) {
338         if (!caflds[0])
339             return gripe("Header field %s required with ...", ca[0].ca_name);
340         return 0;
341     }
342
343     for (i = 0; ca[i].ca_name; i++) {
344         if (ca[i].ca_flags & NSC_EXTRA)
345             continue;
346         len = ca[i].ca_type != NSC_STRINGY ? ca[i].ca_len : 0;
347         if (!len && !caflds[i])
348             res = gripe("Header field %s missing", ca[i].ca_name);
349         else if (len && caflds[i] == len - 1)
350             res = gripe("Header field %s(%d) missing",
351                         ca[i].ca_name, len - 1);
352         else if (len && caflds[i] < len - 1)
353             res = gripe("Header fields %s(%d) ... %s(%d) missing",
354                         ca[i].ca_name, caflds[i], ca[i].ca_name, len - 1);
355     }
356
357     return res;
358 }
359
360 static struct castr *
361 getfld(int fldno, int *idx)
362 {
363     if (fldno >= nflds) {
364         gripe("Too many fields, expected only %d", nflds);
365         return NULL;
366     }
367     if (CANT_HAPPEN(fldno < 0))
368         return NULL;
369     if (idx)
370         *idx = fldidx[fldno];
371     return fldca[fldno];
372 }
373
374 static void *
375 getobj(struct castr *ca, int altid)
376 {
377     struct empfile *ep = &empfile[cur_type];
378     int need_sentinel = !EF_IS_GAME_STATE(cur_type);
379
380     if (!cur_obj) {
381         if (ca->ca_table == cur_type)
382             cur_id = altid;
383         if (cur_id >= ep->fids) {
384             /* TODO grow cache (and posssibly file) unless EFF_STATIC */
385             if (cur_id < ep->csize - !!need_sentinel)
386                 ep->cids = ep->fids = cur_id + 1;
387             /* else: ef_ptr() will fail */
388         }
389         cur_obj = ef_ptr(cur_type, cur_id);
390         if (!cur_obj)
391             gripe("Can't put ID %d into table %s, it holds only 0..%d.",
392                   cur_id, ep->name, ep->fids - 1);
393     }
394
395     return cur_obj;
396 }
397
398 static int
399 setnum(int fldno, double dbl)
400 {
401     struct castr *ca;
402     int idx;
403     char *memb_ptr;
404     double old;
405
406     ca = getfld(fldno, &idx);
407     if (!ca)
408         return -1;
409
410     memb_ptr = getobj(ca, (int)dbl);
411     if (!memb_ptr)
412         return -1;
413     memb_ptr += ca->ca_off;
414
415     switch (ca->ca_type) {
416     case NSC_CHAR:
417     case NSC_TYPEID:
418         old = ((signed char *)memb_ptr)[idx];
419         ((signed char *)memb_ptr)[idx] = (signed char)dbl;
420         break;
421     case NSC_UCHAR:
422         old = ((unsigned char *)memb_ptr)[idx];
423         ((unsigned char *)memb_ptr)[idx] = (unsigned char)dbl;
424         break;
425     case NSC_SHORT:
426         old = ((short *)memb_ptr)[idx];
427         ((short *)memb_ptr)[idx] = (short)dbl;
428         break;
429     case NSC_USHORT:
430         old = ((unsigned short *)memb_ptr)[idx];
431         ((unsigned short *)memb_ptr)[idx] = (unsigned short)dbl;
432         break;
433     case NSC_INT:
434         old = ((int *)memb_ptr)[idx];
435         ((int *)memb_ptr)[idx] = (int)dbl;
436         break;
437     case NSC_LONG:
438         old = ((long *)memb_ptr)[idx];
439         ((long *)memb_ptr)[idx] = (long)dbl;
440         break;
441     case NSC_XCOORD:
442         old = ((coord *)memb_ptr)[idx];
443         /* FIXME use variant of xrel() that takes orig instead of nation */
444         if (old >= WORLD_X / 2)
445             old -= WORLD_X;
446         ((coord *)memb_ptr)[idx] = XNORM((coord)dbl);
447         break;
448     case NSC_YCOORD:
449         old = ((coord *)memb_ptr)[idx];
450         /* FIXME use variant of yrel() that takes orig instead of nation */
451         if (old >= WORLD_Y / 2)
452             old -= WORLD_Y;
453         ((coord *)memb_ptr)[idx] = YNORM((coord)dbl);
454         break;
455     case NSC_FLOAT:
456         old = ((float *)memb_ptr)[idx];
457         ((float *)memb_ptr)[idx] = (float)dbl;
458         break;
459     case NSC_DOUBLE:
460         old = ((double *)memb_ptr)[idx];
461         ((double *)memb_ptr)[idx] = dbl;
462         break;
463     case NSC_TIME:
464         old = ((time_t *)memb_ptr)[idx];
465         ((time_t *)memb_ptr)[idx] = (time_t)dbl;
466         break;
467     default:
468         return gripe("Field %d doesn't take numbers", fldno + 1);
469     }
470
471     if ((ca->ca_flags & NSC_CONST) && old != dbl)
472         return gripe("Value for field %d must be %g", fldno + 1, old);
473
474     return 1;
475 }
476
477 static int
478 setstr(int fldno, char *str)
479 {
480     struct castr *ca;
481     int idx;
482     size_t len;
483     char *memb_ptr, *old;
484
485     ca = getfld(fldno, &idx);
486     if (!ca)
487         return -1;
488
489     memb_ptr = getobj(ca, cur_id);
490     if (!memb_ptr)
491         return -1;
492     memb_ptr += ca->ca_off;
493
494     switch (ca->ca_type) {
495     case NSC_STRING:
496         old = ((char **)memb_ptr)[idx];
497         if (!(ca->ca_flags & NSC_CONST))
498             ((char **)memb_ptr)[idx] = str ? strdup(str) : NULL;
499         len = 65535;            /* really SIZE_MAX, but it's C99 */
500         break;
501     case NSC_STRINGY:
502         if (CANT_HAPPEN(idx))
503             return -1;
504         if (!str)
505             return gripe("Field doesn't take nil");
506         len = ca->ca_len;
507         if (strlen(str) > len)
508             return gripe("Field %d takes at most %d characters",
509                          fldno + 1, len);
510         old = memb_ptr;
511         if (!(ca->ca_flags & NSC_CONST))
512             strncpy(memb_ptr, str, len);
513         break;
514     default:
515         return gripe("Field %d doesn't take strings", fldno + 1);
516     }
517
518     if (ca->ca_flags & NSC_CONST) {
519         if (old && (!str || strncmp(old, str, len)))
520             return gripe("Value for field %d must be \"%.*s\"",
521                          fldno + 1, len, old);
522         if (!old && str)
523             return gripe("Value for field %d must be nil", fldno + 1);
524     }
525
526     return 1;
527 }
528
529 static int
530 xunsymbol1(char *id, struct symbol *symtab, struct castr *ca, int n)
531 {
532     int i = stmtch(id, symtab, offsetof(struct symbol, name),
533                    sizeof(struct symbol));
534     if (i < 0)
535         return gripe("%s %s symbol `%s' in field %d",
536                      i == M_NOTUNIQUE ? "Ambiguous" : "Unknown",
537                      ca->ca_name, id, n);
538     return i;
539 }
540
541 static int
542 setsym(int fldno, char *sym)
543 {
544     struct castr *ca;
545     struct symbol *symtab;
546     int i;
547
548     ca = getfld(fldno, NULL);
549     if (!ca)
550         return -1;
551
552     symtab = get_symtab(ca);
553     if (!symtab || (ca->ca_flags & NSC_BITS))
554         return gripe("Field %d doesn't take symbols", fldno + 1);
555
556     i = xunsymbol1(sym, symtab, ca, fldno);
557     if (i < 0)
558         return -1;
559     return setnum(fldno, symtab[i].value);
560 }
561
562 static int
563 mtsymset(int fldno, long *set)
564 {
565     struct castr *ca;
566     struct symbol *symtab;
567
568     ca = getfld(fldno, NULL);
569     if (!ca)
570         return -1;
571
572     symtab = get_symtab(ca);
573     if (!symtab || !(ca->ca_flags & NSC_BITS)) {
574         return gripe("Field %d doesn't take symbol sets", fldno + 1);
575     }
576     *set = 0;
577     return 0;
578 }
579
580 static int
581 add2symset(int fldno, long *set, char *sym)
582 {
583     struct castr *ca;
584     struct symbol *symtab;
585     int i;
586
587     ca = getfld(fldno, NULL);
588     if (!ca)
589         return -1;
590
591     symtab = get_symtab(ca);
592     i = xunsymbol1(sym, symtab, ca, fldno);
593     if (i < 0)
594         return -1;
595     *set |= symtab[i].value;
596     return 0;
597 }
598
599 static struct symbol *
600 get_symtab(struct castr *ca)
601 {
602     int symtype = ca->ca_table;
603     struct symbol *symtab;
604
605     if (symtype == EF_BAD || ef_cadef(symtype) != symbol_ca)
606         return NULL;
607
608     symtab = ef_ptr(symtype, 0);
609     CANT_HAPPEN(!symtab);
610     return symtab;
611 }
612
613 static int
614 xuheader(FILE *fp, int expected_table)
615 {
616     char name[64];
617     int res, ch;
618     int type;
619
620     while ((ch = skipfs(fp)) == '\n')
621         lineno++;
622     if (ch == EOF && expected_table == EF_BAD)
623         return -2;
624     ungetc(ch, fp);
625
626     human = ch == 'c';
627     res = -1;
628     if ((human
629          ? fscanf(fp, "config%*[ \t]%63[^ \t#\n]%n", name, &res) != 1
630          : fscanf(fp, "XDUMP%*[ \t]%63[^ \t#\n]%*[ \t]%*[^ \t#\n]%n",
631                   name, &res) != 1) || res < 0)
632         return gripe("Expected xdump header");
633
634     type = ef_byname(name);
635     if (type < 0)
636         return gripe("Unknown table `%s'", name);
637     if (expected_table != EF_BAD && expected_table != type)
638         return gripe("Expected table `%s', not `%s'",
639                      ef_nameof(expected_table), name);
640
641     if (!ef_cadef(type) || !(ef_flags(type) & EFF_MEM)) {
642         CANT_HAPPEN(expected_table != EF_BAD);
643         return gripe("Undumping of table `%s' not implemented", name);
644     }
645
646     if (skipfs(fp) != '\n')
647         return gripe("Junk after xdump header");
648     lineno++;
649
650     return type;
651 }
652
653 static int
654 xuheader1(FILE *fp, int type, struct castr ca[])
655 {
656     struct castr **fca;
657     int *fidx;
658     int ch, i, j, n;
659
660     if (human) {
661         /* Allow repetition of the index field in continued table: */
662         caflds[0] = 0;
663         while ((ch = skipfs(fp)) == '\n')
664             lineno++;
665         ungetc(ch, fp);
666         ellipsis = 0;
667         nflds = xuflds(fp, xufldname);
668         if (nflds < 0)
669             return -1;
670         nflds -= ellipsis != 0;
671     } else {
672         fca = fldca;
673         fidx = fldidx;
674
675         for (i = 0; ca[i].ca_name; i++) {
676             if ((ca[i].ca_flags & NSC_EXTRA))
677                 continue;
678             n = ca[i].ca_type != NSC_STRINGY ? ca[i].ca_len : 0;
679             j = 0;
680             do {
681                 *fca++ = &ca[i];
682                 *fidx++ = j;
683             } while (++j < n);
684         }
685
686         nflds = fidx - fldidx;
687     }
688
689     return 0;
690 }
691
692 static int
693 xutrailer(FILE *fp, int type, int row)
694 {
695     int rows, res;
696
697     res = -1;
698     if (human) {
699         if (fscanf(fp, "config%n",  &res) != 0 || res < 0)
700             return gripe("Malformed table footer");
701     } else {
702         if (fscanf(fp, "%d", &rows) != 1)
703             return gripe("Malformed table footer");
704         if (row != rows)
705             return gripe("Read %d rows, which doesn't match footer "
706                          "%d rows", row, rows);
707     }
708     if (skipfs(fp) != '\n')
709         return gripe("Junk after table footer");
710     lineno++;
711
712     return 0;
713 }
714
715 int
716 xundump(FILE *fp, char *file, int expected_table)
717 {
718     struct castr *ca;
719     int type, nca, nf, i, ch;
720
721     if (fname != file) {
722         fname = file;
723         lineno = 1;
724     }
725
726     if ((type = xuheader(fp, expected_table)) < 0)
727         return type;
728
729     ca = ef_cadef(type);
730     if (CANT_HAPPEN(!ca))
731         return -1;
732
733     nca = nf = 0;
734     for (i = 0; ca[i].ca_name; i++) {
735         nca++;
736         if (!(ca[i].ca_flags & NSC_EXTRA))
737             nf += MAX(1, ca[i].ca_type != NSC_STRINGY ? ca[i].ca_len : 0);
738     }
739     fldca = calloc(nf, sizeof(*fldca));
740     fldidx = calloc(nf, sizeof(*fldidx));
741     caflds = calloc(nca, sizeof(*caflds));
742     cur_type = type;
743
744     if (xundump2(fp, type, ca) < 0)
745         type = EF_BAD;
746
747     free(caflds);
748     free(fldidx);
749     free(fldca);
750
751     /* Skip empty lines so that callers can easily check for EOF */
752     while ((ch = skipfs(fp)) == '\n')
753         lineno++;
754     ungetc(ch, fp);
755
756     return type;
757 }
758
759 static int
760 xundump2(FILE *fp, int type, struct castr *ca)
761 {
762     for (;;) {
763         if (xuheader1(fp, type, ca) < 0)
764             return -1;
765         if (xundump1(fp, type, ca) < 0)
766             return -1;
767         if (!ellipsis)
768             return 0;
769         if (xuheader(fp, type) < 0)
770             return -1;
771     }
772 }
773
774 static int
775 xundump1(FILE *fp, int type, struct castr *ca)
776 {
777     struct empfile *ep = &empfile[type];
778     int need_sentinel = !EF_IS_GAME_STATE(type);
779     int row, n, ch;
780
781     n = 0;
782     for (row = 0;; ++row) {
783         while ((ch = skipfs(fp)) == '\n')
784             lineno++;
785         if (ch == '/')
786             break;
787         ungetc(ch, fp);
788         cur_obj = NULL;
789         cur_id = row;
790         if (xuflds(fp, xufld) < 0)
791             return -1;
792         n = MAX(n, cur_id + 1);
793     }
794
795     if (CANT_HAPPEN(n > ep->fids))
796         n = ep->fids;
797     if (n < ep->fids) {
798         if (EF_IS_GAME_STATE(type) && n != ep->csize)
799             /* TODO truncate file */
800             gripe("Warning: should resize table %s from %d to %d, not implemented",
801                   ef_nameof(type), ep->csize, n);
802         else if (type >= EF_SHIP_CHR && type <= EF_NUKE_CHR)
803             ;                   /* shrinking these is okay */
804         else
805             return gripe("Table %s requires %d rows, got %d",
806                          ef_nameof(type), ep->fids, n);
807     }
808
809     if (need_sentinel) {
810         if (CANT_HAPPEN(n >= ep->csize))
811             return gripe("No space for sentinel");
812         memset(ep->cache + ep->size * n, 0, ep->size);
813     }
814
815     if (xutrailer(fp, type, row) < 0)
816         return -1;
817
818     return 0;
819 }