2 * Empire - A multi-player, client/server Internet based war game.
3 * Copyright (C) 1986-2008, Dave Pare, Jeff Bailey, Thomas Ruschak,
4 * Ken Stevens, Steve McClure
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.
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, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
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.
28 * prototypes.h: Prototypes for server functions
30 * Known contributors to this file:
32 * Steve McClure, 1998,2000
47 /* src/server/main.c */
48 extern void shutdwn(int sig);
49 extern void init_server(unsigned);
50 extern void start_server(int);
51 extern void finish_server(void);
53 /* src/lib/empthread/lwp.c */
57 * src/lib/commands/ *.c
59 extern int check_market(void);
60 extern void gift(natid, natid, void *, char *);
61 extern int display_mark(i_type, int);
62 extern int want_to_abandon(struct sctstr *, i_type, int, struct lndstr *);
63 extern int would_abandon(struct sctstr *, i_type, int, struct lndstr *);
64 extern int nav_map(int, int, int);
65 extern int do_unit_move(struct emp_qelem *land_list, int *together,
66 double *minmob, double *maxmob);
67 extern int count_pop(int);
68 extern int scuttle_tradeship(struct shpstr *, int);
69 extern void resnoise(struct sctstr *sptr, int public_amt, char *name,
71 extern int line_of_sight(char **rad, int ax, int ay, int bx, int by);
72 extern void plane_sona(struct emp_qelem *, int, int, struct shiplist **);
73 extern char *prsub(struct shpstr *);
74 extern int check_trade(void);
75 extern int ontradingblock(int, void *);
76 extern void trdswitchown(int, void *, int);
77 extern int do_look(short);
78 extern int radar(short);
79 extern void update_power(void);
255 * src/lib/common/ *.c
258 extern char *bestownedpath(char *, char *, int, int, int, int, int);
260 extern int read_builtin_tables(void);
261 extern int read_custom_tables(void);
263 extern int cnumb(char *);
267 extern int emp_config(char *file);
268 extern void print_config(FILE * fp);
270 extern double hap_fact(struct natstr *, struct natstr *);
271 extern double hap_req(struct natstr *np);
273 extern int is_wday_allowed(int, char *);
274 extern int is_daytime_allowed(int, char *);
275 extern int gamehours(time_t);
277 extern int loginit(char *);
278 extern int logreopen(void);
279 extern void logerror(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
282 extern int deltax(int, int);
283 extern int deltay(int, int);
284 extern int mapdist(int, int, int, int);
290 extern void bp_enable_cachepath(void);
291 extern void bp_disable_cachepath(void);
292 extern void bp_clear_cachepath(void);
293 extern char *BestDistPath(char *, struct sctstr *, struct sctstr *,
295 extern char *BestLandPath(char *, struct sctstr *, struct sctstr *,
297 extern char *BestShipPath(char *, int, int, int, int, int);
298 extern char *BestAirPath(char *, int, int, int, int);
299 extern double pathcost(struct sctstr *, char *, int);
301 extern int read_schedule(char *, time_t[], int, time_t, time_t);
303 extern int max_population(float, int, int);
304 extern int max_pop(float, struct sctstr *);
308 extern int sct_typematch(char *);
310 extern int demand_update_want(int *, int *, int);
311 extern int demand_check(void);
312 extern int demandupdatecheck(void);
313 /* xdump.c xundump.c */
320 extern char *fnameat(const char *, const char *);
321 extern FILE *fopenat(const char *, const char *, const char *);
323 extern int fsize(int);
324 extern int blksize(int);
325 extern time_t fdate(int);
327 extern int roll(int);
328 extern int roundavg(double);
329 extern int chance(double);
330 extern int disassoc(void);
331 extern char *effadv(int);
332 extern int parse(char *, char *, char **, char **, char **, char **);
333 extern int ldround(double, int);
334 extern int roundintby(int, int);
335 extern int scthash(int, int, int);
336 extern int tcp_listen(char *, char *, size_t *);
337 extern char *numstr(char buf[], int n);
339 extern char *esplur(int n);
340 extern char *splur(int n);
341 extern char *iesplur(int n);
342 extern char *plurize(char *buf, int max_len, int n);
346 * src/lib/global/ *.c
348 extern void global_init(void);
352 * src/lib/player/ *.c
355 extern void player_init(void);
356 extern struct player *player_new(int);
357 extern struct player *player_delete(struct player *);
358 extern struct player *player_next(struct player *);
359 extern struct player *player_prev(struct player *);
360 extern struct player *getplayer(natid);
361 extern void player_accept(void *);
363 extern int dispatch(char *, char *);
365 extern int getcommand(char *);
366 extern void init_player_commands(void);
367 extern void log_last_commands(void);
368 extern int gamedown(void);
369 extern void update_timeused_login(time_t now);
370 extern void update_timeused(time_t now);
371 extern void enforce_minimum_session_time(void);
372 extern int may_play_now(struct natstr *natp, time_t current_time,
373 int suppress_deity_message);
374 /* more under Commands */
377 extern int init_nats(void);
378 extern int player_set_nstat(struct player *, struct natstr *);
380 extern void player_login(void *);
382 extern int natbyname(char *, natid *);
383 extern int natpass(int, char *);
385 extern struct player *player; /* current player's context */
386 extern char *praddr(struct player *);
387 extern void player_main(struct player *);
388 /* more under Commands */
390 extern int recvclient(char *, int);
393 extern void stop_service(void);
394 /* more in service.h */
400 extern int confirm(char *);
401 extern int askyn(char *);
403 extern void bridge_damaged(struct sctstr *);
404 extern void bridgefall(struct sctstr *);
406 extern void bsanct(void);
408 extern void caploss(struct sctstr *, natid, char *);
410 extern int check_sect_ok(struct sctstr *);
411 extern int check_ship_ok(struct shpstr *);
412 extern int check_land_ok(struct lndstr *);
413 extern int check_nuke_ok(struct nukstr *);
414 extern int check_plane_ok(struct plnstr *);
415 extern int check_comm_ok(struct comstr *);
416 extern int check_loan_ok(struct lonstr *);
417 extern int check_trade_ok(struct trdstr *);
419 extern void set_coastal(struct sctstr *, int, int);
421 extern int military_control(struct sctstr *);
423 extern void landdamage(struct lndstr *, int);
424 extern void ship_damage(struct shpstr *, int);
425 extern int damage(int, int);
426 extern void shipdamage(struct shpstr *, int);
427 extern void land_damage(struct lndstr *, int);
428 extern void planedamage(struct plnstr *, int);
429 extern int nukedamage(struct nchrstr *, int, int);
430 extern int effdamage(int, int);
431 extern void item_damage(int, short *);
432 extern int commdamage(int, int, i_type);
434 extern int detonate(struct nukstr *, coord, coord, int);
436 extern int disloan(int, struct lonstr *);
438 extern int distrea(int, struct trtstr *);
440 extern void ef_init_srv(void);
441 extern void ef_fin_srv(void);
443 extern int sd(natid, natid, coord, coord, int, int, int);
444 extern int dd(natid, natid, coord, coord, int, int);
445 extern int shipdef(natid, natid, coord, coord);
447 extern int emp_getbit(int, int, unsigned char *);
448 extern void emp_setbit(int, int, unsigned char *);
449 extern void bitinit2(struct nstr_sect *, unsigned char *, int);
451 extern int getele(char *, char *);
453 extern char *prland(struct lndstr *);
454 extern void lnd_oninit(void *);
455 extern void lnd_postread(int, void *);
456 extern void lnd_prewrite(int, void *, void *);
458 extern double seagun(int, int);
459 extern double fortgun(int, int);
460 extern double landunitgun(int, int);
461 extern double torprange(struct shpstr *);
462 extern double fortrange(struct sctstr *);
463 extern int roundrange(double);
465 extern int shipsatxy(coord, coord, int, int, int);
466 extern int carriersatxy(coord, coord, natid);
467 extern int unitsatxy(coord, coord, int, int);
468 extern int planesatxy(coord, coord, int, int);
469 extern int asw_shipsatxy(coord, coord, int, int, struct plnstr *,
471 extern int has_units(coord, coord, natid, struct lndstr *);
472 extern int adj_units(coord, coord, natid);
473 extern int islist(char *);
475 extern int do_map(int bmap, int unit_type, char *arg1, char *arg2);
476 extern int display_region_map(int bmap, int unit_type, coord curx,
477 coord cury, char *arg);
478 extern int bmaps_intersect(natid, natid);
479 extern int share_bmap(natid, natid, struct nstr_sect *, char, char *);
481 extern char *mission_name(short);
482 extern int collateral_damage(coord, coord, int);
483 extern int mission_pln_equip(struct plist *, struct ichrstr *, int, char);
484 extern int ground_interdict(coord, coord, natid, char *);
485 extern int unit_interdict(coord, coord, natid, char *, int, int);
486 extern int off_support(coord, coord, natid, natid);
487 extern int def_support(coord, coord, natid, natid);
488 extern int oprange(struct empobj *);
489 extern int in_oparea(struct empobj *, coord, coord);
490 extern int cando(int, int);
492 extern int check_lmines(coord, coord, double);
493 extern int move_ground(struct sctstr *, struct sctstr *,
495 int (*)(coord, coord, char *),
497 extern int fly_map(coord, coord);
499 extern int msl_intercept(coord, coord, natid, int, int, int, int);
500 extern int msl_equip(struct plnstr *, char);
501 extern int msl_hit(struct plnstr *, int, int, int, int, char *,
503 extern void msl_sel(struct emp_qelem *, coord, coord, natid, int,
505 extern int msl_launch_mindam(struct emp_qelem *, coord, coord, int,
506 int, int, char *, int, int);
508 extern int comtch(char *, struct cmndstr *, int);
510 extern struct natstr *natargp(char *, char *);
511 extern int natarg(char *, char *);
513 extern int neigh(coord, coord, natid);
515 extern void delete_old_news(void);
516 extern void init_nreport(void);
517 extern void nreport(natid, int, natid, int);
519 extern char *prnuke(struct nukstr *);
520 extern void nuk_oninit(void *);
521 extern void nuk_postread(int, void *);
522 extern void nuk_prewrite(int, void *, void *);
524 extern int nxtitem(struct nstr_item *, void *);
526 extern int nxtsct(struct nstr_sect *, struct sctstr *);
528 extern int onearg(char *, char *);
530 extern char *prplane(struct plnstr *);
531 extern void pln_oninit(void *);
532 extern void pln_postread(int, void *);
533 extern void pln_prewrite(int, void *, void *);
535 extern int get_planes(struct nstr_item *, struct nstr_item *,
537 extern struct sctstr *get_assembly_point(char *, struct sctstr *, char *);
538 extern int pln_onewaymission(struct sctstr *, int *, int *);
539 extern int pln_oneway_to_carrier_ok(struct emp_qelem *,
540 struct emp_qelem *, int);
541 extern void pln_newlanding(struct emp_qelem *, coord, coord, int);
542 extern int could_be_on_ship(struct plnstr *, struct shpstr *,
544 extern int put_plane_on_ship(struct plnstr *, struct shpstr *);
545 extern void pln_dropoff(struct emp_qelem *, struct ichrstr *,
547 extern void pln_mine(struct emp_qelem *, coord, coord);
548 extern int pln_capable(struct plnstr *, int, int);
549 extern int pln_airbase_ok(struct plnstr *, int, int);
550 extern int carrier_planes(struct shpstr *, int);
551 extern void pln_sel(struct nstr_item *, struct emp_qelem *,
552 struct sctstr *, int, int, int, int);
553 extern void pln_arm(struct emp_qelem *, int, char, struct ichrstr *, int);
554 extern int pln_mobcost(int, struct plnstr *, int);
555 extern void pln_put(struct emp_qelem *);
556 extern void pln_put1(struct plist *);
557 extern void plane_sweep(struct emp_qelem *, coord, coord);
558 extern int put_plane_on_land(struct plnstr *, struct lndstr *);
559 extern int pln_hitchance(struct plnstr *, int, int);
560 extern int pln_damage(struct plnstr *, coord, coord, char, int *, int);
561 extern int pln_identchance(struct plnstr *, int, int);
562 extern int pln_is_in_orbit(struct plnstr *);
563 extern void pln_set_tech(struct plnstr *, int);
565 extern void pr(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
566 extern void uprnf(char *buf);
567 extern void pr_id(struct player *, int, char *, ...)
568 ATTRIBUTE((format (printf, 3, 4)));
569 extern void pr_flash(struct player *, char *, ...)
570 ATTRIBUTE((format (printf, 2, 3)));
571 extern void pr_inform(struct player *, char *, ...)
572 ATTRIBUTE((format (printf, 2, 3)));
573 extern void pr_wall(char *, ...)
574 ATTRIBUTE((format (printf, 1, 2)));
575 extern void prredir(char *redir);
576 extern void prexec(char *file);
577 extern void prprompt(int min, int btu);
578 extern int prmptrd(char *prompt, char *str, int size);
579 extern int uprmptrd(char *prompt, char *str, int size);
580 extern void prdate(void);
581 extern void prxy(char *format, coord x, coord y, natid country);
582 extern void PR(int, char *, ...) ATTRIBUTE((format (printf, 2, 3)));
583 extern void PRdate(natid cn);
584 extern void pr_beep(void);
585 extern void mpr(int, char *, ...) ATTRIBUTE((format (printf, 2, 3)));
586 extern size_t copy_ascii_no_funny(char *, char *);
587 extern size_t copy_utf8_no_funny(char *, char *);
588 extern size_t copy_utf8_to_ascii_no_funny(char *, char *);
589 extern int ufindpfx(char *, int);
592 extern int deltx(struct range *, coord);
593 extern int delty(struct range *, coord);
594 extern void radmap(int, int, int, int, double);
595 extern void radmapnopr(int, int, int, int, double);
596 extern void radmapupd(int, int, int, int, int, double);
598 extern int setrel(natid, natid, int);
599 extern int setcont(natid, natid, int);
600 extern int setrej(natid, natid, int, int);
602 extern void retreat_ship(struct shpstr *, char);
603 extern void retreat_land(struct lndstr *, char);
604 extern int check_retreat_and_do_shipdamage(struct shpstr *, int);
605 extern int check_retreat_and_do_landdamage(struct lndstr *, int);
607 extern enum ns_seltype sarg_type(char *);
608 extern int sarg_xy(char *, coord *, coord *);
609 extern int sarg_area(char *, struct range *);
610 extern int sarg_range(char *, coord *, coord *, int *);
611 extern int sarg_list(char *, int *, int);
613 extern void satdisp_sect(struct sctstr *, int);
614 extern void satdisp_units(coord, coord);
615 extern void satmap(int, int, int, int, int, int);
616 extern void sathead(void);
618 extern void sct_postread(int, void *);
619 extern void sct_prewrite(int, void *, void *);
620 extern void item_prewrite(short *);
621 extern int issector(char *);
623 extern int sect_damage(struct sctstr *, int);
624 extern int sectdamage(struct sctstr *, int);
626 extern char *prship(struct shpstr *);
627 extern void shp_postread(int, void *);
628 extern void shp_prewrite(int, void *, void *);
630 extern void show_bridge(int);
631 extern void show_tower(int);
632 extern void show_nuke_stats(int);
633 extern void show_nuke_capab(int);
634 extern void show_nuke_build(int);
635 extern void show_ship_build(int);
636 extern void show_ship_stats(int);
637 extern void show_ship_capab(int);
638 extern void show_plane_stats(int);
639 extern void show_plane_capab(int);
640 extern void show_plane_build(int);
641 extern void show_land_build(int);
642 extern void show_land_capab(int);
643 extern void show_land_stats(int);
644 extern void show_sect_build(int);
645 extern void show_sect_stats(int);
646 extern void show_sect_capab(int);
647 extern void show_item(int);
648 extern void show_news(int);
649 extern void show_product(int);
650 extern void show_updates(int);
652 extern void shp_sel(struct nstr_item *, struct emp_qelem *);
653 extern void shp_nav(struct emp_qelem *, double *, double *, int *, natid);
654 extern int shp_sweep(struct emp_qelem *, int, int, natid);
655 extern int shp_check_nav(struct sctstr *, struct shpstr *);
656 extern int sect_has_dock(struct sctstr *);
657 extern int shp_hardtarget(struct shpstr *);
658 extern int shp_nav_one_sector(struct emp_qelem *, int, natid, int);
659 extern int shp_missile_defense(coord, coord, natid, int);
660 extern void shp_missdef(struct shpstr *, natid);
661 extern double shp_mobcost(struct shpstr *);
662 extern void shp_set_tech(struct shpstr *, int);
664 extern int snxtitem(struct nstr_item *, int, char *, char *);
665 extern void snxtitem_area(struct nstr_item *, int,
667 extern void snxtitem_dist(struct nstr_item *, int, int, int, int);
668 extern void snxtitem_xy(struct nstr_item *, int, coord, coord);
669 extern void snxtitem_all(struct nstr_item *, int);
670 extern void snxtitem_group(struct nstr_item *, int, char);
671 extern void snxtitem_rewind(struct nstr_item *);
672 extern int snxtitem_list(struct nstr_item *, int, int *, int);
673 extern void snxtitem_cargo(struct nstr_item *, int, int, int);
675 extern int snxtsct(struct nstr_sect *, char *);
676 extern void snxtsct_area(struct nstr_sect *, struct range *);
677 extern void xydist_range(coord, coord, int, struct range *);
678 extern void xysize_range(struct range *);
679 extern void snxtsct_all(struct nstr_sect *);
680 extern void snxtsct_rewind(struct nstr_sect *);
681 extern void snxtsct_dist(struct nstr_sect *, coord, coord, int);
683 extern void resupply_all(struct lndstr *);
684 extern void resupply_commod(struct lndstr *, i_type);
685 extern int supply_commod(int, int, int, i_type, int);
686 extern int has_supply(struct lndstr *);
688 extern void takeover_land(struct lndstr *, natid);
689 extern void takeover(struct sctstr *, natid);
690 extern void takeover_ship(struct shpstr *, natid);
691 extern void takeover_plane(struct plnstr *, natid);
694 extern int trechk(natid, natid, int);
698 extern void clear_telegram_is_new(natid);
699 extern int typed_wu(natid, natid, char *, int);
700 extern int wu(natid, natid, char *, ...) ATTRIBUTE((format (printf, 3, 4)));
703 * src/lib/update/ *.c
706 extern int age_people(int, int);
707 extern void age_levels(int);
709 extern void delete_old_announcements(void);
713 extern void dodeliver(struct sctstr *);
715 extern int dodistribute(struct sctstr *, int, char *, double, double);
717 extern void finish_sects(int);
719 extern int new_work(struct sctstr *, int);
720 extern int do_feed(struct sctstr *, struct natstr *, short *, int *, int);
721 extern int feed_people(short *, int);
722 extern double food_needed(short *, int);
723 extern int famine_victims(short *, int);
725 extern int prod_land(int, int, struct bp *, int);
731 extern void mob_sect(void);
732 extern void mob_ship(void);
733 extern void mob_land(void);
734 extern void mob_plane(void);
735 extern void sct_do_upd_mob(struct sctstr *sp);
736 extern void shp_do_upd_mob(struct shpstr *sp);
737 extern void lnd_do_upd_mob(struct lndstr *lp);
738 extern void pln_do_upd_mob(struct plnstr *pp);
740 extern void move_sat(struct plnstr *);
742 extern void prod_nat(int);
744 extern int nav_ship(struct shpstr *);
746 extern int load_it(struct shpstr *, struct sctstr *,
748 extern void unload_it(struct shpstr *);
750 extern void *nxtitemp(struct nstr_item *);
752 extern void do_plague(struct sctstr *, struct natstr *, int);
753 extern int plague_people(struct natstr *, short *, int *, int *, int);
755 extern int prod_plane(int, int, struct bp *, int);
757 extern void populace(struct natstr *, struct sctstr *, int);
758 extern int total_work(int, int, int, int, int, int);
760 extern void tax(struct sctstr *, struct natstr *, int, long *, int *,
762 extern int upd_slmilcosts(natid, int);
763 extern void prepare_sects(int, struct bp *);
764 extern int bank_income(struct sctstr *, int);
766 extern int produce(struct natstr *, struct sctstr *, short *, int, int,
768 extern double prod_eff(int, float);
770 extern int update_removewants(void);
772 extern void revolt(struct sctstr *);
773 extern void guerrilla(struct sctstr *);
775 extern void sail_ship(natid);
777 extern void do_fallout(struct sctstr *, int);
778 extern void spread_fallout(struct sctstr *, int);
779 extern void decay_fallout(struct sctstr *, int);
780 extern void produce_sect(int, int, struct bp *, long [][2]);
782 extern int prod_ship(int, int, struct bp *, int);