2 * Empire - A multi-player, client/server Internet based war game.
3 * Copyright (C) 1986-2015, 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 * prototypes.h: Prototypes for server functions
29 * Known contributors to this file:
31 * Steve McClure, 1998,2000
45 /* src/server/main.c */
46 extern void shutdwn(int sig);
47 extern void start_server(int);
48 extern void finish_server(void);
50 /* src/lib/empthread/lwp.c */
54 * src/lib/commands/ *.c
56 extern int check_market(void);
57 extern int edit_sect(struct sctstr *, char *, char *);
58 extern int edit_sect_i(struct sctstr *, char *, int);
59 extern int load_comm_ok(struct sctstr *, natid, i_type, int);
60 extern void gift(natid, natid, void *, char *);
61 extern int display_mark(i_type, int);
62 extern int count_pop(int);
63 extern int line_of_sight(char **rad, int ax, int ay, int bx, int by);
64 extern void plane_sona(struct emp_qelem *, int, int, struct shiplist **);
65 extern char *prsub(struct shpstr *);
66 extern int check_trade(void);
67 extern int ontradingblock(int, void *);
68 extern void trdswitchown(int, struct empobj *, int);
69 extern int do_look(int);
70 extern void look_at_sect(struct sctstr *, int);
71 extern int radar(int);
72 extern void update_power(void);
73 extern int show_first_tel(char *);
243 * src/lib/common/ *.c
246 extern int read_builtin_tables(void);
247 extern int read_custom_tables(void);
249 extern int cnumb(char *);
253 extern int emp_config(char *file);
254 extern void print_config(FILE * fp);
256 extern double hap_fact(struct natstr *, struct natstr *);
257 extern double hap_req(struct natstr *np);
259 extern int is_wday_allowed(int, char *);
260 extern int is_daytime_allowed(int, char *);
261 extern int gamehours(time_t);
263 extern int mapdist(int, int, int, int);
269 extern int read_schedule(char *, time_t[], int, time_t, time_t);
271 extern int max_population(float, int, int);
272 extern int max_pop(float, struct sctstr *);
276 extern int sct_typematch(char *);
278 extern int demand_update_want(int *, int *, int);
279 extern int demand_check(void);
280 extern int demandupdatecheck(void);
281 /* xdump.c xundump.c */
288 extern int disassoc(void);
290 extern char *fnameat(const char *, const char *);
291 extern FILE *fopenat(const char *, const char *, const char *);
293 extern int fsize(int);
294 extern int blksize(int);
295 extern time_t fdate(int);
299 extern int loginit(char *);
300 extern int logreopen(void);
301 extern void logerror(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
305 extern char *effadv(int);
306 extern char *numstr(char buf[], int n);
308 extern int parse(char *, char *, char **, char **, char **, char **);
310 extern char *esplur(int n);
311 extern char *splur(int n);
312 extern char *iesplur(int n);
316 extern int ldround(double, int);
317 extern int roundintby(int, int);
319 extern int scthash(int, int, int);
321 extern int tcp_listen(char *, char *, size_t *);
324 * src/lib/global/ *.c
326 extern void global_init(void);
330 * src/lib/player/ *.c
333 extern void player_init(void);
334 extern struct player *player_new(int);
335 extern struct player *player_delete(struct player *);
336 extern struct player *player_next(struct player *);
337 extern struct player *player_prev(struct player *);
338 extern struct player *getplayer(natid);
339 extern void player_accept(void *);
340 extern time_t player_io_deadline(struct player *, int);
342 extern int dispatch(char *, char *);
344 extern int getcommand(char *);
345 extern void init_player_commands(void);
346 extern void log_last_commands(void);
347 extern void update_timeused_login(time_t now);
348 extern void update_timeused(time_t now);
349 extern void enforce_minimum_session_time(void);
350 extern int may_play_now(struct natstr *, time_t);
351 /* more under Commands */
355 extern int init_nats(void);
356 extern int player_set_nstat(struct player *, struct natstr *);
358 extern void player_login(void *);
360 extern int natbyname(char *, natid *);
361 extern int natpass(natid, char *);
363 extern struct player *player; /* current player's context */
364 extern char *praddr(struct player *);
365 extern void player_main(struct player *);
366 extern void make_stale_if_command_arg(char *);
367 /* more under Commands */
369 extern int recvclient(char *, int);
372 extern void stop_service(void);
373 /* more in service.h */
381 extern int confirm(char *);
382 extern int askyn(char *);
384 extern int bridge_support_at(struct sctstr *, int);
385 extern void bridge_damaged(struct sctstr *);
386 extern void bridgefall(struct sctstr *);
388 extern void bsanct(void);
390 extern void caploss(struct sctstr *, natid, char *);
392 extern int check_obj_ok(struct empobj *);
393 extern int check_sect_ok(struct sctstr *);
394 extern int check_ship_ok(struct shpstr *);
395 extern int check_land_ok(struct lndstr *);
396 extern int check_nuke_ok(struct nukstr *);
397 extern int check_plane_ok(struct plnstr *);
398 extern int check_comm_ok(struct comstr *);
399 extern int check_loan_ok(struct lonstr *);
400 extern int check_trade_ok(struct trdstr *);
402 extern void set_coastal(struct sctstr *, int, int);
404 extern int military_control(struct sctstr *);
405 extern int abandon_askyn(struct sctstr *, i_type, int, struct ulist *);
406 extern int would_abandon(struct sctstr *, i_type, int, struct ulist *);
408 extern void landdamage(struct lndstr *, int);
409 extern void ship_damage(struct shpstr *, int);
410 extern int damage(int, int);
411 extern void shipdamage(struct shpstr *, int);
412 extern void land_damage(struct lndstr *, int);
413 extern void planedamage(struct plnstr *, int);
414 extern int nukedamage(struct nchrstr *, int, int);
415 extern int effdamage(int, int);
416 extern void item_damage(int, short *);
417 extern int commdamage(int, int, i_type);
419 extern int detonate(struct nukstr *, coord, coord, int);
421 extern int disloan(int, struct lonstr *);
423 extern int distrea(int, struct trtstr *);
425 extern void ef_init_srv(int);
426 extern void ef_fin_srv(void);
428 extern int sd(natid, natid, coord, coord, int, int, int);
429 extern int dd(natid, natid, coord, coord, int, int);
430 extern int shipdef(natid, natid, coord, coord);
431 extern int feels_like_helping(natid, natid, natid);
433 extern int emp_getbit(int, int, unsigned char *);
434 extern void emp_setbit(int, int, unsigned char *);
435 extern void bitinit2(struct nstr_sect *, unsigned char *, int);
437 extern int getele(char *, char *);
439 extern char *prland(struct lndstr *);
440 extern void lnd_postread(int, void *);
441 extern void lnd_prewrite(int, void *, void *);
443 extern double torprange(struct shpstr *);
444 extern double fortrange(struct sctstr *);
445 extern int roundrange(double);
447 extern int shipsatxy(coord, coord, int, int, int);
448 extern int carriersatxy(coord, coord, natid);
449 extern int unitsatxy(coord, coord, int, int, int);
450 extern int planesatxy(coord, coord, int, int);
451 extern int asw_shipsatxy(coord, coord, int, int, struct plnstr *,
453 extern void print_shiplist(struct shiplist *);
454 extern int has_units(coord, coord, natid);
455 extern int adj_units(coord, coord, natid);
456 extern int islist(char *);
460 extern char *mission_name(int);
461 extern int collateral_damage(coord, coord, int);
462 extern int mission_pln_equip(struct plist *, struct ichrstr *, char);
463 extern int ground_interdict(coord, coord, natid, char *);
464 extern int unit_interdict(coord, coord, natid, char *, int, int);
465 extern int off_support(coord, coord, natid, natid);
466 extern int def_support(coord, coord, natid, natid);
467 extern int oprange(struct empobj *);
468 extern int in_oparea(struct empobj *, coord, coord);
469 extern int cando(int, int);
471 extern int check_lmines(coord, coord, double);
472 extern int move_ground(struct sctstr *, struct sctstr *,
474 int (*)(coord, coord, char *, char *),
476 extern int fly_map(coord, coord);
478 extern int msl_launch(struct plnstr *, int, char *, coord, coord, natid,
480 extern int msl_hit(struct plnstr *, int, int, int, int, int, natid);
481 extern void msl_sel(struct emp_qelem *, coord, coord, natid, int,
483 extern int msl_abm_intercept(struct plnstr *, coord, coord, int);
484 extern int msl_asat_intercept(struct plnstr *, coord, coord);
486 extern int comtch(char *, struct cmndstr *, int);
488 extern struct natstr *natargp(char *, char *);
489 extern int natarg(char *, char *);
491 extern int neigh(coord, coord, natid);
493 extern void delete_old_news(void);
494 extern void init_nreport(void);
495 extern void nreport(natid, int, natid, int);
497 extern char *prnuke(struct nukstr *);
498 extern void nuk_postread(int, void *);
499 extern void nuk_prewrite(int, void *, void *);
504 extern int onearg(char *, char *);
506 extern char *prplane(struct plnstr *);
507 extern void pln_postread(int, void *);
508 extern void pln_prewrite(int, void *, void *);
510 extern int get_planes(struct nstr_item *, struct nstr_item *,
512 extern struct sctstr *get_assembly_point(char *, struct sctstr *, char *);
513 extern int pln_where_to_land(coord, coord, union empobj_storage *, int *);
514 extern int pln_can_land_on_carrier(struct emp_qelem *, struct emp_qelem *,
516 extern void pln_newlanding(struct emp_qelem *, coord, coord, int);
517 extern int could_be_on_ship(struct plnstr *, struct shpstr *);
518 extern int put_plane_on_ship(struct plnstr *, struct shpstr *);
519 extern void pln_dropoff(struct emp_qelem *, struct ichrstr *,
521 extern void pln_mine(struct emp_qelem *, coord, coord);
522 extern int pln_capable(struct plnstr *, int, int);
523 extern int pln_caps(struct emp_qelem *);
524 extern int pln_airbase_ok(struct plnstr *, int, int);
525 extern int carrier_planes(struct shpstr *, int);
526 extern void pln_sel(struct nstr_item *, struct emp_qelem *,
527 struct sctstr *, int, int, int, int);
528 extern void pln_arm(struct emp_qelem *, int, char, struct ichrstr *);
529 extern int pln_equip(struct plist *, struct ichrstr *, char);
530 extern int pln_mobcost(int, struct plnstr *, char);
531 extern void pln_put(struct emp_qelem *);
532 extern void pln_put1(struct plist *);
533 extern void plane_sweep(struct emp_qelem *, coord, coord);
534 extern int put_plane_on_land(struct plnstr *, struct lndstr *);
535 extern int pln_hitchance(struct plnstr *, int, int);
536 extern int pln_damage(struct plnstr *, char, char *);
537 extern int pln_identchance(struct plnstr *, int, int);
538 extern int pln_is_in_orbit(struct plnstr *);
539 extern void pln_set_tech(struct plnstr *, int);
541 extern void pr(char *, ...) ATTRIBUTE((format (printf, 1, 2)));
542 extern void uprnf(char *buf);
543 extern void pr_id(struct player *, int, char *, ...)
544 ATTRIBUTE((format (printf, 3, 4)));
545 extern void pr_flash(struct player *, char *, ...)
546 ATTRIBUTE((format (printf, 2, 3)));
547 extern void pr_inform(struct player *, char *, ...)
548 ATTRIBUTE((format (printf, 2, 3)));
549 extern void pr_wall(char *, ...)
550 ATTRIBUTE((format (printf, 1, 2)));
551 extern void prredir(char *redir);
552 extern void prexec(char *file);
553 extern void prprompt(int min, int btu);
554 extern int prmptrd(char *prompt, char *str, int size);
555 extern int uprmptrd(char *prompt, char *str, int size);
556 extern void prdate(void);
557 extern void prxy(char *, coord, coord);
558 extern void pr_beep(void);
559 extern void mpr(int, char *, ...) ATTRIBUTE((format (printf, 2, 3)));
560 extern size_t copy_ascii_no_funny(char *, char *);
561 extern size_t copy_utf8_no_funny(char *, char *);
562 extern size_t copy_utf8_to_ascii_no_funny(char *, char *);
563 extern int ufindpfx(char *, int);
565 extern int deltx(struct range *, coord);
566 extern int delty(struct range *, coord);
567 extern void radmap(int, int, int, double, int, double);
568 extern void rad_map_set(natid, int, int, int, double, int);
570 extern void setrel(natid, natid, int);
571 extern void setcont(natid, natid, int);
572 extern void setrej(natid, natid, int, int);
576 extern enum ns_seltype sarg_type(char *);
577 extern int sarg_xy(char *, coord *, coord *);
578 extern int sarg_area(char *, struct range *);
579 extern int sarg_range(char *, coord *, coord *, int *);
580 extern int sarg_list(char *, int *, int);
582 extern void satdisp_sect(struct sctstr *, int);
583 extern void satdisp_units(coord, coord);
584 extern int satmap(int, int, int, int, int, int);
585 extern void sathead(void);
587 extern void sct_postread(int, void *);
588 extern void sct_prewrite(int, void *, void *);
589 extern void item_prewrite(short *);
590 extern int issector(char *);
592 extern int sect_damage(struct sctstr *, int);
593 extern int sectdamage(struct sctstr *, int);
595 extern char *prship(struct shpstr *);
596 extern void shp_postread(int, void *);
597 extern void shp_prewrite(int, void *, void *);
599 extern void show_bridge(int);
600 extern void show_tower(int);
601 extern void show_nuke_stats(int);
602 extern void show_nuke_capab(int);
603 extern void show_nuke_build(int);
604 extern void show_ship_build(int);
605 extern void show_ship_stats(int);
606 extern void show_ship_capab(int);
607 extern void show_plane_stats(int);
608 extern void show_plane_capab(int);
609 extern void show_plane_build(int);
610 extern void show_land_build(int);
611 extern void show_land_capab(int);
612 extern void show_land_stats(int);
613 extern void show_sect_build(int);
614 extern void show_sect_stats(int);
615 extern void show_sect_capab(int);
616 extern void show_item(int);
617 extern void show_news(int);
618 extern void show_product(int);
619 extern void show_updates(int);
626 extern int sct_supply(struct sctstr *, i_type, int);
627 extern int shp_supply(struct shpstr *, i_type, int);
628 extern int lnd_supply(struct lndstr *, i_type, int);
629 extern int lnd_supply_all(struct lndstr *);
630 extern int lnd_in_supply(struct lndstr *);
631 extern int lnd_could_be_supplied(struct lndstr *);
633 extern void takeover_land(struct lndstr *, natid);
634 extern void takeover(struct sctstr *, natid);
635 extern void takeover_ship(struct shpstr *, natid);
636 extern void takeover_plane(struct plnstr *, natid);
640 extern int trechk(natid, natid, int);
644 extern void clear_telegram_is_new(natid);
645 extern int typed_wu(natid, natid, char *, int);
646 extern int wu(natid, natid, char *, ...) ATTRIBUTE((format (printf, 3, 4)));
649 * src/lib/update/ *.c
652 extern int age_people(int, int);
653 extern void age_levels(int);
655 extern void delete_old_announcements(void);
659 extern void dodeliver(struct sctstr *);
661 extern int dodistribute(struct sctstr *, int, double);
663 extern void finish_sects(int);
665 extern int new_work(struct sctstr *, int);
666 extern int do_feed(struct sctstr *, struct natstr *, short *, int *, int);
667 extern int feed_people(short *, int);
668 extern double food_needed(short *, int);
669 extern int famine_victims(short *, int);
671 extern int prod_land(int, int, struct bp *, int);
677 extern void mob_sect(void);
678 extern void mob_ship(void);
679 extern void mob_land(void);
680 extern void mob_plane(void);
681 extern void sct_do_upd_mob(struct sctstr *sp);
682 extern void shp_do_upd_mob(struct shpstr *sp);
683 extern void lnd_do_upd_mob(struct lndstr *lp);
684 extern void pln_do_upd_mob(struct plnstr *pp);
686 extern void move_sat(struct plnstr *);
688 extern void prod_nat(int);
692 extern void do_plague(struct sctstr *, struct natstr *, int);
693 extern int plague_people(struct natstr *, short *, int *, int *, int);
695 extern int prod_plane(int, int, struct bp *, int);
697 extern void populace(struct natstr *, struct sctstr *, int);
698 extern int total_work(int, int, int, int, int, int);
700 extern void tax(struct sctstr *, struct natstr *, int, int *, int *,
702 extern int upd_slmilcosts(natid, int);
703 extern void prepare_sects(int, struct bp *);
704 extern int bank_income(struct sctstr *, int);
706 extern int produce(struct natstr *, struct sctstr *, short *, int, int,
708 extern int prod_materials_cost(struct pchrstr *, short[], int *);
709 extern int prod_resource_limit(struct pchrstr *, unsigned char *);
710 extern double prod_eff(int, float);
712 extern int update_removewants(void);
714 extern void revolt(struct sctstr *);
715 extern void guerrilla(struct sctstr *);
717 extern void do_fallout(struct sctstr *, int);
718 extern void spread_fallout(struct sctstr *, int);
719 extern void decay_fallout(struct sctstr *, int);
720 extern void produce_sect(int, int, struct bp *, int[][2]);
722 extern int prod_ship(int, int, struct bp *, int);