Where's the Start Button? Connecting To The Net
Icons and File Management What's a Daemon?
What About Windows? How to Cut and Paste?
Saving Your Configuration Administrator / Superuser / Root
Installing to Hard Drive myDSL - Seamless Extensions for DSL
GNU/Linux & Debian Compatibility How to Print
...and The Store. License.




Where's the Start Button?

The Start Button is just a way to bring up the menu. In DSL,using JWM Window Manager the start button is label DSL and works similiar to Windows. When using Fluxbox Window Manager right click anywhere on the background of the screen. Then navigate the menus as usual. If you decide not to select anything and want the menu to go away, then left click on the background. Right clicking on an icon will bring up a context sensitive menu for icons, mounting, and file management, the object for such menu is shown by an oval and the menu changes based on the objects properties. You can elect to toggle the root menu via the menu selection (DFM for X11 -> Desktop context menu). Enjoy exploring your new system.



Icons and File Management:

Double click icons to start programs or enter/open folders.

>

When using drag and drop it is important to realize that this is Linux and not Windows. Therefore be very aware of the following actions while dragging:

Group icons by either dragging a rectangle around them or clicking each one while holding down the Ctrl key. A prompt box will appear to confirm subsquent action on the group.

For best experience, drag your favorite applications to the desktop. Do this by navigating the APPS folder and then single click to select an object, then while holding down the left button, press and hold the Ctrl key to copy the object to the desktop. Performing a backup/restore will restore your desktop.



Connecting To The Net:

If you have broadband and have a router that assigns your IP via dhcp, then you may already be on the net without having to configure anything.

If you have a dialup modem, or your ISP requires a login, PPPoE then read on. For dialup, select System->Net Setup->dial-up PPP->config. Follow the on-screen prompts and give a name to your setup. Then to dial in select System->Net Setup->dial-up PPP->dial. Enter the name you gave the setup, and the system will dial in. Select hangup when finished. If you have PPPoE, select the DSL/PPPoE menu section. Use pon and connect and poff to disconnect.

For a list of supported wireless cards please see the Wiki wireless card section.



What's A Daemon?

A daemon is a process that provides services in the background; DSL provides several. Navigate to System->Daemons to see the list. There is an SSH server which provides a secure way to login and/or copy files to and from your DSL machine. NFS, network file system allows you to mount directories that may be provided to you from an NFS server. DSL also provides a complete web server (The Monkey Web Server). All the web server files are located in /opt/monkey directory. You need to access it as the super user root.



What About Windows?

DSL includes smbtree and smbclient programs. Smbclient works similar to an FTP program. Windows share name must be specified with the forward slash character "/" even though one usually uses the backslash "\" character.

Use smbtree to display which computer names are available.

Then to connect use:
smbclient //computername/sharename -U username
At the smb: prompt type help. The usual dir, get, put, mget, mput, and exit commands work like an ftp program.

Cut and Paste:

To cut and paste in Linux one simply highlights the text with the left mouse button and then press the middle button to paste. If you have a two button mouse you would paste by pressing the left and right button together. Cutting and pasting takes a little practice, but is very efficient after one gets use to it.



Saving Your Configuration:

After setting up your new system, you will want to save all of your settings. There is a file called /opt/.filetool.lst. It is a simple text file of files and directories listed one per line using a full path that the user wants to save/restore. Use any of the DSL editors to change/update (e.g., select Beaver, then open /opt/.filetool.lst).

The default is to backup the entire home/dsl directory. However, one can choose to selectively backup only certain files. However it is important to note that the entry /opt/.filetool.lst must NOT be removed from the .filetool.lst as this provides for persistence for the .filetool.lst that the user can keep updated as desired.

Also note that the capability now exists to exclude files from the backup with the file /opt/.xfiletool.lst. Adding entires to this file will exclude them from the backup. Cache and other files are in the default /opt/.xfiletool.lst.

Your backup will be automatically searched for and restored during the boot up process. You can override this feature by specifying the device which holds your backup file.

boot: dsl restore=hda2

These options together with a local .xinitrc provide the user with much more control of their preferred environment. For example, by editing the .xinitrc you can start up your favorite X-Windows programs. You can start non-Window programs by editing the .bash_profile and then adding it to your /opt/.filetool.lst. You can even load addiitonal modules and system-specific required files by editing the /opt/bootlocal.sh file and then adding it to your filetool.lst.

Optionally, you can choose the backup device. If you desire to backup to a hard drive, then select Specify Device, e.g. hda2. This will override the automatic detection for users with no usb pen drives or the desire not to use such. Using this option would require the boot up option of

