rcons has a client / server implementation. The client side (rcons.dll) runs on Symbian OS and the server side (rcons.exe) runs on a Win32 PC. The two sides communicate with one another via a pair of TCP/IP connections. The net result is that when something on the Symbian OS side creates a console, instead of a console window appearing on the Symbian OS hosted screen, a console window appears on the PC. This is a conventional Windows window that can be typed into using the PC's keyboard, resized using the PC's mouse, etc.
In order for the client and server sides to communicate with one another, some kind of TCP transport needs to be in place. However, in most cases you shouldn't need to worry about the details of configuring a suitable transport as that should have already been done in your fshell distribution (assuming you're using supported hardware).
The remainder of this documentation describes how to manually install and configure rcons.
The PC side (rcons.exe) should already be installed in your development environment (assuming you did a full build of fshell). Running it is simply as case of launching \epoc32\tools\rcons.exe. This should create a new window that states the TCP port that the program is listening for connections on. Provided this matches the client side configuration, not further configuration of the server is necessary. For details of how to use the server side, see rcons.exe.
There are more choices to be made regarding the installation of the Symbian OS side. See rcons.dll for more details, however by default fshell
installs and configures rcons.dll appropriately for most peoples needs. It is recommended that you try the default fshell
installation first, and only worry about different configurations if you need more flexibility.
Copyright (c) 2007-2010 Accenture. All rights reserved.