FREESCO 027 Package Howto

Principle of packages

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.

Package commands

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.:


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.

How do I install a package ?

Packages are installed using the installpkg command. Say you wanted to install the ftp package from the official Freesco site. You would type:

installpkg ftp

The following screen then appears:

Now downloading the install script for ftp from the freesco site... (0K) [########################] 0K | 204.42K/s
857 bytes transferred in 0.01 sec (109.69k/sec)
Do you want to view the install script before executing it [y/n]?

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 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).

How do I remove a package ?

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:

removepkg ftp

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.

freesco/howtos/packages_027.txt (146830 views) · Last modified: 2005/09/14 00:49 (external edit)
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki