/*
* Empire - A multi-player, client/server Internet based war game.
- * Copyright (C) 1986-2008, Dave Pare, Jeff Bailey, Thomas Ruschak,
- * Ken Stevens, Steve McClure
+ * Copyright (C) 1986-2011, Dave Pare, Jeff Bailey, Thomas Ruschak,
+ * Ken Stevens, Steve McClure, Markus Armbruster
*
- * This program is free software; you can redistribute it and/or modify
+ * Empire is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
+ * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* ---
*
* ---
*
* xdump.c: Extended dump
- *
- * Known contributors to this file:
- * Markus Armbruster, 2004-2008
- */
-
-/*
- * Dump everything under the sun
*
- * Static game data (configuration):
- * - Item characteristics: ichr[]
- * - Land unit characteristics: lchr[]
- * - Nuke characteristics: nchr[]
- * - Plane characteristics: plchr[]
- * - Product characteristics: pchr[]
- * - Sector designation characteristics: dchr[]
- * - Sector infrastructure characteristics: intrchr[]
- * - Ship characteristics: mchr[]
- * - News item characteristics: rpt[]
- * - News page headings: page_headings[]
- * - Commands: player_coms[] (TODO)
- * - Update schedule: update_time[] (not really static)
- * - Configuration: configkeys[]
- *
- * Dynamic game data:
- * - Sectors: EF_SECTOR (superseding dump)
- * - Land units: EF_LAND (superseding ldump)
- * - Lost: EF_LOST (superseding lost)
- * - Nukes: EF_NUKE (superseding ndump)
- * - Planes: EF_PLANE (superseding pdump)
- * - Ships: EF_SHIP (superseding sdump)
- * - News: EF_NEWS
- * - Treaties: EF_TREATY
- * - Power: EF_POWER (TODO)
- * - Nations: EF_NATION
- * - Loans: EF_LOAN
- * - Map: EF_MAP (TODO)
- * - Bmap: EF_BMAP (TODO)
- * - Market: EF_COMM
- */
-
-/*
- * See doc/xdump for motivation, syntax, semantics, and rationale.
- * Make sure to keep it up-to-date!
+ * Known contributors to this file:
+ * Markus Armbruster, 2004-2011
*/
-/* TODO don't dump stuff that's useless due to options */
-
#include <config.h>
#include <ctype.h>
-#include <stddef.h>
#include "commands.h"
#include "empobj.h"
-#include "match.h"
#include "news.h"
#include "optlist.h"
-#include "treaty.h"
#include "version.h"
-
-/* xdump descriptor */
-struct xdstr {
- natid cnum; /* dump for this country */
- int divine; /* is this a deity dump? */
- void (*pr)(char *fmt, ...); /* callback for printing dump */
-};
-
-/*
- * Initialize XD to dump for country CNUM.
- * Dump is to be delivered through callback PR.
- * Return XD.
- */
-static struct xdstr *
-xdinit(struct xdstr *xd, natid cnum, void (*pr)(char *fmt, ...))
-{
- xd->cnum = cnum;
- xd->divine = getnatp(cnum)->nat_stat == STAT_GOD;
- xd->pr = pr;
- return xd;
-}
-
-/*
- * Evaluate a attribute of an object into VAL, return VAL.
- * CA describes the attribute.
- * XD is the xdump descriptor.
- * PTR points to the context object.
- * IDX is the index within the attribute.
- */
-static struct valstr *
-xdeval(struct valstr *val, struct xdstr *xd,
- struct castr *ca, void *ptr, int idx)
-{
- nstr_mksymval(val, ca, idx);
- return nstr_exec_val(val, xd->cnum, ptr, NSC_NOTYPE);
-}
-
-/*
- * Dump VAL prefixed with SEP, return " ".
- * VAL must be evaluated.
- */
-static char *
-xdprval(struct xdstr *xd, struct valstr *val, char *sep)
-{
- unsigned char *s, *e, *l;
-
- if (CANT_HAPPEN(val->val_cat != NSC_VAL)) {
- xd->pr("%snil", sep);
- return " ";
- }
-
- switch (val->val_type) {
- case NSC_LONG:
- xd->pr("%s%ld", sep, val->val_as.lng);
- break;
- case NSC_DOUBLE:
- xd->pr("%s%#g", sep, val->val_as.dbl);
- break;
- case NSC_STRING:
- s = (unsigned char *)val->val_as.str.base;
- if (s) {
- xd->pr("%s\"", sep);
- l = s + val->val_as.str.maxsz;
- /* FIXME maxsz == INT_MAX ! */
- for (;;) {
- for (e = s;
- e < l && *e != '"' && *e != '\\' && isgraph(*e);
- ++e)
- ;
- xd->pr("%.*s", (int)(e-s), s);
- if (e < l && *e)
- xd->pr("\\%03o", *e++);
- else
- break;
- s = e;
- }
- xd->pr("\"");
- } else
- xd->pr("%snil", sep);
- break;
- default:
- CANT_REACH();
- xd->pr("%snil", sep);
- }
- return " ";
-}
-
-/*
- * Dump field values of a context object to XD.
- * CA[] describes fields.
- * PTR points to context object.
- */
-static void
-xdflds(struct xdstr *xd, struct castr ca[], void *ptr)
-{
- int i, j, n;
- struct valstr val;
- char *sep = "";
-
- for (i = 0; ca[i].ca_name; ++i) {
- if (ca[i].ca_flags & NSC_DEITY && !xd->divine)
- continue;
- if (ca[i].ca_flags & NSC_EXTRA)
- continue;
- n = ca[i].ca_type != NSC_STRINGY ? ca[i].ca_len : 0;
- j = 0;
- do {
- xdeval(&val, xd, &ca[i], ptr, j);
- sep = xdprval(xd, &val, sep);
- } while (++j < n);
- }
-}
-
-/*
- * Dump header for dump NAME.
- * If META, it's for the meta-data dump rather than the data dump.
- */
-static void
-xdhdr(struct xdstr *xd, char *name, int meta)
-{
- xd->pr("XDUMP %s%s %ld\n", meta ? "meta " : "", name, (long)time(NULL));
-}
-
-/* Dump footer for a dump that dumped N objects. */
-static void
-xdftr(struct xdstr *xd, int n)
-{
- xd->pr("/%d\n", n);
-}
+#include "xdump.h"
/*
* Is object P of type TYPE visible to the player?
}
/*
- * Dump items of type TYPE selected by ARG to XD.
- * Return RET_OK on success, RET_SYN on error.
+ * Dump meta-data for items of type TYPE to XD.
+ * Return RET_SYN when TYPE doesn't have meta-data, else RET_OK.
*/
static int
-xditem(struct xdstr *xd, int type, char *arg)
+xdmeta(struct xdstr *xd, int type)
{
- struct castr *ca;
- struct nstr_item ni;
- int n;
- char buf[2048]; /* FIXME buffer size? */
+ struct castr *ca = ef_cadef(type);
+ int i;
+ int n = 0;
- ca = ef_cadef(type);
if (!ca)
return RET_SYN;
- if (!snxtitem(&ni, type, arg))
- return RET_SYN;
-
- xdhdr(xd, ef_nameof(type), 0);
+ xdhdr(xd, ef_nameof(type), 1);
+ xdcolhdr(xd, ca);
- n = 0;
- while (nxtitem(&ni, buf)) {
- if (!xdvisible(type, buf))
+ for (i = 0; ca[i].ca_name; i++) {
+ if (ca[i].ca_flags & NSC_DEITY && !xd->divine)
continue;
- ++n;
- xdflds(xd, ca, buf);
+ if (ca[i].ca_flags & NSC_EXTRA)
+ continue;
+ xdflds(xd, mdchr_ca, &ca[i]);
xd->pr("\n");
+ n++;
}
xdftr(xd, n);
}
/*
- * Dump meta-data for items of type TYPE to XD.
- * Return RET_OK.
+ * Dump items of type TYPE selected by ARG to XD.
+ * Return RET_OK on success, RET_SYN on error.
*/
static int
-xdmeta(struct xdstr *xd, int type)
+xditem(struct xdstr *xd, int type, char *arg)
{
- struct castr *ca = ef_cadef(type);
- int i;
- int n = 0;
+ struct castr *ca;
+ struct nstr_item ni;
+ int n;
+ char buf[2048]; /* FIXME buffer size? */
+ ca = ef_cadef(type);
if (!ca)
return RET_SYN;
- xdhdr(xd, ef_nameof(type), 1);
+ if (!snxtitem(&ni, type, arg, NULL))
+ return RET_SYN;
- for (i = 0; ca[i].ca_name; i++) {
- if (ca[i].ca_flags & NSC_DEITY && !xd->divine)
- continue;
- if (ca[i].ca_flags & NSC_EXTRA)
+ xdhdr(xd, ef_nameof(type), 0);
+
+ n = 0;
+ while (nxtitem(&ni, buf)) {
+ if (!xdvisible(type, buf))
continue;
- xdflds(xd, mdchr_ca, &ca[i]);
+ ++n;
+ xdflds(xd, ca, buf);
xd->pr("\n");
- n++;
}
xdftr(xd, n);
if (!p || !*p)
return RET_SYN;
- xdinit(&xd, player->cnum, pr);
+ xdinit(&xd, player->cnum, 0, pr);
natp = getnatp(player->cnum);
type = isdigit(p[0]) ? atoi(p) : ef_byname(p);
if (type < 0 || type >= EF_MAX)
pr("Access to table %s denied\n", ef_nameof(type));
return RET_FAIL;
}
- if (type == EF_VERSION && !player->argp[2])
- return xditem(&xd, type, "*"); /* backward compatibility */
return xditem(&xd, type, player->argp[2]);
}