Packages are small self-contained programs that come ready-compiled for use on a Freesco machine. Packages provide an easy and fast way to install and uninstall extra components onto a Freesco machine. They are intended to make it easy to add extra facilities (everything from text editors to Perl interpreters, new drivers to network statistics) to a Freesco machine quickly, easily and simply. Normally, all packages are pre-configured and can be used by even a novice user without need of specialist knowledge.
There are a number of official packages and also many third-party packages. See our Programs & Packages section for more details.
There are several commands used within Freesco for installing and removing packages. These can be run from the Freesco machine or over a telnet connection.
First, we need to find a package to install for which there is the listpkg command, which shows which packages are available from a particular site. If you type:
Freesco will look on the official Freesco site and show you a list of all the currently available "official" packages (for which you must be connected to the Internet, obviously). Each package has a name and a short description, e.g.:
ftp - Standard linux/unix ftp program.
You can also list the packages on sites other than the official Freesco site by giving the listpkg command the address, e.g.:
listpkg http://www.fromscratch.org.uk/This will list all of the packages available from this site.
Next, once you have a chosen a package to install, you need to install it.
Packages are installed using the installpkg command. Say you wanted to install the ftp package from the official Freesco site. You would type:
The following screen then appears:
You've now downloaded the install script and now need to run it. Freesco asks if you wish to view the install script before running it (a sensible precaution if you do not trust the script (i.e. package) author and understand shell scripts). If so press Y and then Enter and you will see the script, which you can check for unscrupulous commands.
If you trust the script (i.e. package) author, press N and then Enter. You are now asked:Continue installing [y/n]?
If you are sure you want to install the package, press Y then enter, else press N then Enter.
If you do install the package, it will go off and download it and install it and (hopefully) configure itself for you, although this may take a long time if you install a large package over a slow connection.
Once it is done, the package is then installed and ready for use (usually). Make sure to read all instructions concerning the package, in it's description, on the author's website and in the installation process.
To install a package from a site other than the official Freesco site, say wapr's las package, you would type:
The http://www.freesco.info/freesco.org/~wapr/ is the path to the packages (where you would listpkg to see the list of wapr's packages). The las is the package name (as stated in the listpkg description).
Typing the command:
will display a list of packages which can be automatically removed. To remove a specific package from this list, say ftp, use this command:
You will be asked if you are sure and if you answer Y, the package will be removed. You may need to reboot your router after this to ensure correct operation.
If your package does not appear on this list, the package author has
not provided you a way to automatically remove the package and this needs
to be done so manually.
A package consists of two files, a .tgz archive and a .sh install script. For example, a package named joystick from www.somehost.com is actually the two files:
Thus, downloading these links will give you the complete package so that you can place it on your own website or on a local network web server (such as Freesco's own web server).
For completeness, the list of packages seen when using listpkg is actually just a plain text file which is manually kept synchronised with available packages. E.g.
actually just displays the file:
Once you have downloaded all the appropriate packages and the package list, copying them to a directory which you can access using a normal web browser, either on a proper web server on the web or a local intranet web server, or even the Freesco machine itself (if you enabled the Public HTTP server or Admin server and placed the appropriate files in the /www or /wwa directory respectively) you can then just listpkg and installpkg as normal.
Say you copied your favourite packages to a machine called router on your network which is running a webserver where the files are visible in the /packages directory of the website. Then:
will display the packages.txt file from that location and:
will install the package called firstpackage.
Please note: There appear to be problems accessing Freesco's internal webserver from the machine itself. Hence, if you have enabled the Public HTTP server on Freesco and copied your mirror packages into /www, listpkg and installpkg may or may not work depending on how you access the computer.
Using listpkg nnn.nnn.nnn.nnn (where nnn.nnn.nnn.nnn is the network IP address of the machine) or listpkg networkname (where networkname is the machine's network name) may or may not work. If it does not, usually the problem can be resolved using listpkg 127.0.0.1 or listpkg localhost instead of the usual syntax. Similar changes apply to the installpkg command.
There is an official HOWTO for this, which can be found on our Official HOWTO's page.
Er... not to put too fine a point on it... Tough. Read our Third Party Disclaimer. Blame the package author.