nhyatt/putty-source
1
0
Fork 0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-09 17:38:00 +00:00
Code Issues Projects Releases Wiki Activity
b29758c1b6
putty-source/conf.h
Simon Tatham b29758c1b6 Add ability to specify custom load and save separately. 
This allows a couple more settings to be treated automatically on
save, which are more complicated on load because they still honour
older alternative save keywords.

In particular, CONF_proxy_type and CONF_remote_qtitle_action now have
explicit enum mappings. These were needed for the automated save code,
but also, I've rewritten the custom load code to use them too. This
decouples the storage format of those settings from the order of
values in the internal enum, which is generally an advantage of
specifying storage enums explicitly.

Those two settings weren't already tested by test_conf, because I
wasn't changing them in previous commits. Now I've added extra code
that does test them, and verified it works when backported to commit
b567c9b2b5 where I introduced test_conf before beginning the main
refactoring.

A setting can also be specified explicitly as not loaded and saved at
all. There were quite a few commented that way, but now there's a
machine-readable indication of it.

test_conf will now check that all these settings make sense together -
things shouldn't have a save keyword unless they use it, and should
have one if they don't, and shouldn't specify combinations of options
that conflict.

(For that reason, test_conf is now also running the consistency check
before the main test, so that a missing keyword will cause an error
message _before_ it causes a segfault, saving some debugging!)
2023-09-22 16:23:37 +01:00

1237 lines
32 KiB
C
Raw Blame History

