This file describes how this PC is set up and how to change its configuration.

Use of the different features of this distribution

libc

The C library used in this version of Etlinux is glibc 2.1. It is compiled as a shared library.

Using the ettcl shell running on the console

The ettclsh interpreter is a version of Tcl-7.6 extended with custom commands. The most interesting commands are uuencode and uudecode, that allow data transfer to/from the disk-on-chip system even when it is not configured on the network.

To send data to the system, call uudecode from your console session. The command reads everything it find on standard input up to an "end" line (i.e., to do nothing just type "end" to stop the command). In order to transfer data, invoke the real uuencode command somewhere else redirecting its output to the serial port. For example, to transfer grep, you can call this command on the computer that is connected to the serial console:


	uuencode /bin/grep /bin/grep > /dev/ttyS0

To receive data from the system, you should enable logging in your terminal program and then use the uuencode command in the console. When it is done, just run the real uudecode command on the log file.

Other interesing commands (or procedures) aviable in the console session are the following:

Init

The version of init included in this system is a Tcl script. It has been developed as part of the EtLinux project in order to run in a 386SX with 2MB of system RAM.

When run, /sbin/init reads the following files and/or directories to configure itself. The next section will describe what services are enabled in the released configuration.

Halt and Reboot

init deals with shutdown as well. From the interactive ettclsh sessions you can invoke the halt and reboot commands. If you want to do it from a telnet session, you can invoke the same two commands but you also need to exit from the session for the action to be effective.

If you have no console access, you can count on shutdown to take 5 seconds.

A telnet server on port 2300

The package ettcl-telnetd-1.0.0 implements a very simple telnet server running on port 2300. It asks no password and give instant root access. Use at your own risk (or build Etlinux without the package).

The web server

A server web is running on the system. It reads data that is stored in /html and is able to execute CGI programs

The SMTP server

A server SMTP is running on the system. Save incoming mail in /var/spool/mail and executes programs sent to command@host.

glib

The glib library used in this version of Etlinux is glib 1.2.6. It is compiled as a shared library.

ORBit

ORBit is an Open Source CORBA implementation.

Contents of this distribution

The distribution is made up of the following pieces:

Enjoy.