updatd manual, added FAQ
[xboard.git] / manual / html_node / Chess-Servers.html
1 <html lang="en">
2 <head>
3 <title>Chess Servers - XBoard</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="XBoard">
6 <meta name="generator" content="makeinfo 4.12">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="prev" href="Options.html#Options" title="Options">
9 <link rel="next" href="Firewalls.html#Firewalls" title="Firewalls">
10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11 <meta http-equiv="Content-Style-Type" content="text/css">
12 <style type="text/css"><!--
13   pre.display { font-family:inherit }
14   pre.format  { font-family:inherit }
15   pre.smalldisplay { font-family:inherit; font-size:smaller }
16   pre.smallformat  { font-family:inherit; font-size:smaller }
17   pre.smallexample { font-size:smaller }
18   pre.smalllisp    { font-size:smaller }
19   span.sc    { font-variant:small-caps }
20   span.roman { font-family:serif; font-weight:normal; } 
21   span.sansserif { font-family:sans-serif; font-weight:normal; } 
22 --></style>
23 </head>
24 <body>
25 <div class="node">
26 <p>
27 <a name="Chess-Servers"></a>
28 Next:&nbsp;<a rel="next" accesskey="n" href="Firewalls.html#Firewalls">Firewalls</a>,
29 Previous:&nbsp;<a rel="previous" accesskey="p" href="Options.html#Options">Options</a>,
30 Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
31 <hr>
32 </div>
33
34 <h2 class="chapter">4 Chess Servers</h2>
35
36 <p><a name="index-ICS-377"></a><a name="index-ICS_002c-addresses-378"></a><a name="index-Internet-Chess-Server-379"></a>An <dfn>Internet Chess Server</dfn>, or <dfn>ICS</dfn>, is a place on the\r
37 Internet where people can get together to play chess, watch other\r
38 people's games, or just chat.  You can use either <code>telnet</code> or a\r
39 client program like XBoard to connect to the server.  There are\r
40 thousands of registered users on the different ICS hosts, and it is\r
41 not unusual to meet 200 on both chessclub.com and freechess.org.\r
42 \r
43 Most people can just type <kbd>xboard -ics</kbd> to start XBoard as an ICS\r
44 client.  Invoking XBoard in this way connects you to the Internet\r
45 Chess Club (ICC), a commercial ICS.  You can log in there as a guest\r
46 even if you do not have a paid account.  To connect to the largest\r
47 Free ICS (FICS), use the command <kbd>xboard -ics -icshost freechess.org</kbd>\r
48 instead, or substitute a different host name to connect to your\r
49 favorite ICS.\r
50 For a full description of command-line options that control \r
51 the connection to ICS and change the default values of ICS options, see\r
52 <a href="ICS-options.html#ICS-options">ICS options</a>.  \r
53 \r
54 While you are running XBoard as an ICS client,\r
55 you use the terminal window that you started XBoard from\r
56 as a place to type in commands and read information that is\r
57 not available on the chessboard.\r
58 \r
59 The first time you need to use the terminal is to enter your login name\r
60 and password, if you are a registered player. (You don't need to do\r
61 this manually; the <code>icsLogon</code> option can do it for you.\r
62 see <a href="ICS-options.html#ICS-options">ICS options</a>.)  If you are not registered, \r
63 enter <kbd>g</kbd> as your name, and the server will pick a\r
64 unique guest name for you.\r
65 \r
66 Some useful ICS commands\r
67 include\r
68      <dl>
69 <dt><kbd>help &lt;topic&gt;</kbd><dd><a name="index-help_002c-ICS-command-380"></a>to get help on the given &lt;topic&gt;. To get a list of possible topics type\r
70 <dfn>help</dfn> without topic.  Try the help command before you ask other\r
71 people on the server for help.\r
72 \r
73 For example <kbd>help register</kbd> tells you how to become a registered\r
74 ICS player.\r
75 <br><dt><kbd>who &lt;flags&gt;</kbd><dd><a name="index-who_002c-ICS-command-381"></a>to see a list of people who are logged on.  Administrators\r
76 (people you should talk to if you have a problem) are marked\r
77 with the character &lsquo;<samp><span class="samp">*</span></samp>&rsquo;, an asterisk. The &lt;flags&gt; allow you to\r
78 display only selected players: For example, <kbd>who of</kbd> shows a\r
79 list of players who are interested in playing but do not have\r
80 an opponent.\r
81 <br><dt><kbd>games</kbd><dd><a name="index-games_002c-ICS-command-382"></a>to see what games are being played\r
82 <br><dt><kbd>match &lt;player&gt; [&lt;mins&gt;] [&lt;inc&gt;]</kbd><dd>to challenge another player to a game. Both opponents get &lt;mins&gt; minutes\r
83 for the game, and &lt;inc&gt; seconds will be added after each move.\r
84 If another player challenges you, the server asks if you want to\r
85 accept the challenge; use the <kbd>accept</kbd> or <kbd>decline</kbd> commands\r
86 to answer.\r
87 <br><dt><kbd>accept</kbd><dt><kbd>decline</kbd><dd><a name="index-accept_002c-ICS-command-383"></a><a name="index-decline_002c-ICS-command-384"></a>to accept or decline another player's offer. \r
88 The offer may be to start a new game, or to agree to a \r
89 <kbd>draw</kbd>, <kbd>adjourn</kbd> or <kbd>abort</kbd> the current game. See <a href="Action-Menu.html#Action-Menu">Action Menu</a>.\r
90 \r
91 If you have more than one pending offer (for example, if more than one player\r
92 is challenging you, or if your opponent offers both a draw and to adjourn the\r
93 game), you have to supply additional information, by typing something\r
94 like <kbd>accept &lt;player&gt;</kbd>, <kbd>accept draw</kbd>, or <kbd>draw</kbd>.\r
95 <br><dt><kbd>draw</kbd><dt><kbd>adjourn</kbd><dt><kbd>abort</kbd><dd><a name="index-draw_002c-ICS-command-385"></a><a name="index-adjourn_002c-ICS-command-386"></a><a name="index-abort_002c-ICS-command-387"></a>asks your opponent to terminate a game by mutual agreement. Adjourned\r
96 games can be continued later. \r
97 Your opponent can either <kbd>decline</kbd> your offer or accept it (by typing the\r
98 same command or typing <kbd>accept</kbd>).  In some cases these commands work\r
99 immediately, without asking your opponent to agree.  For example, you can\r
100 abort the game unilaterally if your opponent is out of time, and you can claim\r
101 a draw by repetition or the 50-move rule if available simply by typing \r
102 <kbd>draw</kbd>.\r
103 <br><dt><kbd>finger &lt;player&gt;</kbd><dd><a name="index-finger_002c-ICS-command-388"></a>to get information about the given &lt;player&gt;. (Default: yourself.)\r
104 <br><dt><kbd>vars</kbd><dd><a name="index-vars_002c-ICS-command-389"></a>to get a list of personal settings\r
105 <br><dt><kbd>set &lt;var&gt; &lt;value&gt;</kbd><dd><a name="index-set_002c-ICS-command-390"></a>to modify these settings\r
106 <br><dt><kbd>observe &lt;player&gt;</kbd><dd><a name="index-observe_002c-ICS-command-391"></a>to observe an ongoing game of the given &lt;player&gt;.\r
107 <br><dt><kbd>examine</kbd><dt><kbd>oldmoves</kbd><dd><a name="index-examine_002c-ICS-command-392"></a><a name="index-oldmoves_002c-ICS-command-393"></a>to review a recently completed game\r
108 </dl>
109    \r
110 Some special XBoard features are activated when you are\r
111 in examine mode on ICS.  See the descriptions of the menu commands\r
112 &lsquo;<samp><span class="samp">Forward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Backward</span></samp>&rsquo;, &lsquo;<samp><span class="samp">Pause</span></samp>&rsquo;, &lsquo;<samp><span class="samp">ICS Client</span></samp>&rsquo;, \r
113 and &lsquo;<samp><span class="samp">Stop Examining</span></samp>&rsquo; on the <a href="Step-Menu.html#Step-Menu">Step Menu</a>, <a href="Mode-Menu.html#Mode-Menu">Mode Menu</a>, and\r
114 <a href="Options-Menu.html#Options-Menu">Options Menu</a>.\r
115 \r
116
117    </body></html>
118