2 * Empire - A multi-player, client/server Internet based war game.
3 * Copyright (C) 1986-2014, Dave Pare, Jeff Bailey, Thomas Ruschak,
4 * Ken Stevens, Steve McClure, Markus Armbruster
6 * Empire 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 3 of the License, or
9 * (at your option) any later version.
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.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 * See files README, COPYING and CREDITS in the root of the source
22 * tree for related information and legal notices. It is expected
23 * that future projects/authors will amend these files as needed.
27 * xundump.c: Load back xdump output
29 * Known contributors to this file:
30 * Ron Koenderink, 2005
31 * Markus Armbruster, 2005-2014
35 * See doc/xdump! And keep it up-to-date.
37 * Parsing of machine-readable xdump is not precise: it recognizes
38 * comments, accepts whitespace in place of single space, and accepts
39 * the full human-readable field syntax instead of its machine-
43 * - Normalize terminology: table/rows/columns or file/records/fields
44 * - Loading tables with NSC_STRING elements more than once leaks memory
46 * - Symbolic array indexes
47 * - Option to treat missing and unknown fields as warning, not error
48 * TODO, but hardly worth the effort:
49 * - Permit reordering of array elements
67 static char *fname; /* Name of file being read */
68 static int lineno; /* Current line number */
70 static int cur_type; /* Current table's file type */
71 static int partno; /* Counts from 0..#parts-1 */
72 static void *cur_obj; /* The object being read into */
73 static int cur_id; /* and its index in the table */
75 static unsigned char *idgap; /* idgap && idgap[ID] iff part#0 lacks ID */
76 static int idgap_len; /* #elements in idgap[] */
78 static int human; /* Reading human-readable syntax? */
79 static int ellipsis; /* Header ended with ...? */
80 static int nflds; /* #fields in input records */
81 static struct castr **fldca; /* Map field number to selector */
82 static int *fldidx; /* Map field number to index */
83 static int *caflds; /* Map selector number to #fields seen */
84 static int *cafldspp; /* ditto, in previous parts */
86 static int gripe(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
87 static int deffld(int, char *, int);
88 static int chkflds(void);
89 static int setnum(int, double);
90 static int setstr(int, char *);
91 static int setsym(int, char *);
92 static int mtsymset(int, long *);
93 static int add2symset(int, long *, char *);
94 static int xubody(FILE *);
95 static int xutail(FILE *, struct castr *);
98 * Does the code hardcode indexes for table TYPE?
101 have_hardcoded_indexes(int type)
103 return type == EF_ITEM || type == EF_SECTOR_CHR
104 || type == EF_INFRASTRUCTURE;
108 * Okay to truncate table TYPE?
111 may_truncate(int type)
113 return empfile[type].nent < 0 && !have_hardcoded_indexes(type);
117 * Can we fill in gaps in table TYPE?
120 can_fill_gaps(int type)
122 struct castr *ca = ef_cadef(type);
124 return ca[0].ca_table == type && !(ca[0].ca_flags & NSC_EXTRA)
125 && !have_hardcoded_indexes(type);
129 * Gripe about the current line to stderr, return -1.
132 gripe(char *fmt, ...)
136 fprintf(stderr, "%s:%d: ", fname, lineno);
138 vfprintf(stderr, fmt, ap);
145 /* Make TYPE the current table. */
153 old_nelem = type == EF_BAD ? 0 : ef_nelem(type);
158 /* End the current table. */
167 * Seek to current table's ID-th record.
168 * ID must be acceptable.
169 * Store it in cur_obj, and set cur_id accordingly.
170 * Return 0 on success, -1 on failure.
175 struct empfile *ep = &empfile[cur_type];
177 if (id >= ef_nelem(cur_type)) {
178 if (!ef_ensure_space(cur_type, id, 1))
179 return gripe("Can't put ID %d into table %s", id, ep->name);
182 cur_obj = ef_ptr(cur_type, id);
183 if (CANT_HAPPEN(!cur_obj))
191 * Reset the omitted objects to default state.
194 omit_ids(int id1, int id2)
201 idgap = realloc(idgap, id2 * sizeof(*idgap));
202 for (i = idgap_len; i < id1; i++)
204 for (i = id1; i < id2; i++) {
205 ef_blank(cur_type, i, ef_ptr(cur_type, i));
212 * Return the smallest non-omitted ID in ID1..ID2-1 if any, else -1.
215 expected_id(int id1, int id2)
219 for (i = id1; i < id2; i++) {
220 if (i >= idgap_len || !idgap[i])
227 * Get the next object, it has record index ID.
228 * Store it in cur_obj, and set cur_id accordingly.
229 * Reset any omitted objects to default state.
230 * Return 0 on success, -1 on failure.
233 tbl_skip_to_obj(int id)
235 int prev_id = cur_id;
238 if (CANT_HAPPEN(partno != 0))
240 if (!can_fill_gaps(cur_type) && id != cur_id + 1)
241 return gripe("Expected %d in field %d", cur_id + 1, 1);
243 return gripe("Field %d must be > %d", 1, cur_id);
244 max_id = ef_id_limit(cur_type);
246 return gripe("Field %d must be <= %d", 1, max_id);
248 if (tbl_seek(id) < 0)
251 omit_ids(prev_id + 1, id);
256 * Get the next object.
257 * Store it in cur_obj, and set cur_id accordingly.
258 * Return 0 on success, -1 on failure.
266 if (cur_id >= ef_id_limit(cur_type))
267 return gripe("Too many rows");
268 next_id = cur_id + 1;
270 next_id = expected_id(cur_id + 1, empfile[cur_type].fids);
272 return gripe("Table's first part doesn't have this row");
274 return tbl_seek(next_id);
279 * If the table has variable length, truncate it.
280 * Else ensure we're omitting the same objects as the previous parts.
281 * Reset any omitted objects to default state.
282 * Return 0 on success, -1 on failure.
287 struct empfile *ep = &empfile[cur_type];
290 if (cur_id + 1 < ep->fids) {
292 if (may_truncate(cur_type)) {
293 if (!ef_truncate(cur_type, cur_id + 1))
296 if (!can_fill_gaps(cur_type))
297 return gripe("Expected %d more rows",
298 ep->fids - (cur_id + 1));
299 omit_ids(cur_id + 1, ep->fids);
302 exp_id = expected_id(cur_id + 1, ep->fids);
304 return gripe("Expected row with %d in field %d,"
305 " like in table's first part",
317 * Read and ignore field separators from FP.
318 * Return first character that is not a field separator.
327 } while (ch == ' ' || ch == '\t');
332 } while (ch != EOF && ch != '\n');
339 * Decode escape sequences in BUF.
340 * Return BUF on success, null pointer on failure.
352 if (sscanf(++src, "%3o%n", &octal_chr, &n) != 1 || n != 3)
354 *dst++ = (char)octal_chr;
364 * Read an identifier from FP into BUF.
365 * BUF must have space for 1024 characters.
366 * Return number of characters read on success, -1 on failure.
369 getid(FILE *fp, char *buf)
372 if (fscanf(fp, "%1023[^\"#()<>= \t\n]%n", buf, &n) != 1
380 * Try to read a field name from FP.
381 * I is the field number, counting from zero.
382 * If a name is read, set fldca[I] and fldidx[I] for it, and update
384 * Return 1 if a name or ... was read, 0 on end of line, -1 on error.
387 xufldname(FILE *fp, int i)
395 return gripe("Unexpected EOF");
402 if (getc(fp) != '.' || getc(fp) != '.')
403 return gripe("Junk in header field %d", i + 1);
405 return gripe("Header fields expected");
408 if (ch != EOF && ch != '\n')
409 return gripe("Junk after ...");
414 if (getid(fp, buf) < 0)
415 return gripe("Junk in header field %d", i + 1);
419 return deffld(i, buf, -1);
423 if (isdigit(ch) || ch == '-' || ch == '+') {
424 if (fscanf(fp, "%d", &idx) != 1)
425 return gripe("Malformed number in index of header field %d",
428 return gripe("Index must not be negative in header field %d",
431 if (getid(fp, buf) < 0)
432 return gripe("Malformed index in header field %d", i + 1);
433 return gripe("Symbolic index in header field %d not yet implemented",
438 return gripe("Malformed index in header field %d", i + 1);
439 return deffld(i, buf, idx);
444 * Try to read a field value from FP.
445 * I is the field number, counting from zero.
446 * Return 1 if a value was read, 0 on end of line, -1 on error.
449 xufld(FILE *fp, int i)
459 return gripe("Unexpected EOF");
461 CANT_HAPPEN(i > nflds);
462 for (j = i; j < nflds; j++) {
463 if (CA_IS_ARRAY(fldca[j]))
464 gripe("Field %s(%d) missing",
465 fldca[j]->ca_name, fldidx[j]);
467 gripe("Field %s missing", fldca[j]->ca_name);
470 return i < nflds ? -1 : 0;
471 case '+': case '-': case '.':
472 case '0': case '1': case '2': case '3': case '4':
473 case '5': case '6': case '7': case '8': case '9':
475 if (fscanf(fp, "%lg", &dbl) != 1)
476 return gripe("Malformed number in field %d", i + 1);
477 return setnum(i, dbl);
484 if (fscanf(fp, "%1023[^\"\n]", buf) != 1 || getc(fp) != '"')
485 return gripe("Malformed string in field %d", i + 1);
487 return gripe("Invalid escape sequence in field %d",
490 return setstr(i, buf);
492 if (mtsymset(i, &set) < 0)
496 if (ch == EOF || ch == '\n')
497 return gripe("Unmatched '(' in field %d", i + 1);
501 if (getid(fp, buf) < 0)
502 return gripe("Junk in field %d", i + 1);
503 if (add2symset(i, &set, buf) < 0)
506 return setnum(i, set);
509 if (getid(fp, buf) < 0)
510 return gripe("Junk in field %d", i + 1);
511 if (!strcmp(buf, "nil"))
512 return setstr(i, NULL);
514 return setsym(i, buf);
519 * Read fields from FP.
520 * Use PARSE() to read each field.
521 * Return number of fields read on success, -1 on error.
524 xuflds(FILE *fp, int (*parse)(FILE *, int))
537 else if (ch != ' ' && ch != '\t')
538 return gripe("Bad field separator after field %d", i + 1);
543 * Define the FLDNO-th field.
544 * If IDX is negative, define as selector NAME, else as NAME(IDX).
545 * Set fldca[FLDNO] and fldidx[FLDNO] accordingly.
547 * Return 1 on success, -1 on error.
550 deffld(int fldno, char *name, int idx)
552 struct castr *ca = ef_cadef(cur_type);
555 res = stmtch(name, ca, offsetof(struct castr, ca_name),
556 sizeof(struct castr));
558 return gripe("Header %s of field %d is %s", name, fldno + 1,
559 res == M_NOTUNIQUE ? "ambiguous" : "unknown");
560 if ((ca[res].ca_flags & NSC_EXTRA) || CANT_HAPPEN(ca[res].ca_get))
561 return gripe("Extraneous header %s in field %d", name, fldno + 1);
562 if (CA_IS_ARRAY(&ca[res])) {
564 return gripe("Header %s requires an index in field %d",
565 ca[res].ca_name, fldno + 1);
566 if (idx >= ca[res].ca_len)
567 return gripe("Header %s(%d) index out of bounds in field %d",
568 ca[res].ca_name, idx, fldno + 1);
569 if (idx < caflds[res])
570 return gripe("Duplicate header %s(%d) in field %d",
571 ca[res].ca_name, idx, fldno + 1);
572 if (idx > caflds[res])
573 return gripe("Expected header %s(%d) in field %d",
574 ca[res].ca_name, caflds[res], fldno + 1);
577 return gripe("Header %s doesn't take an index in field %d",
578 ca[res].ca_name, fldno + 1);
581 return gripe("Duplicate header %s in field %d",
582 ca[res].ca_name, fldno + 1);
584 fldca[fldno] = &ca[res];
591 * Check fields in xdump are sane.
592 * Return 0 on success, -1 on error.
597 struct castr *ca = ef_cadef(cur_type);
598 int i, len, cafldsmax, res = 0;
600 /* Record index must come first, to make cur_id work, see setnum() */
601 if (ca[0].ca_table == cur_type && caflds[0] && fldca[0] != &ca[0])
602 res = gripe("Header field %s must come first", ca[0].ca_name);
605 return res; /* table is split, another part expected */
607 /* Check for missing fields */
608 for (i = 0; ca[i].ca_name; i++) {
609 cafldsmax = MAX(caflds[i], cafldspp[i]);
610 if (ca[i].ca_flags & NSC_EXTRA)
612 len = CA_ARRAY_LEN(&ca[i]);
613 if (!len && !cafldsmax)
614 res = gripe("Header field %s missing", ca[i].ca_name);
615 else if (len && cafldsmax == len - 1)
616 res = gripe("Header field %s(%d) missing",
617 ca[i].ca_name, len - 1);
618 else if (len && cafldsmax < len - 1)
619 res = gripe("Header fields %s(%d) ... %s(%d) missing",
620 ca[i].ca_name, cafldsmax, ca[i].ca_name, len - 1);
627 * Get selector for field FLDNO.
628 * Assign the field's selector index to *IDX, unless it is null.
629 * Return the selector on success, null pointer on error.
631 static struct castr *
632 getfld(int fldno, int *idx)
634 if (fldno >= nflds) {
635 gripe("Too many fields, expected only %d", nflds);
638 if (CANT_HAPPEN(fldno < 0))
641 *idx = fldidx[fldno];
646 * Is a new value for field FLDNO required to match the old one?
649 fldval_must_match(int fldno)
651 struct castr *ca = ef_cadef(cur_type);
652 int i = fldca[fldno] - ca;
655 * Value must match if:
656 * it's for a const selector, unless the object is still blank, or
657 * it was already given in a previous part of a split table.
659 return (cur_id < old_nelem && (fldca[fldno]->ca_flags & NSC_CONST))
660 || fldidx[fldno] < cafldspp[i];
664 * Set value of field FLDNO in current object to DBL.
665 * Return 1 on success, -1 on error.
668 setnum(int fldno, double dbl)
675 ca = getfld(fldno, &idx);
680 if (partno == 0 && ca->ca_table == cur_type) {
681 /* Got record index */
684 return gripe("Field %d can't hold this value", fldno + 1);
685 if (tbl_skip_to_obj(next_id) < 0)
688 if (tbl_next_obj() < 0)
693 memb_ptr += ca->ca_off;
695 switch (ca->ca_type) {
697 old = ((signed char *)memb_ptr)[idx];
698 new = ((signed char *)memb_ptr)[idx] = (signed char)dbl;
701 old = ((unsigned char *)memb_ptr)[idx];
702 new = ((unsigned char *)memb_ptr)[idx] = (unsigned char)dbl;
705 old = ((short *)memb_ptr)[idx];
706 new = ((short *)memb_ptr)[idx] = (short)dbl;
709 old = ((unsigned short *)memb_ptr)[idx];
710 new = ((unsigned short *)memb_ptr)[idx] = (unsigned short)dbl;
713 old = ((int *)memb_ptr)[idx];
714 new = ((int *)memb_ptr)[idx] = (int)dbl;
717 old = ((long *)memb_ptr)[idx];
718 new = ((long *)memb_ptr)[idx] = (long)dbl;
721 old = ((coord *)memb_ptr)[idx];
722 /* FIXME use variant of xrel() that takes orig instead of nation */
723 if (old >= WORLD_X / 2)
725 new = ((coord *)memb_ptr)[idx] = XNORM((coord)dbl);
726 if (new >= WORLD_X / 2)
730 old = ((coord *)memb_ptr)[idx];
731 /* FIXME use variant of yrel() that takes orig instead of nation */
732 if (old >= WORLD_Y / 2)
734 new = ((coord *)memb_ptr)[idx] = YNORM((coord)dbl);
735 if (new >= WORLD_Y / 2)
739 old = ((float *)memb_ptr)[idx];
740 ((float *)memb_ptr)[idx] = (float)dbl;
741 new = dbl; /* suppress new != dbl check */
744 old = ((double *)memb_ptr)[idx];
745 ((double *)memb_ptr)[idx] = dbl;
746 new = dbl; /* suppress new != dbl check */
749 old = ((time_t *)memb_ptr)[idx];
750 new = ((time_t *)memb_ptr)[idx] = (time_t)dbl;
753 return gripe("Field %d doesn't take numbers", fldno + 1);
756 if (fldval_must_match(fldno) && old != dbl)
757 return gripe("Value for field %d must be %g", fldno + 1, old);
759 return gripe("Field %d can't hold this value", fldno + 1);
765 * Set value of field FLDNO in current object to STR.
766 * Return 1 on success, -1 on error.
769 setstr(int fldno, char *str)
772 int must_match, mismatch, idx;
774 char *memb_ptr, *old;
776 ca = getfld(fldno, &idx);
781 if (tbl_next_obj() < 0)
785 memb_ptr += ca->ca_off;
786 must_match = fldval_must_match(fldno);
789 switch (ca->ca_type) {
791 old = ((char **)memb_ptr)[idx];
793 mismatch = old ? !str || strcmp(old, str) : !!str;
795 /* FIXME may leak old value */
796 ((char **)memb_ptr)[idx] = str ? strdup(str) : NULL;
797 len = -1; /* unlimited */
800 if (CANT_HAPPEN(idx))
803 return gripe("Field %d doesn't take nil", fldno + 1);
804 /* Wart: if ca_len <= 1, the terminating null may be omitted */
806 len = sz > 1 ? sz - 1 : sz;
807 if (strlen(str) > len)
808 return gripe("Field %d takes at most %d characters",
809 fldno + 1, (int)len);
812 mismatch = !str || strncmp(old, str, len);
814 strncpy(memb_ptr, str, sz);
817 return gripe("Field %d doesn't take strings", fldno + 1);
822 return gripe("Value for field %d must be \"%.*s\"",
823 fldno + 1, (int)len, old);
825 return gripe("Value for field %d must be nil", fldno + 1);
832 * Resolve symbol name ID in table referred to by CA.
833 * Use field number N for error messages.
834 * Return index in referred table on success, -1 on failure.
837 xunsymbol(char *id, struct castr *ca, int n)
839 int i = ef_elt_byname(ca->ca_table, id);
841 return gripe("%s %s symbol `%s' in field %d",
842 i == M_NOTUNIQUE ? "Ambiguous" : "Unknown",
843 ca->ca_name, id, n + 1);
848 * Map symbol index to symbol value.
849 * CA is the table, and I is the index in it.
852 symval(struct castr *ca, int i)
854 int type = ca->ca_table;
856 if (type != EF_BAD && ef_cadef(type) == symbol_ca)
857 /* symbol table, value is in the table */
858 return ((struct symbol *)ef_ptr(type, i))->value;
859 /* value is the table index */
864 * Set value of field FLDNO in current object to value of symbol SYM.
865 * Return 1 on success, -1 on error.
868 setsym(int fldno, char *sym)
873 ca = getfld(fldno, NULL);
877 if (ca->ca_table == EF_BAD || (ca->ca_flags & NSC_BITS))
878 return gripe("Field %d doesn't take symbols", fldno + 1);
880 i = xunsymbol(sym, ca, fldno);
883 return setnum(fldno, symval(ca, i));
887 * Create an empty symbol set for field FLDNO in *SET.
888 * Return 1 on success, -1 on error.
891 mtsymset(int fldno, long *set)
895 ca = getfld(fldno, NULL);
899 if (ca->ca_table == EF_BAD || ef_cadef(ca->ca_table) != symbol_ca
900 || !(ca->ca_flags & NSC_BITS))
901 return gripe("Field %d doesn't take symbol sets", fldno + 1);
907 * Add a symbol to a symbol set for field FLDNO in *SET.
908 * SYM is the name of the symbol to add.
909 * Return 1 on success, -1 on error.
912 add2symset(int fldno, long *set, char *sym)
917 ca = getfld(fldno, NULL);
921 i = xunsymbol(sym, ca, fldno);
924 *set |= symval(ca, i);
929 * Read an xdump table header line from FP.
930 * Expect header for EXPECTED_TABLE, unless it is EF_BAD.
931 * Recognize header for machine- and human-readable syntax, and set
933 * Return table type on success, -2 on EOF before header, -1 on failure.
936 xuheader(FILE *fp, int expected_table)
942 while ((ch = skipfs(fp)) == '\n')
944 if (ch == EOF && expected_table == EF_BAD)
951 ? fscanf(fp, "config%*[ \t]%63[^ \t#\n]%n", name, &res) != 1
952 : fscanf(fp, "XDUMP%*[ \t]%63[^ \t#\n]%*[ \t]%*[^ \t#\n]%n",
953 name, &res) != 1) || res < 0)
954 return gripe("Expected xdump header");
956 type = ef_byname(name);
958 return gripe("Unknown table `%s'", name);
959 if (expected_table != EF_BAD && expected_table != type)
960 return gripe("Expected table `%s', not `%s'",
961 ef_nameof(expected_table), name);
963 if (!empfile[type].file
964 || !ef_cadef(type) || !(ef_flags(type) & EFF_MEM)) {
965 CANT_HAPPEN(expected_table != EF_BAD);
966 return gripe("Table `%s' is not permitted here", name);
969 if (skipfs(fp) != '\n')
970 return gripe("Junk after xdump header");
977 * Find fields in this xdump.
978 * If reading human-readable syntax, read a field header line from FP.
979 * Else take fields from the table's selectors in CA[].
980 * Set ellipsis, nflds, fldca[], fldidx[] and caflds[] accordingly.
981 * Return 0 on success, -1 on failure.
984 xufldhdr(FILE *fp, struct castr ca[])
990 for (i = 0; ca[i].ca_name; i++)
995 while ((ch = skipfs(fp)) == '\n')
998 nflds = xuflds(fp, xufldname);
1001 nflds -= ellipsis != 0;
1006 for (i = 0; ca[i].ca_name; i++) {
1007 if ((ca[i].ca_flags & NSC_EXTRA))
1009 n = CA_ARRAY_LEN(&ca[i]);
1017 nflds = fidx - fldidx;
1024 * Read xdump footer from FP.
1025 * CA[] contains the table's selectors.
1026 * The body had RECS records.
1027 * Update cafldspp[] from caflds[].
1028 * Return 0 on success, -1 on failure.
1031 xufooter(FILE *fp, struct castr ca[], int recs)
1037 if (fscanf(fp, "config%n", &res) != 0 || res < 0)
1038 return gripe("Malformed table footer");
1040 if (fscanf(fp, "%d", &n) != 1)
1041 return gripe("Malformed table footer");
1043 return gripe("Read %d rows, which doesn't match footer "
1044 "%d rows", recs, n);
1046 if (skipfs(fp) != '\n')
1047 return gripe("Junk after table footer");
1048 if (tbl_part_done() < 0)
1052 for (i = 0; ca[i].ca_name; i++) {
1053 if (cafldspp[i] < caflds[i])
1054 cafldspp[i] = caflds[i];
1061 * Read an xdump table from FP.
1062 * Both machine- and human-readable xdump syntax are recognized.
1063 * Expect table EXPECTED_TABLE, unless it is EF_BAD.
1064 * Report errors to stderr.
1065 * Messages assume FP starts in the file FILE at line *PLNO.
1066 * Update *PLNO to reflect lines read from FP.
1067 * Return table type on success, -2 on EOF before header, -1 on failure.
1070 xundump(FILE *fp, char *file, int *plno, int expected_table)
1073 int type, nca, nf, i, ch;
1078 if ((type = xuheader(fp, expected_table)) < 0)
1081 ca = ef_cadef(type);
1082 if (CANT_HAPPEN(!ca))
1086 for (i = 0; ca[i].ca_name; i++) {
1088 if (!(ca[i].ca_flags & NSC_EXTRA))
1089 nf += MAX(1, CA_ARRAY_LEN(&ca[i]));
1091 fldca = malloc(nf * sizeof(*fldca));
1092 fldidx = malloc(nf * sizeof(*fldidx));
1093 caflds = malloc(nca * sizeof(*caflds));
1094 cafldspp = calloc(nca, sizeof(*cafldspp));
1097 if (xutail(fp, ca) < 0)
1106 /* Skip empty lines so that callers can easily check for EOF */
1107 while ((ch = skipfs(fp)) == '\n')
1116 * Read the remainder of an xdump after the table header line from FP.
1117 * CA[] contains the table's selectors.
1118 * Return 0 on success, -1 on failure.
1121 xutail(FILE *fp, struct castr *ca)
1126 if (xufldhdr(fp, ca) < 0)
1128 if ((recs = xubody(fp)) < 0)
1130 if (xufooter(fp, ca, recs) < 0)
1134 if (xuheader(fp, cur_type) < 0)
1140 * Read the body of an xdump table from FP.
1141 * Return number of rows read on success, -1 on failure.
1149 while ((ch = skipfs(fp)) == '\n')
1154 if (xuflds(fp, xufld) < 0)