boot: dsl restore=hda2



Administrator / SuperUser / Root:

Each system requires some command to be run as the administrator. In DSL, such user is called root. To get root privileges to run a specific command, just proceed the command with the word sudo (e.g., sudo dsl-hdinstall).
To become the super user, then use the command sudo su. Normally, you should not run your system as root.



Installing to Hard Drive:

Although DSL was designed to be a nomadic LiveCD, especially when run with the "toram" option, many users will insist to install to their hard drives. Be aware that is not the intended use for DSL. Although it is possible to do a debian-type hard drive-installation. Each new version of DSL will require reinstallation. This is not the case with the frugal-type hard drive installs, as they are easily upgradable from version to version.

If you are planning to install and co-exist with Microsoft Windows, then note that these versions will want to write the Master Boot Record (MBR). This may not work well with newer versions of Microsoft Windows.

Frugal Type HD Install:
A "frugal" type install mirrors the operation of the LiveCD. It installs the compressed filesystem and associated boot files onto a pre-prepared partition of your choice on your hard drive.
The frugal install offers you a choice of two bootloaders, lilo or grub.

This method offers many benefits to you over the typical linux hard drive install.

  1. Use of the extension repository for adding applications, which are designed to run in the frugal/liveCD environment.
  2. Much easier upgrade path, without needing to reinstall from scratch.
  3. Use of the 'toram' option, while still operating from a hard drive type device. This offers you the maximum performance in DSL, by running your entire OS in ramspace, but getting the load performance and speed the hard drive offers.(requires 128MB ram)
  4. Most all other boottime options are available to you, like persistant home and opt directories, autoloading of applications, setting fresh passwords, encrypting/decrypting your backups, unique hostname, and autorestore/backup of your personal files and settings at boottime and shutdown.
  5. You can easily revert back to a pristine install condition, and extend this feature to uninstall any extension.
Steps needed:
  1. Create a 50MB Linux partition with cfdisk (ex. hda2 )
  2. Right-click on the desktop, navigate to Apps>>Tools>>Frugal Install, and select your choice of Frugal-Grub or Frugal-Lilo. This will make a ext2 file system and copies the necessary portions of the cd to it.
  3. You can also bootup the DSL CD with the bootcode option " install " , and you will be presented with all the install options in a menu format.
Debian/Traditional Hard Drive Install:
The version supports US language only; it is based on knx-hdinstall. A lot of improvements need to be back-imported from knx-hdinstall.

The hd installation boots with your choice of grub or lilo and feels similiar to the cd version. Meaning, hardware auto detection still runs and pick_your_resolution_in_here pops up...

Steps needed:
  1. Create a 250-300MB Linux partition with cfdisk (ex. hda2 )
  2. Right-click on the desktop, navigate to Apps>>Tools>>Install to Hard Drive.
  3. You can also bootup the LiveCD, with the bootcode option " install " , and you will be presented with an option for creating the hard drive install
  4. Select a premade linux partition (ex. hda2 ). This will make a linux file system and copies the cd to it. You can choose from an ext2 or ext3 type format. A couple of specific changes are made after that (see end of script)
  5. You will be prompted to choose either the lilo or grub bootloaders.
  6. You will be prompted to choose to reboot the computer.

After reboot, the system comes automatically up as booted from cd. You will be prompted to enter a password for root. You must pick a password of at least 5 characters. Then enter it again to verify that it is what you want. Then you will be prompted to do the same procedure for user dsl. Pick a password and enter it then re-enter it. The system will then proceed to a regular login.

This is a minimal install, using busybox for most base utilities. To 'enhance' your install to more closely mirror a true debian system, read below for how-to install the real gnu-utilities and debian apt package management. (recommended)

The hard drive installation scripts should be used at your own risk.



GNU/Linux & Debian Woody Compatibility:

To make your DSL system more fully GNU compatible, from the system menu select Apps->Tools->Upgrade to GNU Utils. This will replace the busybox used in the base system to the full power of the GNU versions, by installing a special system extension named gnu-utils.dsl. Then for a Debian Woody compatiable system, select Apps->Tools->Enable Apt. This option will then allow use the Debian Woody Package Management System and Synaptic, by installing the dsl-dpkg.dsl system extension.




myDSL - Seamless Extensions for Live CD and Frugal Installations of DSL

Now live CD and Frugal users can easily extend DSL without the complicated re-mastering process. myDSL currently offers two ways to extend DSL.

