settings.c File Reference

#include "astring.h"
#include "fcintl.h"
#include "game.h"
#include "ioz.h"
#include "log.h"
#include "registry.h"
#include "shared.h"
#include "string_vector.h"
#include "map.h"
#include "gamehand.h"
#include "maphand.h"
#include "meta.h"
#include "notify.h"
#include "plrhand.h"
#include "report.h"
#include "rssanity.h"
#include "srv_main.h"
#include "stdinhand.h"
#include "settings.h"

Go to the source code of this file.

Data Structures
struct	setting

Macros
#define	settings_snprintf(_buf, _buf_len, format, ...)
#define	NAME_CASE(_val, _support, _pretty)
#define	GEN_BOOL(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_validate, func_action, _default)
#define	GEN_INT(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_help, func_validate, func_action, _min, _max, _default)
#define	GEN_STRING(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_validate, func_action, _default)
#define	GEN_STRING_NRS(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_validate, func_action, _default)
#define	GEN_ENUM(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_help, func_validate, func_action, func_name, _default)
#define	GEN_BITWISE(name, value, sclass, scateg, slevel, al_read, al_write, short_help, extra_help, func_validate, func_action, func_name, _default)
#define	PACKET_COMMON_INIT(packet, pset, pconn)

Typedefs
typedef bool(*	bool_validate_func_t) (bool value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)
typedef bool(*	int_validate_func_t) (int value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)
typedef bool(*	string_validate_func_t) (const char *value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)
typedef bool(*	enum_validate_func_t) (int value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)
typedef bool(*	bitwise_validate_func_t) (unsigned value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)
typedef void(*	action_callback_func_t) (const struct setting *pset)
typedef const char *(*	help_callback_func_t) (const struct setting *pset)
typedef const struct sset_val_name *(*	val_name_func_t) (int value)

Enumerations
enum	sset_class {   SSET_MAP_SIZE , SSET_MAP_GEN , SSET_MAP_ADD , SSET_PLAYERS ,   SSET_PLAYERS_CHANGEABLE , SSET_GAME_INIT , SSET_RULES , SSET_RULES_SCENARIO ,   SSET_RULES_FLEXIBLE , SSET_META }

Functions
static bool	setting_ruleset_one (struct section_file *file, const char *name, const char *path)
static void	setting_game_set (struct setting *pset, bool init)
static void	setting_game_free (struct setting *pset)
static void	setting_game_restore (struct setting *pset)
static void	settings_list_init (void)
static void	settings_list_free (void)
int	settings_list_cmp (const struct setting *const *pset1, const struct setting *const *pset2)
static bool	set_enum_value (struct setting *pset, int val)
static const struct sset_val_name *	caravanbonusstyle_name (int caravanbonus)
static const struct sset_val_name *	mapsize_name (int mapsize)
static const struct sset_val_name *	topology_name (int topology_bit)
static const struct sset_val_name *	traderevenuestyle_name (int revenue_style)
static const struct sset_val_name *	generator_name (int generator)
static const struct sset_val_name *	startpos_name (int startpos)
static const struct sset_val_name *	teamplacement_name (int team_placement)
static const struct sset_val_name *	persistentready_name (int persistent_ready)
static const struct sset_val_name *	victory_conditions_name (int condition_bit)
static const struct sset_val_name *	autosaves_name (int autosaves_bit)
static const struct sset_val_name *	borders_name (int borders)
static const struct sset_val_name *	trait_dist_name (int trait_dist)
static const struct sset_val_name *	plrcol_name (int plrcol)
static const struct sset_val_name *	happyborders_name (int happyborders)
static const struct sset_val_name *	diplomacy_name (int diplomacy)
static const struct sset_val_name *	citynames_name (int citynames)
static const struct sset_val_name *	barbarians_name (int barbarians)
static const struct sset_val_name *	revolentype_name (int revolentype)
static const struct sset_val_name *	revealmap_name (int bit)
static const struct sset_val_name *	airliftingstyle_name (int bit)
static const struct sset_val_name *	phasemode_name (int phasemode)
static const struct sset_val_name *	scoreloglevel_name (enum scorelog_level sl_level)
static const struct sset_val_name *	compresstype_name (enum fz_method compresstype)
static const struct sset_val_name *	bool_name (int enable)
static const char *	phasemode_help (const struct setting *pset)
static const char *	huts_help (const struct setting *pset)
static void	scorelog_action (const struct setting *pset)
static void	aifill_action (const struct setting *pset)
static void	nationset_action (const struct setting *pset)
static void	plrcol_action (const struct setting *pset)
static void	autotoggle_action (const struct setting *pset)
static void	timeout_action (const struct setting *pset)
static void	first_timeout_action (const struct setting *pset)
static void	huts_action (const struct setting *pset)
static void	topology_action (const struct setting *pset)
static void	metamessage_action (const struct setting *pset)
static bool	savename_validate (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	generator_validate (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	scorefile_validate (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	demography_callback (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	autosaves_callback (unsigned value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	allowtake_callback (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	startunits_callback (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	endturn_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	maxplayers_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	nationset_callback (const char *value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	timeout_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	first_timeout_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	unitwaittime_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	mapsize_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	xsize_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	ysize_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	topology_callback (unsigned value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	compresstype_callback (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static bool	plrcol_validate (int value, struct connection *caller, char *reject_msg, size_t reject_msg_len)
struct setting *	setting_by_number (int id)
struct setting *	setting_by_name (const char *name)
int	setting_number (const struct setting *pset)
const char *	setting_name (const struct setting *pset)
const char *	setting_short_help (const struct setting *pset)
const char *	setting_extra_help (const struct setting *pset, bool constant)
enum sset_type	setting_type (const struct setting *pset)
enum sset_level	setting_level (const struct setting *pset)
enum sset_category	setting_category (const struct setting *pset)
static bool	setting_is_free_to_change (const struct setting *pset, char *reject_msg, size_t reject_msg_len)
bool	setting_is_changeable (const struct setting *pset, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_is_visible_at_level (const struct setting *pset, enum cmdlevel plevel)
bool	setting_is_visible (const struct setting *pset, struct connection *caller)
static enum m_pre_result	setting_match_prefix_base (const val_name_func_t name_fn, const char *prefix, int *ind_result, const char **matches, size_t max_matches, size_t *pnum_matches)
static bool	setting_match_prefix (const val_name_func_t name_fn, const char *prefix, int *pvalue, char *reject_msg, size_t reject_msg_len)
static const char *	setting_bool_to_str (const struct setting *pset, bool value, bool pretty, char *buf, size_t buf_len)
static bool	setting_bool_validate_base (const struct setting *pset, const char *val, int *pint_val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_bool_set (struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_bool_get (struct setting *pset)
bool	setting_bool_validate (const struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
static const char *	setting_bool_secfile_str (secfile_data_t data, int val)
static const char *	setting_int_to_str (const struct setting *pset, int value, bool pretty, char *buf, size_t buf_len)
int	setting_int_min (const struct setting *pset)
int	setting_int_max (const struct setting *pset)
bool	setting_int_set (struct setting *pset, int val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_int_validate (const struct setting *pset, int val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
int	setting_int_get (struct setting *pset)
static const char *	setting_str_to_str (const struct setting *pset, const char *value, bool pretty, char *buf, size_t buf_len)
bool	setting_str_set (struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_str_validate (const struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
char *	setting_str_get (struct setting *pset)
const char *	setting_enum_secfile_str (secfile_data_t data, int val)
const char *	setting_enum_val (const struct setting *pset, int val, bool pretty)
static const char *	setting_enum_to_str (const struct setting *pset, int value, bool pretty, char *buf, size_t buf_len)
static bool	setting_enum_validate_base (const struct setting *pset, const char *val, int *pint_val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
int	read_enum_value (const struct setting *pset)
bool	setting_enum_set (struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_enum_validate (const struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
const char *	setting_bitwise_secfile_str (secfile_data_t data, int bit)
const char *	setting_bitwise_bit (const struct setting *pset, int bit, bool pretty)
static const char *	setting_bitwise_to_str (const struct setting *pset, unsigned value, bool pretty, char *buf, size_t buf_len)
static bool	setting_bitwise_validate_base (const struct setting *pset, const char *val, unsigned *pint_val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_bitwise_set (struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
bool	setting_bitwise_validate (const struct setting *pset, const char *val, struct connection *caller, char *reject_msg, size_t reject_msg_len)
int	setting_bitwise_get (struct setting *pset)
const char *	setting_value_name (const struct setting *pset, bool pretty, char *buf, size_t buf_len)
const char *	setting_default_name (const struct setting *pset, bool pretty, char *buf, size_t buf_len)
void	setting_set_to_default (struct setting *pset)
void	setting_action (const struct setting *pset)
bool	settings_ruleset (struct section_file *file, const char *section, bool act)
bool	setting_non_default (const struct setting *pset)
bool	setting_locked (const struct setting *pset)
void	setting_lock_set (struct setting *pset, bool lock)
void	settings_game_start (void)
void	settings_game_save (struct section_file *file, const char *section)
void	settings_game_load (struct section_file *file, const char *section)
bool	settings_game_reset (void)
void	settings_init (bool act)
void	settings_reset (void)
void	settings_turn (void)
void	settings_free (void)
int	settings_number (void)
void	send_server_setting (struct conn_list *dest, const struct setting *pset)
void	send_server_settings (struct conn_list *dest)
void	send_server_access_level_settings (struct conn_list *dest, enum cmdlevel old_level, enum cmdlevel new_level)
void	send_server_setting_control (struct connection *pconn)
void	settings_list_update (void)
struct setting_list *	settings_list_get (enum sset_level level)
void	setting_changed (struct setting *pset)
enum setting_default_level	setting_get_setdef (const struct setting *pset)

Variables
struct {
bool   init
struct setting_list *   level [OLEVELS_NUM]
}	setting_sorted = { .init = FALSE }
static struct setting	settings []
static const int	SETTINGS_NUM = ARRAY_SIZE(settings)

Macro Definition Documentation

GEN_BITWISE

#define GEN_BITWISE	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_validate,
			func_action,
			func_name,
			_default
	)

Value:

  { name, sclass, al_read, al_write, short_help, extra_help, NULL,          \
    SST_BITWISE, scateg, slevel,                                            \
      INIT_BRACE_BEGIN                                                      \
      .bitwise = { (unsigned *) (void *) &value, _default, func_validate,   \
                   func_name, 0 } INIT_BRACE_END,                           \
      func_action, FALSE, TRUE},

Definition at line 1367 of file settings.c.

GEN_BOOL

#define GEN_BOOL	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_validate,
			func_action,
			_default
	)

Value:

  {name, sclass, al_read, al_write, short_help, extra_help, NULL, SST_BOOL, \
      scateg, slevel,                                                       \
      INIT_BRACE_BEGIN                                                      \
      .boolean = {&value, _default, func_validate, bool_name,               \
     FALSE} INIT_BRACE_END , func_action, FALSE, TRUE},

Definition at line 1316 of file settings.c.

GEN_ENUM

#define GEN_ENUM	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_help,
			func_validate,
			func_action,
			func_name,
			_default
	)

Value:

  { name, sclass, al_read, al_write, short_help, extra_help, func_help,     \
      SST_ENUM, scateg, slevel,                                             \
      INIT_BRACE_BEGIN                                                      \
      .enumerator = {  &value, sizeof(value), _default,                     \
                       func_validate,                                       \
       (val_name_func_t) func_name, 0 } INIT_BRACE_END,                     \
      func_action, FALSE, TRUE},

Definition at line 1356 of file settings.c.

GEN_INT

#define GEN_INT	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_help,
			func_validate,
			func_action,
			_min,
			_max,
			_default
	)

Value:

  {name, sclass, al_read, al_write, short_help, extra_help, func_help,  \
      SST_INT, scateg, slevel,                                          \
      INIT_BRACE_BEGIN                                                  \
      .integer = {(int *) &value, _default, _min, _max, func_validate,  \
                  0} INIT_BRACE_END,                                    \
      func_action, FALSE, TRUE},

Definition at line 1325 of file settings.c.

GEN_STRING

#define GEN_STRING	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_validate,
			func_action,
			_default
	)

Value:

  {name, sclass, al_read, al_write, short_help, extra_help, NULL,       \
      SST_STRING, scateg, slevel,                                       \
      INIT_BRACE_BEGIN                                                  \
      .string = {value, _default, sizeof(value), func_validate, ""}     \
      INIT_BRACE_END,                                                   \
      func_action, FALSE, TRUE},

Definition at line 1336 of file settings.c.

GEN_STRING_NRS

#define GEN_STRING_NRS	(		name,
			value,
			sclass,
			scateg,
			slevel,
			al_read,
			al_write,
			short_help,
			extra_help,
			func_validate,
			func_action,
			_default
	)

Value:

  {name, sclass, al_read, al_write, short_help, extra_help, NULL,       \
      SST_STRING, scateg, slevel,                                       \
      INIT_BRACE_BEGIN                                                  \
      .string = {value, _default, sizeof(value), func_validate, ""}     \
      INIT_BRACE_END,                                                   \
      func_action, FALSE, FALSE},

Definition at line 1346 of file settings.c.

NAME_CASE

#define NAME_CASE	(		_val,
			_support,
			_pretty
	)

Value:

  case _val:                                                                \
    {                                                                       \
      static const struct sset_val_name name = { _support, _pretty };       \
      return &name;                                                         \
    }

Definition at line 215 of file settings.c.

PACKET_COMMON_INIT

#define PACKET_COMMON_INIT	(		packet,
			pset,
			pconn
	)

Value:

  memset(&packet, 0, sizeof(packet));                                       \
  packet.id = setting_number(pset);                                         \
  packet.is_visible = setting_is_visible(pset, pconn);                      \
  packet.is_changeable = setting_is_changeable(pset, pconn, NULL, 0);       \
  packet.initial_setting = game.info.is_new_game;                           \
  packet.setdef = setting_get_setdef(pset);

settings_snprintf

#define settings_snprintf	(		_buf,
			_buf_len,
			format,
			...
	)

Value:

  if (_buf != NULL) {                                                       \
    fc_snprintf(_buf, _buf_len, format, ## __VA_ARGS__);                    \
  }

Definition at line 197 of file settings.c.

Typedef Documentation

action_callback_func_t

typedef void(* action_callback_func_t) (const struct setting *pset)

Definition at line 84 of file settings.c.

bitwise_validate_func_t

typedef bool(* bitwise_validate_func_t) (unsigned value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)

Definition at line 79 of file settings.c.

bool_validate_func_t

typedef bool(* bool_validate_func_t) (bool value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)

Definition at line 66 of file settings.c.

enum_validate_func_t

typedef bool(* enum_validate_func_t) (int value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)

Definition at line 76 of file settings.c.

help_callback_func_t

typedef const char *(* help_callback_func_t) (const struct setting *pset)

Definition at line 85 of file settings.c.

int_validate_func_t

typedef bool(* int_validate_func_t) (int value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)

Definition at line 69 of file settings.c.

string_validate_func_t

typedef bool(* string_validate_func_t) (const char *value, struct connection *pconn, char *reject_msg, size_t reject_msg_len)

Definition at line 72 of file settings.c.

val_name_func_t

typedef const struct sset_val_name *(* val_name_func_t) (int value)

Definition at line 85 of file settings.c.

Enumeration Type Documentation

sset_class

enum sset_class

Enumerator
SSET_MAP_SIZE
SSET_MAP_GEN
SSET_MAP_ADD
SSET_PLAYERS
SSET_PLAYERS_CHANGEABLE
SSET_GAME_INIT
SSET_RULES
SSET_RULES_SCENARIO
SSET_RULES_FLEXIBLE
SSET_META

Definition at line 53 of file settings.c.

Function Documentation

aifill_action()

static void aifill_action ( const struct setting *  pset )

static

Create the selected number of AI's.

Definition at line 655 of file settings.c.

airliftingstyle_name()

static const struct sset_val_name * airliftingstyle_name ( int  bit )

static

Airlifting style setting names accessor.

Definition at line 511 of file settings.c.

allowtake_callback()

static bool allowtake_callback ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify that a given allowtake string is valid. See game.allow_take.

Definition at line 921 of file settings.c.

autosaves_callback()

static bool autosaves_callback ( unsigned  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Autosaves setting callback

Definition at line 897 of file settings.c.

autosaves_name()

static const struct sset_val_name * autosaves_name ( int  autosaves_bit )

static

Autosaves setting names accessor.

Definition at line 366 of file settings.c.

autotoggle_action()

static void autotoggle_action ( const struct setting *  pset )

static

Toggle player AI status.

Definition at line 717 of file settings.c.

barbarians_name()

static const struct sset_val_name * barbarians_name ( int  barbarians )

static

Barbarian setting names accessor.

Definition at line 470 of file settings.c.

bool_name()

static const struct sset_val_name * bool_name ( int  enable )

static

Names accessor for boolean settings (disable/enable).

Definition at line 580 of file settings.c.

borders_name()

static const struct sset_val_name * borders_name ( int  borders )

static

Borders setting names accessor.

Definition at line 382 of file settings.c.

caravanbonusstyle_name()

static const struct sset_val_name * caravanbonusstyle_name ( int  caravanbonus )

static

Caravan bonus style setting names accessor.

Definition at line 225 of file settings.c.

citynames_name()

static const struct sset_val_name * citynames_name ( int  citynames )

static

City names setting names accessor.

Definition at line 456 of file settings.c.

compresstype_callback()

static bool compresstype_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Warn about deprecated compresstype selection.

Definition at line 1279 of file settings.c.

compresstype_name()

static const struct sset_val_name * compresstype_name ( enum fz_method  compresstype )

static

Savegame compress type names accessor.

Definition at line 557 of file settings.c.

demography_callback()

static bool demography_callback ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify that a given demography string is valid. See game.demography.

Definition at line 877 of file settings.c.

diplomacy_name()

static const struct sset_val_name * diplomacy_name ( int  diplomacy )

static

Diplomacy setting names accessor.

Definition at line 438 of file settings.c.

endturn_callback()

static bool endturn_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify that a given endturn is valid.

Definition at line 1021 of file settings.c.

first_timeout_action()

static void first_timeout_action ( const struct setting *  pset )

static

Enact a change in the 'first_timeout' server setting immediately, if the game is afoot.

Definition at line 750 of file settings.c.

first_timeout_callback()

static bool first_timeout_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Validate the 'first_timeout' server setting.

Definition at line 1122 of file settings.c.

generator_name()

static const struct sset_val_name * generator_name ( int  generator )

static

Generator setting names accessor.

Definition at line 281 of file settings.c.

generator_validate()

static bool generator_validate ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify the value of the generator option (notably the MAPGEN_SCENARIO case).

Definition at line 834 of file settings.c.

happyborders_name()

static const struct sset_val_name * happyborders_name ( int  happyborders )

static

Happyborders setting names accessor.

Definition at line 425 of file settings.c.

huts_action()

static void huts_action ( const struct setting *  pset )

static

Clean out absolute number of huts when relative setting set.

Definition at line 770 of file settings.c.

huts_help()

static const char * huts_help ( const struct setting *  pset )

static

Help about huts setting

Definition at line 616 of file settings.c.

mapsize_callback()

static bool mapsize_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Mapsize setting validation callback.

Definition at line 1166 of file settings.c.

mapsize_name()

static const struct sset_val_name * mapsize_name ( int  mapsize )

static

Map size definition setting names accessor. This setting has an hard-coded dependence in "server/meta.c".

Definition at line 240 of file settings.c.

maxplayers_callback()

static bool maxplayers_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify that a given maxplayers is valid.

Definition at line 1036 of file settings.c.

metamessage_action()

static void metamessage_action ( const struct setting *  pset )

static

Update metaserver message string from changed user meta server message string.

Definition at line 793 of file settings.c.

nationset_action()

static void nationset_action ( const struct setting *  pset )

static

Restrict to the selected nation set.

Definition at line 668 of file settings.c.

nationset_callback()

static bool nationset_callback ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Validate the 'nationset' server setting.

Definition at line 1063 of file settings.c.

persistentready_name()

static const struct sset_val_name * persistentready_name ( int  persistent_ready )

static

Persistentready setting names accessor.

Definition at line 337 of file settings.c.

phasemode_help()

static const char * phasemode_help ( const struct setting *  pset )

static

Help about phasemode setting

Definition at line 598 of file settings.c.

phasemode_name()

static const struct sset_val_name * phasemode_name ( int  phasemode )

static

Phase mode names accessor.

Definition at line 529 of file settings.c.

Referenced by phasemode_help().

plrcol_action()

static void plrcol_action ( const struct setting *  pset )

static

Clear any user-set player colors in modes other than PLRCOL_PLR_SET.

Definition at line 701 of file settings.c.

plrcol_name()

static const struct sset_val_name * plrcol_name ( int  plrcol )

static

Player colors configuration setting names accessor.

Definition at line 410 of file settings.c.

plrcol_validate()

static bool plrcol_validate ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Validate that the player color mode can be used.

Definition at line 1297 of file settings.c.

read_enum_value()

int read_enum_value

(

const struct setting *

pset

)

Helper function to read value from enumerator setting

Definition at line 3805 of file settings.c.

Referenced by plrcol_action(), save_game_ruleset(), send_server_setting(), setting_game_set(), setting_non_default(), setting_ruleset_one(), setting_value_name(), settings_game_load(), and settings_game_save().

revealmap_name()

static const struct sset_val_name * revealmap_name ( int  bit )

static

Revealmap setting names accessor.

Definition at line 499 of file settings.c.

revolentype_name()

static const struct sset_val_name * revolentype_name ( int  revolentype )

static

Revolution length type setting names accessor.

Definition at line 485 of file settings.c.

savename_validate()

static bool savename_validate ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify the selected savename definition.

Definition at line 813 of file settings.c.

scorefile_validate()

static bool scorefile_validate ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify the name for the score log file.

Definition at line 860 of file settings.c.

scorelog_action()

static void scorelog_action ( const struct setting *  pset )

static

(De)initialze the score log.

Definition at line 643 of file settings.c.

scoreloglevel_name()

static const struct sset_val_name * scoreloglevel_name ( enum scorelog_level  sl_level )

static

Scorelog level names accessor.

Definition at line 544 of file settings.c.

send_server_access_level_settings()

void send_server_access_level_settings	(	struct conn_list *	dest,
		enum cmdlevel	old_level,
		enum cmdlevel	new_level
	)

Send the server settings that got a different visibility or changability after a connection access level change. Usually called when the access level of the user changes.

Definition at line 5145 of file settings.c.

Referenced by conn_set_access().

send_server_setting()

void send_server_setting	(	struct conn_list *	dest,
		const struct setting *	pset
	)

Tell the client about just one server setting. Call this after a setting is saved.

Definition at line 5014 of file settings.c.

Referenced by metamessage_command(), send_server_access_level_settings(), send_server_settings(), and set_command().

send_server_setting_control()

void send_server_setting_control

(

struct connection *

pconn

)

Tell the client about all server settings.

Definition at line 5177 of file settings.c.

Referenced by establish_new_connection().

send_server_settings()

void send_server_settings

(

struct conn_list *

dest

)

Tell the client about all server settings.

Definition at line 5133 of file settings.c.

Referenced by establish_new_connection(), load_command(), reset_command(), settings_ruleset(), and srv_running().

set_enum_value()

static bool set_enum_value ( struct setting *  pset, int  val  )

static

Helper function to write value to enumerator setting

Definition at line 3771 of file settings.c.

Referenced by setting_enum_set(), setting_ruleset_one(), setting_set_to_default(), and settings_game_load().

setting_action()

void setting_action

(

const struct setting *

pset

)

Execute the action callback if needed.

Definition at line 4168 of file settings.c.

Referenced by set_command(), settings_game_load(), settings_init(), settings_reset(), and settings_ruleset().

setting_bitwise_bit()

const char * setting_bitwise_bit	(	const struct setting *	pset,
		int	bit,
		bool	pretty
	)

Convert the bit number to its string representation. Return NULL if 'bit' is not a valid bit.

Definition at line 3887 of file settings.c.

Referenced by manual_command(), and show_help_option().

setting_bitwise_get()

int setting_bitwise_get

(

struct setting *

pset

)

Get value of bitwise setting

Definition at line 4056 of file settings.c.

Referenced by save_game_ruleset(), and server_ss_val_bitwise_get().

setting_bitwise_secfile_str()

const char * setting_bitwise_secfile_str	(	secfile_data_t	data,
		int	bit
	)

Convert the integer to the long support string representation of an enumerator. This function must match the secfile_enum_name_data_fn_t type.

Definition at line 3875 of file settings.c.

Referenced by save_game_ruleset(), setting_ruleset_one(), settings_game_load(), and settings_game_save().

setting_bitwise_set()

bool setting_bitwise_set	(	struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Set the setting to 'val'. Returns TRUE on success. If it fails, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 4022 of file settings.c.

Referenced by set_command(), and setting_game_restore().

setting_bitwise_to_str()

static const char * setting_bitwise_to_str ( const struct setting *  pset, unsigned  value, bool  pretty, char *  buf, size_t  buf_len  )

static

Compute the string representation of the value for this bitwise setting.

Definition at line 3906 of file settings.c.

Referenced by setting_default_name(), setting_game_restore(), and setting_value_name().

setting_bitwise_validate()

bool setting_bitwise_validate	(	const struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 4043 of file settings.c.

Referenced by set_command().

setting_bitwise_validate_base()

static bool setting_bitwise_validate_base ( const struct setting *  pset, const char *  val, unsigned *  pint_val, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

FIXME: also check the access level of pconn.

Definition at line 3971 of file settings.c.

Referenced by setting_bitwise_set(), and setting_bitwise_validate().

setting_bool_get()

bool setting_bool_get

(

struct setting *

pset

)

Get value of boolean setting

Definition at line 3496 of file settings.c.

Referenced by save_game_ruleset(), and server_ss_val_bool_get().

setting_bool_secfile_str()

static const char * setting_bool_secfile_str ( secfile_data_t  data, int  val  )

static

Convert the integer to the long support string representation of a boolean setting. This function must match the secfile_enum_name_data_fn_t type.

Definition at line 3522 of file settings.c.

Referenced by setting_ruleset_one().

setting_bool_set()

bool setting_bool_set	(	struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Set the setting to 'val'. Returns TRUE on success. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 3477 of file settings.c.

Referenced by set_command(), and setting_game_restore().

setting_bool_to_str()

static const char * setting_bool_to_str ( const struct setting *  pset, bool  value, bool  pretty, char *  buf, size_t  buf_len  )

static

Compute the string representation of the value for this boolean setting.

Definition at line 3427 of file settings.c.

Referenced by setting_default_name(), setting_game_restore(), and setting_value_name().

setting_bool_validate()

bool setting_bool_validate	(	const struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 3508 of file settings.c.

Referenced by set_command().

setting_bool_validate_base()

static bool setting_bool_validate_base ( const struct setting *  pset, const char *  val, int *  pint_val, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

FIXME: also check the access level of pconn.

Definition at line 3448 of file settings.c.

Referenced by setting_bool_set(), and setting_bool_validate().

setting_by_name()

struct setting * setting_by_name

(

const char *

name

)

Returns the setting to the given name.

Definition at line 3138 of file settings.c.

Referenced by api_server_setting_get(), autolock_settings(), metamessage_command(), rscompat_req_vec_adjust_3_1(), sanity_check_req_vec_singlepole(), sanity_check_setting_is_game_rule(), server_ss_by_name(), and srv_ready().

setting_by_number()

struct setting * setting_by_number

(

int

id

)

Returns the setting to the given id.

Definition at line 3130 of file settings.c.

Referenced by optname_accessor(), rscompat_req_vec_adjust_3_1(), sanity_check_req_individual(), sanity_check_req_vec_singlepole(), sanity_check_server_setting_value_in_req(), server_ss_name_get(), server_ss_type_get(), server_ss_val_bitwise_get(), server_ss_val_bool_get(), server_ss_val_int_get(), settings_list_init(), settings_list_update(), show_help_option(), show_settings(), and validate_setting_arg().

setting_category()

enum sset_category setting_category

(

const struct setting *

pset

)

Access function for the setting category.

Definition at line 3207 of file settings.c.

Referenced by manual_command(), and sanity_check_setting_is_game_rule().

setting_changed()

void setting_changed

(

struct setting *

pset

)

Mark setting changed

Definition at line 5341 of file settings.c.

Referenced by metamessage_command(), and set_command().

setting_default_name()

const char * setting_default_name	(	const struct setting *	pset,
		bool	pretty,
		char *	buf,
		size_t	buf_len
	)

Compute the name of the default value of the setting.

Definition at line 4102 of file settings.c.

Referenced by manual_command(), and show_help_option().

setting_enum_secfile_str()

const char * setting_enum_secfile_str	(	secfile_data_t	data,
		int	val
	)

Convert the integer to the long support string representation of an enumerator. This function must match the secfile_enum_name_data_fn_t type.

Definition at line 3690 of file settings.c.

Referenced by save_game_ruleset(), setting_ruleset_one(), settings_game_load(), and settings_game_save().

setting_enum_set()

bool setting_enum_set	(	struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Set the setting to 'val'. Returns TRUE on success. If it fails, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 3832 of file settings.c.

Referenced by autolock_settings(), set_command(), setting_game_restore(), and srv_ready().

setting_enum_to_str()

static const char * setting_enum_to_str ( const struct setting *  pset, int  value, bool  pretty, char *  buf, size_t  buf_len  )

static

Compute the string representation of the value for this enumerator setting.

Definition at line 3722 of file settings.c.

Referenced by setting_default_name(), setting_game_restore(), and setting_value_name().

setting_enum_val()

const char * setting_enum_val	(	const struct setting *	pset,
		int	val,
		bool	pretty
	)

Convert the integer to the string representation of an enumerator. Return NULL if 'val' is not a valid enumerator.

Definition at line 3702 of file settings.c.

Referenced by manual_command(), and show_help_option().

setting_enum_validate()

bool setting_enum_validate	(	const struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

Definition at line 3861 of file settings.c.

Referenced by set_command().

setting_enum_validate_base()

static bool setting_enum_validate_base ( const struct setting *  pset, const char *  val, int *  pint_val, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available in the optional parameter 'reject_msg'.

FIXME: also check the access level of pconn.

Definition at line 3744 of file settings.c.

Referenced by setting_enum_set(), and setting_enum_validate().

setting_extra_help()

const char * setting_extra_help	(	const struct setting *	pset,
		bool	constant
	)

Access function for the long (extra) help of the setting. If 'constant' is TRUE, static, not-yet-translated string is always returned.

Definition at line 3179 of file settings.c.

Referenced by manual_command(), send_server_setting_control(), and show_help_option().

setting_game_free()

static void setting_game_free ( struct setting *  pset )

static

Free the memory used for the settings at game start.

Definition at line 4476 of file settings.c.

Referenced by settings_free().

setting_game_restore()

static void setting_game_restore ( struct setting *  pset )

static

Restore the setting to the value used at the start of the current game.

Definition at line 4486 of file settings.c.

Referenced by settings_game_reset().

setting_game_set()

static void setting_game_set ( struct setting *  pset, bool  init  )

static

Save the setting value of the current game.

Definition at line 4436 of file settings.c.

Referenced by settings_game_start(), and settings_init().

setting_get_setdef()

enum setting_default_level setting_get_setdef

(

const struct setting *

pset

)

Is the setting in changed state, or the default

Definition at line 5349 of file settings.c.

Referenced by save_game_ruleset(), settings_game_save(), and show_settings_one().

setting_int_get()

int setting_int_get

(

struct setting *

pset

)

Get value of integer setting

Definition at line 3608 of file settings.c.

Referenced by save_game_ruleset(), and server_ss_val_int_get().

setting_int_max()

int setting_int_max

(

const struct setting *

pset

)

Returns the maximal integer value for this setting.

Definition at line 3553 of file settings.c.

Referenced by manual_command(), show_help_option(), and show_settings_one().

setting_int_min()

int setting_int_min

(

const struct setting *

pset

)

Returns the minimal integer value for this setting.

Definition at line 3544 of file settings.c.

Referenced by manual_command(), show_help_option(), and show_settings_one().

setting_int_set()

bool setting_int_set	(	struct setting *	pset,
		int	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Set the setting to 'val'. Returns TRUE on success. If it fails, the reason of the failure is available by the function setting_error().

Definition at line 3563 of file settings.c.

Referenced by set_command(), setting_game_restore(), and setting_ruleset_one().

setting_int_to_str()

static const char * setting_int_to_str ( const struct setting *  pset, int  value, bool  pretty, char *  buf, size_t  buf_len  )

static

Compute the string representation of the value for this integer setting.

Definition at line 3533 of file settings.c.

Referenced by setting_default_name(), and setting_value_name().

setting_int_validate()

bool setting_int_validate	(	const struct setting *	pset,
		int	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available by the function setting_error().

FIXME: also check the access level of pconn.

Definition at line 3583 of file settings.c.

Referenced by set_command(), and setting_int_set().

setting_is_changeable()

bool setting_is_changeable	(	const struct setting *	pset,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns whether the specified server setting (option) can currently be changed by the caller. If it returns FALSE, the reason of the failure is available by the function setting_error().

Definition at line 3289 of file settings.c.

Referenced by default_command(), manual_command(), set_command(), setting_bitwise_set(), setting_bool_set(), setting_enum_set(), setting_game_restore(), setting_int_set(), setting_status(), setting_str_set(), settings_game_load(), settings_reset(), and show_help_option().

setting_is_free_to_change()

static bool setting_is_free_to_change ( const struct setting *  pset, char *  reject_msg, size_t  reject_msg_len  )

static

Returns whether the specified server setting (option) can currently be changed without breaking data consistency (map dimension options can't change when map has already been created with certain dimensions)

Definition at line 3217 of file settings.c.

Referenced by setting_is_changeable(), and settings_game_save().

setting_is_visible()

bool setting_is_visible	(	const struct setting *	pset,
		struct connection *	caller
	)

Returns whether the specified server setting (option) can be seen by the caller.

Definition at line 3326 of file settings.c.

Referenced by set_command(), show_help_option(), show_help_option_list(), and show_settings().

setting_is_visible_at_level()

bool setting_is_visible_at_level	(	const struct setting *	pset,
		enum cmdlevel	plevel
	)

Returns whether the specified server setting (option) can be seen by a caller with the specified access level.

Definition at line 3316 of file settings.c.

Referenced by sanity_check_setting_is_seen(), and setting_is_visible().

setting_level()

enum sset_level setting_level

(

const struct setting *

pset

)

Access function for the setting level (used by the /show command).

Definition at line 3199 of file settings.c.

Referenced by manual_command(), and settings_list_init().

setting_lock_set()

void setting_lock_set	(	struct setting *	pset,
		bool	lock
	)

Set the value for the lock of a setting.

Definition at line 4428 of file settings.c.

Referenced by autolock_settings(), setting_ruleset_one(), settings_init(), and settings_ruleset().

setting_locked()

bool setting_locked

(

const struct setting *

pset

)

Returns if the setting is locked by the ruleset.

Definition at line 4420 of file settings.c.

Referenced by manual_command(), save_game_ruleset(), setting_is_changeable(), setting_status(), and settings_list_update().

setting_match_prefix()

static bool setting_match_prefix ( const val_name_func_t  name_fn, const char *  prefix, int *  pvalue, char *  reject_msg, size_t  reject_msg_len  )

static

Convert the string prefix to an integer representation. NB: This function is used for SST_ENUM and SST_BITWISE.

Definition at line 3385 of file settings.c.

Referenced by setting_bitwise_validate_base(), setting_bool_validate_base(), and setting_enum_validate_base().

setting_match_prefix_base()

static enum m_pre_result setting_match_prefix_base ( const val_name_func_t  name_fn, const char *  prefix, int *  ind_result, const char **  matches, size_t  max_matches, size_t *  pnum_matches  )

static

Convert the string prefix to an integer representation. NB: This function is used for SST_ENUM and SST_BITWISE.

FIXME: this mostly duplicate match_prefix_full().

Definition at line 3340 of file settings.c.

Referenced by setting_match_prefix().

setting_name()

const char * setting_name

(

const struct setting *

pset

)

Access function for the setting name.

Definition at line 3162 of file settings.c.

Referenced by manual_command(), optname_accessor(), save_game_ruleset(), send_server_setting_control(), server_ss_name_get(), set_command(), setting_default_name(), setting_game_restore(), setting_is_changeable(), setting_is_free_to_change(), setting_non_default(), setting_ruleset_one(), setting_value_name(), settings_game_load(), settings_game_save(), settings_list_cmp(), settings_list_init(), show_help_option(), show_help_option_list(), show_settings(), show_settings_one(), srv_ready(), tolua_server_server_setting_get00(), and write_init_script().

setting_non_default()

bool setting_non_default

(

const struct setting *

pset

)

Returns whether the setting has non-default value.

Definition at line 4394 of file settings.c.

Referenced by manual_command(), settings_list_update(), and show_settings_one().

setting_number()

int setting_number

(

const struct setting *

pset

)

Returns the id to the given setting.

Definition at line 3153 of file settings.c.

Referenced by manual_command(), send_server_setting_control(), server_ss_by_name(), setting_default_name(), setting_is_free_to_change(), setting_non_default(), and setting_value_name().

setting_ruleset_one()

static bool setting_ruleset_one ( struct section_file *  file, const char *  name, const char *  path  )

static

Set one setting from the game.ruleset file.

Definition at line 4232 of file settings.c.

Referenced by settings_ruleset().

setting_set_to_default()

void setting_set_to_default

(

struct setting *

pset

)

Update the setting to the default value

Definition at line 4138 of file settings.c.

Referenced by default_command(), setting_game_restore(), settings_init(), settings_reset(), and settings_ruleset().

setting_short_help()

const char * setting_short_help

(

const struct setting *

pset

)

Access function for the short help (not translated yet) of the setting.

Definition at line 3170 of file settings.c.

Referenced by manual_command(), send_server_setting_control(), and show_help_option().

setting_str_get()

char * setting_str_get

(

struct setting *

pset

)

Get value of string setting

Definition at line 3679 of file settings.c.

Referenced by save_game_ruleset().

setting_str_set()

bool setting_str_set	(	struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Set the setting to 'val'. Returns TRUE on success. If it fails, the reason of the failure is available by the function setting_error().

Definition at line 3634 of file settings.c.

Referenced by set_command(), setting_game_restore(), setting_ruleset_one(), and settings_game_load().

setting_str_to_str()

static const char * setting_str_to_str ( const struct setting *  pset, const char *  value, bool  pretty, char *  buf, size_t  buf_len  )

static

Compute the string representation of the value for this string setting.

Definition at line 3618 of file settings.c.

Referenced by setting_default_name(), and setting_value_name().

setting_str_validate()

bool setting_str_validate	(	const struct setting *	pset,
		const char *	val,
		struct connection *	caller,
		char *	reject_msg,
		size_t	reject_msg_len
	)

Returns TRUE if 'val' is a valid value for this setting. If it's not, the reason of the failure is available by the function setting_error().

FIXME: also check the access level of pconn.

Definition at line 3654 of file settings.c.

Referenced by set_command(), and setting_str_set().

setting_type()

enum sset_type setting_type

(

const struct setting *

pset

)

Access function for the setting type.

Definition at line 3191 of file settings.c.

Referenced by manual_command(), save_game_ruleset(), send_server_setting(), server_ss_type_get(), set_command(), setting_bitwise_get(), setting_bool_get(), setting_game_free(), setting_game_restore(), setting_game_set(), setting_int_get(), setting_non_default(), setting_str_get(), settings_game_save(), show_help_option(), and show_settings_one().

setting_value_name()

const char * setting_value_name	(	const struct setting *	pset,
		bool	pretty,
		char *	buf,
		size_t	buf_len
	)

Compute the name of the current value of the setting.

Definition at line 4066 of file settings.c.

Referenced by api_server_setting_get(), manual_command(), set_command(), setting_ruleset_one(), settings_game_load(), show_help_option(), show_settings_one(), srv_ready(), and write_init_script().

settings_free()

void settings_free

(

void

)

Deinitialize stuff related to this code module.

Definition at line 4993 of file settings.c.

Referenced by server_quit().

settings_game_load()

void settings_game_load	(	struct section_file *	file,
		const char *	section
	)

Restore all settings from a savegame.

Definition at line 4648 of file settings.c.

Referenced by sg_load_settings(), and sg_load_settings().

settings_game_reset()

bool settings_game_reset

(

void

)

Reset all settings to the values at game start.

Definition at line 4935 of file settings.c.

Referenced by reset_command().

settings_game_save()

void settings_game_save	(	struct section_file *	file,
		const char *	section
	)

Save game settings.

Definition at line 4561 of file settings.c.

Referenced by sg_save_settings().

settings_game_start()

void settings_game_start

(

void

)

Save setting values at the start of the game.

Definition at line 4548 of file settings.c.

Referenced by srv_ready().

settings_init()

void settings_init

(

bool

act

)

Initialize stuff related to this code module.

Definition at line 4952 of file settings.c.

Referenced by main(), and srv_prepare().

settings_list_cmp()

int settings_list_cmp	(	const struct setting *const *	ppset1,
		const struct setting *const *	ppset2
	)

Update sorted settings (changed and locked values).

Definition at line 5299 of file settings.c.

Referenced by settings_list_init(), and settings_list_update().

settings_list_free()

static void settings_list_free ( void  )

static

Free sorted settings.

Definition at line 5324 of file settings.c.

Referenced by settings_free().

settings_list_get()

struct setting_list * settings_list_get

(

enum sset_level

level

)

Get a settings list of a certain level. Call settings_list_update() before if something was changed.

Definition at line 5312 of file settings.c.

settings_list_init()

static void settings_list_init ( void  )

static

Initialise sorted settings.

Definition at line 5212 of file settings.c.

Referenced by settings_init().

settings_list_update()

void settings_list_update

(

void

)

Update sorted settings (changed and locked values).

Definition at line 5270 of file settings.c.

Referenced by settings_init(), and show_settings().

settings_number()

int settings_number

(

void

)

Returns the total number of settings.

Definition at line 5005 of file settings.c.

Referenced by explain_option(), lookup_option(), show_help(), and universal_kind_values().

settings_reset()

void settings_reset

(

void

)

Reset all settings iff they are changeable.

Definition at line 4971 of file settings.c.

Referenced by reset_command().

settings_ruleset()

bool settings_ruleset	(	struct section_file *	file,
		const char *	section,
		bool	act
	)

Load game settings from ruleset file 'game.ruleset'.

Definition at line 4178 of file settings.c.

Referenced by load_rulesetdir(), and reload_rulesets_settings().

settings_turn()

void settings_turn

(

void

)

Update stuff every turn that is related to this code module. Run this on turn end.

Definition at line 4985 of file settings.c.

Referenced by end_turn().

startpos_name()

static const struct sset_val_name * startpos_name ( int  startpos )

static

Start position setting names accessor.

Definition at line 297 of file settings.c.

startunits_callback()

static bool startunits_callback ( const char *  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Verify that a given startunits string is valid. See game.server.start_units.

Definition at line 967 of file settings.c.

teamplacement_name()

static const struct sset_val_name * teamplacement_name ( int  team_placement )

static

Team placement setting names accessor.

Definition at line 317 of file settings.c.

timeout_action()

static void timeout_action ( const struct setting *  pset )

static

Enact a change in the 'timeout' server setting immediately, if the game is afoot.

Definition at line 733 of file settings.c.

timeout_callback()

static bool timeout_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Validate the 'timeout' server setting.

Definition at line 1084 of file settings.c.

topology_action()

static void topology_action ( const struct setting *  pset )

static

Topology setting changed.

Definition at line 778 of file settings.c.

topology_callback()

static bool topology_callback ( unsigned  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Topology setting validation callback.

Definition at line 1243 of file settings.c.

topology_name()

static const struct sset_val_name * topology_name ( int  topology_bit )

static

Topology setting names accessor.

Definition at line 253 of file settings.c.

traderevenuestyle_name()

static const struct sset_val_name * traderevenuestyle_name ( int  revenue_style )

static

Trade revenue style setting names accessor.

Definition at line 267 of file settings.c.

trait_dist_name()

static const struct sset_val_name * trait_dist_name ( int  trait_dist )

static

Trait distribution setting names accessor.

Definition at line 398 of file settings.c.

unitwaittime_callback()

static bool unitwaittime_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

Check 'timeout' setting if 'unitwaittime' is changed.

Definition at line 1140 of file settings.c.

victory_conditions_name()

static const struct sset_val_name * victory_conditions_name ( int  condition_bit )

static

Victory conditions setting names accessor.

Definition at line 352 of file settings.c.

xsize_callback()

static bool xsize_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

xsize setting validation callback.

Definition at line 1185 of file settings.c.

ysize_callback()

static bool ysize_callback ( int  value, struct connection *  caller, char *  reject_msg, size_t  reject_msg_len  )

static

ysize setting validation callback.

Definition at line 1210 of file settings.c.

Variable Documentation

init

bool init

Definition at line 182 of file settings.c.

Referenced by setting_game_set().

level

struct setting_list* level[OLEVELS_NUM]

Definition at line 183 of file settings.c.

Referenced by ai_level_help(), ai_skill_callback(), api_utilities_log_base(), backtrace_print(), boot_help_texts(), caravan_parameter_log_real(), catastrophe_scaled(), check_tilespec_capabilities(), citylog_map_data(), citylog_map_workers(), cmd_of_level(), cmdlevel_command(), con_handle_log(), con_log_init(), create_ai_menu(), create_conn_menu(), create_players_dialog(), create_start_page(), dai_caravan_goto(), do_log(), expansionism_of_skill_level(), fc_assert_fail(), fuzzy_of_skill_level(), get_compression_level(), handicap_of_skill_level(), handle_stdin_input_real(), pregame_options::init(), insert_veteran_help(), is_settable_ai_level(), log_callback_utf8(), log_parse_level_str(), log_real(), log_set_level(), log_write(), luascript_log(), luascript_log_vargs(), pf_path_print_real(), real_bodyguard_log(), real_city_log(), real_conn_list_dialog_update(), real_diplo_log(), real_tech_log(), real_unit_log(), restore_access_level(), ruleset_error_real(), science_cost_of_skill_level(), script_client_output(), script_server_cmd_reply(), set_ai_level(), set_ai_level_direct(), set_ai_level_directer(), set_ai_level_named(), set_cmdlevel(), settings_list_get(), sg_load_game(), sg_load_game(), sg_load_player_main(), sg_load_player_main(), show_settings(), fc_client::start_page_menu(), theme_lookup_sprite_tag_alt(), tiles_lookup_sprite_tag_alt(), tileset_error(), plr_report::toggle_ai_mode(), unit_transport_depth(), pregame_options::update_ai_level(), update_environmental_upset(), utype_veteran_level(), utype_veteran_name_translation(), vdo_log(), veteran_system_definition(), and vsystem_veteran_level().

[struct]

struct { ... } setting_sorted

Referenced by settings_list_free(), settings_list_get(), settings_list_init(), and settings_list_update().

settings

struct setting settings[]

static

Definition at line 1378 of file settings.c.

Referenced by city_receives_goods(), reestablish_city_trade_routes(), set_city_production(), setting_by_number(), setting_number(), and update_city_activities().

SETTINGS_NUM

const int SETTINGS_NUM = ARRAY_SIZE(settings)

static

Definition at line 3125 of file settings.c.

Referenced by send_server_setting_control(), setting_by_number(), and settings_number().