/*
* Master list of configuration options living in the Conf data
* structure.
*
* Each CONF_OPTION directive defines a single CONF_foo primary key in
* Conf, and can be equipped with the following properties:
*
* - VALUE_TYPE: the type of data associated with that key
* - SUBKEY_TYPE: if the primary key goes with a subkey (that is, the
* primary key identifies some mapping from subkeys to values), the
* data type of the subkey
*/
CONF_OPTION(host,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("HostName"),
)
CONF_OPTION(port,
VALUE_TYPE(INT),
SAVE_KEYWORD("PortNumber"),
LOAD_CUSTOM, /* default value depends on the value of CONF_protocol */
)
CONF_OPTION(protocol,
VALUE_TYPE(INT), /* PROT_SSH, PROT_TELNET etc */
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Notionally SAVE_KEYWORD("Protocol"), but saving/loading is handled by
* custom code because the stored value is a string representation
* of the protocol name.
*/
)
CONF_OPTION(addressfamily,
VALUE_TYPE(INT),
DEFAULT_INT(ADDRTYPE_UNSPEC),
SAVE_KEYWORD("AddressFamily"),
STORAGE_ENUM(addressfamily),
)
CONF_OPTION(close_on_exit,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("CloseOnExit"),
STORAGE_ENUM(off_auto_on),
)
CONF_OPTION(warn_on_close,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("WarnOnClose"),
)
CONF_OPTION(ping_interval,
VALUE_TYPE(INT), /* in seconds */
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Saving/loading is handled by custom code because for historical
* reasons this value corresponds to two save keywords,
* "PingInterval" (measured in minutes) and "PingIntervalSecs"
* (measured in seconds), which are added together on loading.
* Rationale: the value was once measured in minutes, and the
* seconds field was added later.
*/
)
CONF_OPTION(tcp_nodelay,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("TCPNoDelay"),
)
CONF_OPTION(tcp_keepalives,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("TCPKeepalives"),
)
CONF_OPTION(loghost, /* logical host being contacted, for host key check */
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("LogHost"),
)
/* Proxy options */
CONF_OPTION(proxy_exclude_list,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("ProxyExcludeList"),
)
CONF_OPTION(proxy_dns,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("ProxyDNS"),
STORAGE_ENUM(off_auto_on),
)
CONF_OPTION(even_proxy_localhost,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ProxyLocalhost"),
)
CONF_OPTION(proxy_type,
VALUE_TYPE(INT), /* PROXY_NONE, PROXY_SOCKS4, ... */
STORAGE_ENUM(proxy_type),
SAVE_KEYWORD("ProxyMethod"),
LOAD_CUSTOM,
/*
* Custom load code: there was an earlier keyword "ProxyType"
* using a different enumeration, in which SOCKS4 and SOCKS5
* shared a value, and a second keyword "ProxySOCKSVersion"
* disambiguated.
*/
)
CONF_OPTION(proxy_host,
VALUE_TYPE(STR),
DEFAULT_STR("proxy"),
SAVE_KEYWORD("ProxyHost"),
)
CONF_OPTION(proxy_port,
VALUE_TYPE(INT),
DEFAULT_INT(80),
SAVE_KEYWORD("ProxyPort"),
)
CONF_OPTION(proxy_username,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("ProxyUsername"),
)
CONF_OPTION(proxy_password,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("ProxyPassword"),
)
CONF_OPTION(proxy_telnet_command,
VALUE_TYPE(STR),
DEFAULT_STR("connect %host %port\\n"),
SAVE_KEYWORD("ProxyTelnetCommand"),
)
CONF_OPTION(proxy_log_to_term,
VALUE_TYPE(INT),
DEFAULT_INT(FORCE_OFF),
SAVE_KEYWORD("ProxyLogToTerm"),
STORAGE_ENUM(on_off_auto),
)
/* SSH options */
CONF_OPTION(remote_cmd,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("RemoteCommand"),
)
CONF_OPTION(remote_cmd2,
/*
* Fallback command to try to run if remote_cmd fails. Only set
* internally by PSCP and PSFTP (so that they can try multiple
* methods of running an SFTP server at the remote end); never set
* by user configuration, or loaded or saved.
*/
VALUE_TYPE(STR),
NOT_SAVED,
)
CONF_OPTION(nopty,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoPTY"),
)
CONF_OPTION(compression,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("Compression"),
)
CONF_OPTION(ssh_kexlist,
SUBKEY_TYPE(INT), /* indices in preference order: 0,...,KEX_MAX-1
* (lower is more preferred) */
VALUE_TYPE(INT), /* KEX_* enum values */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for preference lists */
)
CONF_OPTION(ssh_hklist,
SUBKEY_TYPE(INT), /* indices in preference order: 0,...,HK_MAX-1
* (lower is more preferred) */
VALUE_TYPE(INT), /* HK_* enum values */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for preference lists */
)
CONF_OPTION(ssh_prefer_known_hostkeys,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("PreferKnownHostKeys"),
)
CONF_OPTION(ssh_rekey_time,
VALUE_TYPE(INT), /* in minutes */
DEFAULT_INT(60),
SAVE_KEYWORD("RekeyTime"),
)
CONF_OPTION(ssh_rekey_data,
VALUE_TYPE(STR), /* string encoding e.g. "100K", "2M", "1G" */
DEFAULT_STR("1G"),
SAVE_KEYWORD("RekeyBytes"),
)
CONF_OPTION(tryagent,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("TryAgent"),
)
CONF_OPTION(agentfwd,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("AgentFwd"),
)
CONF_OPTION(change_username, /* allow username switching in SSH-2 */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ChangeUsername"),
)
CONF_OPTION(ssh_cipherlist,
SUBKEY_TYPE(INT), /* indices in preference order: 0,...,CIPHER_MAX-1
* (lower is more preferred) */
VALUE_TYPE(INT), /* CIPHER_* enum values */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for preference lists */
)
CONF_OPTION(keyfile,
VALUE_TYPE(FILENAME),
SAVE_KEYWORD("PublicKeyFile"),
)
CONF_OPTION(detached_cert,
VALUE_TYPE(FILENAME),
SAVE_KEYWORD("DetachedCertificate"),
)
CONF_OPTION(auth_plugin,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("AuthPlugin"),
)
CONF_OPTION(sshprot,
/*
* Which SSH protocol to use.
*
* For historical reasons, the current legal values for CONF_sshprot
* are:
* 0 = SSH-1 only
* 3 = SSH-2 only
*
* We used to also support
* 1 = SSH-1 with fallback to SSH-2
* 2 = SSH-2 with fallback to SSH-1
*
* and we continue to use 0/3 in storage formats rather than the more
* obvious 1/2 to avoid surprises if someone saves a session and later
* downgrades PuTTY. So it's easier to use these numbers internally too.
*/
VALUE_TYPE(INT),
DEFAULT_INT(3),
SAVE_KEYWORD("SshProt"),
STORAGE_ENUM(ssh_protocol),
)
CONF_OPTION(ssh_simple,
/*
* This means that we promise never to open any channel other
* than the main one, which means it can safely use a very large
* window in SSH-2.
*
* Only ever set internally by file transfer tools; never set by
* user configuration, or loaded or saved.
*/
VALUE_TYPE(BOOL),
NOT_SAVED,
)
CONF_OPTION(ssh_connection_sharing,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ConnectionSharing"),
)
CONF_OPTION(ssh_connection_sharing_upstream,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("ConnectionSharingUpstream"),
)
CONF_OPTION(ssh_connection_sharing_downstream,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("ConnectionSharingDownstream"),
)
CONF_OPTION(ssh_manual_hostkeys,
/*
* Manually configured host keys to accept regardless of the state
* of the host key cache.
*
* This is conceptually a set rather than a dictionary: every
* value in this map is the empty string, and the set of subkeys
* that exist is the important data.
*/
SUBKEY_TYPE(STR),
VALUE_TYPE(STR),
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
CONF_OPTION(ssh2_des_cbc, /* "des-cbc" unrecommended SSH-2 cipher */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SSH2DES"),
)
CONF_OPTION(ssh_no_userauth, /* bypass "ssh-userauth" (SSH-2 only) */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SshNoAuth"),
)
CONF_OPTION(ssh_no_trivial_userauth, /* disable trivial types of auth */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SshNoTrivialAuth"),
)
CONF_OPTION(ssh_show_banner, /* show USERAUTH_BANNERs (SSH-2 only) */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("SshBanner"),
)
CONF_OPTION(try_tis_auth,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("AuthTIS"),
)
CONF_OPTION(try_ki_auth,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("AuthKI"),
)
CONF_OPTION(try_gssapi_auth, /* attempt gssapi via ssh userauth */
VALUE_TYPE(BOOL),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifndef NO_GSSAPI */
)
CONF_OPTION(try_gssapi_kex, /* attempt gssapi via ssh kex */
VALUE_TYPE(BOOL),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifndef NO_GSSAPI */
)
CONF_OPTION(gssapifwd, /* forward tgt via gss */
VALUE_TYPE(BOOL),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifndef NO_GSSAPI */
)
CONF_OPTION(gssapirekey, /* KEXGSS refresh interval (mins) */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifndef NO_GSSAPI */
)
CONF_OPTION(ssh_gsslist,
SUBKEY_TYPE(INT), /* indices in preference order: 0,...,ngsslibs
* (lower is more preferred; ngsslibs is a platform-
* dependent value) */
VALUE_TYPE(INT), /* indices of GSSAPI lib types (platform-dependent) */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for preference lists, also this
* setting is under #ifndef NO_GSSAPI */
)
CONF_OPTION(ssh_gss_custom,
VALUE_TYPE(FILENAME),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifndef NO_GSSAPI */
)
CONF_OPTION(ssh_subsys, /* run a subsystem rather than a command */
/*
* Only set internally by PSCP and PSFTP; never set by user
* configuration, or loaded or saved.
*/
VALUE_TYPE(BOOL),
NOT_SAVED,
)
CONF_OPTION(ssh_subsys2, /* fallback to go with remote_cmd_ptr2 */
/*
* Only set internally by PSCP and PSFTP; never set by user
* configuration, or loaded or saved.
*/
VALUE_TYPE(BOOL),
NOT_SAVED,
)
CONF_OPTION(ssh_no_shell, /* avoid running a shell */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SshNoShell"),
)
CONF_OPTION(ssh_nc_host, /* host to connect to in `nc' mode */
/*
* Only set by the '-nc' command-line option and by the SSH proxy
* code. There's no GUI config option for this, and therefore it's
* also never loaded or saved.
*/
VALUE_TYPE(STR),
NOT_SAVED,
)
CONF_OPTION(ssh_nc_port, /* port to connect to in `nc' mode */
/*
* Only set by the '-nc' command-line option and by the SSH proxy
* code. There's no GUI config option for this, and therefore it's
* also never loaded or saved.
*/
VALUE_TYPE(INT),
NOT_SAVED,
)
/* Telnet options */
CONF_OPTION(termtype,
VALUE_TYPE(STR),
DEFAULT_STR("xterm"),
SAVE_KEYWORD("TerminalType"),
)
CONF_OPTION(termspeed,
VALUE_TYPE(STR),
DEFAULT_STR("38400,38400"),
SAVE_KEYWORD("TerminalSpeed"),
)
CONF_OPTION(ttymodes,
SUBKEY_TYPE(STR), /* subkeys are listed in ttymodes[] in settings.c */
VALUE_TYPE(STR), /* values are "Vvalue" or "A" */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
CONF_OPTION(environmt,
SUBKEY_TYPE(STR), /* environment variable name */
VALUE_TYPE(STR), /* environment variable value */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
CONF_OPTION(username,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("UserName"),
)
CONF_OPTION(username_from_env,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("UserNameFromEnvironment"),
)
CONF_OPTION(localusername,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("LocalUserName"),
)
CONF_OPTION(rfc_environ,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("RFCEnviron"),
)
CONF_OPTION(passive_telnet,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("PassiveTelnet"),
)
/* Serial port options */
CONF_OPTION(serline,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("SerialLine"),
)
CONF_OPTION(serspeed,
VALUE_TYPE(INT),
DEFAULT_INT(9600),
SAVE_KEYWORD("SerialSpeed"),
)
CONF_OPTION(serdatabits,
VALUE_TYPE(INT),
DEFAULT_INT(8),
SAVE_KEYWORD("SerialDataBits"),
)
CONF_OPTION(serstopbits,
VALUE_TYPE(INT),
DEFAULT_INT(2),
SAVE_KEYWORD("SerialStopHalfbits"),
)
CONF_OPTION(serparity,
VALUE_TYPE(INT),
DEFAULT_INT(SER_PAR_NONE),
SAVE_KEYWORD("SerialParity"),
STORAGE_ENUM(serparity),
)
CONF_OPTION(serflow,
VALUE_TYPE(INT),
DEFAULT_INT(SER_FLOW_XONXOFF),
SAVE_KEYWORD("SerialFlowControl"),
STORAGE_ENUM(serflow),
)
/* SUPDUP options */
CONF_OPTION(supdup_location,
VALUE_TYPE(STR),
DEFAULT_STR("The Internet"),
SAVE_KEYWORD("SUPDUPLocation"),
)
CONF_OPTION(supdup_ascii_set,
VALUE_TYPE(INT),
DEFAULT_INT(SUPDUP_CHARSET_ASCII),
SAVE_KEYWORD("SUPDUPCharset"),
STORAGE_ENUM(supdup_charset),
)
CONF_OPTION(supdup_more,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SUPDUPMoreProcessing"),
)
CONF_OPTION(supdup_scroll,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SUPDUPScrolling"),
)
/* Keyboard options */
CONF_OPTION(bksp_is_delete,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("BackspaceIsDelete"),
)
CONF_OPTION(rxvt_homeend,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("RXVTHomeEnd"),
)
CONF_OPTION(funky_type,
VALUE_TYPE(INT),
DEFAULT_INT(FUNKY_TILDE),
SAVE_KEYWORD("LinuxFunctionKeys"),
STORAGE_ENUM(funky_type),
)
CONF_OPTION(sharrow_type,
VALUE_TYPE(INT),
DEFAULT_INT(SHARROW_APPLICATION),
SAVE_KEYWORD("ShiftedArrowKeys"),
STORAGE_ENUM(sharrow_type),
)
CONF_OPTION(no_applic_c, /* totally disable app cursor keys */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoApplicationCursors"),
)
CONF_OPTION(no_applic_k, /* totally disable app keypad */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoApplicationKeys"),
)
CONF_OPTION(no_mouse_rep, /* totally disable mouse reporting */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoMouseReporting"),
)
CONF_OPTION(no_remote_resize, /* disable remote resizing */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoRemoteResize"),
)
CONF_OPTION(no_alt_screen, /* disable alternate screen */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoAltScreen"),
)
CONF_OPTION(no_remote_wintitle, /* disable remote retitling */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoRemoteWinTitle"),
)
CONF_OPTION(no_remote_clearscroll, /* disable ESC[3J */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoRemoteClearScroll"),
)
CONF_OPTION(no_dbackspace, /* disable destructive backspace */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoDBackspace"),
)
CONF_OPTION(no_remote_charset, /* disable remote charset config */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NoRemoteCharset"),
)
CONF_OPTION(remote_qtitle_action, /* handling of remote window title queries */
VALUE_TYPE(INT),
STORAGE_ENUM(remote_qtitle_action),
SAVE_KEYWORD("RemoteQTitleAction"),
LOAD_CUSTOM, /* older versions had a boolean "NoRemoteQTitle"
* before we ended up with three options */
)
CONF_OPTION(app_cursor,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ApplicationCursorKeys"),
)
CONF_OPTION(app_keypad,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ApplicationKeypad"),
)
CONF_OPTION(nethack_keypad,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("NetHackKeypad"),
)
CONF_OPTION(telnet_keyboard,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("TelnetKey"),
)
CONF_OPTION(telnet_newline,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("TelnetRet"),
)
CONF_OPTION(alt_f4, /* is it special? */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("AltF4"),
)
CONF_OPTION(alt_space, /* is it special? */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("AltSpace"),
)
CONF_OPTION(alt_only, /* is it special? */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("AltOnly"),
)
CONF_OPTION(localecho,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("LocalEcho"),
STORAGE_ENUM(on_off_auto),
)
CONF_OPTION(localedit,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("LocalEdit"),
STORAGE_ENUM(on_off_auto),
)
CONF_OPTION(alwaysontop,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("AlwaysOnTop"),
)
CONF_OPTION(fullscreenonaltenter,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("FullScreenOnAltEnter"),
)
CONF_OPTION(scroll_on_key,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ScrollOnKey"),
)
CONF_OPTION(scroll_on_disp,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("ScrollOnDisp"),
)
CONF_OPTION(erase_to_scrollback,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("EraseToScrollback"),
)
CONF_OPTION(compose_key,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ComposeKey"),
)
CONF_OPTION(ctrlaltkeys,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("CtrlAltKeys"),
)
CONF_OPTION(osx_option_meta,
VALUE_TYPE(BOOL),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifdef OSX_META_KEY_CONFIG */
)
CONF_OPTION(osx_command_meta,
VALUE_TYPE(BOOL),
LOAD_CUSTOM, SAVE_CUSTOM, /* under #ifdef OSX_META_KEY_CONFIG */
)
CONF_OPTION(wintitle, /* initial window title */
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("WinTitle"),
)
/* Terminal options */
CONF_OPTION(savelines,
VALUE_TYPE(INT),
DEFAULT_INT(2000),
SAVE_KEYWORD("ScrollbackLines"),
)
CONF_OPTION(dec_om,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("DECOriginMode"),
)
CONF_OPTION(wrap_mode,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("AutoWrapMode"),
)
CONF_OPTION(lfhascr,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("LFImpliesCR"),
)
CONF_OPTION(cursor_type,
VALUE_TYPE(INT),
DEFAULT_INT(0),
SAVE_KEYWORD("CurType"),
STORAGE_ENUM(cursor_type),
)
CONF_OPTION(blink_cur,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("BlinkCur"),
)
CONF_OPTION(beep,
VALUE_TYPE(INT),
DEFAULT_INT(BELL_DEFAULT),
SAVE_KEYWORD("Beep"),
STORAGE_ENUM(beep),
)
CONF_OPTION(beep_ind,
VALUE_TYPE(INT),
DEFAULT_INT(B_IND_DISABLED),
SAVE_KEYWORD("BeepInd"),
STORAGE_ENUM(beep_indication),
)
CONF_OPTION(bellovl, /* bell overload protection active? */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("BellOverload"),
)
CONF_OPTION(bellovl_n, /* number of bells to cause overload */
VALUE_TYPE(INT),
DEFAULT_INT(5),
SAVE_KEYWORD("BellOverloadN"),
)
CONF_OPTION(bellovl_t, /* time interval for overload (ticks) */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Loading and saving is done in custom code because the format is
* platform-dependent for historical reasons: on Unix, the stored
* value is multiplied by 1000. (And since TICKSPERSEC=1000 on
* that platform, it means the stored value is interpreted in
* microseconds.)
*/
)
CONF_OPTION(bellovl_s, /* period of silence to re-enable bell (s) */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Loading and saving is done in custom code because the format is
* platform-dependent for historical reasons: on Unix, the stored
* value is multiplied by 1000. (And since TICKSPERSEC=1000 on
* that platform, it means the stored value is interpreted in
* microseconds.)
*/
)
CONF_OPTION(bell_wavefile,
VALUE_TYPE(FILENAME),
SAVE_KEYWORD("BellWaveFile"),
)
CONF_OPTION(scrollbar,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("ScrollBar"),
)
CONF_OPTION(scrollbar_in_fullscreen,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ScrollBarFullScreen"),
)
CONF_OPTION(resize_action,
VALUE_TYPE(INT),
DEFAULT_INT(RESIZE_TERM),
SAVE_KEYWORD("LockSize"),
STORAGE_ENUM(resize_effect),
)
CONF_OPTION(bce,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("BCE"),
)
CONF_OPTION(blinktext,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("BlinkText"),
)
CONF_OPTION(win_name_always,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("WinNameAlways"),
)
CONF_OPTION(width,
VALUE_TYPE(INT),
DEFAULT_INT(80),
SAVE_KEYWORD("TermWidth"),
)
CONF_OPTION(height,
VALUE_TYPE(INT),
DEFAULT_INT(24),
SAVE_KEYWORD("TermHeight"),
)
CONF_OPTION(font,
VALUE_TYPE(FONT),
SAVE_KEYWORD("Font"),
)
CONF_OPTION(font_quality,
VALUE_TYPE(INT),
DEFAULT_INT(FQ_DEFAULT),
SAVE_KEYWORD("FontQuality"),
STORAGE_ENUM(font_quality),
)
CONF_OPTION(logfilename,
VALUE_TYPE(FILENAME),
SAVE_KEYWORD("LogFileName"),
)
CONF_OPTION(logtype,
VALUE_TYPE(INT),
DEFAULT_INT(LGTYP_NONE),
SAVE_KEYWORD("LogType"),
STORAGE_ENUM(log_type),
)
CONF_OPTION(logxfovr,
VALUE_TYPE(INT),
DEFAULT_INT(LGXF_ASK),
SAVE_KEYWORD("LogFileClash"),
STORAGE_ENUM(log_to_existing_file),
)
CONF_OPTION(logflush,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("LogFlush"),
)
CONF_OPTION(logheader,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("LogHeader"),
)
CONF_OPTION(logomitpass,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("SSHLogOmitPasswords"),
)
CONF_OPTION(logomitdata,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SSHLogOmitData"),
)
CONF_OPTION(hide_mouseptr,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("HideMousePtr"),
)
CONF_OPTION(sunken_edge,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("SunkenEdge"),
)
CONF_OPTION(window_border,
VALUE_TYPE(INT), /* in pixels */
DEFAULT_INT(1),
SAVE_KEYWORD("WindowBorder"),
)
CONF_OPTION(answerback,
VALUE_TYPE(STR),
DEFAULT_STR("PuTTY"),
SAVE_KEYWORD("Answerback"),
)
CONF_OPTION(printer,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("Printer"),
)
CONF_OPTION(no_arabicshaping,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("DisableArabicShaping"),
)
CONF_OPTION(no_bidi,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("DisableBidi"),
)
/* Colour options */
CONF_OPTION(ansi_colour,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("ANSIColour"),
)
CONF_OPTION(xterm_256_colour,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("Xterm256Colour"),
)
CONF_OPTION(true_colour,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("TrueColour"),
)
CONF_OPTION(system_colour,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("UseSystemColours"),
)
CONF_OPTION(try_palette,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("TryPalette"),
)
CONF_OPTION(bold_style,
VALUE_TYPE(INT),
DEFAULT_INT(2),
SAVE_KEYWORD("BoldAsColour"),
STORAGE_ENUM(bold_style),
)
CONF_OPTION(colours,
SUBKEY_TYPE(INT), /* indexed by CONF_COLOUR_* enum encoding */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
/* Selection options */
CONF_OPTION(mouse_is_xterm,
VALUE_TYPE(INT),
DEFAULT_INT(0),
SAVE_KEYWORD("MouseIsXterm"),
STORAGE_ENUM(mouse_buttons),
)
CONF_OPTION(rect_select,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("RectSelect"),
)
CONF_OPTION(paste_controls,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("PasteControls"),
)
CONF_OPTION(rawcnp,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("RawCNP"),
)
CONF_OPTION(utf8linedraw,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("UTF8linedraw"),
)
CONF_OPTION(rtf_paste,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("PasteRTF"),
)
CONF_OPTION(mouse_override,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("MouseOverride"),
)
CONF_OPTION(wordness,
SUBKEY_TYPE(INT), /* ASCII character codes (literally, just 00-7F) */
VALUE_TYPE(INT), /* arbitrary equivalence-class value for that char */
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
CONF_OPTION(mouseautocopy,
/*
* What clipboard (if any) to copy text to as soon as it's
* selected with the mouse.
*/
VALUE_TYPE(BOOL),
DEFAULT_BOOL(CLIPUI_DEFAULT_AUTOCOPY), /* platform-dependent bool-valued
* macro */
SAVE_KEYWORD("MouseAutocopy"),
)
CONF_OPTION(mousepaste, /* clipboard used by one-mouse-click paste actions */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* SAVE_KEYWORD("MousePaste"), but loading and saving is done by
* custom code, because the saved value is a string, and also sets
* CONF_mousepaste_custom
*/
)
CONF_OPTION(ctrlshiftins, /* clipboard used by Ctrl+Ins and Shift+Ins */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* SAVE_KEYWORD("CtrlShiftIns"), but loading and saving is done by
* custom code, because the saved value is a string, and also sets
* CONF_ctrlshiftins_custom
*/
)
CONF_OPTION(ctrlshiftcv, /* clipboard used by Ctrl+Shift+C and Ctrl+Shift+V */
VALUE_TYPE(INT),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* SAVE_KEYWORD("CtrlShiftCV"), but loading and saving is done by
* custom code, because the saved value is a string, and also sets
* CONF_ctrlshiftcv_custom
*/
)
CONF_OPTION(mousepaste_custom,
/* Custom clipboard name if CONF_mousepaste is set to CLIPUI_CUSTOM */
VALUE_TYPE(STR),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Loading and saving is handled by custom code in conjunction
* with CONF_mousepaste
*/
)
CONF_OPTION(ctrlshiftins_custom,
/* Custom clipboard name if CONF_ctrlshiftins is set to CLIPUI_CUSTOM */
VALUE_TYPE(STR),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Loading and saving is handled by custom code in conjunction
* with CONF_ctrlshiftins
*/
)
CONF_OPTION(ctrlshiftcv_custom,
/* Custom clipboard name if CONF_ctrlshiftcv is set to CLIPUI_CUSTOM */
VALUE_TYPE(STR),
LOAD_CUSTOM, SAVE_CUSTOM,
/*
* Loading and saving is handled by custom code in conjunction
* with CONF_ctrlshiftcv
*/
)
/* Character-set translation */
CONF_OPTION(vtmode,
VALUE_TYPE(INT),
DEFAULT_INT(VT_UNICODE),
SAVE_KEYWORD("FontVTMode"),
STORAGE_ENUM(line_drawing),
)
CONF_OPTION(line_codepage,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("LineCodePage"),
)
CONF_OPTION(cjk_ambig_wide,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("CJKAmbigWide"),
)
CONF_OPTION(utf8_override,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("UTF8Override"),
)
CONF_OPTION(xlat_capslockcyr,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("CapsLockCyr"),
)
/* X11 forwarding */
CONF_OPTION(x11_forward,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("X11Forward"),
)
CONF_OPTION(x11_display,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("X11Display"),
)
CONF_OPTION(x11_auth,
VALUE_TYPE(INT),
DEFAULT_INT(X11_MIT),
SAVE_KEYWORD("X11AuthType"),
STORAGE_ENUM(x11_auth),
)
CONF_OPTION(xauthfile,
VALUE_TYPE(FILENAME),
SAVE_KEYWORD("X11AuthFile"),
)
/* Port forwarding */
CONF_OPTION(lport_acceptall, /* accept conns from hosts other than localhost */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("LocalPortAcceptAll"),
)
CONF_OPTION(rport_acceptall, /* same for remote forwarded ports */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("RemotePortAcceptAll"),
)
CONF_OPTION(portfwd,
/*
* Subkeys for 'portfwd' can have the following forms:
*
* [LR]localport
* [LR]localaddr:localport
*
* Dynamic forwardings are indicated by an 'L' key, and the
* special value "D". For all other forwardings, the value should
* be of the form 'host:port'.
*/
SUBKEY_TYPE(STR),
VALUE_TYPE(STR),
LOAD_CUSTOM, SAVE_CUSTOM, /* necessary for mappings */
)
/* SSH bug compatibility modes. All FORCE_ON/FORCE_OFF/AUTO */
CONF_OPTION(sshbug_ignore1,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugIgnore1"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_plainpw1,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugPlainPW1"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_rsa1,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugRSA1"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_ignore2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugIgnore2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_derivekey2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugDeriveKey2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_rsapad2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugRSAPad2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_pksessid2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugPKSessID2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_rekey2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugRekey2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_maxpkt2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugMaxPkt2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_oldgex2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugOldGex2"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_winadj,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugWinadj"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_chanreq,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugChanReq"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_dropstart,
VALUE_TYPE(INT),
DEFAULT_INT(FORCE_OFF),
SAVE_KEYWORD("BugDropStart"),
STORAGE_ENUM(off1_on2),
)
CONF_OPTION(sshbug_filter_kexinit,
VALUE_TYPE(INT),
DEFAULT_INT(FORCE_OFF),
SAVE_KEYWORD("BugFilterKexinit"),
STORAGE_ENUM(off1_on2),
)
CONF_OPTION(sshbug_rsa_sha2_cert_userauth,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugRSASHA2CertUserauth"),
STORAGE_ENUM(auto_off_on),
)
CONF_OPTION(sshbug_hmac2,
VALUE_TYPE(INT),
DEFAULT_INT(AUTO),
SAVE_KEYWORD("BugHMAC2"),
STORAGE_ENUM(auto_off_on),
LOAD_CUSTOM, /* there was an earlier keyword called "BuggyMAC" */
)
/* Options for Unix. Should split out into platform-dependent part. */
CONF_OPTION(stamp_utmp, /* used by Unix pterm */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("StampUtmp"),
)
CONF_OPTION(login_shell, /* used by Unix pterm */
VALUE_TYPE(BOOL),
DEFAULT_BOOL(true),
SAVE_KEYWORD("LoginShell"),
)
CONF_OPTION(scrollbar_on_left,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ScrollbarOnLeft"),
)
CONF_OPTION(shadowbold,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("ShadowBold"),
)
CONF_OPTION(boldfont,
VALUE_TYPE(FONT),
SAVE_KEYWORD("BoldFont"),
)
CONF_OPTION(widefont,
VALUE_TYPE(FONT),
SAVE_KEYWORD("WideFont"),
)
CONF_OPTION(wideboldfont,
VALUE_TYPE(FONT),
SAVE_KEYWORD("WideBoldFont"),
)
CONF_OPTION(shadowboldoffset,
VALUE_TYPE(INT), /* in pixels */
DEFAULT_INT(1),
SAVE_KEYWORD("ShadowBoldOffset"),
)
CONF_OPTION(crhaslf,
VALUE_TYPE(BOOL),
DEFAULT_BOOL(false),
SAVE_KEYWORD("CRImpliesLF"),
)
CONF_OPTION(winclass,
VALUE_TYPE(STR),
DEFAULT_STR(""),
SAVE_KEYWORD("WindowClass"),
)
Reference in New Issue View Git Blame Copy Permalink