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
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
40 #include "empthread.h"
45 #include "commodity.h"
47 /* src/server/main.c */
48 extern void panic(int sig);
49 extern void shutdwn(int sig);
50 extern void init_server(void);
51 extern void start_server(int);
52 extern void finish_server(void);
54 /* src/lib/empthread/lwp.c */
58 * src/lib/commands/ *.c
60 extern int check_market(void);
61 extern int sendmessage(struct natstr *, struct natstr *, char *, int);
62 extern void gift(natid, natid, void *, int, char *);
63 extern int display_mark(i_type, int);
64 extern int want_to_abandon(struct sctstr *, i_type, int, struct lndstr *);
65 extern int would_abandon(struct sctstr *, i_type, int, struct lndstr *);
66 extern int nav_map(int, int, int);
67 extern int count_pop(int);
68 extern int scuttle_tradeship(struct shpstr *, int);
69 extern void scuttle_ship(struct shpstr *);
70 extern void resnoise(struct sctstr *sptr, int public_amt, char *name,
72 extern int line_of_sight(char **rad, int ax, int ay, int bx, int by);
73 extern void plane_sona(struct emp_qelem *, int, int, struct shiplist **);
74 extern char *prsub(struct shpstr *);
75 extern int check_trade(void);
76 extern int ontradingblock(int, void *);
77 extern void trdswitchown(int, void *, int);
254 * src/lib/common/ *.c
257 extern char *bestownedpath(char *, char *, int, int, int, int, int);
259 extern void bridgefall(struct sctstr *, struct emp_qelem *);
260 extern void knockdown(struct sctstr *, struct emp_qelem *);
262 extern void landdamage(struct lndstr *, int);
263 extern void ship_damage(struct shpstr *, int);
264 extern int damage(int, int);
265 extern void shipdamage(struct shpstr *, int);
266 extern void land_damage(struct lndstr *, int);
267 extern void planedamage(struct plnstr *, int);
268 extern int nukedamage(struct nchrstr *, int, int);
269 extern int effdamage(int, int);
270 extern void item_damage(int, short *);
271 extern int commdamage(int, int, i_type);
273 extern int check_sect_ok(struct sctstr *);
274 extern int check_ship_ok(struct shpstr *);
275 extern int check_land_ok(struct lndstr *);
276 extern int check_nuke_ok(struct nukstr *);
277 extern int check_plane_ok(struct plnstr *);
278 extern int check_comm_ok(struct comstr *);
279 extern int check_loan_ok(struct lonstr *);
280 extern int check_trade_ok(struct trdstr *);
282 extern int read_builtin_tables(void);
283 extern int read_custom_tables(void);
287 extern int fsize(int);
288 extern int blksize(int);
289 extern time_t fdate(int);
291 extern double hap_fact(struct natstr *, struct natstr *);
293 extern int is_wday_allowed(int, char *);
294 extern int is_daytime_allowed(int, char *);
295 extern int gamehours(time_t);
296 extern int is_daytime_near(int, char *, int);
297 extern int min_to_next_daytime(int, char *);
299 extern int has_units(coord, coord, natid, struct lndstr *);
300 extern int has_units_with_mob(coord, coord, natid);
301 extern int adj_units(coord, coord, natid);
302 extern int has_helpful_engineer(coord x, coord y, natid cn);
304 extern void loginit(char *);
305 extern void logerror(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
308 extern int draw_map(int, char, int, struct nstr_sect *);
309 extern int unit_map(int, int, struct nstr_sect *, char *);
310 extern int bmaps_intersect(natid, natid);
311 extern int share_bmap(natid, natid, struct nstr_sect *, char, char *);
317 extern void bp_enable_cachepath(void);
318 extern void bp_disable_cachepath(void);
319 extern void bp_clear_cachepath(void);
320 extern char *BestDistPath(char *, struct sctstr *, struct sctstr *,
322 extern char *BestLandPath(char *, struct sctstr *, struct sctstr *,
324 extern char *BestShipPath(char *, int, int, int, int, int);
325 extern char *BestAirPath(char *, int, int, int, int);
326 extern double pathcost(struct sctstr *, char *, int);
328 extern int max_population(float, int, int);
329 extern int max_pop(float, struct sctstr *);
331 extern int sect_damage(struct sctstr *, int, struct emp_qelem *);
332 extern int sectdamage(struct sctstr *, int, struct emp_qelem *);
336 extern int sct_typematch(char *);
337 extern int typematch(char *, int);
339 extern void update_policy_check(void);
340 extern int demand_update_want(int *, int *, int);
341 extern int demandupdatecheck(void);
342 extern int updatetime(time_t *);
343 extern void next_update_time(time_t *, time_t *, time_t *);
344 extern void next_update_check_time(time_t *, time_t *, time_t *);
345 extern int updates_disabled(void);
347 extern int xundump(FILE *, char *, int);
353 extern int emp_config(char *file);
354 extern void print_config(FILE * fp);
356 extern int roll(int);
357 extern int roundavg(double);
358 extern int chance(double);
359 extern int disassoc(void);
360 extern int diffx(int, int);
361 extern int diffy(int, int);
362 extern int deltax(int, int);
363 extern int deltay(int, int);
364 extern int mapdist(int, int, int, int);
365 extern char *effadv(int);
366 extern int onearg(char *, char *);
367 extern int parse(char *, char **, char **, char *, char **);
368 extern int ldround(double, int);
369 extern int roundintby(int, int);
370 extern int scthash(register int, register int, int);
371 extern int tcp_listen(char *, char *, size_t *);
372 extern char *numstr(char buf[], int n);
374 extern char *esplur(int n);
375 extern char *splur(int n);
376 extern char *iesplur(int n);
377 extern char *plurize(char *buf, int max_len, int n);
381 * src/lib/global/ *.c
383 extern void global_init(void);
387 * src/lib/player/ *.c
390 extern void player_init(void);
391 extern struct player *player_new(int);
392 extern struct player *player_delete(struct player *);
393 extern struct player *player_next(struct player *);
394 extern struct player *player_prev(struct player *);
395 extern struct player *getplayer(natid);
396 extern void player_wakeup_all(natid);
397 extern void player_wakeup(struct player *);
398 extern void player_accept(void *);
400 extern int dispatch(char *, char *);
402 extern int getcommand(char *);
403 extern void init_player_commands(void);
404 extern void log_last_commands(void);
405 extern int gamedown(void);
406 extern void daychange(time_t);
407 extern int getminleft(time_t, int);
408 /* more under Commands */
411 extern int init_nats(void);
413 extern void player_login(void *);
415 extern int natbyname(char *, natid *);
416 extern int natpass(int, char *);
418 extern struct player *player; /* current player's context */
419 extern char *praddr(struct player *);
420 extern void player_main(struct player *);
421 extern int command(void);
422 /* more under Commands */
424 extern int recvclient(char *, int);
427 extern void stop_service(void);
428 /* more in service.h */
434 extern int confirm(char *);
435 extern int askyn(char *);
437 extern void bsanct(void);
439 extern void caploss(struct sctstr *, natid, char *);
441 extern int chkmoney(long, long, char *);
442 extern int check_cost(int, int, long, int *, char *);
444 extern int cnumb(char *);
446 extern void set_coastal(struct sctstr *sp, int des);
448 extern int military_control(struct sctstr *);
450 extern int detonate(struct plnstr *, int, int);
452 extern int disloan(int, register struct lonstr *);
454 extern int distrea(int, register struct trtstr *);
456 extern void ef_init_srv(void);
457 extern void ef_fin_srv(void);
459 extern int sd(natid, natid, coord, coord, int, int, int);
460 extern int dd(natid, natid, coord, coord, int, int);
461 extern int sb(natid, natid, struct sctstr *, coord, coord, int, int);
462 extern int shipdef(natid, natid, coord, coord);
464 extern int emp_getbit(int, int, unsigned char *);
465 extern void emp_setbit(int, int, unsigned char *);
466 extern void emp_setbitmap(int, int, unsigned char *, int *);
467 extern void bitinit2(struct nstr_sect *, unsigned char *, int);
469 extern int getele(char *, char *);
471 extern char *prland(struct lndstr *);
472 extern int lnd_postread(int, void *);
473 extern int lnd_prewrite(int, void *);
474 extern void lnd_init(int, void *);
476 extern double seagun(int, int);
477 extern double landgun(int, int);
478 extern double landunitgun(int, int, int, int, int);
479 extern int roundrange(double);
481 extern int shipsatxy(coord, coord, int, int);
482 extern int carriersatxy(coord, coord, int, int, natid);
483 extern int unitsatxy(coord, coord, int, int);
484 extern int planesatxy(coord, coord, int, int, struct emp_qelem *);
485 extern int asw_shipsatxy(coord, coord, int, int, struct plnstr *,
487 extern int num_shipsatxy(coord, coord, int, int);
488 extern int islist(char *);
489 /* src/lib/subs/mission.c */
490 extern char *mission_name(short);
491 extern char *nameofitem(struct genitem *, int);
492 extern int collateral_damage(coord, coord, int, struct emp_qelem *);
493 extern int mission_pln_equip(struct plist *, struct ichrstr *, int, char);
494 extern int ground_interdict(coord, coord, natid, char *);
495 extern int unit_interdict(coord, coord, natid, char *, int, int);
496 extern int off_support(coord, coord, natid, natid);
497 extern int def_support(coord, coord, natid, natid);
498 extern int oprange(struct genitem *, int, int *);
499 extern int cando(int, int);
500 extern void show_mission(int, struct nstr_item *);
501 extern int air_defense(coord, coord, natid, struct emp_qelem *,
504 extern int check_lmines(coord, coord, double);
505 extern int move_ground(struct sctstr *, struct sctstr *,
507 int (*)(coord, coord, char *),
509 extern int fly_map(coord, coord);
511 extern int msl_intercept(coord, coord, natid, int, int, int, int);
512 extern int msl_equip(struct plnstr *);
513 extern int msl_hit(struct plnstr *, int, int, int, int, char *,
515 extern void msl_sel(struct emp_qelem *, coord, coord, natid, int,
517 extern int msl_launch_mindam(struct emp_qelem *, coord, coord, int,
518 int, int, char *, int, int);
520 extern int comtch(char *, struct cmndstr *, int);
522 extern struct natstr *natargp(char *, char *);
523 extern int natarg(char *, char *);
525 extern int neigh(coord, coord, natid);
527 extern void delete_old_news(void);
528 extern void init_nreport(void);
529 extern void nreport(natid, int, natid, int);
531 extern int nuk_postread(int, void *);
532 extern int nuk_prewrite(int, void *);
533 extern void nuk_init(int, void *);
534 extern void nuk_add(coord, coord, int, int);
535 extern void nuk_delete(struct nukstr *, int, int);
537 extern int nxtitem(struct nstr_item *, void *);
539 extern int nxtsct(struct nstr_sect *, struct sctstr *);
541 extern char *prplane(struct plnstr *);
542 extern int pln_postread(int, void *);
543 extern int pln_prewrite(int, void *);
544 extern void pln_init(int, void *);
546 extern void count_planes(struct shpstr *);
547 extern struct sctstr *get_assembly_point(char *, struct sctstr *, char *);
548 extern int pln_onewaymission(struct sctstr *, int *, int *);
549 extern int pln_oneway_to_carrier_ok(struct emp_qelem *,
550 struct emp_qelem *, int);
551 extern void pln_newlanding(struct emp_qelem *, coord, coord, int);
552 extern int can_be_on_ship(int, int);
553 extern int put_plane_on_ship(struct plnstr *, struct shpstr *);
554 extern void pln_dropoff(struct emp_qelem *, struct ichrstr *,
555 coord, coord, void *, int);
556 extern void pln_mine(struct emp_qelem *list, struct sctstr *sectp);
557 extern void pln_sel(struct nstr_item *, struct emp_qelem *,
558 struct sctstr *, int, int, int, int);
559 extern int pln_arm(struct emp_qelem *, int, char, struct ichrstr *,
561 extern int pln_mobcost(int, struct plnstr *, int);
562 extern void pln_put(struct emp_qelem *);
563 extern void pln_removedupes(struct emp_qelem *, struct emp_qelem *);
564 extern int take_plane_off_ship(struct plnstr *, struct shpstr *);
565 extern int take_plane_off_land(struct plnstr *, struct lndstr *);
566 extern void plane_sweep(struct emp_qelem *, coord, coord);
567 extern void count_land_planes(struct lndstr *);
568 extern int count_sect_planes(struct sctstr *);
569 extern int put_plane_on_land(struct plnstr *, struct lndstr *);
570 extern int pln_hitchance(struct plnstr *, int, int);
571 extern int pln_damage(struct plnstr *, coord, coord, char, int *, int);
572 extern int pln_identchance(struct plnstr *, int, int);
573 extern void pln_set_tech(struct plnstr *, int);
575 extern void pr(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
576 extern void uprnf(char *buf);
577 extern void pr_id(struct player *, int, char *, ...)
578 ATTRIBUTE((format (printf, 3, 4)));
579 extern void pr_flash(struct player *, char *, ...)
580 ATTRIBUTE((format (printf, 2, 3)));
581 extern void pr_inform(struct player *, char *, ...)
582 ATTRIBUTE((format (printf, 2, 3)));
583 extern void pr_wall(char *, ...)
584 ATTRIBUTE((format (printf, 1, 2)));
585 extern void prredir(char *redir);
586 extern void prexec(char *file);
587 extern void prprompt(int min, int btu);
588 extern int prmptrd(char *prompt, char *str, int size);
589 extern int uprmptrd(char *prompt, char *str, int size);
590 extern void prdate(void);
591 extern void prxy(char *format, coord x, coord y, natid country);
592 extern void PR(int, char *, ...) ATTRIBUTE((format (printf, 2, 3)));
593 extern void PRdate(natid cn);
594 extern void pr_beep(void);
595 extern void mpr(int, char *, ...) ATTRIBUTE((format (printf, 2, 3)));
596 extern size_t copy_ascii_no_funny(char *, char *);
597 extern size_t copy_utf8_no_funny(char *, char *);
598 extern size_t copy_utf8_to_ascii_no_funny(char *, char *);
599 extern int ufindpfx(char *, int);
602 extern int deltx(struct range *, coord);
603 /* Prototype include a typedef name.
604 It should be moved after the typedef declaration */
605 extern int delty(struct range *, coord);
606 /* Prototype include a typedef name.
607 It should be moved after the typedef declaration */
608 extern void radmap(int, int, int, int, double);
609 extern void radmapnopr(int, int, int, int, double);
610 extern void radmapupd(int, int, int, int, int, double);
612 extern int setrel(natid, natid, int);
613 extern int setcont(natid, natid, int);
614 extern int setrej(natid, natid, int, int);
616 extern void retreat_ship(struct shpstr *, char);
617 extern void retreat_land(struct lndstr *, char);
618 extern int check_retreat_and_do_shipdamage(struct shpstr *, int);
619 extern int check_retreat_and_do_landdamage(struct lndstr *, int);
621 extern ns_seltype sarg_type(char *);
622 extern int sarg_xy(char *, coord *, coord *);
623 extern int sarg_area(char *, register struct range *);
624 extern int sarg_range(char *, coord *, coord *, int *);
625 extern int sarg_list(char *, register int *, int);
627 extern void satdisp(struct sctstr *, int, int);
628 extern void satmap(int, int, int, int, int, int);
629 extern void sathead(void);
631 extern int sct_postread(int, void *);
632 extern int sct_prewrite(int, void *);
633 extern void item_prewrite(short *);
634 extern int issector(char *);
636 extern char *prship(struct shpstr *);
637 extern int shp_postread(int, void *);
638 extern int shp_prewrite(int, void *);
639 extern void shp_init(int, void *);
641 extern void show_bridge(int);
642 extern void show_tower(int);
643 extern void show_nuke_stats(int);
644 extern void show_nuke_capab(int);
645 extern void show_nuke_build(int);
646 extern void show_ship_build(int);
647 extern void show_ship_stats(int);
648 extern void show_ship_capab(int);
649 extern void show_plane_stats(int);
650 extern void show_plane_capab(int);
651 extern void show_plane_build(int);
652 extern void show_land_build(int);
653 extern void show_land_capab(int);
654 extern void show_land_stats(int);
655 extern void show_sect_build(int);
656 extern void show_sect_stats(int);
657 extern void show_sect_capab(int);
658 extern void show_item(int);
659 extern void show_news(int);
661 extern void shp_sel(struct nstr_item *, struct emp_qelem *);
662 extern void shp_nav(struct emp_qelem *, double *, double *, int *, natid);
663 extern int shp_sweep(struct emp_qelem *, int, natid);
664 extern char *shp_path(int, struct shpstr *, char *);
665 extern void shp_put(struct emp_qelem *, natid);
666 extern void shp_list(struct emp_qelem *);
667 extern int shp_check_nav(struct sctstr *, struct shpstr *);
668 extern int sect_has_dock(struct sctstr *);
669 extern int shp_hardtarget(struct shpstr *);
670 extern void shp_view(struct emp_qelem *);
671 extern int shp_nav_one_sector(struct emp_qelem *, int, natid, int);
672 extern int shp_missile_defense(coord, coord, natid, int);
673 extern void shp_missdef(struct shpstr *, natid);
674 extern void shp_set_tech(struct shpstr *, int);
676 extern int snxtitem(struct nstr_item *, int, char *);
677 extern void snxtitem_area(struct nstr_item *, int,
679 extern void snxtitem_dist(struct nstr_item *, int, int, int, int);
680 extern void snxtitem_xy(struct nstr_item *, int, coord, coord);
681 extern void snxtitem_all(struct nstr_item *, int);
682 extern void snxtitem_group(struct nstr_item *, int, char);
683 extern void snxtitem_rewind(struct nstr_item *);
684 extern int snxtitem_list(struct nstr_item *, int, int *, int);
686 extern int snxtsct(register struct nstr_sect *, char *);
687 extern void snxtsct_area(struct nstr_sect *, struct range *);
688 extern void xydist_range(coord, coord, int, struct range *);
689 extern void xysize_range(struct range *);
690 extern void snxtsct_all(struct nstr_sect *);
691 extern void snxtsct_rewind(struct nstr_sect *);
692 extern void snxtsct_dist(struct nstr_sect *, coord, coord, int);
694 extern void resupply_all(struct lndstr *);
695 extern void resupply_commod(struct lndstr *, i_type);
696 extern int supply_commod(int, int, int, i_type, int);
697 extern int try_supply_commod(int, int, int, i_type, int);
698 extern int has_supply(struct lndstr *);
699 extern int use_supply(struct lndstr *);
701 extern void takeover_land(struct lndstr *, natid, int);
702 extern void takeover(struct sctstr *, natid);
703 extern void takeover_ship(struct shpstr *, natid, int);
704 extern void takeover_plane(struct plnstr *, natid);
707 extern int trechk(register natid, register natid, int);
711 extern void clear_telegram_is_new(natid);
712 extern int typed_wu(natid, natid, char *, int);
713 extern int wu(natid, natid, char *, ...) ATTRIBUTE((format (printf, 3, 4)));
716 * src/lib/update/ *.c
719 extern void age_levels(int);
721 extern void delete_old_announcements(void);
725 extern void dodeliver(struct sctstr *);
727 extern int dodistribute(struct sctstr *, int, char *, double, double);
729 extern void finish_sects(int);
731 extern int new_work(struct sctstr *, int);
732 extern int do_feed(register struct sctstr *, register struct natstr *,
733 short *, int *, int *, int);
734 extern int feed_people(short *, int, int *);
736 extern int prod_land(int, int, int *, int);
737 extern int feed_land(struct lndstr *, int, int *, int);
743 extern void mob_sect(int);
744 extern void mob_ship(int);
745 extern void mob_land(int);
746 extern void mob_plane(int);
747 extern void update_all_mob(void);
748 extern void update_timestamps(time_t offset);
749 extern void sct_do_upd_mob(struct sctstr *sp);
750 extern void shp_do_upd_mob(struct shpstr *sp);
751 extern void lnd_do_upd_mob(struct lndstr *lp);
752 extern void pln_do_upd_mob(struct plnstr *pp);
754 extern void move_sat(struct plnstr *);
756 extern double logx(double, double);
757 extern void prod_nat(int);
759 extern int nav_ship(register struct shpstr *);
761 extern int load_it(struct shpstr *, struct sctstr *,
763 extern void unload_it(struct shpstr *);
764 extern void auto_fuel_ship(struct shpstr *);
766 extern void *nxtitemp(struct nstr_item *);
768 extern void do_plague(struct sctstr *, struct natstr *, int);
769 extern int plague_people(struct natstr *, short *, int *, int *, int);
771 extern int prod_plane(int, int, int *, int);
773 extern void populace(struct natstr *, register struct sctstr *, int);
774 extern int total_work(int, int, int, int, int, int);
776 extern void tax(struct sctstr *, struct natstr *, int, long *, int *,
778 extern int upd_slmilcosts(natid, int);
779 extern void prepare_sects(int, int *);
780 extern int bank_income(struct sctstr *, int);
782 extern int produce(struct natstr *, struct sctstr *, short *, int, int,
784 extern double prod_eff(struct pchrstr *, float);
786 extern int update_removewants(void);
788 extern void revolt(struct sctstr *);
789 extern void guerrilla(struct sctstr *);
791 extern void sail_ship(natid);
793 extern void do_fallout(register struct sctstr *, register int);
794 extern void spread_fallout(struct sctstr *, int);
795 extern void decay_fallout(struct sctstr *, int);
796 extern void produce_sect(int natnum, int etu, int *bp,
797 long (*p_sect)[2], int sector_type);
799 extern int prod_ship(int, int, int *, int);
800 extern int feed_ship(struct shpstr *, int, int *, int);