Status: research notes, 2026-11-21. Every fact carries a source tag like [S3] (list in section i). Anything not backed by a source is marked UNVERIFIED. Nothing here comes from memory.
Method: web search, the Internet Archive (Wayback Machine) copies of the NEC pages, and strings pulled from the Reversi The Eclipse 1.2 binary. No connection to any server was made: external.nj.nec.com no longer resolves (NXDOMAIN, checked 2026-11-21 with host), so there was nothing to probe.
- IOS is real, documented only indirectly. There is no surviving IOS manual that I could find. The best primary sources are (a) the source of a 1994-95 IOS client written by IOS's own author [S6], (b) the Wayback copy of the author's history page [S3], and (c) strings inside Reversi The Eclipse itself [S9].
- IOS was replaced around 1999 by the Generic Game Server (GGS) on the same host and port (5000) [S3][S4][S5]. GGS is the successor, not a sibling, and has a different, well-documented protocol with a "client" mode. Old IOS clients (such as Eclipse 1.2, 1997) speak the IOS protocol, not GGS.
- "Reversi The Eclipse" is confirmed: a 1997 Macintosh game (Lars Graulund, Freeverse Software) [S8][S10]. Its binary contains an IOS login dialog, host external.nj.nec.com, port 5000, and <ios> message parsing [S9].
- The IOS wire format is human text meant for telnet, parsed by clients by line and column position. The IOS text formats below are recovered from client parsing code, so they are accurate for what that client accepted, but are not a full specification. A real capture or the IOS help text is still needed to close the gaps (section h).
- IOS is the "Internet Othello Server", a telnet-style server where people and programs play Othello [S7][S1]. A shareware author's FAQ (1997) describes it as an Internet-based server "where you can meet people and play games of othello with them" [S7].
- Origin, from its author Igor Durdanovic [S3]: it grew out of the Fall 1993 computer Othello tournament (Waterloo) where the provided server was poor. Durdanovic "volunteered to write an internet othello server", copied "commands and appearance of other internet servers, for example ICS" (the Internet Chess Server), and in a week had a communication server that knew Othello rules, created games and displayed boards. A play-off was run on it "and the IOS was born". Feature freeze in 1995. By 1996-99 it had 1000+ users and the database was straining [S3].
- Moves: in Fall 1996 Durdanovic moved from Paderborn, Germany to NEC Research Institute (NECI), Princeton NJ, and IOS moved with him [S3]. A 1997/98 tournament report gives the new address as ftp.nj.nec.com (or 138.15.10.2) port 5000 [S11]. A 1996 applet page says IOS "recently moved and is now at external.nj.nec.com, port 5000" [S12].
- Ratings: IOS had an ELO-style rating (1996 lists exist [S13]). In Summer 1999 random-opening games were added; the author then migrated the IOS database and recomputed ratings with Glicko, and "one day woke up only to find out that IOS is gone and something incomprehensible took its place" [S3]. That replacement is GGS.
- Current status: IOS itself is gone (replaced by GGS about 1999-2000 [S3][S4]). The host external.nj.nec.com no longer resolves in DNS (checked 2026-11-21; NEC Research Institute no longer exists under that name, UNVERIFIED reason). GGS still runs, now at skatgame.net port 5000 (and 4000) [S2], with a news item dated 2026-11-09, so a GGS adapter target has live servers to test against.
- Programs on IOS: strong Othello programs and humans played there (rating lists name Logistello, Eclipse (a program, not the Mac game), Kitty, Keyano and others) [S13][S14].
| Item | Value | Source |
| Host | external.nj.nec.com (also ftp.nj.nec.com, IP 138.15.10.2 in 1997/98) | [S12][S11][S9] |
| Port | 5000 | [S12][S11], and the Eclipse binary contains "5000" next to the host-name prompt [S9] |
| Transport | plain TCP, "simple telnet"; no telnet option negotiation is performed by the reference client | [S6] |
| Line ending | server lines end in LF; the client strips a CR if present, so CR LF is accepted. Client commands are sent terminated by a single \n. | [S6] |
| Encoding | ASCII (UNVERIFIED, nothing says otherwise; the client treats bytes as chars) | [S6] |
| Max line | the reference client aborts on a received line over 8192 chars | [S6] |
| Login name | at most 8 characters (client buffers are 9 bytes; Eclipse's dialog text says "Max. 8") | [S6][S9] |
| Prompts | login: and password: arrive with no trailing newline and are matched as exact strings; after login the command prompt looks like <login>% and the client extracts its own login name from text before the % | [S6] |
Note: the 1994 client's "simple telnet" claim means a raw TCP connection is enough for the reference client. Whether the server ever sent telnet IAC negotiation bytes is not documented (UNVERIFIED).
- Server prompts login: . Client sends the name followed by \n. Server then prompts password: . Client sends the password followed by \n [S6].
- The reference client always sends a password line when auto-logging in with one [S6]. For an unregistered name the Java client's page says: "If you are a registered player, type your password and return. Otherwise, if your name was taken, you have to try another one" [S15]. So: unregistered users appear to log in with a free name; whether a password is also requested for them in IOS is not clear (UNVERIFIED). (On GGS, a password is required even for unregistered names [S5].)
- Registration was by contacting administrators (GGS: by asking an online administrator; IOS: UNVERIFIED, no IOS source).
- Eclipse's login dialog text (fragments from its compressed image) says to enter "a username with up to eight characters in the Login field", and "if you do not get ... first try, it may be ... that [the name] is already [taken] by someone else" [S9]. This matches the Java client note [S15].
- The Eclipse binary also contains the literal strings set trust 1, quit, resign, which the client sends [S9]. set trust 1 is the IOS-era command for trusting the client-reported move time, see (d).
Verified only where a source is cited. Commands are lines typed to the server (case unclear, UNVERIFIED).
Sent by reference clients:
| Command | Meaning / format | Source |
| who | list users. Client waits for a header line starting login blitz stand. G M idle on for from host | [S6] |
| `match <opponent> <time> <inc> <def> [white\ | black]` | challenge an opponent; the three integers are the client's time settings (see Time). Omitted colour means random | [S6] (put_match) |
| accept <name> | accept a challenge from <name> | [S6] |
| decline <name> | decline; the client may also send tell <name> <reason> | [S6] |
| tell <name> <text> | private message | [S6] |
| PM <sq> <value> <time> | play a move. sq is a letter+digit like D3 (client prints column as upper-case A-H, row digit), pass is ps. value is the program's evaluation, printed %+5.2f; time is time spent on the move, %8.2f. Example form: PM D3 +0.00 1.50 | [S6] (put_move) |
| quit, resign | leave; resign | [S9] (strings) |
| set trust 1 | tell the server to trust client-reported move times | [S9] (strings); the GGS successor documents the same idea as the trust variable [S16] |
| help | server help text ("You can get more help from the server by typing help") | [S15] |
| players | the Java client has a "players" button that lists ready players; its exact wire command is UNVERIFIED (probably who) | [S15] |
Other commands implied but with no verified syntax (UNVERIFIED): shout/yell, channels, observe, undo, adjourn/continue, rated vs unrated toggle, open/close for challenges. Evidence they exist: the IOS who columns show a registered flag, a playing flag, and open/rated/trust flags [S6]; the author says IOS channels existed and had a limit [S3]; Mac Eclipse strings include told, Talk, stored and unrated fragments [S9]; the successor GGS has all of these [S16].
Matches use a request/accept flow: a challenge is "pending" until the target accepts. The server announces events using lines starting <ios> (next section).
All structured server messages carry a <ios> prefix and are parsed by the clients by position within the line [S6][S9]. Formats below are what the reference client's parser (written by IOS's author) expects.
Game created and ended [S6]
<ios> [GAME 2 (fly vs. mic) (rated) created
<ios> [GAME 2 (fly vs. mic) (rated) ended
The first name is black and the second white (the client assigns them in that order). rated/unrated appears in the second parenthesis. "ended" is detected by the word in the eighth token; the final score text is not in this line (UNVERIFIED where the score appears).
Match offer [S6]
<ios> MATCH ... (first line)
... (second line: score range)
Fields recovered from the parser: a rated/unrated/stored marker (column 13 is r for rated, s for stored), then my time, increment, default time, an opponent name, the opponent's time values, and a colour word (white or black, with * at position 5 meaning random colour). Second line: max_win .. min_win draw min_loss .. max_loss - the score range at which the game would be a win, draw or loss for the player (the reference client reads five integers %d .. %d %d %d .. %d). Exact column layout is UNVERIFIED beyond the offsets used by the parser (20 for the first number block, 15 for the second line).
Human-readable board [S6]
<ios> BOARD of GAME 4, (scorpion vs. mic)
followed by a fixed block of lines, which the client reads by line index and column: line 0 header; line 1 holds the colour to move (column 12 is * for black, O for white); lines 2-9 are board rows; column 31+2k is the disc for column k. Discs: * black, O white, - empty. Clock text for the first player sits at fixed columns 11-18 (HH:MM:SS) with a default time at column 20 and increment at column 24; the second player's clock at columns 59-72 [S6]. The last move is at columns 52-58 (move number at 52-53, square letter+digit at 57-58, p for pass), a Y/N at column 0 of the last line says whether it is the client's turn, and the move value at column 70 [S6]. These offsets are copied from parsing code and should be confirmed against a real capture before use (UNVERIFIED as a layout of a whole message).
**Machine-readable board line PB** [S6]
<ios> PB 0 <black> <white> <tb> <tw> <defb> <defw> <incb> <incw> <color> <turn> <moveno> <move> <value> <time> <64 cells>
This is a single-line board used by programs. The parser reads, from column 8: game number, black name, white name, black time, white time, black and white default time, black and white increment, colour to move (* or O), turn flag Y/N (is it my turn), last move number, last move code (negative means pass), evaluation value, elapsed time, and then 64 board characters (*, O, -) starting at column 78, row by row [S6]. Which command or variable switches this form on is not stated in the code (UNVERIFIED; the reference client simply accepts both forms).
Move list [S6]
<ios> MOVES of GAME 2, (mic vs. scorpion)
followed by a grid of 8 board rows where each square shows the move number at which it was played; ( and # mark non-playable squares. The client builds a move-by-move array (up to 60 entries) from it [S6].
Who list [S6]
A header line login blitz stand. G M idle on for from host, then one line per user: name at column 0; blitz rating at column 10; a + at column 15 marks a registered player; the standard (15 minutes or more) rating at column 17; a flag at column 25 (- means not playing); and a flag at column 27 (- closed, otherwise open; r/R rated; R/U trusted). The list ends at the first line without [ at column 9. [S6]
Moves, notation, passes
- Squares: column letter A-H plus row digit 1-8, case-insensitive on input [S6]. The reference client prints A1 style upper case when sending and treats p as pass when reading [S6]. The Java client example in Eclipse strings uses pa for a pass (fragment pa s), while the reference client sends ps; whether both are accepted is UNVERIFIED [S9][S6].
- Passing is client-initiated: the reference client has a pass move and the opponent line shows p. Whether the server auto-passes is UNVERIFIED.
- Game end and score: the server sends ... ended. Score reporting format is UNVERIFIED. The ranges in the MATCH message ("min_win", "draw", "max_loss") show IOS scored games by disc margin tied to win/draw/loss bands (section f) [S6].
- Board 8x8 only for IOS in every source (the reference client hard-codes 8x8 and 100-cell arrays) [S6]. (GGS later added 4x4 to 14x14 and variants [S2][S17].)
- Time: each player has a main time, an increment and a default (minimum) time per game; the reference client sends these as three integers and shows them as HH:MM:SS plus two small integers per player [S6]. Rating lists separate "standard (>= 15 minutes)" from "blitz" games [S6][S13].
- Colour: choose white, black or omit for random [S6].
- Ratings: ELO-style; the who list shows a blitz and a standard rating [S6][S13]. Games can be rated or unrated; a rated game needs registered players (UNVERIFIED for IOS; stated for GGS [S5]).
- Trust option: clients may report their own move time and the server may adjust (set trust 1) [S9]; on GGS this is within 2 s +/- 10 percent of server time or the game is adjourned [S16].
- Random openings added summer 1999 [S3].
- Komi: none in IOS evidence (GGS has komi [S2][S17]). Scoring in the MATCH message uses win/draw/loss bands of disc margin [S6].
- Rooms: none; IOS had numbered channels (limited in number) [S3], syntax UNVERIFIED.
- Observers: games can be watched (Eclipse/olios parse boards for games the user is not in and treat them as "look" boards) [S6].
Reversi The Eclipse 1.2 [S8][S9][S10]
- Macintosh game, 1997, by Lars Graulund, published by Freeverse Software; Macintosh Repository lists it as "Reversi/Othello with a sense of humour. Includes multiple difficulties and multiplayer" [S8]. The French Othello federation lists it as a 1997 Macintosh program with a 2D/3D ancient-Greece theme (Apollo white versus Luna black) [S10]. A copy is at the FFO site (Reversi-the-eclipse.smi.bin, MacBinary / Disk Copy self-mounting image).
- IOS support (from strings pulled out of the 2.3 MB image, which is compressed, so only fragments are readable [S9]):
- a dialog titled "Connecting to IOS:"; text mentions "OpenTransport, version 1.1 or later (Apple System 7.6 has this networking capability)" and the Login field and password;
- default host external.nj.nec.com, "tcp" and port 5000;
- strings <ios>, MOVES of GAME, MATCH, PB, [GAME, ended, told, login, blitz, stand., quit, resign, set trust 1, who;
- a board header string A B C D E F G H, and stats strings ("Stats:", "Time out", "change win ... draw ... loss") that suggest it parses the IOS text board and rating-change line;
- an internal class named MyTelnet.
Conclusion: it is a telnet-style IOS client that parses the same <ios> messages as the reference client; it logs in with a handle and optional password and drives play by sending text commands. UNVERIFIED details: exact commands for challenge and accept, how it turns on the PB single-line board, how it handles server prompts. The ground truth would be to decompress the image (Disk Copy "ADC" compression) and read the program's resources, or to run it in an emulator against our adapter and capture the bytes.
- The Eclipse 1.2 binary is proprietary; do not redistribute. Only short strings were read.
Other IOS clients with sources
- OLIOS 0.95, "the OpenLook X-client for IOS", Michael Buro, built on Igor Durdanovic's client.c/client.h (1994-95, in the Wayback copy olios.tgz, 44 KB) [S6]. No license text is included in the archive; copyright notice names Igor Durdanovic. Treat as all rights reserved: read it for facts only, do not copy it.
- A Java applet client from Lund University (Ola Melen; page archived 1999, undated otherwise) that connects, shows players, uses match <name> and help [S15].
- Chris Welty's Lion (Windows GUI) is a GGS client, not an IOS client [S5][S4]. Super Othello (Mac) did not support IOS [S7].
- Addendum, 2026-11-22 (docs/research/x11-clients.md has the sources): OLIOS 0.95 builds unchanged against XView on Debian 8 x86-64, using the shipped Devguide output; two Wayback captures of olios.tgz are identical. iospair 1.01 (Hugo Calendar, 1996) is an IOS tournament-director bot that uses tell, rtell and channel tells. It is not free software, but it is useful for testing tells. No other Unix IOS client was found. Xoth and Reve are peer-to-peer Reversi programs, and Iagno used its own relay, not IOS.
Added 2026-11-21 from docs/research/pc-clients.md; tags like [pc S1] are that file's sources. Nothing was run.
- No Windows 3.x or DOS IOS client was found. Besides Eclipse (Mac), the Lund Java applet and the reference client, the only other IOS client found is Adrasthello (Amiga, 1996, port 5000) [pc S6].
- Worthy Opponent (DOS, 1988-90) has a Reversi game, "Cornerstone", played peer to peer by Hayes modem [pc S1]. Verdict: a peer reachable through a modem bridge.
- VOG Othello (VINCO+, Moscow, Win95/NT4, about 1999) played on its maker's own servers, now gone [pc S5]. No.
- Internet Reversi (Windows Me, 2000) reaches the Zone; the ZIGS server documents it (clients-checkers.md) [pc S8]. Sierra's WON Hoyle Channel (1999) had Reversi; no open server [pc S29].
- GGS clients for Windows found: GGSA (Java 1.5, after the period) and a C++ client [pc S7].
- Exact IOS help text and the complete command list (no surviving copy found). The IOS server source was never released as far as I found; the GGS source is GPL, but it is the successor [S3][S18].
- Whether who, match and others are case-sensitive; abbreviations.
- Complete text of the board block and the final score line, including how the game result is announced.
- How the PB single-line board is enabled and whether the server stops sending the human board then.
- Pass syntax (ps versus pa) and whether the server auto-passes.
- Shouts, channels, observe, undo, adjourn: syntax.
- Whether telnet negotiation bytes are sent.
- Whether unregistered names need a password.
- How Eclipse 1.2 starts and accepts a game (challenge flow as seen in its UI).
- Why the host is gone (the NEC lab history is not sourced here).
- Whether anyone still runs an IOS-compatible server. Not found; the closest live thing is GGS at skatgame.net:5000 [S2].
Best next step: a capture of Eclipse 1.2 talking to a stub (an emulated Mac under QEMU/Basilisk with our listener on port 5000 and name resolution of external.nj.nec.com pointed at it; that is deployment-layer only). Log the bytes it sends after login, then fill the gaps above from its behaviour. This costs nothing on the project side and settles items 2-9 directly.
- The user-facing protocol the adapter must imitate is the IOS text one in (d)/(e). Since Eclipse speaks IOS, not GGS, an IOS adapter is the first and separate piece of work; GGS is a separate, easier, fully documented second adapter [S5][S16][S17].
- If we target GGS later: the documented client mode and message formats are in [S5], [S16], [S17], [S19]: ts commands, /os: update / /os: join boards ending in a line READY, a request line /os: + .id rating player clock type R|U rating player [clock], PLAY-style tp d6 or ts play d6, ts open 1, ts ask 8 <player>, ts accept, ts resign, ts undo, ts score. These are GPL-documented and low risk.
Our side from docs/protocol.md and docs/types/reversi-1.md.
| Ours | IOS side |
| HELO name, then AUT | the IOS login: / password: exchange. The adapter creates the handle from the IOS name (max 8 chars; ours allows 12, so use the IOS name as given and prefix/suffix only if needed). The IOS password answers the server's password question only (docs/accounts.md). |
| GAM | not needed; IOS has one game. The adapter only exposes reversi/1 standard (size 8). |
| LST | who (users) plus <ios> MATCH offers. Our tables are open seats; IOS has users who are "open". Map open table creators to who lines flagged open; map a match <name> to joining that creator's table. |
| NEW reversi standard | a user becoming "open" / sending match. Our JON plus NEW correspond to challenge then accept. |
| JON table | accept <name> |
| LVE table | resign (if running) or decline; quit closes everything |
| SEE table | observing (UNVERIFIED syntax) |
| VUE table G/M | board text per (e): <ios> BOARD ... block or <ios> PB .... Our rows R y cells and C n0 n1 map to the */O/- rows and the disc counts |
| MOV table d3 | PM D3 +0.00 <time> ; our lowercase square maps to uppercase letters; rows already 1..8 from the top, the same as IOS row digits per the parser (row digit at the line start counts down the board) |
| no PASS verb in ours (server passes) | IOS clients may send a pass (ps/pa). The adapter must translate an incoming pass into nothing when the server has already passed, and drop or reject if illegal. Needs capture to confirm |
| CHT table text | tell <name> <text> |
| EVT ... PUT/FLP/PASS/TURN/END | an <ios> BOARD/PB refresh after each move (IOS resends the whole board, not deltas), a game-end line `<ios> [GAME n (a vs. b) (rated | unrated) ended. END win seat n0-n1` maps to the score text (format UNVERIFIED) |
| clock option clock=... | match time fields (main, increment, default) |
| colours: seat 0 and seat 1, not part of contract | IOS fixes * black and O white; the adapter maps seat 0 to black because reversi/1 says seat 0 moves first and in Othello black moves first (matches IOS's black-first display in [S6]) |
What IOS has that we lack: ratings (ELO/Glicko, rating lists; the adapter should show a fixed or unrated value unless we add ratings), rooms/channels and shouts, tells to arbitrary users (we only have table chat), a global who list, observers, rated vs unrated games, adjourned/stored games, trust time reporting, random openings (r), komi/anti variants (GGS). What we have that IOS lacks: typed move events with flips (IOS resends boards), CHK, SEE as a first-class view, WAT polling, multi-game hosting, board sizes other than 8 for IOS.
- [S1] http://home.datacomm.ch/t_wolf/tw/misc/reversi/ - applet page that mentions IOS and its move to external.nj.nec.com, port 5000 (via search result; fetch of the page itself failed, snippet only).
- [S2] https://skatgame.net/mburo/ggs/ - GGS home (live in 2026; port 5000/4000; news Nov 2026; links to GGSA, How-To, Chris Welty's software).
- [S3] Igor Durdanovic, "History" (IOS to GGS), Wayback copy of http://external.nj.nec.com/homepages/igord/history.htm (snapshot 2000-11-18).
- [S4] Igor Durdanovic, GSA/GGS landing page and User's Manual, Wayback copies of .../igord/gsa-ggs.htm (2000-05-27) and .../igord/usrman.htm (2001-03-03).
- [S5] https://skatgame.net/mburo/ggsa/GGS_Intro.html - Chris Welty's GGS introduction (login, mso, ts open, ts ask, tp, registration, example /os: update board).
- [S6] OLIOS 0.95 sources (client.c, client.h, client_util.i, README), Michael Buro and Igor Durdanovic (1994-95), Wayback copy of http://external.nj.nec.com/homepages/mic/bin/olios.tgz (snapshot 1999-02-09). No license stated; copyright Igor Durdanovic. Used for facts only; nothing copied.
- [S7] Super Othello FAQ (Yellow Lemon Software, 1997-10-27), Q9 and Q10 (defines IOS): https://discmaster.textfiles.com/view/23818/Macworld%20(1998-01).dmg/Games%20World/Shareware%20Games/Board/Super%20Othello%202.3.1/Documentation/Super%20Othello%20FAQ
- [S8] https://www.macintoshrepository.org/13481-reversi-the-eclipse-1-2 - Reversi The Eclipse 1.2, Lars Graulund, Freeverse Software.
- [S9] Strings read from the Reversi The Eclipse 1.2 disk image obtained from https://www.ffothello.org/programmes/Reversi-the-eclipse.smi.bin (local analysis, fragments only because the image is compressed).
- [S10] https://www.ffothello.org/informatique/telecharger-des-programmes/ - FFO program list entry for Reversi the Eclipse 1.2 (1997, Macintosh, 2D/3D, Apollo/Luna).
- [S11] Michael Buro, PB-IV tournament report, Wayback copy of http://external.nj.nec.com/homepages/mic/PBIV.report (1998-04-30): new IOS address ftp.nj.nec.com or 138.15.10.2, port 5000.
- [S12] Same page as S1; the "recently moved ... port 5000" and "IOS rating 1408" statements reached me only through a web search snippet. The page itself could not be fetched, so treat S1/S12 as secondary.
- [S13] Michael Buro, IOS rating lists (Aug 1996) and "Very Unofficial Rating List", Wayback copies of .../homepages/mic/iosrat.html and .../mic/rating.html (1996-11-12).
- [S14] Gunnar Andersson, "Othello servers", http://www.radagast.se/othello/servers.html ("Michael Buro and Igor Durdanovic, the guys behind IOS").
- [S15] Ola Melen, Lund University, "Othello Java Client" for IOS, Wayback copy of http://external.nj.nec.com/homepages/igord/OTH/ola/ (1999-02-04).
- [S16] Igor Durdanovic, "Game Service Commands" and "Game Service Variables" (GGS /os), Wayback copies of .../igord/service-cmd.txt (2001-03-04) and service-var.txt (2001-03-04), plus the command reference service-cmd-ref.txt (2001-06-28).
- [S17] Igor Durdanovic, "GGS clock", "GGS rating system", Wayback copies of .../igord/service-clock.txt, service-rating.txt (2001-03-04); Michael Buro, GGS How-To https://skatgame.net/mburo/ggs/ggs-howto.
- [S18] GGS source release: GPL and NECI license (gsa-ggs.htm [S4]); GGS C++ client GGS_Client.C/.H is GPL v2 or later (header text), Wayback copy of .../igord/GGS_Client.C (2001-06-28). Current source tarball: https://skatgame.net/mburo/ggs/ (license not rechecked).
- [S19] GGS_Client.C message parsing (GGS /os: messages end with a line READY or ALERT; update/join boards; request and match lines); Wayback copy, see S18.
This doc on GitHub
| | These pages cover every ParlorNet server. | Source code | ParlorNet is free software. |