updated manual to 4.7.0
[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.13">
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 <a name="Chess-Servers"></a>
27 <p>
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">5 Chess Servers</h2>
35
36 <p><a name="index-ICS-568"></a><a name="index-ICS_002c-addresses-569"></a><a name="index-Internet-Chess-Server-570"></a>An <dfn>Internet Chess Server</dfn>, or <dfn>ICS</dfn>, is a place on the
37 Internet where people can get together to play chess, watch other
38 people's games, or just chat.  You can use either <code>telnet</code> or a
39 client program like XBoard to connect to the server.  There are
40 thousands of registered users on the different ICS hosts, and it is
41 not unusual to meet 200 on both chessclub.com and freechess.org.
42
43    <p>Most people can just type <kbd>xboard -ics</kbd> to start XBoard as an ICS
44 client.  Invoking XBoard in this way connects you to the Internet
45 Chess Club (ICC), a commercial ICS.  You can log in there as a guest
46 even if you do not have a paid account.  To connect to the largest
47 Free ICS (FICS), use the command <kbd>xboard -ics -icshost freechess.org</kbd>
48 instead, or substitute a different host name to connect to your
49 favorite ICS. 
50 For a full description of command-line options that control
51 the connection to ICS and change the default values of ICS options, see
52 <a href="ICS-options.html#ICS-options">ICS options</a>.
53
54    <p>While you are running XBoard as an ICS client,
55 you use the terminal window that you started XBoard from
56 as a place to type in commands and read information that is
57 not available on the chessboard.
58
59    <p>The first time you need to use the terminal is to enter your login name
60 and password, if you are a registered player. (You don't need to do
61 this manually; the <code>icsLogon</code> option can do it for you. 
62 see <a href="ICS-options.html#ICS-options">ICS options</a>.)  If you are not registered,
63 enter <kbd>g</kbd> as your name, and the server will pick a
64 unique guest name for you.
65
66    <p>Some useful ICS commands
67 include
68      <dl>
69 <dt><kbd>help &lt;topic&gt;</kbd><dd><a name="index-help_002c-ICS-command-571"></a>to get help on the given &lt;topic&gt;. To get a list of possible topics type
70 <dfn>help</dfn> without topic.  Try the help command before you ask other
71 people on the server for help.
72
73      <p>For example <kbd>help register</kbd> tells you how to become a registered
74 ICS player. 
75 <br><dt><kbd>who &lt;flags&gt;</kbd><dd><a name="index-who_002c-ICS-command-572"></a>to see a list of people who are logged on.  Administrators
76 (people you should talk to if you have a problem) are marked
77 with the character &lsquo;<samp><span class="samp">*</span></samp>&rsquo;, an asterisk. The &lt;flags&gt; allow you to
78 display only selected players: For example, <kbd>who of</kbd> shows a
79 list of players who are interested in playing but do not have
80 an opponent. 
81 <br><dt><kbd>games</kbd><dd><a name="index-games_002c-ICS-command-573"></a>to see what games are being played
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
83 for the game, and &lt;inc&gt; seconds will be added after each move. 
84 If another player challenges you, the server asks if you want to
85 accept the challenge; use the <kbd>accept</kbd> or <kbd>decline</kbd> commands
86 to answer. 
87 <br><dt><kbd>accept</kbd><dt><kbd>decline</kbd><dd><a name="index-accept_002c-ICS-command-574"></a><a name="index-decline_002c-ICS-command-575"></a>to accept or decline another player's offer. 
88 The offer may be to start a new game, or to agree to a
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>.
90
91      <p>If you have more than one pending offer (for example, if more than one player
92 is challenging you, or if your opponent offers both a draw and to adjourn the
93 game), you have to supply additional information, by typing something
94 like <kbd>accept &lt;player&gt;</kbd>, <kbd>accept draw</kbd>, or <kbd>draw</kbd>. 
95 <br><dt><kbd>draw</kbd><dt><kbd>adjourn</kbd><dt><kbd>abort</kbd><dd><a name="index-draw_002c-ICS-command-576"></a><a name="index-adjourn_002c-ICS-command-577"></a><a name="index-abort_002c-ICS-command-578"></a>asks your opponent to terminate a game by mutual agreement. Adjourned
96 games can be continued later. 
97 Your opponent can either <kbd>decline</kbd> your offer or accept it (by typing the
98 same command or typing <kbd>accept</kbd>).  In some cases these commands work
99 immediately, without asking your opponent to agree.  For example, you can
100 abort the game unilaterally if your opponent is out of time, and you can claim
101 a draw by repetition or the 50-move rule if available simply by typing
102 <kbd>draw</kbd>. 
103 <br><dt><kbd>finger &lt;player&gt;</kbd><dd><a name="index-finger_002c-ICS-command-579"></a>to get information about the given &lt;player&gt;. (Default: yourself.) 
104 <br><dt><kbd>vars</kbd><dd><a name="index-vars_002c-ICS-command-580"></a>to get a list of personal settings
105 <br><dt><kbd>set &lt;var&gt; &lt;value&gt;</kbd><dd><a name="index-set_002c-ICS-command-581"></a>to modify these settings
106 <br><dt><kbd>observe &lt;player&gt;</kbd><dd><a name="index-observe_002c-ICS-command-582"></a>to observe an ongoing game of the given &lt;player&gt;. 
107 <br><dt><kbd>examine</kbd><dt><kbd>oldmoves</kbd><dd><a name="index-examine_002c-ICS-command-583"></a><a name="index-oldmoves_002c-ICS-command-584"></a>to review a recently completed game
108 </dl>
109
110    <p>Some special XBoard features are activated when you are
111 in examine mode on ICS.  See the descriptions of the menu commands
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;,
113 and &lsquo;<samp><span class="samp">Stop Examining</span></samp>&rsquo; on the <a href="Edit-Menu.html#Edit-Menu">Edit Menu</a>, <a href="Mode-Menu.html#Mode-Menu">Mode Menu</a>, and
114 <a href="Action-Menu.html#Action-Menu">Action Menu</a>.
115
116    </body></html>
117