The first method is to separate out the static parts of your /opt/.filetool.lst. A good example is your custom settings of printer, modem, wireless, etc. These entries can easily be separated out into its own myconf.tar.gz. In fact any application that runs on the unmodified liveCD can now be separated out in this fashion.

Your second choice is to download from our community contributed selection of pre-configured DSL applications. These are designated with the .dsl, .uci, .unc, or .tar.gz extension.

The .uci and .unc compressed cloop files. These provide much savings of your ramdisk and "load up" very quickly. Now run OpenOffice on lower resource machines than the ramdisk based .dsl.

Also available is the gnu-utils.dsl module that will allow liveCD users to have access to the full standard GNU Utilites.

All of these types of "modules" or "plugins" can easily be saved onto external media, such as, a hard drive partition, a usb pendrive, or even on the cdrom, just boot DSL with the boot option of mydsl=hda2 The system will automatically make a level 1 directory called mydsl on the specified drive. Upon subsquent booting you do not need to use this boot option. The system will automatically scan for a level 1 mydsl/ directory.

Note: The default boot of DSL without the boot option mydsl=hdXY and without finding an autoscanned mydsl/ directory or if DSL is booted with the "base" option then the MyDSL extensions will be save in the tmp/mydsl directory and will disappear upon reboot.

Note: Unpacked (installed) MyDSL extensions are clickable icons using the extension ".app". These are actually "shortcuts" to allow easy icon access to using the extensions. Important! Do not copy these shortcuts outside of their hosting folder! These shortcuts are dynamically created and need not to be saved.

For rarely used extensions we have the optional directory. Create this directory under the mydsl directory of the cdrom or external media. Place your extensions into this optional directory for those applications that you do not wish to have automatically loaded. These would be the resource intense applications. myDSL will still generate an installation menu for easy installation.

For user created additional modules there is the modules directory. Create this directory under the mydsl directory of the cdrom or external media. Place your modules into this modules directory. All of these additional modules will be loaded (insmod'ed) into the system.

For Debian packages, copy them into the optional directory. Also add the dsl-dpkg.dsl to have the Debian Package Management files restored. Then use the dpkg -i /path_to_deb_package to install under your control. Note: Using deb files will use substantially more of your ramdisk.

Do not store extensions in your home directory. Extensions are large and static, you would only slow down your backup and also likely overrun the capabilites of your backup device. Keep extensions separate from your home directory. Write once, read many!

For extensions that are copied onto external media, the system will autoscan all available devices for the mydsl directory, find, and load your extensions, build your optional menu and load your modules. When you wish to not load any of these extensions you can use the boot option base. Also to skip the autoscan you can specify the location of the extensions by using the boot time option mydsl=hdxy.

For example:
a usb pendrive would use mydsl=sda1
a hard drive partition would use mydsl=hda2

Another option is that you can choose not to use the mydsl directory and make and use a directory with any name you choose. But then you will have to fully specify it with a boot code like mydsl=hda2/my_named_dir.

The best news is that when a new version of DSL comes out, you don't have to do anything to keep your mydsl apps.

By using the mydsl directory the boot process seamlessly restores your favorite apps.The size of your myDSL is your choice, you can have a 64MB, 128MB, 210MB, or even all the way up to 700MB myDSL cdrom. MyDSL is the keystone to DSL. When a new version of DSL comes out, just copy your additional applications to the mydsl directory of the cdrom. There is no more need to redo a custom remaster to get your favorite applications on the live CD -- no more time consuming uncompressing, chroot'ing process, or accidentally making "coasters". There is even a mkmydsl script to help you make your "mydsl" cdrom. The mkmydsl script users your existing mydsl directory and its supplemental subdirectories of optional and modules.


How to Print:

First, configure your printer by selecting System->Printing/lpd->configure a printer. Follow the on-screen prompts to test and install the printer driver. Once installed, you then must start the printing services. Select System->Printing/lpd->start



License:

Damn Small Linux being derived from GNU/Linux, Debian, & Knoppix is also covered by the GPL v2 License. All custom code developed by John Andrews and Robert Shingledecker are therfore also covered by the same GPL v2 License. Any other software contained within, if not specifically stated would also fall under the same such license.

The Store:

If you are a fan of DSL and want to support our efforts consider buying items at our store. All proceeds go back into supporting this project and its developers.


Congratulations! If you are reading this, then you have read the very basics of how to use DSL. If you so desire to remove this help page from initially starting each time you boot, then simply comment out the dillo line in the file .xinitrc This means using any editor in DSL, edit the file .xinitrc and place a # at the beginning of the line starting with the word dillo.