http://www.epicsol.org/help/ 2008-01-28T16:27:56+00:00 http://www.epicsol.org/help/ http://www.epicsol.org/help/lib/images/favicon.ico text/html 2006-07-12T09:00:00+00:00 http://www.epicsol.org/help/2.8script?rev=1152712800 # $EPIC: 2.8script.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ load 2.8script This is one of the default script loaded when the client is started; it is loaded from GLOBAL. It redefines the returned messages from STATS queries and in channel ban lists. It contains several aliases; those whose names are the same as built-in commands are intended to enhance them. text/html 2006-07-12T09:00:00+00:00 http://www.epicsol.org/help/abort?rev=1152712800 abort This command initiates an orderly abnormal shutdown of EPIC using the abort(3) C library function, which typically results in a core dump. This command is intended for debugging purposes. The abort command first appeared in “plus-9” (post-ircII, pre-EPIC). text/html 2006-07-12T09:00:00+00:00 http://www.epicsol.org/help/about_epic?rev=1152712800 EPIC is 100% backwards compatible with ircII because EPIC is ircII. EPIC was originally built upon the ircII 2.6 client and has maintained faithfulness to remain current up to the 2.8.2 release. EPIC is slightly larger than ircII-4.4 (about 40k on this system), but that is mostly because of the multitude of new features, the dual ANSI/K&R compliant function headers, and the large amount of re-written code in an attempt to make ircII faster, more efficient, and more powerful. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/abs?rev=1152593863 # $EPIC: abs.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $abs(<number>) Calculates the absolute value of <number>. The absolute value of the argument, or nothing if no argument is specified. * abs(-3) returns “3” * abs(5) returns “5” * abs(0) returns “0” text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/acos?rev=1156125339 # $EPIC: acos.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $acos(<number>) * Returns the arc cosine of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/acosh?rev=1156125339 # $EPIC: acosh.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $acosh(<number>) * Returns the inverse hyperbolic cosine of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2007-02-28T11:16:22+00:00 http://www.epicsol.org/help/activity?rev=1172682982 text/html 2007-02-18T09:20:00+00:00 http://www.epicsol.org/help/addset?rev=1171812000 text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/admin?rev=1152712801 admin admin <server> admin <nickname> This command asks a server to give you information about who runs this irc server and how you can contact them (usually by email.) If you don’t specify any arguments, your local server will be queried. If you specify a remote server, it will be queried instead. If you specify another irc user, that user’s server will be queried. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/after?rev=1172803800 # $EPIC: after.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $after([<count>] <char> <text>) * The <count> argument is optional, the default value is 1. <count> must be some non-zero number to be recognized as a count. If <count> is 0, it will be taken as the <char> argument, and <count> will default to 1! * If <count> is positive, then the return value of this function is the trailing portion of <text> that is after the <count>th occurrence of any of the characters in <char>. * If <cou… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/afterw?rev=1172803800 # $EPIC: afterw.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ $afterw(<word> <pattern list>) * If the <word> argument is omitted this function returns the empty string. * The <pattern list> does not actually need to be a list of wildcard patterns. A list of literal words will work just fine. * If <word> is not matched by any of the words in <pattern list>, this function returns the empty string. * Otherwise, the function behaves “as if” the following had been performed: <val> = rma… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/alias?rev=1156876398 This is a disambiguation page. Do you mean the alias command or the aliasctl function? text/html 2007-08-05T08:50:00+00:00 http://www.epicsol.org/help/alias_command?rev=1186321800 alias alias <alias-name> alias -<alias-name> alias <alias-name> {block} alias <alias-name> (<argument-list>) {block} Alias creates a macro which can be either used as the command in a statement, and as a function name. Just as with any other command or function, an alias receives an argument list. Each time the alias is invoked, the arguments are processed according to <argument-list>, and the block is executed. text/html 2007-08-06T16:26:04+00:00 http://www.epicsol.org/help/aliasctl?rev=1186435564 #$EPIC: aliasctl.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ $aliasctl(<domain> <operation> <operand> [<rval>]) $aliasctl(<domain> GETPACKAGE <lval>) $aliasctl(<domain> GET <lval>) $aliasctl(<domain> SETPACKAGE <lval> <package-name>) $aliasctl(<domain> SET <lval> <rval>) $aliasctl(<domain> MATCH <word>) $aliasctl(<domain> PMATCH <pattern>) $aliasctl(<domain> EXISTS <lval>) text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/allocdump?rev=1152593863 allocdump <filename> If you #define’d ALLOC_DEBUG in config.h (it is not by default), then this command will write a log of all of the heap memory that is currently in use. This is used by developers to check for memory leaks. The argument is required. If you not provide an argument, don’t say that I didn’t warn you. text/html 2007-03-16T18:20:00+00:00 http://www.epicsol.org/help/altchan?rev=1174087200 text/html 2007-02-27T00:50:28+00:00 http://www.epicsol.org/help/arglists?rev=1172559028 Argument lists are an optional way to automatically shift values from $* into local variables. You can use argument lists in your aliases or your ons. The fix_arglist function also handles arglists. Behavior of Argument Lists When an alias or on is called, the magic variable $* is set with the arguments passed into your code. Usually the first thing most people do is copy arguments from $* into local variables, such as: text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/arrays?rev=1184106000 EPIC supports a large number of different data types. Among the least used, and least understood, are Karll’s arrays. This is mostly due to the lack of publicized documentation for them. No more. IrcII has long supported an array type. These are best identified as hash arrays (or associative arrays, for Perl hackers). However, Karll’s arrays are different, more in line with the traditional notion of an array. Due to how EPIC stores information, these arrays are not like normal variabl… text/html 2006-08-29T16:20:00+00:00 http://www.epicsol.org/help/ascii?rev=1156886400 # $EPIC: ascii.txt,v 1.2 2006/08/29 20:58:41 jnelson Exp $ $ascii(<character list>) The ascii function converts a sequence of characters into a word list of codepoints. Because EPIC only supports latin-1 at this time, all of the codepoints are 0 to 255 (strictly 1 byte per codepoint). If in the future epic supports UTF8 or something like that, codepoints greater than 255 might be returned. text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/asciiq?rev=1171513201 text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/asin?rev=1156125339 # $EPIC: asin.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $asin(<number>) * Returns the principal value in radians of the arc sine of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/asinh?rev=1156125339 # $EPIC: asinh.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $asinh(<number>) * Returns the inverse hyperbolic sine of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2007-10-13T12:07:11+00:00 http://www.epicsol.org/help/assign?rev=1192295231 assign assign <variable name> assign -<variable name> assign <variable name> <value> ASSIGN is the general-purpose interface for creating and manipulating variables. Just about any value can be assigned, whether it be a string or a number. Internally, ircII-EPIC treats the contents of all variables as strings, though it is smart enough to distinguish between strings and numerical values for mathematical purposes. text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/atan?rev=1156125339 # $EPIC: atan.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $atan(<number>) * Returns the principal value in radians of the arc tangent of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2006-08-20T20:55:39+00:00 http://www.epicsol.org/help/atanh?rev=1156125339 # $EPIC: atanh.txt,v 1.3 2006/08/21 01:55:33 sthalik Exp $ $atanh(<number>) * Returns the inverse hyperbolic tangent of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/atomic_scope?rev=1171513201 text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/autoget?rev=1172553600 text/html 2007-03-04T12:50:00+00:00 http://www.epicsol.org/help/autojoin?rev=1173034200 text/html 2007-02-24T13:20:00+00:00 http://www.epicsol.org/help/autoquery?rev=1172344800 text/html 2006-07-31T22:15:12+00:00 http://www.epicsol.org/help/away?rev=1154402112 away away -all away <away message> away -all <away message> away -- <away message> You have the option of telling the irc server to send a message to anyone who tries to contact you (while you are away from your keyboard). This is your <away message>. You can use the -all option to set all servers to the same <away message>. When you return, use the command without any arguments. If your <away message> starts with a hyphen, you can prefix it with a double-hyphen so it won’… text/html 2006-07-16T23:00:00+00:00 http://www.epicsol.org/help/b64decode?rev=1153108800 $b64decode(<stuff>) Returns the inverse RFC1421 transformation of <stuff>, commonly known as Base64. The inverse transformation converts four Base64 digits into three bytes. Alas, because ircII only supports C strings, if <stuff> decodes to binary data (with nuls) it will probably not do what you hope. text/html 2006-07-16T23:00:00+00:00 http://www.epicsol.org/help/b64encode?rev=1153108800 # $EPIC: b64encode.txt,v 1.2 2006/07/17 03:42:24 jnelson Exp $ $b64encode(<stuff>) Returns the RFC1421 transformation of <stuff>, commonly known as Base64. Base64 converts three bytes of input into four Base64 digits. By definition Base64 digits are safe to send over text-only transmissions. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/beep?rev=1152593863 beep This command makes your terminal emulator beep. Sometimes it is simpler than ECHOing control-G’s. This command is strictly local; it does not send beeps to other users. If SET BEEP is OFF, then this command has no effect. The beep command first appeared in ircII. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/before?rev=1172803800 # $EPIC: before.txt,v 1.2 2006/08/29 18:22:56 sthalik Exp $ $before([<count>] <char> <text>) * The <count> argument is optional, the default value is 1. <count> must be some non-zero number to be recognized as a count. If <count> is 0, it will be taken as the <char> argument, and <count> will default to 1! * If <count> is positive, then the return value of this function is the initial portion of <text> that is before the <count>th occurrence of any of the characters in <char>. * If <c… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/beforew?rev=1172803800 # $EPIC: beforew.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $beforew(<word> <pattern list>) * If the <word> argument is omitted this function returns the empty string. * The <pattern list> does not actually need to be a list of wildcard patterns. A list of literal words will work just fine. * If <word> is not matched by any of the words in <pattern list>, this function returns the empty string. * Otherwise, the function behaves “as if” the following had been performed: <val> = r… text/html 2006-09-18T07:50:00+00:00 http://www.epicsol.org/help/bind?rev=1158583800 bind bind -DEFAULTS bind <character_sequence> bind -RECURSIVE <character_sequence> bind <character_sequence> <action> <args> bind -SYMBOLIC <symbolic_name> <action> <args>// BIND allows you to control how the client behaves when you enter a sequence of one or more keys. By default, the client binds most of the common key sequences to useful default values. You may not necessarily need to bind your own key sequences unless you do not like the default values. text/html 2006-09-01T19:37:31+00:00 http://www.epicsol.org/help/bind_altcharset?rev=1157157451 # $EPIC: bind_altcharset.txt,v 1.3 2006/09/02 00:37:24 jnelson Exp $ bind <key> altcharset This keybinding toggles the use of the alternate character set in your terminal emulator’s font -- if it has one. On those fonts that do support alternate character sets, one set usually uses latin characters, and the other set uses VGA box drawing characters. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_backspace?rev=1152712801 # $EPIC: bind_backspace.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> backspace If the input cursor is at the start of the input line, nothing happens. Otherwise, the action is the composite action of <backward_character> and <delete_character> text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_backward_character?rev=1152712801 # $EPIC: bind_backward_character.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> backward_character If the cursor is at the beginning of the input line, nothing happens. Otherwise, the input cursor is moved to the previous character in the input line. If you are close enough to the left part of the screen, this action may cause the input line to scroll to the left. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_backward_word?rev=1152712801 # $EPIC: bind_backward_word.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> backward_word This function moves the cursor backward until it reaches the beginning of a word. If the cursor is currently in the middle of a word, it is shifted to the beginning of that word. If it is already at the beginning of a word, or on whitespace of any kind, it is moved back to the previous word. It has no effect if the cursor is at the beginning of the first word. text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/bind_beginning_of_line?rev=1184106000 # $EPIC: bind_beginning_of_line.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> beginning_of_line This function moves the cursor to the beginning of the input line. This may be a position not currently visible on screen, due to the way the client wraps long input. It has no visible effect when the cursor is already at the beginning of the input line. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_blink?rev=1152712801 # $EPIC: bind_blink.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> blink This function toggles the current blink setting. Due to internal limitations of the client, BLINK is displayed as an F on the input line, regardless of the key it is bound to. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_bold?rev=1152712801 # $EPIC: bind_bold.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> bold This function toggles the current boldface setting. Due to internal limitations of the client, BOLD is displayed as a B on the input line, regardless of the key it is bound to. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_clear_screen?rev=1152712801 # $EPIC: bind_clear_screen.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> clear_screen This executes the CLEAR command, which updates the current input window’s scrollable view so nothing is visible in it, and the next line of output will appear on the top line of the window. If you are in hold mode or scrollback, you will not see any change to the window until you exit hold mode or scrollback. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/bind_cpu_saver?rev=1152593863 # $EPIC: bind_cpu_saver.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ bind <key> cpu_saver This keybinding immediately switches the client to CPU saver mode. Normally, when CPU saver is inactive, the system clock, notify system, and mail checking occur via regular intervals controlled by set CLOCK_INTERVAL, set NOTIFY_INTERVAL, and set MAIL_INTERVAL. When CPU saver is activated, these sets are ignored, and the interval given by set CPU_SAVER_EVERY is used instead. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_delete_character?rev=1152712801 # $EPIC: bind_delete_character.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> delete_character This function deletes the character currently under the cursor, then shifts any text to the right of the cursor one space to the left. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_delete_next_word?rev=1152712801 # $EPIC: bind_delete_next_word.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> delete_next_word This function deletes text on the input line from the position of the cursor forward to the end of the first word found. If is it in the middle of a word, that word is truncated. If it is on whitespace, all text and whitespace to the end of the next word are deleted. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_delete_previous_word?rev=1152712801 # $EPIC: bind_delete_previous_word.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> delete_previous_word This function deletes text on the input line from the position of the cursor backward to the beginning of the first word found. If is it in the middle of a word, the beginning of that word is chopped. If it is on whitespace, all text and whitespace to the beginning of the previous word are deleted. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_delete_to_previous_space?rev=1152712801 # $EPIC: bind_delete_to_previous_space.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> delete_to_previous_space This function deletes everything to the left of the cursor until a space is found. If the character immediately before the cursor is whitespace of some kind, it does nothing. text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/bind_end_of_line?rev=1184106000 # $EPIC: bind_end_of_line.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> end_of_line This function moves the cursor to the last character on the input line. This position may not be currently visible, due to the manner in which EPIC handles input line wrapping. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_erase_line?rev=1152712801 # $EPIC: bind_erase_line.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> erase_line This function clears the contents of the input line. The data cleared is not preserved in the command history. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_erase_to_beg_of_line?rev=1152712801 # $EPIC: bind_erase_to_beg_of_line.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> erase_to_beg_of_line This function erases all text from (but not including) the cursor to the beginning of the input line. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_erase_to_end_of_line?rev=1152712801 # $EPIC: bind_erase_to_end_of_line.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> erase_to_end_of_line This function erases all text from (and including) the cursor to the end of the input line. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_forward_character?rev=1152712801 # $EPIC: bind_forward_character.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> forward_character This function causes the cursor to move right by one character. It has no effect if the cursor is at the end of the input line. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_forward_word?rev=1152712801 # $EPIC: bind_forward_word.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> forward_word This function moves the cursor forward to the beginning of the next word in the input line. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_highlight_off?rev=1152712801 # $EPIC: bind_highlight_off.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> highlight_off This function turns off any special highlighting in use prior to this character, including ANSI color escape sequences. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_next_window?rev=1152712801 # $EPIC: bind_next_window.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> next_window This function causes the client to change the current window to the one immediately below the current one in the window list. If the current window is the last in the list, the first becomes the current window. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/bind_nothing?rev=1152593863 # $EPIC: bind_nothing.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ bind <key> nothing This function causes the specified key to do nothing, effectively disabling it. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_parse_command?rev=1152712801 # $EPIC: bind_parse_command.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> parse_command <commands> This function causes the specified command(s) to be executed when the given key is pressed. If multiple commands are desired, they may be surrounded with curly braces. Command-line expando variables ($*, $2, $n-m, etc.) are expanded as if there were no arguments given. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_previous_window?rev=1152712801 # $EPIC: bind_previous_window.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> previous_window This function causes the client to change the current window to the one immediately above the current one in the window list. If the current window is the first in the list, the last becomes the current window. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_quit_irc?rev=1152712801 # $EPIC: bind_quit_irc.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> quit_irc This function causes the client to sign off from the irc network. Thus function has the same effect as the QUIT command, except that a specific QUIT reason cannot be specified. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/bind_quote_character?rev=1152593863 # $EPIC: bind_quote_character.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ bind <key> quote_character This function quotes, or escapes, the next key entered. It overrides the key’s normal default meaning and forces it to insert itself into the input buffer. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_refresh_inputline?rev=1152712801 # $EPIC: bind_refresh_inputline.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> refresh_inputline This function causes the client to redraw the input line. It is mostly only useful when another process sends data to the client’s tty, which sometimes corrupts the display of the input line (but not the actual contents). text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_refresh_screen?rev=1152712801 # $EPIC: bind_refresh_screen.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> refresh_screen This function causes the client to redraw the screen line by line. It is mostly only useful when another process sends data to the client’s tty, which sometimes corrupts the screen display (but not the actual contents). text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_refresh_status?rev=1152712801 # $EPIC: bind_refresh_status.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> refresh_status This function forces the client to update and redraw the status line to ensure it has the current values. This is most often necessary if you use set STATUS_DOES_EXPANDOS and you change the value of one of the expandos in the status_format. text/html 2006-09-19T05:50:00+00:00 http://www.epicsol.org/help/bind_reset_line?rev=1158663000 # $EPIC: bind_reset_line.txt,v 1.2 2006/09/19 10:48:09 sthalik Exp $ bind <key sequence> reset_line <new text> This binding replaces the current contents of the input line with the <new text>. The <new text> is treated as though it were passed through xtype -l. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_reverse?rev=1152712801 # $EPIC: bind_reverse.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> reverse This function toggles the current reverse video setting. Due to internal limitations of the client, REVERSE is displayed as a V on the input line, regardless of the key it is bound to. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_scroll_backward?rev=1152712801 # $EPIC: bind_scroll_backward.txt,v 1.2 2006/07/12 13:57:46 sthalik Exp $ bind <key> scroll_backward This executes the WINDOW SCROLL_BACKWARD command. It moves the scrollback view backward (towards older output). The amount it moves is determined by SET(4) SCROLLBACK_RATIO as a percentage. It is usual and customary when you scroll backward for the scrollback view to become the current view, so you should immediately see an effect. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_scroll_end?rev=1152712801 # $EPIC: bind_scroll_end.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> scroll_end This function is used to end the lastlog scrollback mode. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/bind_scroll_forward?rev=1156876398 # $EPIC: bind_scroll_forward.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ bind <key> scroll_forward This function allows the user to move forward in the client’s lastlog one page at a time. The percentage of the screen that makes up a page is defined by the set(4) set scrollback_ratio variable. This is useful for reviewing events as they happened, in a manner easier than LASTLOG provides. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_scroll_start?rev=1152712801 # $EPIC: bind_scroll_start.txt,v 1.3 2006/07/12 13:57:46 sthalik Exp $ bind <key> scroll_start This function causes the client to enter scrollback mode. This allows the lastlog buffer to be viewed interactively. Any server messages received while in scrollback mode are queued, and are not displayed until the client exits scrollback mode. It is generally a good idea to set HOLD_MODE on while in scrollback mode. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_self_insert?rev=1152712801 # $EPIC: bind_self_insert.txt,v 1.3 2006/07/12 13:57:46 sthalik Exp $ bind <key> self_insert This function overrides the key’s default value, causing it to insert itself into the input buffer, instead of doing what it would normally do. This can be used to intentionally prevent certain control keys from being misused. text/html 2006-10-01T19:20:00+00:00 http://www.epicsol.org/help/bind_send_line?rev=1159748400 # $EPIC: bind_send_line.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> send_line This function causes the current input buffer to be sent to the current server, in a manner like that of SENDLINE. To quell any confusion, this is typically the default behavior of the return/enter key. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/bind_stop_irc?rev=1156876398 # $EPIC: bind_stop_irc.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ bind <key> stop_irc This command causes the client process to temporarily stop, returning the user to the parent process that started the client (usually the user’s command shell). This is useful for executing commands that aren’t well suited to EXEC. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_swap_last_window?rev=1152712801 # $EPIC: bind_swap_last_window.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> swap_last_window This function swaps the current window with the most recently hidden window. If no windows are hidden, this function has no effect. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_swap_next_window?rev=1152712801 # $EPIC: bind_swap_next_window.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> swap_next_window This executes the WINDOW NEXT command. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_swap_previous_window?rev=1152712801 # $EPIC: bind_swap_previous_window.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> swap_previous_window This executes the WINDOW PREVIOUS command. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_switch_channels?rev=1152712801 # $EPIC: bind_switch_channels.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> switch_channels This function changes the current channel in the current window. It can be used to cycle through all channels in the window. However, it will only switch to channels that are not already being directed to another window. text/html 2006-09-01T19:37:31+00:00 http://www.epicsol.org/help/bind_switch_query?rev=1157157451 # $EPIC: bind_switch_query.txt,v 1.3 2006/09/02 00:37:24 jnelson Exp $ bind <key> switch_query When you have multiple query targets in your query list, you can cycle through them to set the “current” query using this keybinding. It works on the same princple as switch_channels. text/html 2006-07-12T11:00:00+00:00 http://www.epicsol.org/help/bind_toggle_insert_mode?rev=1152720000 # $EPIC: bind_toggle_insert_mode.txt,v 1.3 2006/07/12 15:01:19 sthalik Exp $ bind <key> toggle_insert_mode This toggles the client’s default input mode between insert mode and overwrite mode. In insert mode, text typed in inserted into the input buffer, shifting text following the input to the right, preserving it. In overwrite mode, text typed will overwrite any following text. The mode is insignificant when there is no text following the cursor. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_toggle_stop_screen?rev=1152712801 # $EPIC: bind_toggle_stop_screen.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> toggle_stop_screen This executes a WINDOW HOLD_MODE TOGGLE in your current window. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_transpose_characters?rev=1152712801 # $EPIC: bind_transpose_characters.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> transpose_characters This function swaps the character under the cursor with the character immediately before it. It has no effect if the cursor is at the end of the input line, or if no characters precede the current one. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_type_text?rev=1152712801 # $EPIC: bind_type_text.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> type_text <text> This function executes XTYPE -L <text>, which means it adds <text> to the input buffer literally, ignoring all key bindings and treating each character as though it were bound to bind SELF_INSERT. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_unclear_screen?rev=1152712801 # $EPIC: bind_unclear_screen.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> unclear_screen This function un-clears a /clear command or a /bind <key> clear_screen. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_underline?rev=1152712801 # $EPIC: bind_underline.txt,v 1.2 2006/07/12 13:26:15 sthalik Exp $ bind <key> underline This function toggles the current underline setting. Due to internal limitations of the client, UNDERLINE is displayed as a ^V_^V on the input line, regardless of the key it is bound to. text/html 2006-07-12T11:00:00+00:00 http://www.epicsol.org/help/bind_unstop_all_windows?rev=1152720000 # $EPIC: bind_unstop_all_windows.txt,v 1.3 2006/07/12 15:01:19 sthalik Exp $ bind <key> unstop_all_windows This executes /WINDOW HOLD_MODE OFF in all windows. Windows that were stopped with TOGGLE_STOP_SCREEN are restarted. text/html 2006-07-12T09:00:01+00:00 http://www.epicsol.org/help/bind_yank_from_cutbuffer?rev=1152712801 # $EPIC: bind_yank_from_cutbuffer.txt,v 1.3 2006/07/12 13:57:46 sthalik Exp $ bind <key> yank_from_cutbuffer This function restores the last text string deleted from the input buffer with DELETE_NEXT_WORD, DELETE_PREVIOUS_WORD, ERASE_LINE, ERASE_TO_END_OF_LINE, or DELETE_TO_PREVIOUS_SPACE. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/bindctl?rev=1172803800 # $EPIC: bindctl.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $bindctl(FUNCTION <function> <action> [<args]>) $bindctl(SEQUENCE <sequence> <action> [<args]>) $bindctl(MAP [<sequence>] [<action>]) * This function is a low-level interface to the client’s keybindings system. * There are three top-level arguments which can be passed to the function: * FUNCTION: Manipulates the functions which key sequences can be bound to. * SEQUENCE: Manipulates the key sequences themselves. *… text/html 2006-07-17T16:00:00+00:00 http://www.epicsol.org/help/bless?rev=1153170000 bless Ordinarily, the local variables of an atomic scope are only visible to that atomic scope, and cannot be used outside. Sometimes you need to be able to access an atomic scope’s local variables within another atomic scope. Two atomic scopes can cooperate at runtime to accomplish this if the enclosing scope does wait and the enclosed scope does bless. text/html 2006-08-29T15:20:00+00:00 http://www.epicsol.org/help/block?rev=1156882800 A block is a sequence of statements separated by semicolons. A block statement is a block that is optionally surrounded by curly braces. For more details, see ircii syntax. A block statement containing two statements { echo one; echo two } text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/botmode?rev=1152593863 botmode If you are running epic in “dumb mode” (with the -d command line option), you may use the BOTMODE command to complete the transformation into a bot, equivalent to using the -b command line option. You may want to do this if your script needs to interact with the user before launching into a bot mode (for example, asking configuration questions, or even just telling the user what you’re doing). text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/break?rev=1156876398 break Break, like its C counterpart, breaks out of a loop. @loop = 0 while (0==0) { /* endless loop? */ @loop++ if (loop==20) break } /* loop only made 20 iterations */ alias; continue; return; for; while; until text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/builtin_expando?rev=1153166400 # $EPIC: builtin_expando.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $builtin_expando(<expando name>) * If the <expando name> argument is omitted the empty string is returned. * If the inline expando <expando name> does not exist, the empty string is returned. * This function returns the value that would be returned by the “inline expando” $<expando name>. text/html 2007-02-28T21:50:00+00:00 http://www.epicsol.org/help/builtins?rev=1172721000 text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/call?rev=1153166400 call CALL produces a gdb/dbx-like stack trace of the alias currently being executed. It returns a list of the commands currently being executed, tracing back from the current command, to the command that called it, and so forth until the CALL command itself it listed. A deeply nested alias might have the following alias stack: text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/cd?rev=1152593863 cd cd <path> The cd command changes the current working directory for the process. If the <path> is given, the current directory is changed to it. If the <path> is not given, the current directory is displayed. If <path> is invalid or cannot be changed to, an error will be displayed, and the current directory will not change. text/html 2006-07-17T16:00:00+00:00 http://www.epicsol.org/help/ceil?rev=1153170000 # $EPIC: ceil.txt,v 1.2 2006/07/17 20:15:25 sthalik Exp $ $ceil(<number>) Calculates the smallest integer that is greater than or equal to <number> The smallest integer that is greater than or equal to the argument, or nothing if no argument is specified. text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/center?rev=1153166400 # $EPIC: center.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $center(<width> <text>) This function returns the input text right-justified in a buffer that is precisely ( / 2) + strlen(text) ) characters wide. The width must be given, there is no default. text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/cexist?rev=1153166400 # $EPIC: cexist.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $cexist(<command>) This function tells wether or not a built-in command exists. This can be used to emulate a built-in command in older versions of epic that may not support it. 1 If the built-in command <command> exists 0 If <command> doesn’t exist text/html 2006-07-17T16:00:00+00:00 http://www.epicsol.org/help/chanmode?rev=1153170000 # $EPIC: chanmode.txt,v 1.3 2006/07/17 20:15:25 sthalik Exp $ $chanmode(<channel list>) * If the <channel list> argument is omitted, the current channel is used. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON! * <channel list> is taken as a word list (space separated) of channel names. The asterisk (”*”) is a special channel name that refers to the current window’s current channel. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON! * The return value is a word list of channel modes … text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/chanmonitor?rev=1172803800 text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/channel?rev=1152593863 This is a disambiguation page. Do you mean the channel command or the channel function? text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/channel_command?rev=1156876398 # $EPIC: channel_command.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ channel channel -invite channel <channel list> channel <channel list> <key list> Channels are the most important part of IRC. A “channel” is a place where one or more people can congregate and talk to each other. Each channel has a name, and there are an almost limitless number of channels available. Channels are shared amongst all of the servers of a network. Each network has a different set of channels than… text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/channel_function?rev=1153166400 # $EPIC: channel_function.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $channel(<channel name>) This function returns some extended information about who’s on a channel. It returns a sorted list of nicknames prepended by two characters. If a <channel name> is not supplied, the current channel will be assumed. text/html 2006-07-17T16:00:00+00:00 http://www.epicsol.org/help/chanusers?rev=1153170000 # $EPIC: chanusers.txt,v 1.3 2006/07/17 20:15:25 sthalik Exp $ $chanusers(<channel>) * This function is a synonym for $onchannel() and is provided for compatibility with ircII. * See the help file for $onchannel() for more particulars. This function first appeared in ircII-2.6. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/chanwin?rev=1152593863 # $EPIC: chanwin.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $chanwin(<window refnum/name>|<channel>) $chanwin() and $winchan() are the same function. * If no argument given: * Return the current window’s current channel. * If one argument, and it’s a window refnum: * Return that window’s current channel. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/chmod?rev=1172803800 # $EPIC: chmod.txt,v 1.2 2006/07/17 20:15:25 sthalik Exp $ $chmod(<file> <mode>) This function provides an interface to the Unix system call chmod(2). It applies the given mode to the file specified. Refer to your Unix system manual for more information (usually “man 2 chmod”). The mode must be in numeric format. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/chngw?rev=1172803800 # $EPIC: chngw.txt,v 1.3 2006/09/07 01:18:17 sthalik Exp $ $chngw(<index> <word> <word list>) * If the <index> argument is omitted the empty string is returned. * If the <word> argument is omitted the empty string is returned. * If the <index> argument is less than 0 then <word list> is returned. * The return value if <word list> with the <index>th word, counting from zero, changed to <word>. * Historically <word list> does not support double-quoted words. This may change in the fut… text/html 2006-08-30T16:20:00+00:00 http://www.epicsol.org/help/chop?rev=1156972800 # $EPIC: chop.txt,v 1.3 2006/08/30 21:02:47 sthalik Exp $ $chop(<num> <text>) This function chops <num> characters from the end of <text>. It is an excellent shortcut for $mid() expressions starting at the first character of <text>. <text> with <num> characters removed from the end text/html 2006-07-17T16:00:00+00:00 http://www.epicsol.org/help/chops?rev=1153170000 # $EPIC: chops.txt,v 1.3 2006/07/17 20:15:25 sthalik Exp $ $chops(<channel>) * If the <channel> argument is omitted, the current window’s current channel is used. THIS IS NOT NECCESARILY THE CORRECT CHANNEL IN AN /ON! * If the <channel> argument is the literal star character (``*’‘), the current window’s current channel is used. THIS IS NOT NECCESARILY THE CORRECT CHANNEL IN AN /ON! * This function returns the channel operators on the specified channel. * You must be on the … text/html 2006-08-29T16:20:00+00:00 http://www.epicsol.org/help/chr?rev=1156886400 # $EPIC: chr.txt,v 1.2 2006/08/29 20:58:41 jnelson Exp $ $chr(<list of codepoints>) The chr function converts a word list of codepoints into a sequence of characters. Because EPIC only supports latin-1 at this time, only the codepoints 0 to 255 provide defined behavior. Other codepoints will yield one character per codepoint, but the character is undefined. text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/chrq?rev=1160162400 # $EPIC: chrq.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $chrq(<list of codepoints>) The chrq function is much the same as the chr function, but the result is filtered through ctcp enquoting. Even if the input string contains binary data (including nuls) the output string is safe for assigning to a variable and sending over irc. text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/cipher?rev=1153166400 # $EPIC: cipher.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $cipher(<refnum>) * This function returns the value of SSL_get_cipher() for the SSL enabled server connection for server <refnum>. * It probably does nothing useful if <refnum> is not an ssl-enabled server. text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/clear?rev=1184106000 # $EPIC: clear.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ clear [-all|-hidden|-visible] [-unhold] CLEAR clears the current window of all text. It is useful for wiping a screen that has rendered improperly (such as due to a bad termcap entry) or that contains sensitive information (such as one’s OPER password). text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/close?rev=1153166400 # $EPIC: close.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $close(<file descriptor>) This function unbinds the given file descriptor (previously returned by the $open() function) from the underlying file, causing the file to be committed to disk if necessary. An error is returned if it is passed a file descriptor not produced by an $open() call. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/cofilter?rev=1172803800 text/html 2007-02-19T20:50:00+00:00 http://www.epicsol.org/help/command_line?rev=1171939800 There are a number of command line options available. The basic command-line syntax is: epic5 [<switches>] [<nickname> [<server list>]] The nickname may be at most 30 characters long. The server list may be a space-delimited list of server descriptions. Each server name may use the server:port notation if a port other than the default (usually 6667) is desired. The available switches are as follows: text/html 2007-03-06T00:20:00+00:00 http://www.epicsol.org/help/commandqueues?rev=1173162000 text/html 2007-01-24T03:18:20+00:00 http://www.epicsol.org/help/commands_overview?rev=1169630300 Commands are the way for interacting with the client. They allow various tasks to be done - interacting with the remote server, changing client’s user interface (including, but not limited to managing windows and changing key bindings), programming the client and much more. text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/comment?rev=1153166400 # $EPIC: comment.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ comment [<anything>] This is exactly what it says, a comment. It does nothing. It is useful in scripts for explaining bits of code, adding disclaimers or copyright notices, etc. There are also several symbolic comments. Both the # and : characters may be used to designate comments. There is no functional difference between any of them. Additionally, EPIC supports C /* */ multiline comments. text/html 2006-07-17T15:00:00+00:00 http://www.epicsol.org/help/common?rev=1153166400 # $EPIC: common.txt,v 1.2 2006/07/17 19:41:50 sthalik Exp $ $common(<word list 1> / <word list 2>) * There must be a literal slash character (’/’) that separates the two word lists. If it is omitted the empty string is returned. * It is not required to have spaces on either side of the slash, but it also does not hurt to have them. * The return value is a word list comprised of the set-intersection of <word list 1> and <word list 2>, that is to say: * The return value is a word l… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/compile_opts?rev=1156876398 EPIC supports numerous configuration options that may be selectively included or excluded from the client at compile time. Since many of these enable or disable certain special features, it is useful to script writers to be able to find out what options are present while the client is running. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/connect?rev=1152593863 This is a disambiguation page. Do you mean the connect command or the connect function? text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/connect_command?rev=1153728000 connect <new server> [[<port>] <existing server>] This command is used to connect servers to the irc network. It must be given at least one argument, the name of a remote server to connect to the network. If only one server is given, it is connected to the client’s server on the default port. Alternately, a specific server and port may be specified. text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/connect_function?rev=1153728000 # $EPIC: connect_function.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $connect(<host> <port> [family]) * If the <host> argument is omitted the empty string is returned. * If the <port> argument is omitted the empty string is returned. * If the <host> argument does not resolve to a known Internet hostname, an error is output and the empty string is returned. * If a TCP connection to host <host> on port <port> cannot be opened, an error is output and the empty string is returned. * I… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/continue?rev=1152593863 continue Continue ends the current iteration of a do, while, foreach, fe, fec, for .. next, for .. in, and for (...) loop, just as if you had reached the end of the current iteration normally. The break and return commands are other ways of ending loops. text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/convert?rev=1153728000 # $EPIC: convert.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $convert(<ip address|hostname>) This function does a DNS lookup on the given address. For an IP address, it attempts to find the corresponding Internet hostname. For a hostname, it attempts to find the corresponding IP address. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/copattern?rev=1172803800 # $EPIC: copattern.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $copattern(<pattern> <var1> <var2>) * If the <pattern> argument is omitted the empty string is returned. * If the <var1> argument is omitted the empty string is returned. * If the <var2> argument is omitted the empty string is returned. * <pattern> is taken to be a wildcard pattern * <var1> and <var2> are taken to be lvals (names of ASSIGNs) * <var1> and <var2> should each have the same number of words. * For each se… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/copyright?rev=1152593863 /* * Copyright (c) 1990 Michael Sandroff. * Copyright (c) 1991, 1992 Troy Rollo. * Copyright (c) 1992-1996 Matthew Green. * Copyright 1993, 1997 Jeremy Nelson. * Copyright 1994 Jake Khuon. * Copyright 1995, 1998 Jeremy Nelson and others ("EPIC Software Labs"). * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the … text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/corfilter?rev=1172803800 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/corpattern?rev=1172803800 text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/cos?rev=1153771200 # $EPIC: cos.txt,v 1.4 2006/07/24 19:50:14 sthalik Exp $ $cos(<number>) * Returns the cosine of the angle of <number> radians. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/cosh?rev=1153771200 # $EPIC: cosh.txt,v 1.3 2006/07/24 19:50:14 sthalik Exp $ $cosh(<number>) * Returns the hyperbolic cosine of <number>. * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/count?rev=1172803800 # $EPIC: count.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $count(<string> <text>) This function counts how many times <string> appears in the text specified by <text>, possibly overlapping. The uses for a function like this are unlimited. One may be to count how many times a person’s nick appears in a public message, for logging purposes. text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/country?rev=1153728000 # $EPIC: country.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ load country This script is used for converting between a country’s (official) name and its ISO country code. It can convert in either direction, and can convert to a country name based on an email address. Everything is done through a single alias, /country. The basic syntax is: text/html 2007-03-25T12:01:26+00:00 http://www.epicsol.org/help/cparse?rev=1174842086 # $EPIC: cparse.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $cparse(<text>) $cparse(<text> <arguments>...) This function parses <text> according to the following table: Any instance of will be replaced with ^C codes to change the text to text to background to --------------------------------------------------------------------- %k %K %0 black bold black black %r %R %1 red bold red … text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/crypt?rev=1172803800 # $EPIC: crypt.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $crypt(<string> <salt>) Given an arbitrary string and a “salt” (a randomizer), this function returns the input string in a one-way encrypted form. This function depends on the availability of a local crypt(3) library function. Only the first 8 characters of the input string are significant. The salt is a two-character string, and may be composed of any combination of any alphanumeric character, a period (.), or a forward-sl… text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/ctcp?rev=1153728000 ctcp <target> <command> ctcp <target> <command> <arguments> CTCP is the Client To Client Protocol. The purpose of CTCP is to send requests for information to other clients on the network, instead of the server. CTCP messages are specially coded and the client to which you send a CTCP request will respond if it supports the request. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_action?rev=1153771200 CTCP <target> action <action description> This is the command that implements the functionality of the DESCRIBE and ME commands. This command should not be used directly. Actions you send are caught with on send_action and are caught by the other person with on action text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_clientinfo?rev=1153771200 ctcp <target> clientinfo <ctcp command> This CTCP request roughly acts as a “help” command. If you do not provide any arguments, the other person’s client will give you a list of which CTCP requests it supports. If you give it an argument, the other person’s client will give you information about its implementation of that CTCP request. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_echo?rev=1153771200 ctcp <target> echo <any text> This CTCP request asks the other client to return your message back to you. Tricks like this were formerly the way that PING times were measured. Many clients do not support this request because attacks by floodnets can disconnect you from your irc server. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_finger?rev=1153771200 ctcp <target> finger This CTCP request asks for more detailed information about the person you send it to. The information returned is usually under the control of the other person and may or may not be useful. Many clients do not support CTCP requests or severely throttle the rate at which they reply because floodnets make it easy to be knocked off of your IRC server. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_ping?rev=1153771200 ctcp <target> ping <current time> This command implements the underlying support for the PING command. It is not intended to be used directly. # $EPIC: ctcp_ping.txt,v 1.3 2006/07/24 19:50:14 sthalik Exp $ text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/ctcp_time?rev=1156876398 ctcp <target> time This asks another client for its local time of day. This differs from the TIME command, which queries the server instead of a client. Not every client will return a reply for this request. # $EPIC: ctcp_time.txt,v 1.5 2006/08/29 18:22:56 sthalik Exp $ text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_userinfo?rev=1153771200 ctcp <target> userinfo This asks another client to return whatever text it has stored in its USER_INFORMATION variable which can be just about anything. Not every client will return a reply for this request. # $EPIC: ctcp_userinfo.txt,v 1.3 2006/07/24 19:50:14 sthalik Exp $ text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_utc?rev=1153771200 ctcp <target> utc <time value> This “inline” CTCP request includes a timestamp as the argument. This timestamp is the number of seconds since the UNIX epoch, the same as is used by the PING command. The receiver’s client will expand the timestamp to the receiver’s own locale-dependent time representation. text/html 2006-07-24T15:00:00+00:00 http://www.epicsol.org/help/ctcp_version?rev=1153771200 ctcp <target> version This command asks another client what irc client they are using, including the version information, if available. Many users’ scripts or clients have been customized or modified to intercept CTCP VERSION requests and return falsified information. You should not trust the value returned by this request unless you trust the person you queried. text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/curcmd?rev=1171347600 # $EPIC: curcmd.txt,v 1.2 2007/02/13 06:05:45 jnelson Exp $ $curcmd() When called while a ircii_syntax is running, this function returns the command being executed. This is either a builtin command name, a user-created alias name, or an unknown command name. text/html 2006-07-24T03:00:00+00:00 http://www.epicsol.org/help/curpos?rev=1153728000 # $EPIC: curpos.txt,v 1.2 2006/07/24 07:11:25 sthalik Exp $ $curpos() * Arguments, if any, are ignored. * This function returns the “index” of the cursor’s position in the “current” input line ($L). * As with all “index” values, counting starts from zero. * Counting begins after the input prompt, if any. * The “current” input line is the last screen to receive a key-press. If you use this function outside of a key binding, this may be an important consideration. U… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/currchans?rev=1152593863 # $EPIC: currchans.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $currchans([<server refnum>]) Returns the current channels for each window connected to <server refnum>. If <server refnum> is -1, then $lastserver() is assumed. If no arguments are passed, all current channels are returned. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/data_array?rev=1152593863 text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/data_struct?rev=1152593863 text/html 2007-05-14T20:50:00+00:00 http://www.epicsol.org/help/dbmctl?rev=1179193800 # $EPIC: dbmctl.txt,v 1.2 2006/10/06 02:07:37 jnelson Exp $ $dbmctl(OPEN type filename) $dbmctl(OPEN_READ type filename) $dbmctl(CLOSE refnum) $dbmctl(ADD refnum “key” data) $dbmctl(CHANGE refnum “key” data) $dbmctl(DELETE refnum “key”) $dbmctl(READ refnum “key”) $dbmctl(NEXT_KEY refnum start-over) $dbmctl(ALL_KEYS refnum) $dbmctl(ERROR refnum) text/html 2007-02-02T17:28:46+00:00 http://www.epicsol.org/help/dcc?rev=1170458926 # $EPIC: dcc.txt,v 1.3 2006/08/01 02:17:03 sthalik Exp $ dcc [<command> [<arguments>]] DCC stands for Direct Client-to-Client connection. The DCC command manages all off these connections. There are two primary uses for DCC; chatting with other users without having to use the irc network; and file transfers. These are examples; they are not the limit of DCC’s capabilities. text/html 2007-02-02T17:28:46+00:00 http://www.epicsol.org/help/dcc_chat?rev=1170458926 # $EPIC: dcc_chat.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ dcc chat <nick> [-p <port>] DCC CHAT initiates a direct connection to another client, allowing you to talk to that person without the messages passing through the irc network. Because messages over DCC CHAT do not travel over a public irc network, they are more secure against snooping, and the messages will be much faster since they do not have to make many hops across irc servers to the destination. Netsplits, server changes, and … text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/dcc_close?rev=1156876398 # $EPIC: dcc_close.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ dcc close [<type>|-all|*] [<nick>|-all|*] [”<filename>”] DCC CLOSE cancels a DCC session: * For DCC SEND, it rescinds the offer to send a file * For DCC GET, it rejects our interest in receiving the file * For DCC CHAT, it closes the dedicated chat connection * For $connect(), it closes the raw client socket connection * For $listen(), it closes the listening socket (but not any connections) * For a file transfer… text/html 2006-07-31T21:18:34+00:00 http://www.epicsol.org/help/dcc_closeall?rev=1154398714 # $EPIC: dcc_closeall.txt,v 1.3 2006/08/01 02:17:03 sthalik Exp $ dcc closeall This will close every open or pending DCC connection and send the necessary CTCP DCC REJECT replies to all peers. Your DCC list will be quite empty after this command. text/html 2006-08-31T06:57:09+00:00 http://www.epicsol.org/help/dcc_get?rev=1157025429 # $EPIC: dcc_get.txt,v 1.4 2006/08/31 11:57:06 sthalik Exp $ dcc get [=]<nick> <file> [file2] [file3] ... dcc get [=]<nick> <file> [file2] [file3] ... /directory dcc get [=]<nick> <file> <not-offered-file> dcc get [=]<nick> DCC GET opens a file transfer connection and downloads a file that someone else has offered you with the DCC SEND command. text/html 2006-07-26T15:00:00+00:00 http://www.epicsol.org/help/dcc_list?rev=1153944000 # $EPIC: dcc_list.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ dcc list Whenever you need to take stock of your DCC connections, you can use the DCC LIST command to show you all active and pending DCC’s. The information shown includes the type of connection, whether the connection is entropic, the nickname of the other person, the current status, the time that the connection was opened, the size of the file being transfered (if any), the transfer throughput, and the name of the file bein… text/html 2007-05-19T20:19:15+00:00 http://www.epicsol.org/help/dcc_ports?rev=1179623955 # $EPIC: dcc_ports.txt,v 1.1 2007/05/20 01:19:15 jnelson Exp $ load dcc_ports set dcc_port_first 1024 set dcc_port_last 65536 This script implements a dcc port range facility. Each time you offer a dcc chat or dcc send to someone else, the next open port in the port range will be used as though you had supplied the -p option to the dcc command. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/dcc_raw?rev=1153944001 # $EPIC: dcc_raw.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ dcc raw <fd> <host> <message> The DCC RAW command implements the underlying functionality for the MSG =<fd> <message> command. You should prefer to use MSG instead because you do not then have to keep track of the hostname. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/dcc_rename?rev=1153944001 # $EPIC: dcc_rename.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ dcc rename [<nick>] <name> [<new name>] dcc rename -chat <dcc-nick> <new nick> Sometimes someone will offer you a filename that you already have, and you want to get the file but not clobber your existing file. With the /DCC RENAME command, you can change the name that this new file will be saved as, sparing your existing file from removal. text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/dcc_resume?rev=1154400332 # $EPIC: dcc_resume.txt,v 1.6 2006/08/01 02:45:08 sthalik Exp $ dcc resume [=]<nick> <file> If a previous DCC GET file transfer from another person did not complete successfully, you may be left with a partial file. Normally, you would have to start over again, but if you are trying to get a very large file, you may not want to start over again. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/dcc_send?rev=1153944001 # $EPIC: dcc_send.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ dcc send [=]<nick> [-p <port>] <file> [<file> ...] Sometimes you want to share a file with another person on irc. The DCC SEND command sends an offer to share to another person. The remote client must of course open the connection before the file transfer will begin. text/html 2007-05-19T20:20:00+00:00 http://www.epicsol.org/help/dccctl?rev=1179624000 # $EPIC: dccctl.txt,v 1.6 2006/08/30 19:28:30 sthalik Exp $ $dccctl(REFNUMS) $dccctl(TYPEMATCH [pattern]) $dccctl(DESCMATCH [pattern]) $dccctl(FILEMATCH [pattern]) $dccctl(USERMATCH [pattern]) $dccctl(OTHERMATCH [pattern]) $dccctl(LOCKED [pattern]) $dccctl(REFBASE [number]) $dccctl(HELD) $dccctl(UNHELD) $dccctl(WRITABLES) $dccctl(USERHOSTMATCH [userhost]) $dccctl(GET <refnum> <item>) $dccctl(SET <refnum> <item> <value>) text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/debug.irc?rev=1153944001 # $EPIC: debug.irc.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ load debug.irc debug_section debug_endsection This script provides an example of how to effectively debug sections of code in large scripts, or while other scripts are loaded. It consists of two aliases, which are inserted into the code to be debugged to turn debugging on/off where needed. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/debugging?rev=1156876398 Several tools exist in the client which can aid in debugging and testing scripts. * /set debug Allows the client to show which commands are actually being executed, how they are being parsed, and what alias and variable substitutions are taking effect. * /pretend Causes the client to “pretend” it received a given line of text from the server. Use with caution. * /shook Causes a given hook to be triggered as if the event had actually occurred. * /xdebug inbound (not officially… text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/decode?rev=1153944001 # $EPIC: decode.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ $decode(<text>) * If the <text> argument is omitted the empty string is returned. * The <text> argument must be text that was previously returned by the $encode() function. All other inputs will yield undefined results. * This function returns the original <text> that was passed to the $encode() function. * Hardcoding $encode()d values into your script IS A BAD THING. Please be aware that $encode() may change in the future … text/html 2006-07-31T21:18:34+00:00 http://www.epicsol.org/help/defer?rev=1154398714 # $EPIC: defer.txt,v 1.3 2006/08/01 02:17:03 sthalik Exp $ defer {<stuff>} The DEFER command schedules <stuff> to be executed later on when the client is idle, and there is no risk that if <stuff> were to destroy something that it would crash the client. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/delarray?rev=1153944001 # $EPIC: delarray.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ $delarray(<array>) This function removes all items in an array created with $setitem(), having the effect of deleting the array. This function deletes an array. Generally this is most useful when cleaning up after a script. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/delitem?rev=1153944001 # $EPIC: delitem.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ $delitem(<array> <item#>) This function is used to delete an entry from an array created with $setitem(). If the item deleted is the only one present in the array, the array is deleted too. If the item is not the last item in the array, all items beyond it (with higher item numbers) are shifted down by one to fill in the gap. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/delitems?rev=1172553600 text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/deop?rev=1153944001 deop This command is used by an irc operator to remove his or her operator status. In short it gets the user’s current nickname from the server and then uses MODE to remove oper status. That’s it. DEOP has the same effect as setting user mode -o with MODE. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/describe?rev=1153944001 # $EPIC: describe.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ describe <nickname|channel> <action description> DESCRIBE lets you perform an action. It lets you describe what you’re doing as though someone is watching you, rather than you telling them. You may send an action to either an individual or to an entire channel. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/deuhc?rev=1153944001 # $EPIC: deuhc.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ $deuhc(<user@host>) This function removes a *! or *!*@ from the <user@host>, if it is present. It can be used as a quick way to get only the hostname from a full address argument. arguments without *! or *!*@ in front text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/die?rev=1152593863 die DIE causes the operator’s server to do just that; die. The process terminates normally. This command is limited to irc operators. Additionally, it may not be available even to them, depending on how the server was compiled. The server must #define either OPER_DIE or LOCAL_DIE (or both) for someone to be able to use it at all. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/diff?rev=1153944001 # $EPIC: diff.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ $diff(<word list 1> / <word list 2>) * There must be a literal slash character (’/’) that separates the two word lists. If it is omitted the empty string is returned. * It is not required to have spaces on either side of the slash, but it also does not hurt to have them. * The return value is a word list comprised of the negated set-difference of <word list 1> and <word list 2>, that is to say: * The return value is a word… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/disambiguation?rev=1152593863 This is a disambiguation page. Do you mean the log command or the log function? text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/disconnect?rev=1171347600 # $EPIC: disconnect.txt,v 1.4 2006/09/19 10:52:37 sthalik Exp $ disconnect [<server number> [<reason>]] The disconnect command disconnects you from an irc server but does not make the client quit. If you are on multiple servers, only the one server will be disconnected and the others are unaffected. text/html 2006-07-26T15:00:01+00:00 http://www.epicsol.org/help/do?rev=1153944001 #$EPIC: do.txt,v 1.2 2006/07/26 19:47:17 sthalik Exp $ do <commands> do { <commands> } [while (<condition>)] DO has two uses. In its first use it is a synonym for EVAL, but it’s a bad idea to use EVAL either. Its second use is a post-test loop. You are obliged to put your commands in curly braces and after the closing curly brace a WHILE expression. DO .. WHILE loops always execute at least once. You must be careful to put the WHILE expression on the same line as the closing brace. … text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/dump?rev=1152593863 #$EPIC: dump.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ dump [all|alias|var|on] This mass-deletes all of your aliases, assigns (variables) and/or ons. This can be useful if a script is trying to reload and wants to know that there is nothing else that will interfere with it, without having to restart epic. It can also be used to completely wipe away all of the scripts that epic loads by default when you start up. text/html 2006-07-31T21:28:06+00:00 http://www.epicsol.org/help/echo?rev=1154399286 echo [<anything>] This command prints its arguments back to the screen. That’s it. It is useful for printing status messages from inside scripts, or inside hooks for redefining server messages. The ECHO command is also the only command (one of two, actually; see XECHO) that can write to the screen when set DISPLAY is off. ECHO now has no length limitation, it can display any string within the confines of memory. text/html 2007-02-19T22:20:00+00:00 http://www.epicsol.org/help/edit_topic?rev=1171945200 text/html 2006-07-31T21:28:06+00:00 http://www.epicsol.org/help/encode?rev=1154399286 # $EPIC: encode.txt,v 1.2 2006/08/01 02:24:39 sthalik Exp $ $encode(<text>) * If the <text> argument is omitted the empty string is returned. * The output of this function is a transformation of <text> that has the following characteristics AND ONLY the following characteristics: * It is unique encode(X) != encode(Y) for all X != Y * It is case sensitive: encode(foo) != encode(FOO) * It is reversable: decode($encode(foo)) == [foo] * It can be assigned to: @ encode(foo) … text/html 2006-08-31T08:33:33+00:00 http://www.epicsol.org/help/encrypt?rev=1157031213 # $EPIC: encrypt.txt,v 1.3 2006/08/31 13:33:30 sthalik Exp $ encrypt encrypt [server]/<channel> [-<cipher>] <key> [<program>] encrypt [server]/<channel,sourcenick!user@host> [-<cipher>] <key> [<program>] This allows you to maintain an encrypted conversation with a person or channel. Any messages you send to the specified target will automatically be encrypted. If the recipient has likewise specified the proper encryption key for you, the incoming message will automatically be decrypted.… text/html 2007-02-21T23:20:00+00:00 http://www.epicsol.org/help/encryptparm?rev=1172121600 text/html 2006-07-31T21:28:06+00:00 http://www.epicsol.org/help/environment_variables?rev=1154399286 Numerous environment variables are recognized by . Environment variables are various settings that describe your login process on a Unix system. How they are set mainly depends on the command shell you use. * For csh and tcsh shells: setenv variable “value” text/html 2006-07-31T21:28:06+00:00 http://www.epicsol.org/help/eof?rev=1154399286 # $EPIC: eof.txt,v 1.2 2006/08/01 02:24:39 sthalik Exp $ $eof(<file descriptor>) This function tests whether the client is currently at the end of the file pointed to by the given file descriptor. The only valid input is a file descriptor returned by the $open() function. text/html 2007-02-21T23:07:29+00:00 http://www.epicsol.org/help/epic-crypt-gpg-aa?rev=1172120849 # $EPIC: epic-crypt-gpg-aa.txt,v 1.1 2007/02/22 05:07:29 jnelson Exp $ This is a (bash) shell script that can be used as an external program with the client’s external encryption program support. Both the sender and receiver must be encrypting with each other using this script as the external cipher program. text/html 2007-02-21T23:07:29+00:00 http://www.epicsol.org/help/epic-crypt-gpg?rev=1172120849 # $EPIC: epic-crypt-gpg.txt,v 1.1 2007/02/22 05:07:29 jnelson Exp $ This is a (bash) shell script that can be used as an external program with the client’s external encryption program support. Both the sender and receiver must be encrypting with each other using this script as the external cipher program. text/html 2006-07-31T21:28:06+00:00 http://www.epicsol.org/help/epic?rev=1154399286 # $EPIC: epic.txt,v 1.2 2006/08/01 02:24:39 sthalik Exp $ $epic() Returns true if the client is an EPIC client. If this function returns true, the client is an EPIC3 client, or some variant of it. The $V and $J expandos will tell you the exact version of the client. This function is necessary because the stock ircII client’s value for $V and EPIC’s overlap. This is mostly a useful way for scripts to see if they can load or not. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/etiquette?rev=1152593863 Original Authors Lea Viljanen (LadyBug) <viljanen@kreeta.helsinki.fi> Ari Husa (luru) <so-luru@tolsun.oulu.fi> Modified By Troy Rollo (Troy) <troy@plod.cbme.unsw.oz.au> Further Modified By James Sneeringer (CrowMan) <jvs@ocslink.com> 1) Language text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/eval?rev=1171347600 eval <block> Eval accepts a <block> of code and executes it. Generally the only place you need to use eval is at the input prompt. The commands you run at the input prompt are different from commands you run in your script: at the input prompt, command arguments are taken as a literal string, whereas in your scripts, command arguments are expanded and dequoted before the command is executed. The eval command permits you to run a command at the input prompt as though it were running in a s… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/exec?rev=1152593863 This is a disambiguation page. Do you mean the exec command or the exec function? text/html 2006-08-30T16:20:00+00:00 http://www.epicsol.org/help/exec_command?rev=1156972800 # $EPIC: exec_command.txt,v 1.3 2006/08/30 21:02:47 sthalik Exp $ exec [<options>] [<shell commands>] exec -direct <commands> exec -name <name> <process id|shell commands> exec -out <process id|shell commands> exec -msg <nickname|channel> <process id|shell commands> exec -notice <nickname|channel> <process id|shell commands> exec -in <process id> <text to send to process> exec -window <process id|shell commands> exec -<signal> <process id> exec -close <process id> exec -clo… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/exec_function?rev=1156876398 # $EPIC: exec_function.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ $exec(<program> <args>) * If the <program> argument is ommited, the empty string is returned. * Otherwise, <program> is forked and executed with <args> for arguments. * This function returns 3 (three) FDs, which are pipes to/from STDIN, STDOUT and STDERR of the forked process respectively. * The first FD returned (STDIN) is a write mode FD. * The subsequent FDs (STDOUT and STDERR) are read mode FDs. * The FDs retur… text/html 2006-07-16T23:00:00+00:00 http://www.epicsol.org/help/exit?rev=1153108800 # $EPIC: exit.txt,v 1.2 2006/07/17 03:42:24 jnelson Exp $ exit <reason> The exit command is an internal alias for quit. text/html 2006-07-16T23:00:00+00:00 http://www.epicsol.org/help/exp?rev=1153108800 # $EPIC: exp.txt,v 1.2 2006/07/17 03:42:24 jnelson Exp $ $exp(<number>) * The function returns the value of e raised to <number>. * If <number> is omitted, the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means an error ocurred. text/html 2007-08-06T16:26:04+00:00 http://www.epicsol.org/help/expando_substitution?rev=1186435564 Before a string can be used, it must be “expanded” whereby the expandos (things that start with $) in the string are removed and replaced with their values, and backslashes (\\) are dequoted. However, stuff inside of parenthesis “(...)” or curly braces “{...}” is considered literal text and is not expanded. The stuff inside parenthesis and curly braces is usually expanded later by someone else. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/expandos?rev=1172553600 text/html 2007-10-13T12:07:11+00:00 http://www.epicsol.org/help/expressions?rev=1192295231 About "expression mode" and "text mode" EPIC has two “modes” it executes your code in. “Text mode” is the standard mode that every command starts out in. Text mode Expression mode Everything is plain text Everything is operator or operand First word is command, rest is arg list Can escape to text mode with []s $’s start “expandos” (macro substitution) $’s are not permitted before vars “Expression mode” occurs in all of the following text-mode commands: … text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/fe?rev=1184106000 fe (<list>) <variable> [<variable> ...] { <actions> } fe <source_variable> <variable> [<variable> ...] { <actions> } Form 1: FE is one of several loop types available in ircII-EPIC. This loop takes a list of items, and for each one, it performs the specified action. text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/fec?rev=1154400332 fec (<string>) <variable> [<variable> ...] { <actions> } fec <source_variable> <variable> [<variable> ...] { <actions> } The fec command works in the same way as fe, except that it iterates over each character rather than each word. Leading whitespace between the opening parenthesis and first non-whitespace character and trailing whitespace between the final non-whitespace character and the closing parenthesis is ignored. This is probably not the ideal behavior, but it is backwards compatab… text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/ferror?rev=1160162400 # $EPIC: ferror.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $ferror(<file descriptor>) This function returns non-zero if an error has occurred on the file descriptor since the last read, because the read and readb functions clear the file descriptors error code. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/fexist?rev=1172803800 # $EPIC: fexist.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $fexist(<file>) $fexist("" <file>) * In the first case, <file> is a single extended word (you may surround it with double quotes if it contains spaces). Any further arguments are ignored. * In the second case, the first argument is an empty string, and the rest of the arguments are taken as a filename literally. Do not backslash or double quote anything in <file>. * Tile-expansion is supported in both forms. * If <file> … text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/files?rev=1154400332 # $EPIC: files.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ load files This script is meant as a working example of the possible uses of EPIC’s various built-in file-access functions. Three aliases are provided: Alias Description /cat like the Unix command, it displays the named file /grep like the Unix command, it searches for pattern $0 in files $1- /log_it writes an arbitrary line to file $0 … text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/filter?rev=1154400332 # $EPIC: filter.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $filter(<pattern> <word list>) * If the <pattern> argument is omitted the empty string is returned. * This function returns a space separated word list of all of the words in <word list> that are NOT matched by <pattern>. * This is the complement to $pattern(), and the inverse of $rfilter(). * Double quoted words are honored, but the double quotes will be lost in the return value. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/finditem?rev=1172553600 # $EPIC: finditem.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $finditem(<array> <string>) $ifinditem(<array> <string>) $ifindfirst(<array> <string>) These functions do a binary search on the items stored in the given array, looking for an exact match of the input string. It will only return the results of an exact match. Unlike other string handlers in the client, these are case-sensitive. They only operate on arrays created with the $setitem() function. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/finditems?rev=1172553600 text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/findw?rev=1154400332 # $EPIC: findw.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $findw(<word> <wordlist>) This function searches <wordlist> for <word> and returns the place it was found. If <word> isn’t in <wordlist>, -1 is returned. This function should put many scripters to ease, as it has been written into many scripts :) text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/findws?rev=1171513201 text/html 2007-02-24T12:20:00+00:00 http://www.epicsol.org/help/fix_arglist?rev=1172341200 text/html 2007-03-01T20:32:04+00:00 http://www.epicsol.org/help/flood_control?rev=1172802724 $EPIC: flood_control.txt,v 1.1 2007/03/02 02:32:04 jnelson Exp $ The client has an anti-flood facility whose purpose is to prevent crapflooding to your display. Since flood control is a client-side facility, it can’t stop someone from consuming all your cpu or bandwidth. text/html 2007-03-03T12:50:00+00:00 http://www.epicsol.org/help/floodinfo?rev=1172947800 text/html 2007-02-28T11:50:00+00:00 http://www.epicsol.org/help/floodprot?rev=1172685000 text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/floor?rev=1154400332 # $EPIC: floor.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $floor(<number>) Calculates the largest integer that is less than or equal to <number> The largest integer that is less than or equal to the argument, or nothing if no argument is specified. text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/flush?rev=1154400332 flush This command effectively does a /REDIRECT 0 WAIT. In other words, it suppresses all output to all of your windows from your current server for one full “WAIT” cycle (the time it takes for a command to go out to the server and come back) text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/fnexist?rev=1154400332 # $EPIC: fnexist.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $fnexist(<function>) This function tells wether or not a built-in function exists. This can be used to emulate a built-in function in older versions of epic that may not support it. 1 If the built-in function <function> exists 0 If <function> doesn't exist text/html 2006-07-31T21:59:15+00:00 http://www.epicsol.org/help/for?rev=1154401155 for (once, expression, each) { block } for var from firstval to lastval { block } for var from firstval to lastval step stepval { block } for var in (word list) { block } FOR is a general purpose loop. It is modeled on the C for statement, and works in a very similar manner. Aside from the action, there are three parts to a FOR loop: text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/foreach?rev=1154400332 foreach [-]<structure> <variable> { <action> } The FOREACH command is a loop type that iterates through the items in a variable (or alias, see below) structure. This is often useful for purging an entire structure, or for searching through it for a certain piece of data. text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/frewind?rev=1160162400 # $EPIC: frewind.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $frewind(<file descriptor>) This function resets the file pointer back to the beginning of the file. The next read or readb in the file after this call will read the first line of the file. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/fromw?rev=1172803800 # $EPIC: fromw.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $fromw(<word> <word list>) * If the <word> argument is omitted this function returns the empty string. * The <word list> is a list of literal words. Before EPIC4-1.1.10, the <word list> was a list of wildcard patterns. * If <word> is not found in <word list>, this function returns the empty string. * Otherwise, the function behaves “as if” the following had been * performed: <val> = findw(<word> <word list>) <functi… text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/fseek?rev=1160162400 # $EPIC: fseek.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $fseek(file descriptor position anchor) This function resets the file pointer to position bytes away from anchor. The next read or readb of the file after this call will read the data from the new location. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/fsize?rev=1172803800 # $EPIC: fsize.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $fsize(<file>) $fsize(”” <file>) * In the first case, <file> is a single extended word (you may surround it with double quotes if it contains spaces). Any further arguments are ignored. * In the second case, the first argument is an empty string, and the rest of the arguments are taken as a filename literally. Do not backslash or double quote anything in <file>. * Tile-expansion is supported in both forms. * If <file> ex… text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/fskip?rev=1160162400 # $EPIC: fskip.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $fskip(file descriptor number) The fskip function skips the next number lines in the file. The return value is the number of lines that were actually skipped. If you try to skip more lines than are left in the file (end of file), the return value will be less than number. text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/ftell?rev=1160162400 # $EPIC: ftell.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $ftell(file descriptor) This function returns the current position of the file pointer, measured in bytes from the beginning of the file. This value can be used to save your position in the file, and you can later use text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/ftime?rev=1172803800 # $EPIC: ftime.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ $ftime(<file>) This function gets the last modified time (mtime) of a file, and returns it in seconds since the epoch. when the file was last modified eval echo $stime($ftime(/usr/local/bin/irc)) "Tue Oct 21 23:30:54 1997" text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/ftruncate?rev=1160162400 # $EPIC: ftruncate.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ $ftruncate(bytes filename) The ftruncate file causes the filename to change to exactly bytes bytes in size. The file is grown or shrunk as necessary. If the file is shrunk, the data beyond the new file size is irretrievably lost. If the file is grown, the contents of the new space is unspecified, but usually it is nuls (ascii 0). text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/functioncall?rev=1156876398 # $EPIC: functioncall.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $functioncall() * This function returns 1 if the current script context is expecting a return value (ie, in an alias called as a function and not as a command.) * This function returns 0 in all other circumstances, including but not limited to aliases executed as commands, /on bodies, /userhost -cmd bodies, and any other place where a return value is not expected. text/html 2006-09-07T00:08:49+00:00 http://www.epicsol.org/help/functions_overview?rev=1157605729 EPIC functions are very similar to those of common procedural languages - they have arguments and they return a value. There are many different kinds of functions - ones that manipulate strings, ones that retrieve information from the client, ones that perform math operations et cetera. text/html 2006-07-31T21:45:32+00:00 http://www.epicsol.org/help/functions_script?rev=1154400332 # $EPIC: functions_script.txt,v 1.2 2006/08/01 02:45:08 sthalik Exp $ load functions This script contains several functions useful in scripting for text display. Of primary interest are $format() and $lformat(). They behave similarly to using the $[]var notation, except they will not truncate text that is wider than the specified width. text/html 2006-07-31T22:26:53+00:00 http://www.epicsol.org/help/geom?rev=1154402813 # $EPIC: geom.txt,v 1.3 2006/08/01 03:26:48 sthalik Exp $ $geom() $geom(<winref>) * In the first case, the screen of the client’s global current window is used. * In the second case, the screen of the given window refnum is used. * In both cases, the return value is two numbers, the first is the number of columns and the second is the number of lines on the screen. text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getarrays?rev=1154402550 # $EPIC: getarrays.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getarrays() This function displays all existing arrays created by $setitem(). This function is used to show all current arrays. his might be useful for modifying data in multiple arrays, when it is not known precisely which ones exist at the moment in question. text/html 2006-12-13T05:07:43+00:00 http://www.epicsol.org/help/getcap?rev=1166008063 # $EPIC: getcap.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getcap(TERM <capname> <nametype> <mangle>) * The first argument must be a capability type; currently only “TERM” is supported. * If the <capname> argument is omitted, the empty string is returned. * If the <nametype> argument is omitted, the name type is taken as 0. * If the <mangle> argument is omitted, the mangle value is taken as 1. * This function queries a capability database (currently only TERMinal capabilities … text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getcommands?rev=1154402550 # $EPIC: getcommands.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getcommands() $getcommands(<pattern>) * If no argument is given, the return value is a word list of all built in commands. * If an argument is given, the return value is a word list of all built in commands that match the given pattern. * Multiple patterns may be specified; the result is a concatenated list of return values as if each pattern had been processed individually. Specifically, any duplicates will NOT be rem… text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getenv?rev=1154402550 # $EPIC: getenv.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getenv(<variable>) This function returns the <variable> from the shell’s environment. This function is especially useful when a /set or /assign variable conflicts with an environment variable. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/getfunctions?rev=1172553600 text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getgid?rev=1154402550 # $EPIC: getgid.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getgid() Gets the current group id, similar to the Unix system call. current groupid text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getitem?rev=1154402550 # $EPIC: getitem.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getitem(<array> <item#>) $igetitem(<array> <index#>) These functions are used to fetch data held in the given array. The $getitem() function retrieves data based on its item number in the array (counting from zero, the order in which the data was entered). text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getlogin?rev=1154402550 # $EPIC: getlogin.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getlogin() Gets the name of the current logged in user, similar to the Unix system call. current logged in username text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/getmatches?rev=1172553600 # $EPIC: getmatches.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getmatches(<array> <pattern>) $getrmatches(<array> <string>) This functions operate in a manner similar to $matchitem() and $rmatchitem(), except that they return a list of all items that match the input pattern or string, not just the best match. Item numbers are returned, not the actual array contents. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/getopt?rev=1172803800 # $EPIC: getopt.txt,v 1.3 2006/08/01 03:26:48 sthalik Exp $ $getopt(<optopt-var> <optarg-var> <option-list> <argument-list>) * This function should be called as the expression of a WHILE command. * If the <optopt-var> argument is omitted the empty string is returned. * If the <optarg-var> argument is omitted the empty string is returned. * If the <option-list> argument is omitted the empty string is returned. * The <optopt-var> argument is taken as the name of a variable in which to… text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getpgrp?rev=1154402550 # $EPIC: getpgrp.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getpgrp() Gets the current process group id of the client, similar to the Unix system call. current process group id text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/getrmatches?rev=1172553600 text/html 2007-02-18T21:20:58+00:00 http://www.epicsol.org/help/getserial?rev=1171855258 text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/getset?rev=1152593863 # $EPIC: getset.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $getset(<set name>) * If the <set name> argument is omitted the empty string is returned. * If the set variable <set name> does not exist, the empty string is returned. * This function returns the value that would be returned by the “set value” $<set name>. text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getsets?rev=1154402550 # $EPIC: getsets.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getsets() $getsets(<pattern>) * If no argument is given, the return value is a word list of all built in set variables. * If an argument is given, the return value is a word list of all built in set variables that match the given pattern. * Multiple patterns may be specified; the result is a concatenated list of return values as if each pattern had been processed individually. Specifically, any duplicates will NOT be removed. text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/gettmatch?rev=1154402550 # $EPIC: gettmatch.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $gettmatch(<array> <pattern>) This function returns the best match of <pattern> within the array of strings specified by <array>. This is different than $getmatches(), which returns all matches. text/html 2006-07-31T22:22:30+00:00 http://www.epicsol.org/help/getuid?rev=1154402550 # $EPIC: getuid.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $getuid() Gets the current user id, similar to the Unix system call. current userid text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/glob?rev=1172803800 # $EPIC: glob.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $glob(<file glob pattern>) This function is used to find filenames that are matched by specified patterns. This function is controlled by a compile time option, so it may not be available on every installation. Multiple patterns may be specified. Hidden files (dot-files) are not displayed unless a glob pattern beginning with a dot is given. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/global?rev=1156876398 # $EPIC: global.txt,v 1.4 2006/08/29 18:33:16 sthalik Exp $ load global This script is loaded automatically when the client first starts. At the time of this writing, it automatically loads 2.8SCRIPT and LOCAL. It also sets the following aliases: text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/globi?rev=1172803800 # $EPIC: globi.txt,v 1.2 2006/08/01 03:22:01 sthalik Exp $ $globi(<file glob pattern>) This is just like $glob(), but it’s case insensitive. This is necessary for doing filename generation when you can’t control whether the files will be in uppercase or lower case (such as with the /HELP command.) text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/glossary?rev=1152593863 This file contains definitions and examples for epic concepts that are not covered by their own help files text/html 2007-02-19T20:50:00+00:00 http://www.epicsol.org/help/grep?rev=1171939800 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/guh?rev=1156876398 # $EPIC: guh.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ load guh This script consists of a trio of functions, primarily aimed at fetching information about other clients. Each relies on a server query, so they may not return the requested information immediately. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/hash_32bit?rev=1172803800 # $EPIC: hash_32bit.txt,v 1.2 2006/08/01 03:29:42 sthalik Exp $ $hash_32bit(<word> <length>) * If the <word> argument is omitted the empty string is returned * If the <length> argument is omitted it defaults to 0 * If the <length> argument is a negative number of is greater than 64, it is changed to 20. * The return value of this function is a 32 bit signed integer that is a “hash” of the first <length> characters in <word>. * Analytically speaking, hashing is a specific type of… text/html 2007-02-19T22:20:00+00:00 http://www.epicsol.org/help/help?rev=1171945200 text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/highlight?rev=1172553600 text/html 2007-03-16T18:20:00+00:00 http://www.epicsol.org/help/history?rev=1174087200 # $EPIC: history.txt,v 1.3 2006/08/01 03:30:43 sthalik Exp $ history history [<number>] ! [<history number|history match>] With the HISTORY command you can display commands that you have previously executed at the input prompt. The HISTORY command attempts to behave similar to bash or tcsh for your sanity. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/hold_mode?rev=1172553600 text/html 2006-07-31T22:29:49+00:00 http://www.epicsol.org/help/hook?rev=1154402989 hook <anything> HOOK throws an on hook event. The on hook feature is your way to create your own user-defined ons. This script will echo a line every 10 seconds: on ^hook "foo" { timer 10 { echo This line is repeated every 10 seconds hook foo } } hook foo #$EPIC: hook.txt,v 1.2 2006/08/01 03:29:42 sthalik Exp $ text/html 2006-08-31T21:50:00+00:00 http://www.epicsol.org/help/hookctl?rev=1157079000 === ADDING AND REMOVING HOOKS === $hookctl(ADD [#][!][']<noise><TYPE> [<serial>] <pattern> [(<arg list>)] <code>) Compare this to: /ON [#]<noise><TYPE> [<serial>] [!]<pattern> [(<arglist>)] <code> Where [#] is used to indicate a <serial> number should be used, where [!] is used to indicate that the ON is a "negative" ON where ['] is used to indicate that the ON is a "flexible" ON where [<noise>] is one… text/html 2006-09-19T06:20:00+00:00 http://www.epicsol.org/help/hostname?rev=1158664800 # $EPIC: hostname.txt,v 1.4 2006/09/19 10:52:37 sthalik Exp $ hostname <hostname for ipv4 and ipv6> hostname [hostname for ipv4]/[hostname for ipv6] EPIC has many opportunities to create internet connections. The most obvious circumstances are server connections and dcc connections. Every internet connection has a specific internet protocol (IP) address (in IPv4, addresses are 32 bit integers; in IPv6, they are larger) for both you and for the person you’re talking to. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/idle?rev=1154403642 # $EPIC: idle.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $idle() * Arguments, if any, will be ignored. * Returns the number of seconds since you last pressed a key. * Equivalent to $E. * Present for compatibility with ircII. This returns your “idle time”, which is measured by the number of seconds since you last pressed a key, which is what we consider “not idle”. Use $idle() instead of $E if you want to be laterally compatible with standard ircII. Note that the client�… text/html 2007-05-30T23:20:00+00:00 http://www.epicsol.org/help/if?rev=1180585200 if (<condition>) <then> if (<condition>) { <then> } [{ <else> }] if (<condition>) { <then> } elsif (<condition>) { <then> } else { <then> } if (<condition>) { <then> } elif (<condition>) { <then> } if (<condition>) { <then> } else if (<condition>) { <then> } text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/ifindfirst?rev=1172553600 text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/ifinditem?rev=1172553600 text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/ifinditems?rev=1172553600 text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/igetitem?rev=1172553600 text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/igetmatches?rev=1154403642 # $EPIC: igetmatches.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $igetmatches(<array> <pattern>) $igetrmatches(<array> <string>) This functions operate in a manner similar to $getmatches() and $getrmatches(), except that they return an index number (in alphabetical order) of the array members rather than the item numbers. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/igetrmatches?rev=1172553600 text/html 2006-08-31T09:20:00+00:00 http://www.epicsol.org/help/ignore?rev=1157034000 # $EPIC: ignore.txt,v 1.4 2006/08/31 14:06:54 sthalik Exp $ ignore [<nick>] +|^]<message type(s)>] \\ __ignore__ [<user@host>] [[-|+|^]<message type(s)>] \\ __ignore__ [<nick!user@host>] [[-|+|^]<message type(s)>] \\ __ignore__ [<channel>] [[-|+|^]<message type(s)>] \\ __ignore__ [<refnum>] [[-|+|^]<message type(s)>] \\ __ignore__ [<something>] [<types>] [REASON "<reason>"] \\ __ignore__ [<something>] [<types>] [REASON "<reason>"] ======Description:====… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/ignorectl?rev=1156876398 # $EPIC: ignorectl.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $ignorectl(REFNUMS) $ignorectl(REFNUM <refnum>) $ignorectl(ADD <ignore-pattern> [level-desc]) $ignorectl(CHANGE <refnum> [level-desc]) $ignorectl(DELETE <refnum>) $ignorectl(PATTERN <wildcard-pattern>) $ignorectl(RPATTERN <nick!user@host>) $ignorectl(WITH_TYPES [level-desc]) $ignorectl(GET <refnum> <item>) $ignorectl(SET <refnum> <item> <value>) text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/index?rev=1172803800 # $EPIC: index.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $index(<characters> <text>) * If the <characters> argument is omitted the empty string is returned. * <characters> may contain any number of different characters. If you want to include the space character, enclose <characters> in double quotes. If you want to include the double-quote character, then put some other character before it that won’t be in <text>. * If the first character in <characters> is the caret (”^”… text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/indextoitem?rev=1154403642 # $EPIC: indextoitem.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $indextoitem(<array> <index number>) $itemtoindex(<array> <item number>) These functions are used to convert between array item numbers are index numbers. Item numbers are counted incrementally as items are added to an array, starting at 0 (zero). Each new item uses the next available item number; if there are 5 items in an array, the next item that may be added is item number 5 (remember that we count from zero... 5 items is … text/html 2006-07-31T22:47:48+00:00 http://www.epicsol.org/help/indextoword?rev=1154404068 # $EPIC: indextoword.txt,v 1.3 2006/08/01 03:47:40 sthalik Exp $ $indextoword(<position> <text>) * If the <position> argument is omitted the empty string is returned. * If the <position> argument is a negative number the empty string is returned. * If the <text> argument is omitted the empty string is returned. * If the length of <text> is less than <position> the empty string is returned. * Otherwise, the return value returns a value suitable for use with the $word() function (or o… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/info?rev=1152593863 This is a disambiguation page. Do you mean the info command or the info function? text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/info_command?rev=1152593863 info [<server>] This command asks the server for information about the ircd program. You will see a list of contributers to ircd, and ircII, and EPIC. You can query a remote server, but that doesn’t serve much purpose since networks usually run the same software network-wide. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/info_function?rev=1154403642 # $EPIC: info_function.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $info(c|o|s|v|r|i) This function returns information about how the client was compiled. This function is used to fetch information stored in the client at compile time. It can be used to find out who compiled it, and when; what #define options were enabled; and to get the checksums of the binary. text/html 2006-09-01T06:20:00+00:00 http://www.epicsol.org/help/input?rev=1157109600 input “<prompt>” <command> [<arguments>] input_char “<prompt>” <command> [<arguments>] This command is primarily for use inside scripts. It allows the client to present the user with a visible prompt for specific commands. This can be used for interactive commands, for command confirmation, etc. Multiple commands may be specified if surrounded with curly braces. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/input_char?rev=1154403642 input_char [-noecho] “<prompt>” {<stuff>} This command prompts the user to type ONE character and then runs the <stuff> and $* will be the user’s response. The -noecho option will suppress the outputting of the character to the input line as it is typed. text/html 2007-05-19T16:12:56+00:00 http://www.epicsol.org/help/input_handling?rev=1179609176 I get many requests for utf8 support. As of the time I write this, epic does not support utf8, and support for it is not planned in the short term. This document describes how epic handles your keypresses, and discusses how utf8 support might grow in the future. This document is not intended to be excruciatingly exacting enough to satisfy pedants, but rather to gently introduce people to the issues and why console programs have a much harder time of it than graphical program.s text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/insert?rev=1172803800 # $EPIC: insert.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $insert(<num> <word> <text>) * If the <num> integer argument is omitted the empty string is returned. * If the <word> argument is omitted the empty string is returned. * The return value of this function is <text> with the <word> argument inserted after the <num>th character. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/insertw?rev=1172803800 # $EPIC: insertw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $insertw(<index> <word> <word list>) * If the <index> argument is omitted the empty string is returned. * If the <index> argument is less than 1, then the return value is the rest of the argument list as it is passed. (<word> <word list>) * Otherwise, the return value is a copy of <word list> that has had <word> inserted as the <index>th word, counting from zero. * No words in <word list> are removed. * Historically <word … text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/introduction?rev=1154403642 Crash Course in irc with EPIC You are using the EPIC irc client. Assuming you have the correct help files for your client, you are using version 4 of EPIC. EPIC is a variant of the ircII client that contains countless enhancements, while retaining near full backward compatibility with ircII version 2.8.2. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/invite?rev=1154403642 # $EPIC: invite.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ invite <nickname> <channel> You may invite another irc user to join a channel by sending them an invitation with INVITE. If a channel is join-by-invitation-only (mode +i), you must be a channel operator to invite people there. Some servers also require that you be a member of a channel to invite others when the channel is not invite-only. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/iptolong?rev=1154403642 # $EPIC: iptolong.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $iptolong(<dotted-quad>) * If the <dotted-quad> value is omitted the empty string is returned. * The <dotted-quad> value is taken to be a dotted-quad ipv4 internet address of the form “A.B.C.D” where A,B,C,D are integers less than 256. * The return value is the NETWORK ORDER integer equivalent of <dotted-quad>. text/html 2006-07-31T22:47:48+00:00 http://www.epicsol.org/help/iptoname?rev=1154404068 # $EPIC: iptoname.txt,v 1.3 2006/08/01 03:47:40 sthalik Exp $ $iptoname(<ip address>) $nametoip(<hostname>) These functions are used to convert an IP address to a hostname, and vice versa. The $iptoname() function returns the hostname associated with the given IP address, and $nametoip() does the opposite. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/ipv6?rev=1156876398 IPv6 Support As of 7/29/2002 EPIC fully supports IPv6 in server descriptions, server connections, $connect(), $listen(), /DCC GET, Virtual Hostnames, $iptoname(). Server descriptions: Surround the ipv6 p-addr with square brackets: /server [1:2::3]:... text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/ircii_syntax?rev=1171347600 The ircII language is organized into blocks. A block is a sequence of statements separated by semicolons. A statement is one of the following * A command statement * An expression statement * A block statement A command statement is of the form text/html 2006-08-20T22:50:00+00:00 http://www.epicsol.org/help/irclib?rev=1156132200 # $EPIC: irclib.txt,v 1.3 2006/08/21 03:39:11 sthalik Exp $ $irclib() This function returns the path to the irc library that the client is currently using. This value is set at client boot time and does not change afterwards. The irc library path influences the default values of /SET LOAD_PATH and /SET HELP_PATH. text/html 2006-09-19T06:20:00+00:00 http://www.epicsol.org/help/ircuser?rev=1158664800 # $EPIC: ircuser.txt,v 1.3 2006/09/19 10:52:37 sthalik Exp $ ircuser <username> Whenever you connect to an irc server, the client sends some information about you to the server (``registration’‘). One of the pieces of infor- mation it sends is your “username”. This is supposed to be the name of the account you are logged into. The server treats this username as nothing more than a fallback value; a hint. The server does not trust the client to send trustworthy data (and why should… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/isalpha?rev=1152593863 # $EPIC: isalpha.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $isalpha(<text>) $isdigit(<text>) These function test whether the first character in the given string is an alphabetical character or a digit. Only the first character is tested. These functions are useful for testing an input string to see whether it is a number or a text string. One use for this might be to check if it would be suitable input for $iptoname() or $nametoip(). Keep in mind that only the first character is t… text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/isaway?rev=1154403642 # $EPIC: isaway.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $isaway() $isaway(<server refnum>) * If the <server refnum> argument is omitted, the “from (current) server” is the default. * If the <server refnum> argument is not a number, it will be changed to the server refnum 0. * If the <server refnum> argument is not a valid server refnum, the return value is 0. * This function returns 1 if you are AWAY on that server, and 0 if you are not. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/ischannel?rev=1154403642 # $EPIC: ischannel.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $ischannel(<channel name>) * This function returns 1 if <channel name> is a valid channel name, and 0 if it is not a valid channel name. * A channel is “valid” if it begins with the plus character, (’+’), the hash character (’#’), the ampersand (’&’), or the bang (’!’). * This function does NOT tell you whether or not a channel exists. text/html 2006-10-13T12:51:07+00:00 http://www.epicsol.org/help/ischanop?rev=1160761867 # $EPIC: ischanop.txt,v 1.5 2006/10/13 17:51:04 sthalik Exp $ $ischanop(<nick> <channel>) * If the <nick> argument is omitted, the empty string is returned. * If the <channel> argument is omitted, or if it is a literal star (’*’), then the current channel is assumed. * BEWARE -- if you are connected to more than one server and the current window is connected to a different server than whatever context this function is called in, it may falsely return 0. To be sure, always specify… text/html 2006-07-31T22:47:48+00:00 http://www.epicsol.org/help/ischanvoice?rev=1154404068 # $EPIC: ischanvoice.txt,v 1.3 2006/08/01 03:47:40 sthalik Exp $ $ischanvoice(<nick> <channel>) This function searches the client’s channel cache for the user <nick> on the channel <channel> for the current server refnum, and returns their current channel voiced status. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/isconnected?rev=1154403642 # $EPIC: isconnected.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $isconnected([<server refnum>]) This function tells wether a server is fully connected and ready to receive data. If no arguments are given, the last server to send you data is assumed. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/iscurchan?rev=1152593863 # $EPIC: iscurchan.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $iscurchan(<channel name>) This function returns ‘1’ if the input channel name is the current channel on any window connected to the current server. This function was intended to allow more flexibility for testing the current channel in an ON hook. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/isdigit?rev=1152593863 # $EPIC: isdigit.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $isalpha(<text>) $isdigit(<text>) These function test whether the first character in the given string is an alphabetical character or a digit. Only the first character is tested. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/isdisplaying?rev=1156876398 # $EPIC: isdisplaying.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $isdisplaying() * This function returns 0 if output is being “suppressed”. * This function returns 1 if output is not being “suppressed” * Output is NEVER “suppressed” in the following circumstances * The /ECHO command turns off the suppressed value unless you specify the /ECHO -SAY option * The /SENDLINE command turns off the suppressed value. * Output is “suppressed” in the following circumstances:… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/isencrypted?rev=1152593863 # $EPIC: isencrypted.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $isencrypted(<server refnum>) * This function returns 0 The EPIC-SSL client’s version of this function returns 1 if the connect to server <server refnum> is encrypted (via SSL). EPIC’s version always returns 0 because it does not support SSL server connections. Use this function to isolate code that needs to behave differently for SSL server connections. text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/isfilevalid?rev=1171513201 text/html 2006-10-13T12:51:07+00:00 http://www.epicsol.org/help/ishalfop?rev=1160761867 # $EPIC: ishalfop.txt,v 1.5 2006/10/13 17:51:04 sthalik Exp $ $ishalfop(<nick> <channel>) * If the <nick> argument is omitted, the empty string is returned. * If the <channel> argument is omitted, or if it is a literal star (’*’), then the current channel is assumed. * BEWARE -- if you are connected to more than one server and the current window is connected to a different server than whatever context this function is called in, it may falsely return 0. To be sure, always specify… text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/isnumber?rev=1154403642 # $EPIC: isnumber.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $isnumber(<text>) $isnumber(b<base-num> <text>) $isnumber(<text> b<base-num>) * The <base-num> argument may either be the first or second word, but in either case must be prefixed with the literal ‘b’ character. * The <text> argument may either be the first or second word, but in either case must NOT be prefixed with the literal ‘b’ character. * If the <base-num> argument is not specified, the default value is 0.… text/html 2006-08-30T14:28:33+00:00 http://www.epicsol.org/help/ison?rev=1156966113 ison [-n] [-s] [-len <number>] [-oncmd <command>] [-offcmd <command>] [<nick> [<nick> ...]] This server query implements the underlying functionality for the NOTIFY command. Given a list of nicknames, it returns the subset of those nicknames that are currently on your network. If none of them are on the network, an empty list is returned. text/html 2006-07-31T22:40:42+00:00 http://www.epicsol.org/help/itemtoindex?rev=1154403642 # $EPIC: itemtoindex.txt,v 1.2 2006/08/01 03:40:36 sthalik Exp $ $indextoitem(<array> <index number>) $itemtoindex(<array> <item number>) These functions are used to convert between array item numbers are index numbers. Item numbers are counted incrementally as items are added to an array, starting at 0 (zero). Each new item uses the next available item number; if there are 5 items in an array, the next item that may be added is item number 5 (remember that we count from zero... 5 items i… text/html 2006-07-31T22:51:57+00:00 http://www.epicsol.org/help/jn?rev=1154404317 # $EPIC: jn.txt,v 1.3 2006/08/01 03:51:53 sthalik Exp $ $jn(<level> <number>) * Returns the bessel function of the first kind of the order <level> for <number>. * If the <level> or <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means there was an error. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/join?rev=1156876398 # $EPIC: join.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ //join [-invite|<channel list> [<key>]] join (join channel you were invited to) join <chan>[,<chan>] (comma separate multiple channels) [keys do not work with commas] join channel <key> (will auto-prepend a # for you) join #channel <key> (join a network channel) join &channel <key> (join a local server channel) join !channel <key> (join an IRCNet “id” channel) join +channel (join an IRCNet “mod… text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/joinstr?rev=1171513201 text/html 2006-07-31T22:51:29+00:00 http://www.epicsol.org/help/jot?rev=1154404289 # $EPIC: jot.txt,v 1.2 2006/08/01 03:50:35 sthalik Exp $ $jot(<start> <stop> <interval>) * If the <start> argument is omitted the empty string is returned. * If the <stop> argument is omitted the empty string is returned. * If the <interval> argument is omitted the default value of 1 is used. * If the <interval> argument is 0, the empty string is returned. * The <interval> argument should be an integer value -- support for fractional numbers will be added in the future. * The <int… text/html 2007-02-26T22:57:37+00:00 http://www.epicsol.org/help/karll_arrays?rev=1172552257 What are Karll Arrays? Karll Arrays (named after the person who contributed them to the client) are named collections of items. Unlike the client’s standard associative arrays, karll arrays use index refnums to refer to items. Arrays can have any name that is a lawful C string, and array names are case sensitive. An array is created when you set item 0 in that array. Any other operation on a non-existant array has not been created is a “not found” error. text/html 2006-07-31T22:55:11+00:00 http://www.epicsol.org/help/key?rev=1154404511 # $EPIC: key.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $ $key(<channel list>) * If the <channel list> argument is omitted, the current channel is used. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON! * <channel list> is taken as a word list (space separated) of channel names. The asterisk (”*”) is a special channel name that refers to the current window’s current channel. THIS MAY NOT BE THE CORRECT CHANNEL IN AN /ON! * The return value is a word list of channel keys correspondi… text/html 2006-07-31T22:55:11+00:00 http://www.epicsol.org/help/key_bindings?rev=1154404511 How to Use Key Bindings in EPIC One of the strengths of this client is its /bind command. It permits any key or sequences of keys to be bound to any arbitrary action. You are most likely already familiar with using keyboard shortcuts with other programs. text/html 2006-07-31T22:55:11+00:00 http://www.epicsol.org/help/kick?rev=1154404511 # $EPIC: kick.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $ kick *|<channel> <nickname> [<reason for kick>] This command revokes the membership of another irc user from a channel in which you are a channel operator. Customarily, it is used to remove troublemakers, flooders, or others who are making a nuisance of themselves. You may specify a reason for the kick, and doing so is considered good style by most; however it is not required. text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/kill?rev=1184106000 kill <nick> <comment> KILL is used to forcibly remote a client from the irc network. It works similarly to KICK, except that a reason must be given (even if it is meaningless or flat-out wrong). In general, KILL is useful only as a warning tool for abusive users. Modern irc clients (this one included) have automated means for reconnecting to a server after a disconnection (whether due to a KILL or something else), so KILL is by no means a permanent solution. It is not intended as a means for… text/html 2006-07-31T22:55:11+00:00 http://www.epicsol.org/help/killpid?rev=1154404511 #$EPIC: killpid.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $ $killpid(<signal> <pid> [...<pid>]) This function sends a signal to one or more pids This allows sending signals to other processes without having to used exec to invoke the kill command. text/html 2006-07-31T22:55:11+00:00 http://www.epicsol.org/help/knock?rev=1154404511 # $EPIC: knock.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $ knock <channel> The KNOCK command sends a message to <channel> asking them to INVITE you. This is useful for channels with the +i channel mode (which requires an invitation from a channel operator before you may join.) text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/lastlog?rev=1152593863 This is a disambiguation page. Do you mean the lastlog command or the lastlog function? text/html 2007-02-19T20:50:00+00:00 http://www.epicsol.org/help/lastlog_command?rev=1171939800 # $EPIC: lastlog_command.txt,v 1.6 2006/08/31 14:06:54 sthalik Exp $ lastlog [-] [-<flag>] [--<flag>] [-mangle <descr>] [<pattern>] [<number of entries> [<start>]] LASTLOG allows you to grep through output lines that have previously been displayed on your screen. The contents of this buffer are controlled by SET LASTLOG_LEVEL and the size is controlled by SET LASTLOG. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/lastlog_function?rev=1172803800 # $EPIC: lastlog_function.txt,v 1.2 2006/08/01 04:07:08 sthalik Exp $ $lastlog(<window> <pattern> <level> ...) This function searches the lastlog buffer of window <window> for lines matching <pattern> _and_ with lastlog level matching any of <level>. All arguments are required, but you can specify additional <level>s. If you wish all lines matching <pattern> to be returned, specify <level> as ALL. text/html 2006-07-31T23:13:03+00:00 http://www.epicsol.org/help/left?rev=1154405583 # $EPIC: left.txt,v 1.4 2006/08/01 04:12:59 sthalik Exp $ $left(<count> <text>) * If <count> is omitted, this function returns the empty string. * If <text> is omitted, this function returns the empty string. * If <count> is less than 0, this function returns the empty string. * If <text> is more than <count> characters long, then this function will return a copy of the first <count> characters in <text>. * If <text> is less than or exactly <count> characters long, then this functio… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/leftpc?rev=1152593863 # $EPIC: leftpc.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $leftpc(<count> <text>) This function returns the leftmost <count> printable characters of <text>, taking into account ANSI color codes. <count> number of printable characters in <text> text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/leftw?rev=1172803800 # $EPIC: leftw.txt,v 1.2 2006/08/01 04:07:08 sthalik Exp $ $leftw(<count> <word list>) * If the <count> argument is omitted the empty string is returned. * If the <count> argument is less than 1, the empty string is returned. * This function returns the first <count> words from <word list>. * Historically <word list> does not support double-quoted words. This may change in the future. Try using /xdebug extractw. text/html 2007-02-17T12:50:00+00:00 http://www.epicsol.org/help/less-pipe?rev=1171738200 text/html 2007-02-17T12:50:00+00:00 http://www.epicsol.org/help/less?rev=1171738200 # $EPIC: less.txt,v 1.3 2006/08/01 04:11:44 sthalik Exp $ load more This script is an emulation of the Unix utility of the same name. It displays the contents of a text file, pausing after each windowfull. This script was written by Jeremy Nelson (hop), <jnelson@acronet.net>, who was inspired by the more script by archon, <archon@tamu.edu>. text/html 2007-02-17T12:50:00+00:00 http://www.epicsol.org/help/levelctl?rev=1171738200 text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/levels?rev=1171513201 This is a list of message levels that ignore, flood and lastlog commands use. Level Description CRAP PUBLICS Public messages sent and received from channels. MSGS Private messages sent and received from individual nicks. NOTICES Notices sent and received from channels and nicks. WALLS Received WA… text/html 2006-07-31T23:11:47+00:00 http://www.epicsol.org/help/levelwindow?rev=1154405507 # $EPIC: levelwindow.txt,v 1.3 2006/08/01 04:11:44 sthalik Exp $ $levelwindow(<server refnum> <lastlog level descriptions>) * <server refnum> is, well, a server refnum (reference number) * <lastlog level descriptions> is of the same format as /WINDOW LEVEL * Only windows connected to the specified server are considered * The return value is the window refnum of one of the windows connected to <server refnum> that has one or more of the level descriptions. * To avoid ambiguity, it’… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/license?rev=1152593863 license This command shows you the copyright notices and license information for the software you are using. Please remember that a license is a legal document that unconditionally grants you certain legal rights that you would ordinarily not be entitled to. Please honor the kindness of the granter by following the boundaries of the license. text/html 2006-08-30T14:53:51+00:00 http://www.epicsol.org/help/line?rev=1156967631 # $EPIC: line.txt,v 1.3 2006/08/30 19:53:48 sthalik Exp $ $line(<line> [<window>|-level] [-time] ...) This function retrieves data from the lastlog buffer. * <line> is the number of the line in the lastlog. 1 is the last line. * <window> is the window number of the lastlog buffer. It defaults to the current window. Only the last one specified is used. * If the given line doesn’t exist, the empty string is returned. * Otherwise, the raw text of the line is returned. * If the -… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/links?rev=1156876398 #$EPIC: links.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ links [<glob>] IMPORTANT: See Privacy and Restrictions sections before using this command for important warnings. Show linked servers, and interconnections between them. To list all servers on the network: text/html 2006-07-31T23:07:13+00:00 http://www.epicsol.org/help/list?rev=1154405233 list [<switch> [<arg>] [<switch> [<arg>] ...]] [<channel>] This query asks the server about all of the public channels that exist on the current network. A summary of each channel, including the channel name, the number of users on the channel, and the channel’s topic (if any) will be displayed, one per line. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/listarray?rev=1172803800 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/listen?rev=1156876398 # $EPIC: listen.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $listen() $listen(<port> [family]) * The listen function establishes a passive TCP connection (``server’‘). * The <port> argument is optional and if provided is taken as a number. * If the <port> argument is not a number, the empty string is returned. * If the <port> argument is not zero and less than 1024, the empty string is returned. * The optional family argument can be 4, 6, v4, or v6, and tells the client whethe… text/html 2006-09-01T20:40:31+00:00 http://www.epicsol.org/help/load?rev=1157161231 load [-args] <file> [<file> ...] The load command runs blocks of code from a file. When you start up the client, it loads your ~/.epicrc file (assuming you didn’t use the -q command line option. Each <file> is searched for each of the directories in the colon-separated set load_path variable. <file> can be an absolute pathname, or it can start with a tilde, and the client does tilde expansion. text/html 2007-02-28T21:50:00+00:00 http://www.epicsol.org/help/loadformats?rev=1172721000 text/html 2006-07-31T23:07:13+00:00 http://www.epicsol.org/help/loadinfo?rev=1154405233 # $EPIC: loadinfo.txt,v 1.2 2006/08/01 04:07:08 sthalik Exp $ $loadinfo() * If the loadinfo function is called when the LOAD command is not currently executing, the literal string “-1” is returned. * Otherwise, the loadinfo function returns a three-word list where the first word is the line number in the file being loaded, the second word is the name of the file being loaded, and the third word is “pf” or “std” depending on the loader that was used. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/local.examp?rev=1172803800 text/html 2006-07-31T23:07:13+00:00 http://www.epicsol.org/help/local?rev=1154405233 local <variable name> local <variable name>,<variable name> local <variable name> <value> local -<variable name> local <structure>. local -dump The local command creates local variables (as opposed to global variables). A local variable can be used until the end of the current atomic scope. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/log?rev=1152593863 This is a disambiguation page. Do you mean the log command or the log function or the logctl function? text/html 2006-07-31T23:11:47+00:00 http://www.epicsol.org/help/log10?rev=1154405507 # $EPIC: log10.txt,v 1.3 2006/08/01 04:11:44 sthalik Exp $ $log10(<number>) * Returns the base-10 logarithm of <number> * If the <number> argument is omitted the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM and RANGE means an error occured. text/html 2007-02-14T22:20:01+00:00 http://www.epicsol.org/help/log_command?rev=1171513201 text/html 2006-08-20T17:50:00+00:00 http://www.epicsol.org/help/log_function?rev=1156114200 # $EPIC: log_function.txt,v 1.4 2006/08/20 22:36:18 sthalik Exp $ $log_function|log(<number>) * Returns the natural logarithm of <number>. * If <number> is omitted, the empty string is returned. * As always, the return value is limited to 6 decimal places. * As always, DOM or RANGE means an error occurred. text/html 2006-08-30T14:54:09+00:00 http://www.epicsol.org/help/logctl?rev=1156967649 # $EPIC: logctl.txt,v 1.10 2006/08/30 19:54:06 sthalik Exp $ $logctl(REFNUMS [ACTIVE|INACTIVE|ALL]) $logctl(REFNUM <log-desc>) $logctl(ADD log-desc [target]) $logctl(DELETE log-desc [target]) $logctl(GET <refnum> [ITEM]) $logctl(SET <refnum> [ITEM] [VALUE]) $logctl(MATCH [pattern]) $logctl(PMATCH [pattern]) $logctl(CURRENT) text/html 2006-07-31T23:07:13+00:00 http://www.epicsol.org/help/longtoip?rev=1154405233 # $EPIC: longtoip.txt,v 1.2 2006/08/01 04:07:08 sthalik Exp $ $longtoip(<integer>) * If the <integer> value is omitted the empty string is returned. * The <integer> value is taken to be a 32 bit unsigned integer. * The <integer> value is taken to be in NETWORK ORDER. * The return value is the dotted-quad IP address of <integer> text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/lusers?rev=1152593863 lusers [<server mask> [<remote server>]] LUSERS (shorthand for List USERS) returns summary information about how many users are using the network. It shows how many users are visible and how many are invisible. It may also show how many users are connected to your server, and the maximum number of users who have been connected to your server at any one time. It may also show the maximum number of users connected to the network at any one time. Other information of this sort may be returned. text/html 2007-08-06T16:25:50+00:00 http://www.epicsol.org/help/lval?rev=1186435550 # $EPIC: lval.txt,v 1.1 2007/08/06 21:25:50 jnelson Exp $ An lvalue is the token on the left hand side of an assignment operation. More broadly speaking, an lvalue is a thing that may be assigned to. There are several places where you use an lvalue: text/html 2007-03-04T15:20:00+00:00 http://www.epicsol.org/help/mail?rev=1173043200 text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/man?rev=1154409365 # $EPIC: man.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ load man This script creates a man-like interface to the EPIC help files. It will search all subdirectories for a particular topic. This script was written by Dawid Kuroczko. text/html 2007-02-24T13:20:00+00:00 http://www.epicsol.org/help/mangle_types?rev=1172344800 Mangle types are used by: * /lastlog -mangle * /log mangle * /set mangle_inbound * /set mangle_outbound * The status bar All characters are grouped into one of 9 “types”: Type number Description ASCII characters 0 Normal chars 32-127, 160-255 1 High bit control chars 128-159 … text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/map?rev=1152593863 This is a disambiguation page. Do you mean the map command or the map script? text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/map_command?rev=1154409365 map This displays a hierarchical map of the topology of the current network, drawn from your server’s perspective. The map is vaguely tree-shaped. This command is available on undernet-class servers. text/html 2007-03-04T15:20:00+00:00 http://www.epicsol.org/help/map_script?rev=1173043200 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/mask?rev=1172803800 # $EPIC: mask.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $mask(<type> <address>) This function returns <address> in a wildcard mask according to the type specified by <type>. The mask types are defined in the following table: <type> <address> has a hostname <address> has an ip ------------------------------------------------------------------- 0 *!u@h.d *!u@d.h 1 *!*u@h.d *!*u@d.h 2 *!*@h.d… text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/match?rev=1154409365 # $EPIC: match.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $match(<pattern> <word list>) * If the <pattern> argument is omitted the empty string is returned. * <word list> contains zero or more space separated “extended words” * Each word in <word list> is taken as literal text, and each are matched against <pattern>. * If none of the words in <word list> are matched by <pattern>, then the return value of match is 0 (zero). * Otherwise, the return value is the index of the first… text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/matchitem?rev=1172553600 # $EPIC: matchitem.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $matchitem(<array> <word>) $rmatchitem(<array> <pattern>) These functions are used to search through the given array for the item that best matches the given word or pattern. These functions are analogous to $match() and $rmatch(). Given a word or pattern, they search through the given array’s contents and look for the best match, if any. Basically, the array’s contents behave as if they were the list of words or patterns… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/maxlen?rev=1152593863 # $EPIC: maxlen.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $maxlen(<word list>) * If the <word list> argument is omitted the value 0 is returned. * The return value is the length of the longest word in <word list>. If you want to “line up” a list of words into columns, you need to know how wide your columns should be, and that is determined by the “widest” word. This function will give you that value, so you can compute how wide your columns should be and how many you can f… text/html 2006-08-18T20:20:00+00:00 http://www.epicsol.org/help/me?rev=1155950400 # $EPIC: me.txt,v 1.3 2006/08/19 01:19:53 sthalik Exp $ me <action description> ME lets you perform an action on your current channel. It lets you describe what you’re doing as though someone is watching you, rather than you telling them. To perform an action: text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/mesg?rev=1152593863 # $EPIC: mesg.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ mesg [display the current terminal writability state] mesg yes [make your terminal world-writeable] mesg no [make your terminal not world-writeable] This command simulates the effect of the unix mesg(1) command. When you specify the ‘yes’ flag, other users on your system may write messages directly to your terminal, which will mess up your ircII screen. If you specify the ‘no’ flag, other users will be prohibite… text/html 2007-02-19T20:50:00+00:00 http://www.epicsol.org/help/meta-compat?rev=1171939800 text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/metric_time?rev=1154409365 # $EPIC: metric_time.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $metric_time() The current metric time, represented as: $0 The number of whole days since the epoch $1 The number of (fractional) millidays since the epoch. You can use this when you’re feeling particularly geeky. text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/mid?rev=1154409365 # $EPIC: mid.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $mid(<start> <length> <text>) * If <start> is omitted, this function returns the empty string. * If <length> is omitted, this function returns the empty string. * If <text> is omitted, this function returns the empty string. * If <start> is greater than the number of characters in <text>, this function returns the empty string. * If <length> is zero, this function returns the empty string. * If <length> is negative, this fun… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/midw?rev=1172803800 # $EPIC: midw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $midw(<start> <length> <word list>) * If the <start> argument is omitted the empty string is returned. * If the <length> argument is omitted the empty string is returned. * If the <start> argument is less than 0, the empty string is returned. * If the <length> argument is less than 1, the empty string is returned. * The return value is the first <length> words of the result of removing the first <start> words from <word list>… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/mkdir?rev=1172803800 # $EPIC: mkdir.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $mkdir(<directory> [<directory> ...]) This function adds the following directories to the filesystem, using the mkdir(3) library call. The default permissions are 0777, minus the current umask value. Any number of directories may be created at once. Tilde-expansion is permitted. text/html 2006-08-31T12:20:00+00:00 http://www.epicsol.org/help/mktime?rev=1157044800 # $EPIC: mktime.txt,v 1.2 2006/08/31 16:53:16 sthalik Exp $ $mktime(<year> <month> <day> <hour> <minute> <second> <DST>) This function returns the epoch time basing on specified parameters. Parameter Name Description $0 year Number of years since 1900 $1 month Month, in range of 0-11 $2 day Day of the month, in range of 1-31 $3 hour Hour, in range of 0-23 … text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/mode?rev=1156876398 # $EPIC: mode.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ mode <your nickname|channel> [<+|-><mode> [<mode parameter(s)>]] # Currently I (hop) am renovating the structure of this help file. The # first part of the help file will be a basic description of the purpose # of modes in irc, both to users and to channels. Then a description of # user modes will follow, with each user mode documented and its side # effects explained. Each network will get a section where its deviant # user modes … text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/motd?rev=1152593863 This is a disambiguation page. Do you mean the motd command or the motd script? text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/motd_command?rev=1152593863 motd [<server|nickname>] This queries a server’s Message Of The Day. Each server is supposed to have an MOTD and your server sent you an MOTD when you connected to it. These messages will tell you about the server you are connected to, and any other information the server administrator wants you to know about. text/html 2007-02-19T22:20:00+00:00 http://www.epicsol.org/help/motd_script?rev=1171945200 text/html 2006-08-01T00:16:05+00:00 http://www.epicsol.org/help/msar?rev=1154409365 # $EPIC: msar.txt,v 1.2 2006/08/01 05:15:58 sthalik Exp $ $msar([i][g][r]/[<search>/<replace>/]*<text>) * The arguments are composed of: * zero or more of the options ‘i’, ‘g’, and ‘r’, * a delimiter which can be any character other than ‘i’, ‘g’, or ‘r’, and is customarily a forward-slash, * ZERO OR MORE SETS OF SUBSTITUTIONS: * some text (”<search>”) that may not contain the delimiter to be removed, * a delimiter; the same as (2), * some te… text/html 2006-08-31T21:50:00+00:00 http://www.epicsol.org/help/msg?rev=1157079000 # $EPIC: msg.txt,v 1.5 2006/09/01 02:43:42 sthalik Exp $ msg [-server/]<nickname> <text to send> msg [-server/]<channel> <text to send> msg =<dcc chat peer> <text to send> msg %<process id|process name> <text to send> msg /<command> <command arguments> text/html 2006-08-01T00:18:29+00:00 http://www.epicsol.org/help/mychannels?rev=1154409509 # $EPIC: mychannels.txt,v 1.3 2006/08/01 05:18:26 sthalik Exp $ $mychannels() $mychannels(<server refnum>) $mychannels(#<window refnum>) $mychannels(<window name>) * This function returns a space separated word list of all of the currently active channels on the specified server. Pending channels (those which you have sent off a JOIN but have not received a reply back from the server) are NOT included. * If the argument is a number, then it is taken as a server refnum, and the chan… text/html 2006-08-20T21:51:32+00:00 http://www.epicsol.org/help/myservers?rev=1156128692 # $EPIC: myservers.txt,v 1.3 2006/08/21 02:51:28 sthalik Exp $ $myservers() $myservers(<anything>) * If provided with no arguments, this function returns a space separated list of server names of all servers that epic has a connection open to. For registered connections (you’ve gotten the 001 numeric), the name will be “its” name (the server’s own name as used in the 001 numeric). For pending connections (you’ve not gotten the 001 numeric yet), the name will be “our” name (t… text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/names?rev=1184106000 names [<switch> [<arg>] [<switch> [<arg>] ...]] [<channel>] NAMES is similar to LIST except it will show nicknames in addition to channel names. Only visible users on public channels are returned. If a nickname is prefixed with a +, that means they are a channel voice (mode +v) on that channel. If a nickname is prefixed with @, that means they are a channel operator (mode +o) on that channel. text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/nametoip?rev=1154410382 # $EPIC: nametoip.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $iptoname(<ip address>) $nametoip(<hostname>) These functions are used to convert an IP address to a hostname, and vice versa. The $iptoname() function returns the hostname associated with the given IP address, and $nametoip() does the opposite. text/html 2007-02-21T23:20:00+00:00 http://www.epicsol.org/help/netsplit?rev=1172121600 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/new_user?rev=1156876398 New user information about IRC This file is for users new to irc. Its intention is to briefly describe what irc is all about. It is not a command summary. Please refer to Introduction to get started with the various EPIC commands. IRC stands for Internet Relay Chat. It is a networked, real-time, online chat system. Its popularity has grown enormously since its invention more than 7 years ago, and shows no signs of stopping anytime soon. There are currently upwards of 30 irc “networks”… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/newaway?rev=1156876398 # $EPIC: newaway.txt,v 1.3 2006/08/29 18:33:16 sthalik Exp $ load newaway This script does essentially the same thing that set SHOW_AWAY_ONCE once did. It suppresses the on 301 server numeric if the same one is received more than once. It will display changes in AWAY messages. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/newnick?rev=1172553600 text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/nick?rev=1154410382 # $EPIC: nick.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ nick [<new nickname>] The NICK command allows you to change your nickname. If you try to change to a nickname that someone else is using, you will get an error message to that effect and your nickname will be unchanged. Nicknames are CASE-INSENSITIVE. text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/nickcomp?rev=1172553600 text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/nochops?rev=1154410382 # $EPIC: nochops.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $nochops(<channel>) * If the <channel> argument is omitted, the current window’s current channel is used. THIS IS NOT NECCESARILY THE CORRECT CHANNEL IN AN /ON! * If the <channel> argument is the literal star character (``*’‘), the current window’s current channel is used. THIS IS NOT NECCESARILY THE CORRECT CHANNEL IN AN /ON! * This function returns the non-channel-operators on the specified channel. * You must be… text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/nohighlight?rev=1154410382 # $EPIC: nohighlight.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $nohighlight(<string>) This function returns <string> with all highlight characters escaped. All ^B, ^V, ^_, ^O, ^C, and ^[ characters will be replaced by an inverse of their control character, to remove all highlighting. text/html 2006-10-06T14:20:00+00:00 http://www.epicsol.org/help/nopaste?rev=1160162400 # $EPIC: nopaste.txt,v 1.2 2006/10/06 19:08:28 jnelson Exp $ load nopaste set nopaste ON set nopaste OFF This script adds the set NOPASTE variable. When you set it on, it keeps you from flooding your current target by (accidentally) pasting text to your client screen. When you set it off, this protection is disabled. The default value is OFF. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/note?rev=1152593863 # $EPIC: note.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ note <command> [+|-<flags>] [<arguments>] The NOTE command is a historic irc server command (meaning this help file really belongs in section 3). You would be hard pressed to find a server that supports the NOTE command. As of mid-2001, only the undernet servers even come with the NOTE system, and it isn’t turned on by default, and it isn’t even a configuration-time option. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/notice?rev=1156876398 notice <nickname> <text to send> notice <channel> <text to send> notice =<dcc chat peer> <text to send> notice %<process id|process name> <text to send> notice /<command> <command arguments> The NOTICE command is just like the MSG command, and is used to send a message to another target. Whenever you use msg in response to an irc privmsg (a msg, or a ctcp request), it will be converted into a notice for you. text/html 2006-08-01T00:37:01+00:00 http://www.epicsol.org/help/notify?rev=1154410621 This is a disambiguation page. Do you mean the notify command, the notify function, or the notify script? text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/notify_command?rev=1154410382 # $EPIC: notify_command.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ notify notify - notify +]<nickname> [[+]<nickname> ... notify -]<nickname> [[-]<nickname> ... You will want to know when your irc friends enter and leave irc. You can manage a list of nicknames with the /NOTIFY command, and when any of those nicknames join or leave your network, or when anyone changes to or from one of the nicknames, you will be informed. text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/notify_function?rev=1154410382 # $EPIC: notify_function.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $notify([on|off serv <server number>]) This function provides an interface to the client’s internal NOTIFY list. If no arguments are passed, a list of all nicknames on the list is returned. If the ON command is used, only those nicknames that are currently present on the given server are shows; if the OFF command is used, those not on irc are shown. text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/notify_script?rev=1154410382 # $EPIC: notify_script.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ load notify This is a scripted notify system, much like EPIC’s internal notify system, with the ability to manage both global and local notify lists. Alias Description /nlist shows nicknames in all notify lists /notify manages local and global notify lists The syntax for managing notify lists is similar to that of EPIC’s internal /notify. To modify a list, supply a li… text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/notifywindows?rev=1154410382 # $EPIC: notifywindows.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $notifywindows() * This function returns a space-separated list of window refnums that meet the following criteria: * The window must have /window notify ON * The window must be hidden * The window must have received output since it was hidden * If no windows meet this criteria, the empty string is returned. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/notw?rev=1172803800 # $EPIC: notw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $notw(<number> <word list>) * If the <number> argument is omitted the empty string is returned. * If the <number> argument is negative, <word list> is returned. * The return value of this function is <word list> with the <number>th word omitted, counting from zero. * Extra spaces surrounding the <number>th word will be removed. * Historically <word list> does not support double-quoted words. This may change in the future. Tr… text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/numarrays?rev=1154410382 # $EPIC: numarrays.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $numarrays() This function shows the total number of arrays created by $setitem(). It takes no arguments, and ignores any passed to it. This function is used to show how many arrays currently exist. This might be useful if the arrays were named in a sequential order, thus allowing you to know what the next available number is. text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/numitems?rev=1154410382 # $EPIC: numitems.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $numitems(<array>) This function is used to show how many items are currently defined in the given array. This function shows how many items are in an array. This is quite useful, because the number it returns is the next available item number in the array. text/html 2006-08-01T00:37:01+00:00 http://www.epicsol.org/help/numlines?rev=1154410621 # $EPIC: numlines.txt,v 1.3 2006/08/01 05:36:58 sthalik Exp $ $numlines(<columns> <string>) This function tells you the number of lines that the given string would occupy after final display in a window with a width of <columns>. This function can be used to determine how many lines a particular string will occupy in particular window. One thing this could be used for is scripting a file pager that will correctly pause between each screen of output, regardless of long lines and SET CONTINUED… text/html 2006-08-18T21:04:44+00:00 http://www.epicsol.org/help/numonchannel?rev=1155953084 # $EPIC: numonchannel.txt,v 1.3 2006/08/19 02:04:37 sthalik Exp $ $numonchannel(<channel>) * If the <channel> argument is omitted the current window’s current channel is assumed. THIS MAY NOT NECCESARILY BE THE CORRECT CHANNEL IN AN /ON! * If the <channel> argument is the literal asterisk, (``*’‘), then the current window’s current channel is assumed. THIS MAY NOT NECCESARILY BE THE CORRECT CHANNEL IN AN /ON! * This function returns the number of members of the given channel… text/html 2006-07-16T23:00:00+00:00 http://www.epicsol.org/help/numsort?rev=1153108800 # $EPIC: numsort.txt,v 1.2 2006/07/17 03:42:24 jnelson Exp $ $numsort(<list>) This function sorts the word list <list> in ascending numerical order. The numbers in <list> must be integral values, not decimal numbers. Non-numeric words are sorted in ascii order between 0 and 1. Numbers embedded within words in <list> are properly recognized. text/html 2006-08-01T00:33:02+00:00 http://www.epicsol.org/help/numwords?rev=1154410382 # $EPIC: numwords.txt,v 1.2 2006/08/01 05:32:26 sthalik Exp $ $numwords(<word list>) This function serves as a replacement for the $#var notation when you want to count the words in a string not held in a variable. This function is used to count the number of words in an arbitrary string. Normally, you could get this value with the $#var form, but that doesn’t work for parameter expandos or function return values. text/html 2007-10-13T12:09:50+00:00 http://www.epicsol.org/help/on?rev=1192295390 # $EPIC: on.txt,v 1.7 2006/08/30 18:34:50 sthalik Exp $ This file is currently being overhauled, so it’s a mess. on [#][<modes>]<event-type> [<serial#>] [-|^]<match> [{ <action> }] ircII-EPIC is an event-driven programming language. What this means is that your script does not cause things to happen, but rather waits for things to happen (”events”) and then reacts to them. Each time an event occurs, EPIC executes any event handlers you have registered for the event. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_action?rev=1172946000 # $EPIC: on_action.txt,v 1.3 2006/08/19 02:04:37 sthalik Exp $ on action This hook is triggered whenever the client observes a CTCP ACTION. It will hook when the recipient is either the user or a channel. $0 nickname of the ACTION sender $1 target of the ACTION (user’s nickname or a channel) $2- message body of the ACTION To distinguish personal actions from those sent to a channel: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_channel_lost?rev=1172946000 # $EPIC: on_channel_lost.txt,v 1.3 2007/03/03 17:58:33 jnelson Exp $ on [<modes>]channel_lost [<serial#>] [-|^]<match> { <action> } This event is thrown whenever your membership in a channel ends for any reason whatsoever. The most common causes of losing your channel membership are part, kick, disconnect, and being disconnected by the server. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_channel_nick?rev=1172946000 on channel_nick A channel_nick event is thrown each time someone (including you) on one of your channels changes nickname. If the nick changer is on multiple channels with you, multiple events are thrown. The default action of the channel_nick event is to throw an on nickname event. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_channel_signoff?rev=1172946000 on [<modes>]channel_signoff [<serial#>] [-|^]<match> { <action> } The channel_signoff event is thrown every time someone on one of your channels quits irc. If the person is on multiple channels with you, multiple events are thrown. The default action for channel_signoff is to throw a SIGNOFF event. This event is not thrown when you quit irc, the event for that is exit. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_channel_sync?rev=1172946000 # $EPIC: on_channel_sync.txt,v 1.2 2006/08/19 01:57:03 sthalik Exp $ on [<modes>]channel_sync [<serial#>] [-|^]<match> { <action> } This event is thrown after all of the cached information about a channel has been collected. When this event is thrown, it is safe to ask about who is on the channel, chanop status, userhost, and so forth. Before this event is thrown, there are no promises! text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_connect?rev=1172946000 # $EPIC: on_connect.txt,v 1.3 2006/08/19 02:04:37 sthalik Exp $ on [<modes>]connect [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client has successfully registered with an irc server. This hook differs from on server_established in that the on server_established hook is triggered as soon as the client establishes a TCP connection with a server. text/html 2007-10-08T11:28:32+00:00 http://www.epicsol.org/help/on_ctcp?rev=1191860912 on [<modes>]ctcp [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a CTCP message, whether directly or one sent to a channel it is on. $0 nickname of CTCP message sender $1 target of CTCP (client’s nickname or channel name) $2 type of CTCP $3- arguments to CTCP command, if any To customize the normal CTCP message: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_ctcp_reply?rev=1172946000 # $EPIC: on_ctcp_reply.txt,v 1.3 2006/08/19 02:04:37 sthalik Exp $ on [<modes>]ctcp_reply [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a CTCP reply from another client. Note that the client doesn’t necessarily need to send any CTCP messages to receive a “reply”. text/html 2007-10-08T11:28:32+00:00 http://www.epicsol.org/help/on_ctcp_request?rev=1191860912 on ctcp_request This hook is triggered whenever the client receives a CTCP request sent to you personally or one of the channels you are on. Using the CTCP command within this on causes a properly formatted reply to be sent. Because this on is hooked as the result of a PRIVMSG, you cannot send a PRIVMSG in reply to this on, only NOTICEs. If you use the CTCP command, it will send a ctcp reply. If you use the MSG command it will be sent as a NOTICE. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_activity?rev=1172946000 # $EPIC: on_dcc_activity.txt,v 1.2 2006/08/19 01:57:03 sthalik Exp $ on [<modes>]dcc_activity [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client updates the %D status expando, which holds metadata about the last open DCC transaction that had activity. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_chat?rev=1172946000 on [<modes>]dcc_chat [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a message across a DCC CHAT connection. $0 nickname of the message sender $1- message received DCC falls outside of the irc protocol, and as such there are no restrictions on automated replies. This creates the potential for uncontrolled looping, so caution is advised. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_connect?rev=1172946000 on [<modes>]dcc_connect [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client successfully establishes a DCC connection with another client. Currently, this is either a CHAT or a SEND connection. $0 nickname of remote client $1 type of DCC connection $2 ip address of remote client $3 port on the ip address the client is connected to $4 file name (SEND only) $5 file size (SEND only) To customize the connection message: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_list?rev=1172946000 on [<modes>]dcc_list [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a /dcc or /dcc list command is issued. The ‘banner’ of the list can be determined when $0 is “Start”, and the end of the list is determined when $0 is “end”. text/html 2007-05-19T20:20:00+00:00 http://www.epicsol.org/help/on_dcc_lost?rev=1179624000 #$EPIC: on_dcc_lost.txt,v 1.2 2006/08/19 01:57:03 sthalik Exp $ on [<modes>]dcc_lost [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a DCC CHAT or SEND connection ends whether or not the connection was successful or not. $0 nickname of the dcc connection $1- disconnection message (varies) To indicate that dcc connection was terminated: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_offer?rev=1172946000 on [<modes>]dcc_offer [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client offers an outbound DCC. This could be either a DCC CHAT or a file transfer. $0 person who is being offered the DCC $1 type of DCC being offered $2 filename being offered (if type of DCC is ‘SEND’) $3- size of file being offered (if type of DCC is ‘SEND’) To alert user of bad DCC’s: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_raw?rev=1172946000 on [<modes>]dcc_raw [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a raw message about a tcp connection established, or a connection attempt, with $connect(). Raw messages are sent across established tcp connections with DCC RAW. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_dcc_request?rev=1172946000 on [<modes>]dcc_request [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a DCC request of some sort (currently CHAT or SEND). $0 nickname of remote client$1 type of DCC connection$2 description of dcc connection (currently same as $1)$3 ip address of remote client$4 port on the ip address the client is connected to$5 file name (SEND only)$6 file size (SEND only) To customize the dcc request message: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_disconnect?rev=1172946000 on [<modes>]disconnect [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client is disconnected from a server, and it is unable to reconnect to the server itself (assuming the AUTO_RECONNECT setting is turned on). This would be any situation in which the client would normally print the following message: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_encrypted_notice?rev=1172946000 on encrypted_notice This event is generated when someone sends you an encrypted notice (that contains a ctcp sed), As with all notice hooks, you cannot send a msg or notice to a person over irc from within this hook. The default action of this event is to throw a general_notice event. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_encrypted_privmsg?rev=1172946000 on [<modes>]encrypted_privmsg [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a MSG encrypted with CTCP SED. This is how the ENCRYPT command normally works. $0 nickname of message sender $1 target of message (the sender or channel) $2- message received To clearly distinguish encrypted MSGs from unencrypted ones: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_error?rev=1172946000 on [<modes>]error [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a server sends the client an ERROR message. $0 server who sent the message (your server) $1- the text of the error message text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_exec?rev=1172946000 on [<modes>]exec [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever an EXECed process generates output to standard output. $0 the exec name or refnum that triggered the hook. $1- a line of the process’s stdout To distinguish process output from other window output: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_exec_errors?rev=1172946000 on [<modes>]exec_errors [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever an EXECed process produces output to standard error. $0 process number or name of the EXECed process $1- a line of the process’s output to stderr To distinguish process errors from other window output: text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_exec_exit?rev=1172946000 on [<modes>]exec_exit [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever an EXECed process finishes, either because it exits, it is killed by a signal, or you asked the client to disown it. This hook is always thrown, no matter what the value of set notify_on_termination is. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_exec_prompt?rev=1172946000 on [<modes>]exec_prompt [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever an EXECed process displays a “prompt”. More precisely, it is triggered when the process returns any line of output that is not terminated by a newline. This is generally the case with interactive commands, such as nslookup(1). text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_exit?rev=1172946000 on [<modes>]exit [<serial#>] [-|^]<match> { <action> } This hook is triggered when the client is about to exit normally (from the QUIT command, etc.). It is mostly useful for doing cleanup before exiting, such as saving any current settings. It cannot be used to trap the QUIT command; the client will exit immediately after this hook is triggered.. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_flood?rev=1172946000 on [<modes>]flood [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client’s internal flood detection code is activated. The client is “flooded” when it receives a large number of messages (of any sort) in a relatively short period of time. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_general_notice?rev=1172946000 # $EPIC: on_general_notice.txt,v 1.3 2006/08/19 02:17:54 sthalik Exp $ on [<modes>]general_notice [<serial#>] [-|^]<match> { <action> } A general_notice event is thrown whenever you receive a NOTICE. The default action for general_notice is to throw one of the encrypted_notice, notice, oper_notice, public_notice, or server_notice events, as the case may be. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_general_privmsg?rev=1172946000 #$EPIC: on_general_privmsg.txt,v 1.2 2006/08/19 02:15:40 sthalik Exp $ on [<modes>]general_privmsg [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a PRIVMSG from another client. $0 nickname of message sender $1 target of PRIVMSG $2- text of message If this hook is used in silent mode, the corresponding MSG, MSG_GROUP, PUBLIC, and PUBLIC_OTHER hooks will not be thrown. text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_hook?rev=1172946000 on [<modes>]hook [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the HOOK command is issued with the appropriate arguments. Its sole purpose is to be hooked by HOOK. It is useful for avoiding alias recursion. $* text to hook text/html 2007-03-03T12:20:00+00:00 http://www.epicsol.org/help/on_idle?rev=1172946000 on [<modes>]idle [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client’s idle time reaches the given value, in minutes. The idle time is reset when the client is given a command. $0 minutes idle To automatically set the client away after being idle for 5 minutes: text/html 2006-08-18T21:15:46+00:00 http://www.epicsol.org/help/on_input?rev=1155953746 on [<modes>]input [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a command is entered on the input line, or when text is sent to a channel or query. This is a very powerful mechanism of the client. Used intelligently, it permits a very fine degree of control over the text entered on the input line. Used carelessly, and it can easily disable the client. Use with caution. text/html 2006-08-18T21:15:46+00:00 http://www.epicsol.org/help/on_invite?rev=1155953746 on [<modes>]invite [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives an invitation to a channel. $0 nickname inviting the client to a channel $1 channel invited to Customizing the appearance of the invitation: text/html 2006-08-18T21:15:46+00:00 http://www.epicsol.org/help/on_join?rev=1155953746 on [<modes>]join [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client joins a channel, or whenever it observes another client joining a common channel. $0 nickname of person joining channel $1 channel joined $2 address of person joining channel (same as $userhost()) $3 person joining’s channel status (on avalon 2.9 servers), could be either (+o) or (+v) To distinguish between the client and other users joining the channel: text/html 2006-08-31T07:53:19+00:00 http://www.epicsol.org/help/on_keybinding?rev=1157028799 on [<modes>]keybinding [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a keybinding is activated. $0 The keybinding that’s activated $1 Length of the sequence (future expansion - currently 0) $2 ASCII number of the key that’s activated it text/html 2006-08-18T21:15:46+00:00 http://www.epicsol.org/help/on_kick?rev=1155953746 on [<modes>]kick [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client observes another client (or itself!) being kicked from a channel. $0 nickname of user kicked from channel $1 nickname of user kicking $0 from channel $2 channel kick observed on $3- kick message To distinguish who is being kicked on a channel: text/html 2006-08-18T21:15:46+00:00 http://www.epicsol.org/help/on_kill?rev=1155953746 on [<modes>]kill [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever someone is kill(3)ed by an oper. $0 server who sent the message (your server) $1 the victim being killed $2 the oper who issued the kill $3 server path to the oper $4- reason for the kill To display kills in a more sane manner: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_list?rev=1155954999 on [<modes>]list [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives server output from the LIST command. Any individual line of output can trigger the hook. $0 channel name $1 number of users on the channel $2- channel topic (if any) To limit output to channels with a topic: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_mail?rev=1155954999 on [<modes>]mail [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client detects that the user has new email locally. It relies on MAIL being non-zero. $0 number of new email messages $1 total number of email messages in user’s mailbox To keep the new mail message grammatically correct: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_mode?rev=1155954999 on [<modes>]mode [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client observes a mode change on a channel, or whenever the client changes its modes. $0 nickname of person issuing mode change $1 channel or nickname affected by mode change $2 modes changed $3- arguments to modes (if any) To distinguish between user modes and channel modes: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_mode_stripped?rev=1155954999 on [#][<mode>]mode_stripped [<serial#>] [-|^]<match> { <action> } This hook is similar to the MODE hook, except it only hooks a single mode change at a time. This hook relies on MODE_STRIPPER being turned on. It is mostly useful in scripts that wish to evaluate each individual mode change. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_msg?rev=1155954999 # $Id: on_msg.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]msg [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a MSG from another client. $0 nickname of message sender $1- text of message The client does not permit automated responses to a MSG with another MSG. Such replies may use NOTICE instead. Any attempt to use MSG within this hook will be automatically converted to a NOTICE. The whole point of this is to prevent loops between… text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_msg_group?rev=1155954999 on [<modes>]msg_group [<serial#>] [-|^]<match> { <action> } This hook is similar to the MSG hook, except it applies to messages sent to an undetermined group of people. Typically, this is a server mask or hostmask, and is sent by an irc operator. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_names?rev=1155954999 on [<modes>]names [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives server output from the NAMES command. $0 channel name $1- nicknames of (visible) users on the channel This hook is not triggered by the implicit NAMES done when the client joins a channel. Hook the 353 numeric instead. text/html 2006-08-18T21:42:42+00:00 http://www.epicsol.org/help/on_new_nickname?rev=1155955362 # $EPIC: on_new_nickname.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $ on [<modes>]new_nickname [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever your current nickname is no longer acceptable and a new one must be created. It is expected that you would use the NICK command in the <action> of this hook. If you do not hook this, the client chooses a new one for you. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_nickname?rev=1155954999 on [<modes>]nickname [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client observes a nickname change. It only hooks once per nick change, not once per channel. $0 old nickname$1 new nickname To distinguish the client from another user: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_note?rev=1155954999 on [<modes>]note [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a NOTE. $0 nickname of message sender $1 time the message was send (accurate +/- 60 seconds) $2- text of message To customize the display of irc NOTEs: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_notice?rev=1155954999 # $Id: on_notice.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]notice [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a NOTICE from another client. This hook will not be thrown if a matching ON GENERAL_NOTICE hook is being used in silent mode. ON GENERAL_NOTICE and on NOTICE are mutually exclusive. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_notify_signoff?rev=1155954999 on [<modes>]notify_signoff [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client detects that a nickname on its internal NOTIFY list has signed off from irc. $0 nickname that signoff was detected for text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/on_notify_signon?rev=1156876398 on [<modes>]notify_signon [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client detects that a nickname on its internal NOTIFY list has signed on to irc. $0 nickname that signon was detected for $1 user@host of person signing on (if set(4) notify_userhost_automatic is ON) text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/on_numeric?rev=1171347600 on [<modes>]on_numeric [<serial#>] [-|^]<match> { <action> } This on is triggered for every numeric that don’t have a more specific /on <number> hook. $0 Numeric being thrown $1 The server which sent the message $2 The message text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_odd_server_stuff?rev=1155954999 on [<modes>]odd_server_stuff [<serial#>] [-|^]<match> { <action> } This is easily the most flexible hook available in the client. It allows any arbitrary string to be hooked from the server’s raw output. It is useful for overriding the client’s default behavior when it otherwise wouldn’t permit it, or for hooking information when the available named hooks won’t do. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_oper_notice?rev=1155954999 on [<modes>]oper_notice [<serial#>] [-|^]<match> { <action> } This is triggered whenever a global oper notice is received. $0 server the notice came from $1- body of the message To alert the user of global oper notices: text/html 2006-08-31T08:33:30+00:00 http://www.epicsol.org/help/on_operwall?rev=1157031210 on [<modes>]operwall [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives an OPERWALL event, used by EFNet servers. If you don’t hook this and happen to receive an OPERWALL event, it will be triggered as /on wallops. text/html 2006-08-25T23:03:56+00:00 http://www.epicsol.org/help/on_part?rev=1156565036 # $EPIC: on_part.txt,v 1.1 2006/08/26 04:03:56 sthalik Exp $ on [<modes>]part [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a client (the user’s or any other) is observed leaving a channel (but not signing off from irc). text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_pong?rev=1155954999 on [<modes>]pong [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a protocol PONG message. Under normal circumstances, the sender will be a server. However, clients are also allowed to send PONG messages to each other. Since there is never any reason for a client to send a PONG to another client, this hook can be useful for blocking PONG floods. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_public?rev=1155954999 on [<modes>]public [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a regular public message is sent to the client’s current channel by someone else also on the channel. $0 nickname sending message $1 channel sent to $2- text of message text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_public_msg?rev=1155954999 on [<mode>]public_msg [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a public message in a channel from someone not actually in the channel. $0 nickname sending message $1 channel sent to $2- text of message To customize how these messages are displayed: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_public_notice?rev=1155954999 # $EPIC: on_public_notice.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]public_notice [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a NOTICE is sent to any channel the client is on from someone not actually on that channel. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_public_other?rev=1155954999 on [<modes>]public_other [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client observes a message sent to any channel it is on that isn’t its current channel, from someone else on that channel. $0 nickname sending message$1 channel sent to$2- text of message text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_raw_irc?rev=1155954999 on [<modes>]raw_irc [<serial#>] [-|^]<match> { <action> } This is easily the most flexible hook available in the client. It allows any arbitrary string to be hooked from the server’s raw output. It is useful for overriding the client’s default behavior when it otherwise wouldn’t permit it, or for hooking information when the available named hooks won’t do. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_redirect?rev=1155954999 on [<modes>]redirect [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever something is redirected. $0 Target to which the text is about to be sent$1- The actual text to be sent text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_action?rev=1155954999 # $EPIC: on_send_action.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]send_action [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a CTCP ACTION to a channel or to another person. $0 target of the ACTION (nickname or channel)$1- text of message sent To display separate messages for public and private actions: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_ctcp?rev=1155954999 on [<modes>]send_ctcp [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a CTCP request or reply to another client. $0 “PRIVMSG” for requests, “NOTICE” for replies$1 nick the CTCP is being sent to$2 type of CTCP being sent$3- optional arguments to the CTCP being sent To show the user when a CTCP request is sent: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_dcc_chat?rev=1155954999 on [<modes>]send_dcc_chat [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a message to another client across a DCC CHAT connection. $0 nickname of recipient of message sent$1- text of message sent text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_msg?rev=1155954999 on [<modes>]send_msg [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a MSG to another user. It is only triggered when sending messages to individual clients, not to channels. $0 nickname message is sent to$1- text of message sent text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_notice?rev=1155954999 on [<modes>]send_notice [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a NOTICE message to a channel or another client. $0 nickname or channel the NOTICE is sent to$1- text of message sent text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_public?rev=1155954999 on [<modes>]send_public [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client sends a regular, public message to any channel it is on. $0 the channel the message is sent to$1- text of message sent text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_send_to_server?rev=1155954999 on [<modes>]send_to_server [<serial#>] [-|^]<match> { <action> } This hook, when set, is triggered whenever the client sends data to the server that matches the hook. It is useful for catching raw messages destined for the server and redefining them. One such use is with DCC, as it offers no convenient way to send a raw request. By using the silent mode, the default action (sending data to the server) is suppressed, allowing any arbitrary command to be replaced. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_server_established?rev=1155954999 # $EPIC: on_server_established.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]server_established [<serial#>] [-|^]<match> { <action> } This hook is triggered as soon as a TCP connection to a server is established. This hook differs from “connect” hook in that the “connect” hook isn’t triggered until the 003 server line is received. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_server_lost?rev=1155954999 on [<modes>]server_lost [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client is disconnected from any server for any reason. $0 server refnum$1 server name$2- reason for disconnect. usually the same as your QUIT(1) message text/html 2006-08-18T21:42:42+00:00 http://www.epicsol.org/help/on_server_notice?rev=1155955362 # $EPIC: on_server_notice.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $ on [<modes>]server_notice [<serial#>] [-|^]<match> { <action> } This event is thrown any time any server sends you a NOTICE. Because remote servers can send you notices, and because it’s not possible to know all of the server names on a network, it is assumed if the sender has a dot (”.”) in their name, it’s a servername, and if there isn’t, then it is a normal irc nickname. If you’re on a network that has a ser… text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/on_server_status?rev=1171378200 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/on_set?rev=1156876398 on [<modes>]set [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a /set is issued. $0 name of variable to be set. will be “set-error” if an invalid SET variable was specified $1- value the variable will be set to. will be “No such variable “FOO”“, where FOO is the invalid SET variable if $0 is “set-error” To make sure set security stays on: text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_signoff?rev=1155954999 on [<modes>]signoff [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client observes another client on a common channel signing off from irc. It only hooks once per user, not once per channel. $0 nickname of person signing off$1- signoff message This hook is only triggered for other users. To hook your own signoff, use the EXIT hook. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_silence?rev=1155954999 on [<modes>]silence [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a reply from the server from a SILENCE command. $0 a ‘+’ if a pattern was added, ‘-’ if one was removed$1 the pattern silenced (or unsilenced) text/html 2006-08-18T21:42:42+00:00 http://www.epicsol.org/help/on_ssl_server_cert?rev=1155955362 # $EPIC: on_ssl_server_cert.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $ on [<modes>]ssl_server_cert [<serial#>] [-|^]<match> { <action> } This hook is triggered after SSL negotation with an irc server has successfully completed. $0 The file descriptor for the server [NOT THE SERVER REFNUM]$1 The certificate subject, passed through $urlencode(). Use $urldecode($1) to recover the cert subject. $2 The certificate issuer, passed through $urlencode() Use $urldecode($2) to recover the cert issuer.… text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_status_update?rev=1155954999 on [<modes>]status_update [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the status bar of a visible window in dumb mode is updated. $0 Refnum of the window whose status bar was updated$1 Which status bar has changed, 0 or 1$2- The actual status bar that has been updated text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_switch_channels?rev=1155954999 # $EPIC: on_switch_channels.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]switch_channels [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the current channel is switched. $0 reference number of the window in which the switch occurred$1 channel you were talking to$2 channel you are now talking to text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_switch_windows?rev=1155954999 on [<modes>]switch_windows [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client changes what it thinks your “current” window is in any given context. $0 the old screen number$1 the old window number$2 the new screen number$3 the new window number Note that the window might change through forces other than the window keybindings. You can get a pretty good idea when this happens, though, because $0 and $2 will be different. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_timer?rev=1155954999 on [#][<mode>]timer [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the specified time (or time glob pattern) matches the current time. The time may be in one of two formats: Format Description hh:mm<am|pm> 0 <= hh <= 12, 0 <= mm <= 59, am or pm set accordingly hh:mm 0 <= hh <= 23, 0 <= mm <= 59 $0 current time (format depends on CLOCK_24HOUR setting) To inform the user of the… text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_topic?rev=1155954999 on [<modes>]topic [<serial#>] [-|^]<match> { <action> } This hook is triggered when the topic is changed on any channel the client is on. $0 nickname of person changing topic$1 channel topic was changed on$2- new topic text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/on_unknown_command?rev=1171347600 text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_unload?rev=1155954999 on [<modes>]unload [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the unload(5) command is issued to unload a packaged script. $* the parameters passed to the /package command (NOTE that passing more than one argument to /package may cause future incompatibilities, and should be avoided at all costs) text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_wall?rev=1155954999 on [#][<mode>]wall [<serial#>] [-|^]<match> { <action> } This hook used to be triggered whenever the client received a WALL message. WALL is no longer in use on any known irc network, and this hook is but a relic of days long gone. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_wallop?rev=1155954999 on [<modes>]wallop [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever the client receives a WALLOPS message (a message sent to all irc operators). $0 nickname of the message sender$1 a ‘*’ if the sender is an operator, ‘S’ if the sender is a server$2- text of message text/html 2006-08-18T21:44:24+00:00 http://www.epicsol.org/help/on_who?rev=1155955464 on [#][<mode>]who [<serial#>] [-|^]<match> { <action> } This hook is triggered when the client receives server output from the WHO command. Each line received can trigger the hook. $0 channel the user is on, of ‘*’ if none or if it is private$1 nickname of user$2 status of user: <G|H>[*][@|+] ‘G’ for gone (away), ‘H’ for here (not away), ‘*’ for irc operator, ‘@’ for channel operator, ‘+’ for voice status $3 username portion of user’s address$4 hostname portion of … text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_window?rev=1155954999 on [<modes>]window [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever output to any window matches any existing WINDOW hook. Extreme care should be taken when using this hook to redefine messages, as an ECHO command inside it will also be hooked by it. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_window_beforekill?rev=1155954999 on [<modes>]window_beforekill [<serial#>] [-|^]<match> { <action> } This hook is triggered just before a window is killed. It is permissible to query any data you want about the window, but it is NOT PERMISSIBLE to try to change anything about the window, particularly its visibility. If you try to change the window, you may crash the client. Use /DEFER to be on the safe side. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_window_command?rev=1155954999 # $EPIC: on_window_command.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]window_command [<serial#>] [-|^]<match> { <action> } This hook is triggered each time a /WINDOW command is executed, to inform you of any changes to the current operative window. This can be useful if you need to prep a window before commands are executed on it. text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_window_create?rev=1155954999 on [<modes>]window_create [<serial#>] [-|^]<match> { <action> } This hook is triggered whenever a new window is created. This enables defaults to be given to each window. $0 reference number of created window /* doubles the status bar for each new window */ on -window_create "*" { window double on } text/html 2006-08-18T21:36:39+00:00 http://www.epicsol.org/help/on_window_kill?rev=1155954999 # $EPIC: on_window_kill.txt,v 1.2 2006/08/19 02:36:28 sthalik Exp $ on [<modes>]window_kill [<serial#>] [-|^]<match> { <action> } This hook is triggered after a window has been killed. By the time that this is triggered, the window has been irrevocably destroyed, and cannot be used. You can use this hook to clean up after your own data that may be keyed on the window’s refnum. text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/on_window_server?rev=1171347600 # $EPIC: on_window_server.txt,v 1.2 2007/02/13 06:05:45 jnelson Exp $ on [<modes>]window_server [<serial#>] [-|^]<match> { <action> } This hook is triggered each time a window changes its server association for any reason whatsoever. The server refnum -2 is special, and it means the window has disconnected; it is no longer associated with any server. text/html 2006-08-18T21:42:42+00:00 http://www.epicsol.org/help/on_yell?rev=1155955362 on [<modes>]yell [<serial#>] [-|^]<match> { <action> } This is hooked by fairly useless but necessary in beta yell()s. They are present in the client for debugging purposes, and scripters may not want them to appear. ON ^yell will suppress their output. text/html 2006-08-18T22:35:14+00:00 http://www.epicsol.org/help/onchannel?rev=1155958514 # $EPIC: onchannel.txt,v 1.4 2006/08/19 03:35:12 sthalik Exp $ $onchannel() (First Action) $onchannel(<channel>) (First Action) $onchannel(<nick> <channel>) (Second Action) * There are two different actions provided by this function. The first action is to provide a list of nicknames that are on a channel. The section action is to tell you whether a particular person is on a particular channel. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/open?rev=1172803800 # $EPIC: open.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $open(<file> R|W) This functions allows the client to open an arbitrary file for reading or writing. Write mode appends to the file. The function returns a file descriptor for the open file; the file descriptor is an integer. Tilde- expansion is permitted. text/html 2006-08-18T22:33:02+00:00 http://www.epicsol.org/help/oper?rev=1155958382 oper [<nick> [<password>]] The OPER command is used to gain irc operator status on the current server, with the stipulation that the specified (or current) nickname and password match an O: line entry in the server’s configuration. If a password is not specified, the client will prompt for one. text/html 2007-05-19T16:12:56+00:00 http://www.epicsol.org/help/output-help?rev=1179609176 # $EPIC: output-help.txt,v 1.1 2007/05/19 21:12:56 jnelson Exp $ This help file discusses various problems you might have with getting output to work properly, and how to fix them. About terminal emulators A terminal emulator is the computer program that handles input and output between you, the user, and a login shell (on a unix system). text/html 2006-08-18T22:36:46+00:00 http://www.epicsol.org/help/outputinfo?rev=1155958606 # $EPIC: outputinfo.txt,v 1.4 2006/08/19 03:36:44 sthalik Exp $ $outputinfo() * This function does not take any arguments; they are ignored. * The return value is the current output display context * The current output display context is the mechanism by which the program figures out what window output should go to. * Throughout the entire client, the tuple (server refnum, lastlog level) can map to only one window (but perhaps not to any window). * The current output display context… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/package?rev=1156876398 package <name> The PACKAGE command allows a script to “group” all of the assigns, aliases, binds, ON hooks (and stubs) under a common package name. When the PACKAGE command is used, any alias/assigns/on that are registered until the end of the file are given the current package name. The package name can be changed anywhere in a script, even if PACKAGE had been previously used. However, packages only last until the end of the file, they never propagate upwards. Scripts that are loaded by ot… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/pad?rev=1172803800 # $EPIC: pad.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ $pad(<width> <char> <text>) * If the <width> argument is omitted the empty string is returned. * If the <char> argument is omitted the empty string is returned. * The <width> argument may be positive or negative. * Although the <char> argument can be a string, only the first character is actually used. * If the absolute value of <width> is less than the length of <text>, then <text> is returned. * The number of “neccesary … text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/parsekey?rev=1155959901 parsekey <key function> This command allows direct access to the functions normally bound to special keys via the BIND command. It is useful for using rarely- used key functions that are not bound to a particular key. Any of the functions that may be bound to a key may be used. text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/part?rev=1155959901 # $EPIC: part.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ part <channel>|* [<part message>] When you wish to leave a channel, you “PART” it. After you have parted a channel you are no longer a member of that channel, you are no longer a channel operator or a channel voice, and you will no longer receive any messages sent to the channel. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/pass?rev=1172803800 # $EPIC: pass.txt,v 1.3 2006/08/19 04:05:34 sthalik Exp $ $strip(<chars> <text>) $pass(<chars> <text>) * If the <chars> argument is omitted the empty string is returned. * If the <text> argument is omitted the empty string is returned. * The return value for $strip() is a copy of <text> from which every instance of any character in <chars> has been removed. * The return value for $pass() is a copy of <text> from which every instance of any character not in <chars> has been removed. text/html 2007-02-19T20:50:00+00:00 http://www.epicsol.org/help/paste?rev=1171939800 text/html 2007-05-14T20:50:00+00:00 http://www.epicsol.org/help/pattern?rev=1179193800 # $EPIC: pattern.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ $pattern(<pattern> <word list>) * If the <pattern> argument is omitted the empty string is returned. * This function returns a space separated word list of all of the words in <word list> that are matched by <pattern>. * This is the complement to $filter(), and the inverse of $rpattern(). * Double quoted words are honored, but the double quotes will be lost in the return value. text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/patterns?rev=1155959901 Pattern Matching Literally, any string is a pattern. In general, though, a pattern is a string intended to match, or be matched by, one or more other strings. The pattern will usually contain one or more wildcards, but it doesn’t need to. The following wildcard characters are supported: text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/pause?rev=1155959901 # $EPIC: pause.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ pause <seconds> PAUSE performs a nonblocking sleep for <seconds> seconds. During the nonblocking sleep, the client performs all actions as normal, except that PAUSE will not return until <seconds> seconds have elapsed. Because things might have occurred during the nonblocking sleep, it not guaranteed that everything is as it was when the PAUSE started. Servers may have closed, the input line may have changed, dccs may have finished… text/html 2006-07-16T12:30:59+00:00 http://www.epicsol.org/help/perl?rev=1153071059 This is a disambiguation page. Do you mean the perl command or the perl function? text/html 2006-07-28T00:00:00+00:00 http://www.epicsol.org/help/perl_command?rev=1154062800 #$EPIC: perl_command.txt,v 1.3 2006/07/28 04:14:52 jnelson Exp $ perl {perl statement} If EPIC was linked with an embedded perl interpreter, the perl statement shall be executed by perl. If EPIC was not linked against perl, then no action shall take place. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/perl_function?rev=1156876398 # $EPIC: perl_function.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $perl(perl statement) If EPIC was linked with an embedded perl interpreter, the perl statement shall be executed by perl. If EPIC was not linked against perl, then no action shall take place. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/perlcall?rev=1172803800 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/perlxcall?rev=1172803800 # $EPIC: perlxcall.txt,v 1.4 2006/08/29 18:33:16 sthalik Exp $ $perlcall(<subroutine> [<text>]) $perlxcall(<subroutine> [<array-in> [<array-out> [<index> [<text>]]]]) These functions call a given subroutine in the embedded perl interpreter and return the subroutines return value. text/html 2007-05-14T20:50:00+00:00 http://www.epicsol.org/help/pf_loader?rev=1179193800 load -pf <file> [<file> ...] The pf loader (”pf” stands for “pre-formatted”) reads in a text file that contains one big block of code and executes it. All of the scripts that come with epic5 are in pf-format. It is expected that most, if not all script packs that work with epic5 will be in pf-format. You should switch, because it’s much less painful for you this way. text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/pid?rev=1155959901 # $EPIC: pid.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ $pid() * This function ignores its arguments * This function returns the current process id of EPIC. If you wanted to send a signal to your epic client, then you would need its process id. text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/ping?rev=1155959901 # $EPIC: ping.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ ping <nickname> ping <channel> Lag is a way of life on irc. “Lag” is determined by how much time it takes a message to get from the sender to the recipient. The more lag, the longer it takes for someone to get your messages. Sometimes you want to see just how long it will take for a message to get to someone else and back. The PING command sends someone a specially crafted message asking them to send the message back. When you… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/pipe?rev=1152593863 This is a disambiguation page. Do you mean the pipe function or the pipe script? text/html 2006-08-18T22:58:21+00:00 http://www.epicsol.org/help/pipe_function?rev=1155959901 # $EPIC: pipe_function.txt,v 1.2 2006/08/19 03:58:07 sthalik Exp $ $pipe(<program>) This function executes <program> and returns its output. It is defined in the pipe(8) script. It’s an easy way to grab the output of a program quickly. <program>’s output text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/pipe_script?rev=1156876398 # $EPIC: pipe_script.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ load pipe This script implements the pipe(6) function to capture output from an /exec‘d command and return in a function. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/pop?rev=1152593863 This is a disambiguation page. Do you mean the pop command or the pop function? text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/pop_command?rev=1156876398 # $EPIC: pop_command.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ pop <variable name> The pop command removes the final word from the value of <variable name>. DOUBLE QUOTED WORDS ARE NOT SUPPORTED (yet). If the value of <variable name> contains only one word, then the variable is unset. text/html 2007-02-17T12:50:00+00:00 http://www.epicsol.org/help/pop_function?rev=1171738200 # $EPIC: pop_function.txt,v 1.4 2006/08/29 18:33:16 sthalik Exp $ $pop(<variable name>) $pop(<word list>) * If no arguments are provided, the empty string is returned. * If the argument consists of only one word, it is taken as <variable name>. * If more than one arguments are provided, they are taken as <word list>. * If a <word list> is provided, the return value is the last word in <word list>. DOUBLE QUOTED WORDS ARE NOT SUPPORTED. (This may change in the future.) * If <vari… text/html 2006-08-29T16:20:00+00:00 http://www.epicsol.org/help/ppid?rev=1156886400 # $EPIC: ppid.txt,v 1.2 2006/08/29 21:02:33 jnelson Exp $ $ppid() This function ignores its argument and returns the parent process id as returned by the ppid(2) system call. If you wanted to send a signal to the shell that ran your epic client, then you would need its process id. text/html 2006-08-18T23:05:38+00:00 http://www.epicsol.org/help/prefix?rev=1155960338 # $EPIC: prefix.txt,v 1.4 2006/08/19 04:05:34 sthalik Exp $ $prefix(<word list>) * If the <word list> argument is omitted the empty string is returned. * The return value of this function is whatever string is the common initial substring (CIS) of all of the words in <word list>. If there is no CIS in <word list>, the empty string is returned. * This function uses an O(M*N) algorithm where M is the number of words in <word list> and N is the length of the first word in <word list>. Tak… text/html 2006-08-18T23:05:38+00:00 http://www.epicsol.org/help/pretend?rev=1155960338 # $EPIC: pretend.txt,v 1.3 2006/08/19 04:05:34 sthalik Exp $ pretend <arguments> The PRETEND command allows the client to “pretend” it received the given arguments from the server. It is intended only to be used inside a hook action. One possible use for this might be a highly customized scripted DCC system. It is mostly only of use with on RAW_IRC. text/html 2006-08-18T23:05:38+00:00 http://www.epicsol.org/help/printlen?rev=1155960338 # $EPIC: printlen.txt,v 1.3 2006/08/19 04:05:34 sthalik Exp $ $printlen(<text>) * The return value is the number of printable characters in <text>. * ANSI escape sequences will be counted as printable characters by this function! Convert <text> via $stripcrap(ANSI <text>) first if you suspect it may contain ansi escape sequences. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/programming?rev=1156876398 This short (very short) document describes EPIC’s programming language (some would argue it’s but a scripting language) and how to use it. The first thing to remember about scripts is that command characters are not required for commands! In fact, their use is discouraged, as it only makes more work for the client when parsing the command. There is, of course, an exception to this rule (but only one). Because the client allows commands to be overloaded by aliases, there needs to be a way… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/push?rev=1152593863 This is a disambiguation page. Do you mean the push command or the push function? text/html 2007-03-23T11:50:00+00:00 http://www.epicsol.org/help/push_command?rev=1174668600 push <variable name> <word> pop <variable name> PUSH appends the given word (or words) to the given variable, padded with a single space. The variable name itself may not contain a leading ‘$’; the command uses the variable itself, not the expanded contents. If the variable does not exist, it is created containing the given word(s) (just as if ASSIGN were used). text/html 2007-03-23T11:50:00+00:00 http://www.epicsol.org/help/push_function?rev=1174668600 # $EPIC: push_function.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $push(<variable name> <data>) * If the <variable name> argument is omitted the empty string is returned. * <variable name> should be the name of an ASSIGN variable. * If the rvalue of <variable name> is the empty string, then the rvalue of <variable name> is set to <data>. * Otherwise, the rvalue of <variable name> is set to the present value of <variable name> plus a space, plus <data>. * The new rvalue of <variable… text/html 2006-08-18T23:08:30+00:00 http://www.epicsol.org/help/query?rev=1155960510 # $EPIC: query.txt,v 1.2 2006/08/19 04:08:24 sthalik Exp $ query query <nickname> query <channel> query =<dcc chat peer> query %<process id|process name> query /<command> The QUERY command is exactly the same as WINDOW QUERY. See the help file for WINDOW QUERY(4) for details. text/html 2006-08-20T22:05:18+00:00 http://www.epicsol.org/help/querywin?rev=1156129518 # $EPIC: querywin.txt,v 1.3 2006/08/21 03:05:12 sthalik Exp $ $querywin(<target>) $querywin(<target> <server refnum>) This function returns the window owning the query target <target>, or “-1” if there are no queries for <target>. An optional server refnum argument may be specified in order to obtain the query window for a target on a particular server. text/html 2006-08-18T23:08:30+00:00 http://www.epicsol.org/help/queue?rev=1155960510 # $EPIC: queue.txt,v 1.2 2006/08/19 04:08:24 sthalik Exp $ queue [<flag>] <name> [<number>] [<commands>] QUEUE allows for a sort of batch processing in ircII-EPIC. It is a convenient mechanism for preparing to execute a command at a later, undetermined time. It can also be used as a sort of dynamically growing alias. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/quit?rev=1156876398 # $EPIC: quit.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $ quit [<quit message>] When you are all done with talking, you can use the QUIT command to exit from IRC and go back to your shell. * All of your dcc connections are terminated * Your quit message is created, either <quit message> or set quit_message. * on exit is thrown. * TCL, Perl, and Ruby finalizers (if any) are run. * You are disconnected from every server using your quit message. * All of your logfiles are closed… text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/quote?rev=1152593863 quote <rfc1459-statement> The quote command behaves the same as xquote without any options. To send a PRIVMSG to foo: quote PRIVMSG foo :text of message text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/quoting_hell?rev=1184106000 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/qword?rev=1172803800 # $EPIC: qword.txt,v 1.3 2007/03/02 02:32:04 jnelson Exp $ $qword(<index> <list>) * If the <index> argument is omitted, the empty string is returned. * If the <list> argument is omitted, the empty string is returned. * The <index> argument is taken as an integer number. * If <index> is a negative number, the empty string is returned. * The return value is the <index>th word in <list>, counting from zero. * Remember that <list> is always a list of words. * In either case, if the … text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rand?rev=1155967649 # $EPIC: rand.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rand(<maximum>) * If <maximum> is omitted, this function returns the empty string. * Otherwise, a “random number” that fits in an “unsigned long” on your machine is created: * If <maximum> is zero, the “random number” is returned as is. * Otherwise, the return value is “as if” you had done the following: ${rand(0) % <maximum>} text/html 2007-02-17T12:33:43+00:00 http://www.epicsol.org/help/random_numbers?rev=1171737223 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/randread?rev=1172803800 # $EPIC: randread.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $randread(<filename>) This function reads a random line from the specified <filename>. This function has many novelty uses: random messages for /quit, /kick, /part, or /topic. The empty string is returned on error (the file does not exist, the file is empty, or the file cannot be read). Otherwise, a random line from the file is returned. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/rbind?rev=1152593863 rbind <bind function> The rbind command shows you all of the key sequences that are bound to the <bind function>. This is useful if you know what <bind function> you want to use but you don’t know what is bound to it. # $EPIC: rbind.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ text/html 2007-06-04T23:20:00+00:00 http://www.epicsol.org/help/read?rev=1181017200 # $EPIC: read.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $read(<fd> [<length>]) This function is used to read data from a file pointed to by the given file descriptor. The file descriptor is returned when the file is opened for reading with the $open() function. If a second argument is passed, that many bytes are read and returned; otherwise, it reads up to the next newline. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/realpath?rev=1152593863 # $EPIC: realpath.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $realpath(<filepath>) * If the <filepath> argument is omitted the empty string is returned. * If the operating system does not have the realpath(3) function call, the <filepath> argument is returned. * All directories, if any, in <filepath> must exist; if any of them do not exist the empty string is returned. * The return function is the full absolute path of <filepath> with all symbolic links, `.’, `..’ and extra �… text/html 2006-09-01T18:28:37+00:00 http://www.epicsol.org/help/reconnect?rev=1157153317 This is a disambiguation page. Do you mean the reconnect command or the reconnect script? text/html 2007-02-13T00:20:00+00:00 http://www.epicsol.org/help/reconnect_command?rev=1171347600 # $EPIC: reconnect_command.txt,v 1.2 2006/09/19 10:52:37 sthalik Exp $ reconnect [<reason>] The reconnect command does a disconnect of the current server immediately followed by a server +refnum. The effect of this is your connection to the server is abandoned and then immediately restarted. text/html 2007-02-28T21:50:00+00:00 http://www.epicsol.org/help/reconnect_script?rev=1172721000 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/redirect?rev=1156876398 # $EPIC: redirect.txt,v 1.4 2006/08/29 18:33:16 sthalik Exp $ redirect <nick>|*|<channel>|%<process>|=<nick> <command> Redirect sends a copy of all of the output sent to any windows connected to the current server to any place you can send a MSG to (ie, an irc nickname, a channel, an EXEC process, a DCC CHAT, etc) The first argument is a MSG list and it can contain any number of targets and it’s formatted like like a MSG would be. REDIRECTing to the special target 0 (zero) acts as a sink an… text/html 2006-09-01T19:37:24+00:00 http://www.epicsol.org/help/referring_to_servers?rev=1157157444 # $EPIC: referring_to_servers.txt,v 1.1 2006/09/02 00:37:24 jnelson Exp $ A server has several pieces of data that identify it Refnum A small positive integer number Our Name The hostname you provided in the server description Its Name The name the server refers to itself as on irc Group The (local) group name you put the server into Alt names Any alternate name you have given the server There are many places you provide a “server” to the client. … text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regcomp?rev=1171378200 text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regcomp_cs?rev=1171378200 text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regerror?rev=1171378200 text/html 2007-02-17T13:20:00+00:00 http://www.epicsol.org/help/regex?rev=1171740000 # $EPIC: regex.txt,v 1.4 2006/08/19 06:21:24 sthalik Exp $ $regcomp(<regex pattern>) $regexec(<compiled pattern> <string>) $regmatches(<compiled pattern> <matches> <string>) $regerror(<compiled pattern>) $regfree(<compiled pattern>) These functions are an interface to “regular expression” pattern matching: text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regexec?rev=1171378200 text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regfree?rev=1171378200 text/html 2007-02-13T08:50:00+00:00 http://www.epicsol.org/help/regmatches?rev=1171378200 text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rehash?rev=1155967649 #$EPIC: rehash.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ rehash [command] This command is used to force the current server to reload its ircd.conf configuration file. This is useful for effecting configuration changes without starting a new server. A command can be given on some servers which extends rehash to other configuration files and other functionality. text/html 2007-07-10T17:20:00+00:00 http://www.epicsol.org/help/remw?rev=1184106000 # $EPIC: remw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $remw(<word> <word list>) * If the <word> argument is omitted this function returns the empty string. * The return value of this function is <word list> with the first occurrence of the literal word <word> removed. * One space surrounding <word> is removed; additional spaces will remain. * Historically <word list> does not support double-quoted words. This may change in the future. Try using /xdebug extractw. * <word> and <w… text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/remws?rev=1155967649 # $EPIC: remws.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $remws(<lwords> / <rwords>) * The first literal slash character found in the input acts as the separator between <lwords> and <rwords>. This means that <lwords> must not contain any slashes, but <rwords> may. If you do not put in a slash somewhere, the empty string is returned. * Any extra spaces between words in <rwords> will be removed. * The return value of this function will be all words in <rwords> that are NOT also in <l… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/rename?rev=1172803800 #$EPIC: rename.txt,v 1.3 2006/08/19 06:19:30 sthalik Exp $ $rename(<oldpath> <newpath>) * If the <oldpath> or <newpath> arguments are omitted this function returns the empty string. * The file <oldpath> is renamed to <newpath> in accordance with the rename(2) system call on your operating system. * Generally speaking $rename() cannot move files between file systems, but they can be moved between directories on the same file system. text/html 2007-02-28T11:50:00+00:00 http://www.epicsol.org/help/renumber?rev=1172685000 text/html 2006-07-31T22:15:12+00:00 http://www.epicsol.org/help/repeat?rev=1154402112 This is a disambiguation page. Do you mean the repeat command or the repeat function? text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/repeat_command?rev=1155967649 #$EPIC: repeat_command.txt,v 1.4 2006/08/19 06:07:20 sthalik Exp $ repeat (<count>) <command> repeat <count> <command> This command repeatedly executes <command> <count> number of times. If <count> is enclosed in parenthesis, it is evaluated as a mathematical expression (ala ${...}), and if it is not, it is evaluated as regular text. text/html 2006-07-10T23:57:43+00:00 http://www.epicsol.org/help/repeat_function?rev=1152593863 # $EPIC: repeat_function.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $repeat(<count> <text>) This function returns a string composed of the input text concatenated to itself the specified number of times. This function has many potential uses. For example, it would be used to format output from a script such that it is always the width of the current window. This has the side bonus of removing the need to hard- code formatting devices (table headers and such), which tend to look rather… text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rest?rev=1155967649 # $EPIC: rest.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rest(<text>) $rest(<num> <text>) * If the <num> argument is not provided, 1 is the default value. * The return value is <text> with the first <num>th characters removed. * If you think that the first word in <text> may be a number, better to be safe than sorry; specify an explicit “1” for <num>. text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/restart?rev=1155967649 restart This command is used to completely restart the server. A side effect of this is that the configuration file will be read again. However, it is generally more useful for clearing out internal buffers and other wasted memory. This command is limited to irc operators on the server to be RESTARTed. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/restw?rev=1172803800 # $EPIC: restw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $restw(<count> <word list>) * If the <count> argument is omitted the empty string is returned. * This function returns the complement of $leftw(); that is, * This function returns <word list> with the first <count> words removed. * Historically <word list> does not support double-quoted words. This may change in the future. Try using /xdebug extractw. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/return?rev=1156876398 return return <arguments> Return terminates processing of the current * alias (command or function) call, * defer command, * exec callback, * load, * on hook callback, * queue command, * timer command, * wait -cmd callback, * wait %proc -cmd callback, or * {...} math operator. text/html 2007-02-19T22:20:00+00:00 http://www.epicsol.org/help/revdcc?rev=1171945200 text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/reverse?rev=1155967649 # $EPIC: reverse.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $reverse(<text>) * This function returns a copy of <text> with all of the characters in reverse order, to wit: * Let the characters in <text> be numbered from 0 to <L>: Index in <word list> Index in return value 0 <L> 1 <L-1> 2 <L-2> ... ... <L-2> 2 … text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/revw?rev=1155967649 # $EPIC: revw.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $revw(<word list>) * This function returns a copy of <word list> with all of the words in reverse order, to wit: * Let the words in <word list> be numbered from 0 to <L>: Index in <word list> Index in return value 0 <L> 1 <L-1> 2 <L-2> ... ... … text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rfilter?rev=1155967649 # $EPIC: rfilter.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rfilter(<word> <pattern list>) * If the <word> argument is omitted the empty string is returned. * This function returns a space separated pattern list of all of the patterns in <pattern list> that DO NOT match <word>. * This is the complement to $rpattern(), and the inverse of $filter(). * Double quoted words are honored, but the double quotes will be lost in the return value. text/html 2006-08-19T01:22:02+00:00 http://www.epicsol.org/help/right?rev=1155968522 # $EPIC: right.txt,v 1.4 2006/08/19 06:21:24 sthalik Exp $ $right(<count> <text>) * If <count> is omitted, this function returns the empty string. * If <text> is omitted, this function returns the empty string. * If <count> is less than 0, this function returns the empty string. * If <text> is more than <count> characters long, then this function will return a copy of the last <count> characters in <text>. * If <text> is less than or exactly <count> characters long, then this functi… text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/rightw?rev=1172803800 # $EPIC: rightw.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ $rightw(<count> <word list>) * If the <count> argument is omitted the empty string is returned. * If the <count> argument is less than 1, the empty string is returned. * This function returns the last <count> words from <word list>. * Historically <word list> does not support double-quoted words. This may change in the future. Try using /xdebug extractw. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/rindex?rev=1172803800 # $EPIC: rindex.txt,v 1.1.1.1 2006/07/11 04:57:43 jnelson Exp $ $rindex(<characters> <text>) * If the <characters> argument is omitted the empty string is returned. * <characters> may contain any number of different characters. If you want to include the space character, enclose it in double quotes. If you want to include the double quote character, put some other character before the double-quote. * If the first character in <characters> is the caret (”^”), then the list of <char… text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/rmatch?rev=1156876398 # $EPIC: rmatch.txt,v 1.5 2006/08/29 18:22:56 sthalik Exp $ $rmatch(<word> <pattern list>) * If the <word> argument is omitted the empty string is returned. * <pattern list> contains zero or more space separated “extended words” * Each pattern in <pattern list> is taken as a wildcard pattern, which is matched against <word>, which is taken as literal text. * If none of the patterns in <pattern list> match <word>, then the return value of $rmatch() is 0 (zero). * Otherwise, the r… text/html 2007-02-26T23:20:00+00:00 http://www.epicsol.org/help/rmatchitem?rev=1172553600 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/rmdir?rev=1172803800 # $EPIC: rmdir.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rmdir(<directory> [<directory> ...]) This function unlinks the specified directories from the filesystem. As with the normal shell mechanism, the directory must be empty before it can be removed. Tilde-expansion is permitted. text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rpattern?rev=1155967649 # $EPIC: rpattern.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rpattern(<word> <pattern list>) * If the <word> argument is omitted the empty string is returned. * This function returns a space separated pattern list of all of the patterns in <pattern list> that match <word>. * This is the complement to $rfilter(), and the inverse of $pattern(). * Double quoted words are honored, but the double quotes will be lost in the return value. text/html 2006-08-19T01:07:29+00:00 http://www.epicsol.org/help/rping?rev=1155967649 rping <server> This command works like the PING command (CTCP PING), except it is used on a server instead of a client. As with PING, it is used to test the relative distance another server is from you across the irc network. This command is limited to irc operators. Additionally, it is limited to the Undernet, and servers using recent ircu server code. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/rsubstr?rev=1172803800 # $EPIC: rsubstr.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ $rsubstr(<substring> <search string>) This function searches for <substring> from the end of <search string> and returns the $index() to it. They can be used to search for specific things in output from a server, or as an alternative to $match(*substring* searchstring). text/html 2006-07-28T00:00:00+00:00 http://www.epicsol.org/help/ruby?rev=1154062800 This is a disambiguation page. Do you mean the ruby command or the ruby function? text/html 2007-02-19T22:20:00+00:00 http://www.epicsol.org/help/ruby_command?rev=1171945200 #$EPIC: ruby_command.txt,v 1.2 2006/08/19 06:07:20 sthalik Exp $ ruby {ruby statement} If EPIC was linked with an embedded ruby interpreter, the ruby statement shall be executed by ruby. If EPIC was not linked against ruby, then no action shall take place. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/ruby_function?rev=1156876398 # $EPIC: ruby_function.txt,v 1.2 2006/08/29 18:22:56 sthalik Exp $ $ruby(ruby statement) If EPIC was linked with an embedded ruby interpreter, the ruby statement shall be executed by ruby. If EPIC was not linked against ruby, then no action shall take place. text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/sar?rev=1155979560 # $EPIC: sar.txt,v 1.2 2006/08/19 09:25:52 sthalik Exp $ $sar([i][g][r]/<search>/<replace>/<text>) The arguments are composed of: * zero or more of the options ‘i’, ‘g’, and ‘r’, * a delimiter which can be any character other than ‘i’, ‘g’, or ‘r’, and is customarily a forward-slash, * some text (”<search>”) that may not contain the delimiter to be removed, * a delimiter; the same as (2), * some text (”<replace>”) that may not contain the delimiter t… text/html 2007-02-17T12:50:00+00:00 http://www.epicsol.org/help/save?rev=1171738200 text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/say?rev=1156876398 # $EPIC: say.txt,v 1.3 2006/08/29 18:22:56 sthalik Exp $ say <text> This command sends a message to the current window’s current channel. This is useful when you want to send a message to the current channel of a window that has a QUERY active. text/html 2007-02-21T23:20:00+00:00 http://www.epicsol.org/help/scan?rev=1172121600 text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/screen?rev=1155979560 # $EPIC: screen.txt,v 1.2 2006/08/19 09:25:52 sthalik Exp $ load screen This script allows ircII windows to be manipulated muck like with the screen program. It creates a number of key bindings: Key Function ^X1 ... ^X0 swap windows 1 to 10. ^Xa goes to the last window.. ^Xc , ^X^C creates a new window … text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/security?rev=1155979560 EPIC is an extremely flexible client. To borrow a phrase from many a C programmer, it gives you enough rope to hang yourself. With caution and some common sense, this isn’t a problem. By far, the most potentially dangerous facility is ON. Because hooks can be set to activate on any arbitrary input, and because they can perform most any action when activated, they are often used for malicious purposes. Consider the following: text/html 2006-08-19T04:35:47+00:00 http://www.epicsol.org/help/sedcrypt?rev=1155980147 # $EPIC: sedcrypt.txt,v 1.2 2006/08/19 09:35:40 sthalik Exp $ $sedcrypt(<flag> <from> <text>) This is a debugging function. It should not be used unless you are debugging. They encrypt and decrypt <text> using the current crypt settings for the peer <from>. Ciphertext is always CTCP enquoted. That does not mean it is /echo‘able, only tha it can be sent in a PRIVMSG. text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/send?rev=1155979560 send <text> This command provides a convenient mechanism for scripts, aliases, key bindings, etc. to send a line of text to the current channel or query. It is also useful for chatting while COMMAND_MODE is off. Other than the ability to send a message to a query, SEND is identical to SAY. text/html 2006-10-01T19:20:00+00:00 http://www.epicsol.org/help/sendline?rev=1159748400 sendline <text> The sendline command submits <text> to the command processor without any further $-expansion (as contrasted with eval) If <text> begins with a slash (”/”), then <text> is taken to be a command. If <text> does not begin with a slash, then <text> is taken to be a message that should be sent to the current window’s current target. text/html 2006-08-19T04:35:47+00:00 http://www.epicsol.org/help/serial_numbers?rev=1155980147 One of the neat things about ON hooks is that multiple hooks of the same type may be given different priorities. A serial number may be any number, positive or negative; zero is the default and should not be used directly. The numbers themselves don’t really matter, rather their relation to other serial numbers is what’s important. For example: text/html 2006-10-05T19:38:34+00:00 http://www.epicsol.org/help/server?rev=1160095114 # $EPIC: server.txt,v 1.5 2006/09/02 00:38:26 jnelson Exp $ server server [<server description>|<server refnum>] server [+|-][<server name>] server [-add] <server description> [see below] server [-delete <server refnum>] The nexus of irc is the server, also known as “ircd”, which comes in different classes, such as “irc2.8”, “irc2.9”, “EFNext”, “ircu2.8” “ircu2.9”, “hybrid5”, “hybrid6”, “hybrid7”, “dreamforge”, “bahamut”, and a huge l… text/html 2006-11-23T11:20:00+00:00 http://www.epicsol.org/help/server_description?rev=1164302400 # $EPIC: server_description.txt,v 1.2 2006/09/19 03:17:58 jnelson Exp $ A server description is the way you give the client enough information about an irc server for it to be added to the server list and used. Any place you are supposed to provide a “server”, you can provide either a server refnum, or the server description. text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/server_list?rev=1155979560 There are several ways to set a predefined list of servers for EPIC to use. In general, though, they all use the same basic format: server:port:password:nickname The server is the name of the server to connect to. The port is the port number on the server’s host to connect on. The password is only required for servers that require one to connect. The nickname is the nick to use once connected to the server. Only the server name is required. The remaining parameters may be specified as … text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/server_numerics?rev=1155979560 In addition to the numerous named hooks provided by the client (refer to the ON command in Section 5), EPIC can hook any numeric reply sent by a server. They are treated no differently from named hooks. Space constraints prevent a full discussion of all server numerics, not to mention that they tend to differ from network to network. text/html 2006-09-19T06:20:00+00:00 http://www.epicsol.org/help/server_state?rev=1158664800 # $EPIC: server_state.txt,v 1.5 2006/09/19 10:52:37 sthalik Exp $ Each server in your server list has a state that it is in. The valid states are: Name Description CREATED The initial state while it is being added to the server list RECONNECT Ready to be used: will be connected to when window points at it DNS Server being brought up: Nonblocking DNS lookup in progress CONNECTING Server being brought up: Nonblocking connect in progress SSL_CONNECTING Server being br… text/html 2007-05-14T20:50:00+00:00 http://www.epicsol.org/help/serverctl?rev=1179193800 # $EPIC: serverctl.txt,v 1.8 2006/09/01 23:29:58 jnelson Exp $ $serverctl(REFNUM <server refnum>) $serverctl(REFNUM <name>) $serverctl(REFNUM <name>:<port>) $serverctl(OMATCH <pattern>) $serverctl(IMATCH <pattern>) $serverctl(GMATCH <pattern>) $serverctl(LAST_SERVER) $serverctl(FROM_SERVER) $serverctl(MAX) $serverctl(GET <refnum> <param>) $serverctl(SET <refnum> <param> <val>) text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/serverwin?rev=1155979560 # $EPIC: serverwin.txt,v 1.2 2006/08/19 09:25:52 sthalik Exp $ $serverwin() $serverwin(<server refnum>) * If the <server refnum> argument is omitted, the current server’s refnum is taken as the default value. * If <server refnum> is not a valid server refnum, -1 is returned. * If there are no windows connected to the server (which should never happen, but hey, you never know), -1 is returned. * Otherwise, the refnum of the last window to recieve the input focus that is connected t… text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/servlist?rev=1155979560 # $EPIC: servlist.txt,v 1.2 2006/08/19 09:25:52 sthalik Exp $ servlist [<name> [<type>]] This query asks the server for the list of services that are available to you right now. You use the squery command to talk to the service. Usually a network server will be used to perform some administrative task for the network, such as a channel service, a nickname service, or a note service. text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/servports?rev=1155979560 # $EPIC: servports.txt,v 1.2 2006/08/19 09:25:52 sthalik Exp $ $servports(<server name/refnum>) This function returns the remote and local port assignments for the connection to the specified server. the remote and local port assignments for the specified server connection, separated by a space text/html 2007-03-07T21:20:00+00:00 http://www.epicsol.org/help/set?rev=1173324000 set [<variable> [<value>]] set [-]<variable> This command is used to set the value of one of EPIC’s numerous internal variables. These variables affect all aspects of the client’s behavior, from enabling special text highlighting to enforcing strict security features. text/html 2006-08-19T04:26:00+00:00 http://www.epicsol.org/help/set_allow_c1_chars?rev=1155979560 # $EPIC: set_allow_c1_chars.txt,v 1.3 2006/08/19 09:25:52 sthalik Exp $ set allow_c1_chars [on|off|toggle] When ON: Characters from 128 to 159 (inclusive) are permitted to be sent to your display. This can be really bad if you’re using GNU Screen or a terminal that doesn’t understand 8 bit characters. When OFF: Characters from 128 to 159 (inclusive) are always stripped and not sent to your display. This can be bad if your font uses characters in that range to represent characters that … text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_always_split_biggest?rev=1155982633 set always_split_biggest [on|off|toggle] When you use window new or window show to split the screen into multiple windows, one of the windows on the screen has to be split in half to make room for the new window. This value controls which window is selected to be split. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_banner?rev=1155982633 set banner <text> Changes the default “***” in front of informational messages. The banner is used internally for “say” messages, and by xecho -b. You will want to set banner_expand to ON if the banner contains expandos that need to be expanded each time. text/html 2006-08-19T05:22:26+00:00 http://www.epicsol.org/help/set_banner_expand?rev=1155982946 set banner_expand [on|off|toggle] If ON: The value of set banner is run through expando-substution every time it is used. If OFF: The value of set banner is taken as a literal string. This is useful if you like to display the current time ($Z) in your banner. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_beep?rev=1155982633 set beep [on|off|toggle] When turned off, this suppresses any audible beeps the client may try to use. Any ^G processed by the client will be printed as a ^VG^V. This setting will override the BEEP_ON_MSG and BEEP_WHEN_AWAY settings, and will effectively disable the BEEP command. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_channel_name_width?rev=1155982633 set channel_name_width [<number>] This variable sets the maximum width a channel’s name may use on the client’s status bar. If set to 0 (zero), there is no limit on the length of the channel’s name. This variable also affects the default display of LIST and NAMES output. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_client_information?rev=1155982633 set client_information [<text>] The contents of this variable are appended to the client’s default CTCP VERSION reply. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_clock?rev=1155982633 set clock [on|off|toggle] When turned on, the system clock runs and updates every minute. This is reflected in the STATUS_CLOCK status bar expando, and $Z. If you turn the clock off, STATUS_CLOCK shows nothing. It is a BAD IDEA to turn the clock off if you use $Z. If you don’t want to see the clock in your status bar, take %T out of your STATUS_FORMAT. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/set_clock_24hour?rev=1156876398 set clock_24hour [on|off|toggle] When turned on, this setting causes EPIC’s clock to display time in 24-hour format. When off, EPIC displays time in 12-hour format, using “AM” and “PM”. The EPIC clock is shown in the status bar by the %T expando, and is available to scripts in the $Z special variable. text/html 2006-10-01T18:03:57+00:00 http://www.epicsol.org/help/set_clock_format?rev=1159743837 set clock_format <text> The client uses strftime(3) to create the system clock (%T on your status bar or $Z. The value is normally “%R” if set clock_24hour is ON and “%I:%M%p” if it is OFF. You can overrule set clock_24hour and choose your own strftime(3) format with this variable. If you unset this variable, then the appropriate value based on set clock_24hour is used. text/html 2006-08-19T05:22:26+00:00 http://www.epicsol.org/help/set_clock_interval?rev=1155982946 set clock_interval [<seconds>] This setting controls how often the client’s status bar clock gets updated. The default value is 60 (at the top of every minute). Previously, this value was not configurable and the client would just update the clock (and $T inline expando, /ON TIMER, and /ON IDLE) at the top of every minute. For some people, this was not nearly often enough. Now you can control exactly how often the clock is updated with this /SET. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_cmdchars?rev=1155982633 set cmdchars [<characters>] This variable sets all characters that may be used as a command character on the input line. Any number of characters may be specified, and the slash ‘/’ will always be assumed. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_comment_hack?rev=1155982633 set comment_hack [on|off|toggle] This variable determines how the client will handle C-style comments in loaded scripts. When turned on, it causes the client to only recognize such comments when they start at the beginning of a line. When off, the comments may begin anywhere. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_continued_line?rev=1155982633 set continued_line [<text>] The text in this variable, if any, will be prepended to any lines printed that are wider than the display. This is to provide a visual indicator that the line is part of the previous line, and not a new message. This variable may be set in conjunction with the INDENT variable. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_cpu_saver_after?rev=1155982633 set cpu_saver_after [<minutes>] This triggers CPU Saver mode after <minutes> without a keypress. When CPU Saver is enabled, the status bar isn’t updated and the notify list isn’t checked. If either this value or set(4) cpu_saver_every is 0, CPU Saver mode will not activate. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_cpu_saver_every?rev=1155982633 # $EPIC: set_cpu_saver_every.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set cpu_saver_every [<seconds>] This determines how often the client will update status bar, check the time, and check the notify list if CPU saver mode is active. When CPU Saver is enabled, the status bar isn’t updated and the notify list isn’t checked. If either this value or set cpu_saver_every is 0, CPU Saver mode will not activate. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_current_window_level?rev=1155982633 set current_window_level [<lastlog levels>] This variable takes a lastlog level description (eg. “MSGS,PUBLIC,CRAP”) which defines which levels are redirected to the current window. This means all output with the levels in this variable are *NOT* sent to their regular window, but the current window instead. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dcc_auto_send_rejects?rev=1155982633 # $EPIC: set_dcc_auto_send_rejects.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set dcc_auto_send_rejects [on|off|toggle] This variable controls whether DCC REJECTs will be sent to the remote peer whenever you /DCC CLOSE a dcc connection before it is opened by either you or the other person. This tells the other person that the offer has been revoked and they should not expect to use it. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dcc_dequote_filenames?rev=1155982633 # $EPIC: set_dcc_dequote_filenames.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set dcc_dequote_filenames [on|off|toggle] When ON: Attempt to graciously deal with malformed DCC SEND requests from other clients that enclose filenames in double quotes when there is a space in the filename. You may not be able to recieve files with a double quote in it if you set this on. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dcc_long_pathnames?rev=1155982633 set dcc_long_pathnames [on|off|toggle] When turned on, this variable will cause the client to display the full pathnames of all files being transferred to or from the client via DCC. When off, only the filenames are shown, not their parent directories. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dcc_sliding_window?rev=1155982633 set dcc_sliding_window [<number>] The DCC specification requires that data cannot be sent via a DCC SEND connection until all previous data have been acknowledged by the receiver. For high latency/high bandwidth connections (ie, anything faster than 28.8k), this can have serious consequences on throughput because at least half of the time the connection is idle waiting for an acknowledgement to be returned. Although strict conformance to the DCC specification requires that this value be set … text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dcc_store_path?rev=1155982633 set dcc_store_path [<path>] This sets the default directory to store files retrieved with DCC GET. Naturally, the client must have write permissions in the chosen directory for it to work properly (the client will not warn if it has insufficient access). The default is to save the file to the current directory. text/html 2006-08-19T05:22:26+00:00 http://www.epicsol.org/help/set_dcc_use_gateway_addr?rev=1155982946 # $EPIC: set_dcc_use_gateway_addr.txt,v 1.3 2006/08/19 10:22:21 sthalik Exp $ set dcc_use_gateway_addr [on|off|toggle] This variable sets the IP address that is used in DCC requests. If dcc_use_gateway_addr is on, the client will use the IP address of the userhost sent by the server, otherwise it will use the local IP address. Having dcc_use_gateway_addr on may be useful in an environment where Linux IP Masquerading or NAT is used. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_debug?rev=1155982633 set debug [<level>] When turned on, this variable enables various degrees of debugging while the client is running. It is useful for seeing precisely where a particular alias or function is failing, what variables are being assigned what values, etc. There are three general classes of debug output, each assigned a unique number. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_dispatch_unknown_commands?rev=1155982633 set dispatch_unknown_command [on|off|toggle] When this is set ON, all commands unknown to the client will be sent to the server. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_display?rev=1155982633 set display [on|off|toggle] When turned off, this setting will cause the client to suppress all messages from being displayed (though it can still act on them internally. However, ECHO can still be used to explicitly print messages to the display. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/set_do_notify_immediately?rev=1156876398 set do_notify_immediately [on|off|toggle] When this is set ON, the notify list is checked on every /notify command. Else, it will wait until the top of the minute to update. This was added primarily to speed up server connects, since so many people have huge notify lists which slow down an initial connection. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_floating_point_math?rev=1155982633 set floating_point_math [on|off|toggle] When turned on, EPIC becomes capable of handling floating-point math operations. In truth, all math is done in floating-point, except the normal behavior is to convert everything to integers before actually displaying them. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_floating_point_precision?rev=1155982633 # $EPIC: set_floating_point_precision.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set floating_point_precision [number] This sets the number of decimal places that each floating point operation is rounded to. Setting it to 0 is not necessarily the same thing as turning floating_point_math off. The default is 6. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_flood_after?rev=1155982633 set flood_after [<number>] This setting specifies how many messages must be received before triggering the FLOOD hook. Naturally, the hook is only triggered if the message rate meets or exceeds the FLOOD_RATE setting. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/set_flood_ignore?rev=1172803800 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/set_flood_maskuser?rev=1172803800 text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/set_flood_rate?rev=1172803800 set flood_rate [<number>] This variable sets the message rate (per second) that will trigger the FLOOD hook, if the total message count exceeds the FLOOD_AFTER setting at the given rate. Thus, if messages from a remote client outpace the FLOOD_RATE for at least FLOOD_AFTER messages, the FLOOD hook is caught. If FLOOD_RATE is larger than FLOOD_AFTER, the client will not trigger the hook until at least FLOOD_RATE messages have been received. text/html 2007-03-01T20:50:00+00:00 http://www.epicsol.org/help/set_flood_rate_per?rev=1172803800 text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_flood_users?rev=1155982633 set flood_users [<number>] This variable sets the maximum number of users (unique nicknames) that the client will perform flood protection for. Larger numbers may start to affect client performance, so experiment with this value as needed. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_flood_warning?rev=1155982633 set flood_warning [on|off|toggle] When turned on, the client will display a message to the user to that effect (who is flooding, what type, etc.). If off, the client does not warn the user that flood protection has kicked in, unless a custom message is returned from within the FLOOD hook. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_hide_private_channels?rev=1155982633 set hide_private_channels [on|off|toggle] When turned on, the client will not display the name of any current channel in the status bar if that channel is +p or +s. Instead, it will display “*private*”. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_high_bit_escape?rev=1155982633 #$EPIC: set_high_bit_escape.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set high_bit_escape [0|1|2] Controls how EPIC treats characters with the high bit set: When 0: The character is accepted as-is. However, the character is still subject to the value of set eight_bit_characters. If you need to input 8 bit characters, make sure that set high_bit_escape is 0 and set eight_bit_characters is ON. This is the preferred setting for non-english users who expect the <meta> key to input 8-bit latin… text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_hold_interval?rev=1155982633 set hold_interval [<lines>] This controls how many lines must be added to a window’s hold buffer before your status line is forcibly refreshed. The default is 10, which is the traditional value. The number of lines must be at least 1. This command sets the default for all windows. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_hold_mode?rev=1155982633 set hold_mode [on|off|toggle] When turned on, this setting causes the client to pause the held window after each screenful of data, unless there is interaction by the user. If the user does not issue a command of some sort within one screenful, EPIC will buffer all further incoming messages. An issued command or a simple carriage return will cause the display to advance another screenful, and so on, until the display is up to date again. text/html 2006-08-19T05:17:13+00:00 http://www.epicsol.org/help/set_hold_slider?rev=1155982633 # $EPIC: set_hold_slider.txt,v 1.2 2006/08/19 10:15:16 sthalik Exp $ set hold_slider <number> This sets the value of HOLD_SLIDER for the current window, and the default value for any future windows you create. You should read the help file for WINDOW HOLD_SLIDER for more info. text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_indent?rev=1156081883 set indent [on|off|toggle] When turned on, long lines will be wrapped such that they are indented to the same position as the second word on the first line. Subsequent wrapping of the same line will be indented to the same place. If CONTINUED_LINE is also set, the client will pad the wrapped portions of the line with the CONTINUED_LINE contents, unless CONTINUED_LINE happens to be longer than the indented space. CONTINUED_LINE will not be truncated in this event; it is either displayed in fu… text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_input_prompt?rev=1156081883 set input_prompt [<string>] This setting allows the user to add a custom string the the beginning of the input line (for display purposes). Much like the various Unix shells, the prompt can contain any string desired. It is generally used for displaying information about the current target (such as a channel or queried nickname). Any variables used in the prompt are re-evaluated after each command issued from the input prompt. text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_insert_mode?rev=1156081883 set insert_mode [on|off|toggle] When this setting is on, text typed on the input line in the middle of a text string will shift the text to the right, making room for the text being typed. If it is off, the typed text overwrites anything ahead of it. text/html 2006-09-02T13:27:49+00:00 http://www.epicsol.org/help/set_key_interval?rev=1157221669 # $EPIC: set_key_interval.txt,v 1.3 2006/09/02 18:27:47 sthalik Exp $ set key_interval [<number>] This sets the timeout in milliseconds for the key input disambiguator. You are permitted to create ambiguous keybindings, for example: /BIND ^[ PARSE_COMMAND {echo You pressed Escape!} /BIND ^%%[[%%11~ PARSE_COMMAND {echo You pressed F1!} Now when you press <escape>, EPIC does not know if you actually pressed the <escape> key, or if you pressed <f1>, and it should wait for more characters. It … text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_lastlog?rev=1156081883 set lastlog [<number>] This option sets the size of the client’s lastlog buffer. It can be disabled if set to 0 (zero). text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_lastlog_level?rev=1156081883 set lastlog_level -]<level> [[-]<level> ... This setting controls the type(s) of information that EPIC will store in its lastlog buffer. Any single message type, or any combination, may be used. If a type is prepended with a ‘-’, messages of that type are explicitly not saved (useful with the ALL type). Message types may be abbreviated unambiguously. text/html 2006-08-29T13:33:18+00:00 http://www.epicsol.org/help/set_load_path?rev=1156876398 set load_path [<directory>[:<directory> ...]] This setting is used primarily by LOAD and WHICH (and thus the $which() function). If the client tries to access a file and cannot find it, it searches through each directory listed in the LOAD_PATH. It operates much like the PATH statement in Unix shells. The directories are searched sequentially. text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_log?rev=1156081883 set log [on|off|toggle] This variable globally sets whether the client saves its lastlog buffer to an external file. The actual buffer itself isn’t saved, rather anything that is saved to the buffer is also saved to the file. If multiple windows are in use, this setting will affect all of them, and will make no distinction in the log file as to which messages are from which window. In this case, WINDOW LOG should be used. text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_log_rewrite?rev=1156081883 # $EPIC: set_log_rewrite.txt,v 1.2 2006/08/20 13:51:17 sthalik Exp $ set(4) log_rewrite If this /SET is defined (by default, it is un-set), then every time a LOGICAL line of output is about to be sent to a window, the /SET value is expanded, and the result of that expansion is substituted for the original text. The expansion is parsed in the context that: $0 The window refnum the output is going to $1- The text itself. text/html 2006-08-20T09:01:15+00:00 http://www.epicsol.org/help/set_logfile?rev=1156082475 set logfile [<filename>] This variable sets the name of the file the client will log to when the LOG variable is on. This setting can be overridden by a logfile setting for a specific window. text/html 2006-08-20T08:51:23+00:00 http://www.epicsol.org/help/set_mail?rev=1156081883 # $EPIC: set_mail.txt,v 1.2 2006/08/20 13:51:17 sthalik Exp $ set mail [<0|1|2|3>] This setting affects how the client checks for new mail. When set to 0 (zero), mail checking is disabled. When set to 1 (one), the client will periodically report how many new messages have arrived since the last check, and the total message count. When set to 2 (two), the client shows the sender and subject of each new message as well. When set to 3 (three), the client does everything it does when set to 2,… text/html 2006-08-20T09:01:15+00:00 http://www.epicsol.org/help/set_mail_interval?rev=1156082475 set mail_interval [<seconds>] This setting controls how often the client checks your mbox for new mail. The default value is 60 (at the top of every minute). Previously, this value was not configurable and the client would just check for new mail at the top of every minute. For some people, this was far too often, and for others, it was not nearly often enough. Now you can cont