cdt/rse/examples/org.eclipse.rse.examples.daytime

Readme for RSE Daytime Example
------------------------------

The Daytime Example shows how a new subsystem (daytime) is contributed
to RSE, and how an existing subsystem (ftp) is configured for a system
type. The example is mainly meant for developer's educational use,
it does not have much user value: the Daytime Subsystem retrieves 
the current time of day from a remote host via TCP port 13.

__Requirements:__
The Daytime example has been tested with with RSE M1 candidate
(CVS HEAD as of April 25, 2006) and Eclipse 3.2 RC1.

__Installation:__
You need an Eclipse PDE Workspace with RSE.
Then, choose File > Import > Existing Projects > Archive File,
to import the example archive.

__Usage:__
The daytime service must be enabled on the remote system (see below).
* Start RSE, create a new system of type "FTP-Daytime".
* Select the Daytime Subsystem and choose Contextmenu > Connect.
* Enter any username and password (this is not checked).
* Select the Daytime Subsystem and choose Refresh, or Contextmenu > Monitor.
* Enable polling in the remote monitor, you can see the time advance.

__Programmer's documentation:__
The interesting part of this example is in package 
   org.eclipse.rse.examples.daytime.model
where you see how the daytime node is added to the RSE tree through an
AbstractSystemViewAdapter. The DaytimeService is rather simple, since
queries are fast enough to use a connectionless service.

__Known Issues:__
* Entering Username and Password should not be required.
* Manual Refresh after connect should not be required.
* When something goes wrong during connect, the error message 
  does not give enough information about the cause of the error.
* The example defines a Service for its task; there might be 
  applications where this is not required or desired. A simpler 
  example should be provided that only defines a Subsystem but
  no Service, ConnectorService or ConnectorServiceManager.

__Enabling the Daytime Service on a Remote Host:__
In order for the example to work, the service on TCP port 13 must be 
activated on the host as follows:
* On Linux or other xinetd based UNIX systems, edit /etc/xinetd.d/daytime
  and set "disable=no", then restart (kill -HUP) xinetd
* On Solaris or other inetd based UNIX systmes, edit /etc/inetd.conf
  and make sure the following line is there:
     daytime stream tcp nowait root internal
  the kill -HUP inetd.
* On Windows/Cygwin, with xinetd installed, edit config
  files like described for Linux, then start xinetd.exe