fgwirc: runtime config values

These are per execution global states that can be changed using the set action any time.

IRC related settings

irc_ident (string)

The ident string sent to the IRC server when connecting. This is the second part in the full hostmask on IRC: nick!ident@hostname.

Default value is "fgwirc".

Historically this is the real user name on a big, shared operating system of the connecting user. The value supplied here would be overridden by the ident server response on port 113, but nobody runs and ident server anymore. The ident server would be ran by the root user and would do an user name lookup based on the IRC TCP connection data. The IRC server prefixes the user supplied ident with a ~ to mark it unreliable, while a true ident server response based ident is not prefixed.

irc_user (string)

Default user real name when connecting to an IRC server. This is always a self-reported field and supposed to contain the real name of the user connecting. In practice it is rarely filled in properly because of privacy concerns. This field shows up on a whois response.

Default value is "fgwirc".

irc_nick (string)

Default nickname when connecting to a new IRC server. Shall be modified from the rc script.

Default value is "fgwirc".

irc_default_port (int)

Default port to be used when connecting to a new IRC server with port unspecified in the server action.

Default value is 6667.

irc_debug (int)

When non-zero, print all incoming lines from the IRC servers in the server status window. Useful for debugging the code or user scripts.

Default value is 0.

Windowing related settings

win_max_scroll_back_len (int)

Number of raw lines to remember (store in memory) for the per window scroll-back buffer. A new value takes effect in each window the next time a new raw line is appended in the given window.

Default value is 256.

win_display_timestamp (int)

When set to non-zero, display time stamp with each raw line on screen (does not affect file logging).

Default value is 0.

win_encoding (string)

Convert raw lines (e.g. incoming IRC messages) to the specified character encoding before inserting in the window log. Value is an iconv(3) encoding name.

Default value is "iso-8859-1//TRANSLIT".

Misc settings

fgwirc_exit_val (int)

Exit value of the fgwirc process once the exit or quit action is called. Typically the script that is going to call exit or quit will set this value first to indicate normal or error exit.

Default value is 0.

edit_history_len (int)

Number of lines remembered for edit line history. Has to be at least 1. Line editor history is per execution, no history saved on disk. A new value takes effect next time a line is appended to the line editor history.

Default value is 128.