release.txt

一个symbian下的tcp连接的客户端/服务器源代码

Minimal TCP/IP Application
2/8/99
V 1.0

A Client-Server pair of EIKON applications, TCP_CLI.APP and TCP_SVR.APP, demonstrate how
to use the TCP/IP capabilities of EPOC (both ER3 and ER5).
These two applications are intended to be run on the same machine (or emulator) and
communicate through the 'loopback' IP address (KInetAddrLoop).

Building the applications
-------------------------
Unzip the source files into your root directory using the full folder names stored in the
zip. This will place the projects in c:\epoc_trn\tcpc_sol and c:\epoc_trn\tcps_sol.
Use makmake to make suitable make files. For example to generate a workspace for
Microsoft Visual C++ v5 use,
	makmake tcp_srv vc5
	makmake tcp_cli vc5
and to generate makefiles for MARM targets use
	makmake tcp_srv marm
	makmake tcp_cli marm
Compile the resources using
	eikrs tcp_cli sc
	eikrs tcp_srv sc
For VC5, compile the main code within the developer studio and for MARM use
	nmake /f tcp_srv.marm
	nmake /f tcp_cli.marm
For MARM builds, create sub-directories TCP_CLI and TCP_SRV under system\apps.
Copy tcp_cli.app and tcp_cli.rsc to system\apps\tcp_cli. Similarly copy tcp_srv.app
and tcp_srv.rsc to system\apps\tcp_srv. The two apps should then appear on the Extras Bar.

Running the applications
------------------------
After compiling, both apps should appear on the extras bar of the Series 5/emulator.
Start tcp_svr.app and then return to the extras bar to start tcp_cli.app. Click on the
file list button (top right) to switch between client and server.
Press the 'Start' button of the tcp_srv toolbar to start listening for an incoming TCP/IP connection.
Switch to tcp_cli, press the 'Start' toolbar button there and you will see that a connection
is made, data transferred and the connection closed. If you now return to the Server, you will
see corresponding notifications indicating the progress of the transaction.

Things to try
-----------------
Since a loopback address (KInetAddrLoop) is specified in tcp_clie.cpp, EPOC sub-system NIFMAN is able
to resolve the IP address locally and therefore the Dial-Up connection dialog is not required.
Specify a different IP address instead of localLoop and you will see the dial-up connection dialog
launch automatically.

It is possible for tcp_cli.app to communicate with a PC running appropriate TCP/IP software.
Additionally, the data sent by the client application is the string "GET" which is a valid HTTP command.
So, for example, you could use a Series 5(mx) to connect to a PC running a HTTP server using NT RAS. There
are various resources on the web describing how to configure NT RAS for use with the Series 5(mx).
If you do attempt connecting to a PC based server, ensure that the Remote Link on the Series 5(mx) is
turned off and PsiWin is closed.