Using Debian GNU/Linux
This basic guide assumes you have already successfully installed Debian GNU/Linux, and have a root and at least one user account (called here user1) with the X server configured.
It is not intended to be a complete guide to using Debian GNU/Linux but rather a brief collection of helpful practical notes to help you to use Debian. This guide will enable you to, among other things, connect to the Internet, and configure proper E-mail facilities using superb packages like Exim and Fetchmail.
The guide assumes that IceWM (a fast, simple and very elegant Window
Manager) is the default X Window Manager - but the notes apply to most
X Window Managers.
Note: for clarity, commands which are typed in (to an xterminal, for example) are given in italics.
When you turn the system on (boot the machine) there will be a brief pause at Lilo boot... and then GNU/Linux will load, with information scrolling down the screen until the xdm graphical prompt is reached which will read:
To login, type either root or user1, press the Return key, then enter the password. Note - passwords when typed on GNU/Linux systems are not echoed/shadowed by ******** as on some Operating Systems. If you make a mistake, you will simply be returned to the login prompt and will need to login again and then enter the password.
When logged in, the default Window Manager will start and you will be presented with a 'desktop' with some icons. You are now ready to use GNU/Linux.
For the IceWM you will find a 'start' button at the bottom left
(Debian 2.1) and then various other icons. To open an Xterminal (or xterm)
left click once on the icon that shows a small computer (it will say XTerm
when you place your cursor over it). The numbers 1,2,3,4 represent the
four virtual desktops available by default, and the xconsole will show
system messages. The window at extreme right shows the CPU Status and can
be very useful for monitoring the system - for instance, if a process is
misbehaving you will be able to spot it here.
The best way to learn is to use GNU/Linux. If you login as, and use, a user account, you can move around the system and discover how things work without doing any damage to the system itself (unlike some other Operating Systems). At the very worst, your X Window will freeze - and you can simply exit by pressing the Control, Alt and Backspace keys. And if ever the system itself seems to you to be frozen, then press Alt and Fx (where x is 2, 3, 4, 5 or 6) and you will open another virtual terminal with a prompt - or, if you are already using an X Window, Control-Alt-Fx which will again bring you to a command prompt.
Xterminals are a powerful feature of GNU/Linux - they give you access to the shell, the 'command line', where you can enter (i.e. type in) commands. Such commands enable you to start processes ('programmes') and interact with your system. A lot of the power and flexibility of GNU/Linux derives from using the shell, and by using it, you can configure and control your system.
When logged in as an ordinary user, there is a special command - su - which allows you access to the root shell (if you know and enter the root password). To use this, open an Xterminal and type su - you will be asked for the root password.
The su command is very useful, and saves logging out as a user
and logging in as root. Be aware, though, that when you are logged in as
root, either directly or when using the su command, it is
possible to cause problems or damage your GNU/Linux Operating System,
especially when editing configuration files.
If you are using Linux for the first time, a good way to find your way around is to use FTE, for which there is an icon in IceWM. However, you may find this a little daunting, as it is also a powerful editor, in which case an icon-based File-Manager may be better. An excellent one is included in Tkdesk - enter tkdesk in an xterm. It is recommended to place a space after this command and then the symbol & after the space. This returns the xterm to a prompt and gives you a PID (process ID) which can be useful (see Top and Kill Commands, below). You can do this with all similar commands which are non-interactive (i.e. which do not require further input).
To add a new user, login/su as root, then type:
where <username> is the name of the user. This will create
a directory for the user in /home and other directories, and you will be
prompted for a full name and then asked to specify a password.
To change the password for a user at any time, login as the user, and type:
You will then be prompted to enter a new password.
You will often need to edit or create files. You must login as root, or (better) use the su command in a user Xterminal. The easiest editor to use is Vim - see the Vim manual page (enter man vim in an Xterminal). To start Vim simply enter
followed by the path to the file you want to edit (e.g. /etc/fstab ).
Vim starts in Command mode - to enter text, press the i key, and then move the cursor to the desired position. When finished editing, press the Escape key (Esc), which brings you back to command mode. To save and exit, you must be in command mode, and enter
where w means 'write' and q, quit. Remember to add the :
symbol also before wq. To delete text, enter command mode - pressing the
x key deletes what is under the cursor.
A command can be a combination of letters, a single letter, a name, or a combination of all these. The basic structure of commands is:
commandname/indicator <flag(s)> <argumentA> <argumentB> ....... <argumentX>
Simple commands consist of just a name or some letters - such as cd. Most simple commands can have a flag and arguments applied to them which can be said to 'refine' the basic command or make it perform a specific function. The flags and arguments for a particular command are given in the man page (manual page) associated with the command - enter man <command> in an xterminal to view the manual. Flags are often preceded by a minus sign, or two minus signs ( --) and the flag is always separated from the command, and the arguments from the flags, by a space. Note that all directories begin with a / and this must be written - e.g. to specify the /home/user1 directory, it must be written with / first.
cd <name> change to the directory <name>. Here, cd is the command, and <name> an argument of the command
ls list the files in the current directory (except hidden ones)
ls -a list all the files in the current directory
create a new directory with the name <name>
The default installation of Debian does not allow you to directly access these drives. To access them you can, as root, or via su, edit the /etc/fstab file and change it to read:
/dev/hda1 / ext2 default,errors=remount-ro 0 1
/dev/hda2 none swap sw 0 0
proc /proc proc defaults 0 0
/dev/hdc /cdrom iso9660 ro,noauto,user 0 0
Note: hda1, hda2 will vary depending on the partitions on your hard drive. hdc is a CD-ROM drive as master on secondary IDE controller.
This will allow users access to both drives.
To access the floppy drive, use the su command, enter the root password, then
When finished, you must unmount the floppy using
Please note the space after mount and before /floppy; and after umount and before /floppy. Such spaces are important when entering commands in GNU/Linux. To mount the CD-ROM drive:
This must also be unmounted when finished with:
To find your hostname (needed for IP and mail configuration - see later) enter
in an xterm. The name is also given in the /etc/hostname file.
Also, as root, run the command ifconfig and it should give you basic
network configuration information.
On Debian, new software should be installed in /usr/local/
To install software from CD-ROM (e.g. Applixware Office) you can mount
the CD-ROM manually from the command line, as root, or use the command
su in a user Xterminal which will bring you to a root prompt. You can
mount /dev/hdc -o ro /cdrom
This will give execute access to the CD-ROM. Alternatively, you could,
as root, change (by adding 'exec') the /etc/fstab file, then change it
back after the install. To do this, change the /dev/hdc /cdrom line to
/dev/hdc /cdrom iso9660 noauto,ro,exec 0 0
Note: It is best to use dselect to install .deb packages to update the
system, either from the supplied CD's or via the Internet using the apt
method of dselect (see below: dselect-apt). You can also use the
excellent apt-get method (see below: Updating Packages).
To logout - e.g. to change from root to user1 and vice versa - either use the Close button after opening the Debian 'start menu' or right click on an empty Desktop area, then click on 'Close'.
If you are using a text console (e.g. the display has frozen and/or you used Ctrl-Alt-Fx ) then to logout - e.g. to change from root to user1 and vice versa - type
It is important to shut GNU/Linux down correctly, otherwise the file system may be damaged. To shut down, login/su as root then type:
shutdown -h now
When you see:
it is safe to turn the system off.
If you just wish to re-boot the system, enter
shutdown -r now
If you are new to GNU/Linux, writing your own configuration scripts to enable your system to connect to the Internet may seem daunting, but it is fairly simple and does not take much time. Once done, and your connection is up and running, you will have a sense of achievement - something you do not get by simply clicking on an icon. You will also have developed a better understanding of how your system - and GNU/Linux - works. You will have completed your first adventure in a new world.
Several web browsers are installed by default - including Mozilla and Amaya [go Programs->Apps->Net]. Amaya is good, but remember that this is still 'beta' software and so may have some 'bugs' - once connected to the Internet, you can download the latest version (currently 2.1 which is good but does not support frames) from ftp://ftp.w3.org/pub/amaya. [Note: For how to install the Amaya file once downloaded, see below. ]
You can also use a text browser such as lynx (see below Using the Lynx Browser), or install Xemacs and the w3 packages (if not already installed) and then use Xemacs for browsing (see below Using Xemacs). Lynx is a very good and much underestimated browser, although it does not show images and does not work with those badly designed image-rich sites whose GNU/Linux unaware designers wrongly and somewhat ignorantly assume everyone uses a MS Internet Explorer type, frames-aware, Java-enhanced browser. Xemacs/W3 is also a good browser and will work with some of these badly designed sites.
Before you start your Internet configuration you will need to have connected
a modem to a serial port (or installed an internal modem) and know:
(1) the telephone number of your ISP
(2) your login name and password
(3) details of the DNS servers - domain name (e.g. dial.pipex.com) and the primary and secondary DNS (e.g. 126.96.36.199)
(4) the port your modem is set on (e.g. ttyS1)
(5) the type of authentication - either CHAP or PAP.
The configuration is divided into two stages, as follows, and is for a 'stand-alone' system with a modem connected to a serial port. It assumes you have set your system, during install, in loopback mode - i.e. you are not on a network and intend to use a modem to connect to your ISP.
The first thing you need to do is install the Apache webserver (using dselect) and then configure it.
Apache configuration is very simple. Once Apache is installed enter, in an xterminal,
and then set the options to those of your system (usually you can accept the defaults).
If Apache still does not work after this, then check the /etc/apache/httpd.conf file. This must have an uncommented line which says:
Server Name localhost
If necessary, remove the # before ServerName and add 'localhost', deleting anything else on that line.
Check also that the file contains:
Then re-run apacheconfig if you have edited the file.
The important configuration files for internet connection on Debian are: (1) /etc/ppp/peers/provider; (2) /etc/ppp/chap-secrets [or pap-secrets]; (3) /etc/resolv.conf; (4) /etc/chatscripts/provider. These are the files you must check and if necessary edit. You should also check the /etc/ppp/options file and make sure that 'lock' (some way down the file) is commented out - place a # in front of it if one is not there.
Under 'debug' you will find the lines you may have to edit. Note: the text in square brackets is not in these files, but notes to inform you what the line means, or what to add/change. For clarity the actual content of the files is given in bold.
/dev/ttySx [Note- change this to the port your modem is on: for example to /dev/ttyS1
115200 [Note:- modem speed. Usually set to this.]
defaultroute [Note:- if this is not present, add]
noipdefault [Note:- if this is not present, add
user <your ISP login name> [Note:- if not present, add followed by a space and then your login name. If your login name has characters e.gUk/zza29 - enclose in ' ' ( e.g. 'UK/zza29' )]
(2) .../chap-secrets [or pap-secrets if PAP is used]
Make sure this contains your ISP login name followed on the same line (after some spaces) by * and then your ISP password, e.g.:
'UK/zza29' * mypassword
[Note: you should add another line below this, exactly the same,
if you enclosed your login name as above, but this time leaving out the
' ' .]
This should be empty (or anything else commented out with #) except for
'Nameserver' should be followed - after some spaces - by first the primary and then the secondary numbers given to you by your ISP (e.g. 188.8.131.52). Thus the line would read: Nameserver 184.108.40.206
" " ATZ
there should be
OK ATDT<number to be dialled>
Note: you might also want to check that the /etc/ppp/peers/provider file has the line:
connect "/usr/sbin/chat -v -f /etc/chatscripts/provider"
Once these files are configured, you can connect to the Internet by opening an Xterminal, entering the su command, and typing
To disconnect, enter
(Note: watch, or open, the Xconsole window, for it will tell you a lot.)
If you have all these scripts configured correctly, and still cannot connect, check the following:
This should contain only one line such as:
127.0.0.1 spacetime localhost
(replace spacetime with the name you have given to your system)
This should contain only:
This should have only:
Also installed on the system is an Internet dial-up utility called WVDial. This is very good, and easy to configure. If not already configured, enter wvdialconf in an xterm. The configuration script is in /etc/wvdial.conf and should be along the following lines, depending on your modem:
Phone = < your ISP telephone number, with no space>
Username = <your ISP username>
Password = <your ISP password>
New PPPD = yes
Modem = /dev/ttySx <replace x with correct number, as above>
Baud = 115200
Init1 = ATZ
Init2 = ATQO V1 E1 SO=O &C1 &D2 S11=55 +FClass=0
You should also have a /etc/ppp/peers/wvdial file which contains only:
To start wvdial - open xterminal, su, and enter
To stop wvdial, the best way is to click on the xterminal where you
entered the wvdial command, then press the Control key and the c key together.
The lynx browser is very fast, and ideal for viewing and retrieving information from the Internet. To start lynx, simply enter lynx in an xterm. Note that if you try to start lynx without being connected to the Internet and it fails to start, returning a message like 'cannot connect' than you have probably specified a URL during install and need to edit the /etc/lynx.cfg file if you want to use lynx off-line. You need to change the Startfile line to read exactly as the Helpfile line below (after the initial Helpfile word), and then restart lynx.
To set your options, enter the single letter o (small letter o ). This allows you to reject/accept cookies, set an editor for html files (such as emacs) and turn the colour setting off (this can make text easier to read). The user mode enables you to disable the bottom two lines of help text.
To fetch a URL, press the g key, then type in the full URL (i.e. with http:// ) then press the Return key. Links are highlighted (if colour mode is off) or in a different colour (if colour mode is on) - to follow a highlighted link, press the right arrow key. To move to another link and highlight it, use the up or down arrow keys. To go back, use the left arrow keys.
To bookmark a URl, press the a key, then choose from the list. To view browsing history, press the backspace key (on most UK keyboards; if this does not work, use the delete key). To download a page, press the d key, then choose from the options.
You can view the html of the viewed page by pressing the \ (forward slash) key - and edit this by pressing the e key (if you have entered an editor in the Options file). You can also view files on the local disk - press g key then enter the local path to the file after entering
You can use lynx for ftp sessions as well. Press the g key then enter
where <ftp server> is the name of the ftp site you wish to connect to - e.g. ftp.debian. org (for help on using ftp - see Using FTP below).
If you want to view pages in a slightly larger format than the default xterm size, then before you start lynx, re-size the xterm window you are going to use, then start lynx.
Sometimes, you may find that you cannot stop a process (or 'program') that you have been running when clicking the 'close/exit' button. To stop the process, you need to know what is called its PID (Process ID).
There are two ways of finding this. First, enter
in an xterminal. The second way is to enter
then the single letter
(for user) followed by your user name. This will show the processess you are running and the PID's. To quit top, simply enter the single letter
To stop - kill - the process enter
If this does not work (and it usually does) enter
kill -9 <PID>
which will certainly terminate the process.
Unless you know what you are doing do not use the kill command when
logged in as root, either directly or via the su command
You should download the tar.gz file into /usr/local (or your home directory - e.g. /home/user1). Make sure you download the Linux Elf 2.1 file.
Then change to that directory by entering:
Then enter the following command to uncompress the file <filename>:
tar -xvzf <filename>.tar.gz
This creates a new Amaya directory within the local directory and unpacks the Amaya files into that directory.
[Note: A tar.gz file is a compressed tarball, and a tarball is basically a collection of files which are bundled together. Here, the command is tar - the option x means uncompress; the option v means verbose - show list of files; the option z extract, and the option f creates and names the folder that the files are extracted into. ]
Change to this new directory (if you wish you can look for it using a File Manager).
To run Amaya, open an Xterminal and simply enter the path:
Currently the full path is:
It is best to create a link to this file from the /usr/local/bin directory which will enable you to just type in 'amaya' in an xterminal. You could also remove the old 1.3 version which is installed by default. To remove the old version, use either the Remove option in dselect or the dpkg purge command (see below under dpkg ).
To create a symlink the easy way, start Tkdesk (enter tkdesk
in an xterm) then using the browser, select the file you wish to make the
link from, then right click, select the Copy option and enter the directory
for the link (usually /usr/local/bin) then click on Link (symbolic) option.
Edit the /etc/X11/window-managers file and place the WM you want as default at the top of the list.
The file for configuration of a particular WM (~/preferences) is in /etc/X11. Thus, for Icewm, the file is /etc/X11/icewm/preferences.
If you wish to configure Icewm then edit the /etc/X11/icewm/preferences file. Anything that can be configured, can be done here.
For example, to remove the clock, simply change
TaskbarShowClock = 0
To set the default appearence, simply edit the
line. For example, if you want Motif as the default,
On Debian, the system searches the pattern given in the /etc/profile file when a command is entered. The default is:
which means /usr/local/bin is searched first for executables (binaries),
then /usr/bin and so on. Thus, if you install programmes, you would
usually install the binary of the programme in /usr/local/bin
To use the apt method of dselect in Debian 2.1 to install packages from the CD-ROM drive, start dselect, then go to Apt and add the following entry to the sources list:
Then go to the packages - e.g. 'slink', 'main'.
Sometimes you may find the CD-ROM drive busy - you may have mounted it as a different user. To find out, enter
fuser -v /cdrom
The default Debian installation boots straight into GNU/Linux without offering a prompt or much of a delay. If you need a prompt, then when LILO boots, press the Alt key which should bring you to a prompt. If this does not work, try the Shift, Ctrl and Alt keys together. However, some users prefer a permanent prompt followed by a set delay so that if necessary certain boot options can be set. This is useful if you need to boot into single user mode, which is a root shell on a console (no X ) - this is necessary on the rare occasions when you need to recover a crashed system or if you need to change monitors and do not wish to boot straight into an X window session (because xdm is configured by default and you need to re-edit the /etc/X11/XF86config file).
To enable a prompt and a delay, as root, edit the /etc/lilo.conf file and add the single word
after vga=normal and before delay=
Then change the delay to 100 (tenths of a second). Save changes, and then as root run the following command which will re-install LILO:
If you need to boot into single user mode, then at the prompt enter
While Netscape can be used for E-mail it is better to use a proper MTA - Mail Transfer Agent. One of the easiest to use and configure is exim which is installed by default. To configure, you need to make sure that your system has a fully qualified domain name. To check, in an xterm enter
It should come back with something like
That is, there will be a dot (.) somewhere. If it comes back with a short name (like spacetime) you need to edit the /etc/hosts file, which will probably say something like
127.0.0.1 spacetime localhost
You need to first decide on a domain name in the form <name.anothername> and change the file to
127.0.0.2 <name.anothername> <name>
Here, the first part of the second line is the fully qualified domain name (long name) you have chosen, and the second part the short, or host, name. Note that <name>in the long name should be the same as <name> in the short name.
Next, you need to as root enter eximconfig in an xterm. Usually Option 2 should be chosen (smarthost with dial-up connection).
Set the visible name to the domain name (it should come up as
the default option). Set the smart host to the smtp server
where you have your ISP account - usually something like smtp.<ISP name>.
For instance - smtp.dial.pipex.com. You should accept the default values
for the rest, and choose a user account for admin when prompted.
You also need to edit the new /etc/exim.conf file so that it reads
local_domains = < short domain name> : localhost
where < short domain name> is the name <name> you entered in the
127.0.0.2 line above.
Next, you need to add several things at the end of the exim.conf file - at the very end of the #Rewrite Config .... section. You need the following entry:
<local user name>@* <ISPusername>@<ISP domain> Ffs
Thus, if your local name on the system is orion, and if your ISP E-mail address is firstname.lastname@example.org then this would be:
orion@* email@example.com Ffs
Note the three letters - Ffs - at the end. F means From-address;
f means from-header; s means sender-header. The entry you make should be
just before the #End of Exim conf....
You can check that all is well by entering the following in an xterm:
telnet localhost 25
This should return something like
220 <hostname> ESMTP Exim 2.05
To quit, enter quit.
The easiest way to use exim is to have or create an account for yourself with the username which is the first part of your provided or chosen ISP E-mail address. For instance, if you have firstname.lastname@example.org as your E-mail address, then create user orion.
To send mail, you need to use a Mail User Agent (MUA) - either elm which is installed by default, or another MUA such as Mutt or Pine. elm is easy to use - just enter elm in an xterm and it will create the folders required. Note that when you are composing a mail, elm drops you into Command mode (see Editing Files as Root above) - press i to enter text, and Esc when finished, etc.
Another good mailer, VM, is included with Xemacs - enter xemacs
an xterm, then from the top menu bar choose Apps, then Read Mail (VM).
To compose, click once on the Compose icon. To send, click on the Mail
option from the top menu bar, then Send. You can also use mail which
is the Unix default - just enter mail in an xterm.
To retrieve mail from your ISP, you can use Fetchmail, which is installed by default. All that needs to be done is create a file, in the home directory of the user, called .fetchmailrc (note the dot - . - before the filename). Thus if the user is orion, this would be in /home/orion. This must be owned by the user, and have the following permissions:
rw- --- ---
(Note: You can use Tkdesk to create the file, and change/set the permissions - click on the Info icon to change/set permissions.)
The .fetchmailrc file should be along the following lines:
set postmaster "<username>"
poll <POP mail server> with proto POP3
user "<POP username>" there with password "<POPpassword>" is <username> here
This assumes POP3 protocol is being used. The username is the username on the localhost, the POP mail server the ISP mail server domain name (e.g. pop.dial.pipex.com); and the POP username your ISP/mail username. Postmaster, POP username, and POP password should be enclosed in quotes (".......").
To run fetchmail, connect to the ISP, enter fetchmail in an xterm and it will collect and deliver your mail to /var/spool/mail/<username> where it can be read by elm or any other MUA.
Many options can be entered in the .fetchmailrc file - see the documentation in /usr/doc/fetchmail. For instance, you can set a logfile (e.g. /var/log/fetchmail.log), set a daemon to poll for mail at regular intervals, and poll several mail accounts.
Also, if you have multiple accounts on one POP server, and another account on another POP server, you should create a root .fetchmailrc (in /root) which is like this:
set postmaster "postmaster"
poll pop <POP mail server> with proto POP3
user <POP username1> there with password <POPpasswd1> is <username> here
user <POP username2> there with password <POPpasswd2> is <username> here
poll pop <POP mail server2> with proto POP3
user <POP username3> there with password <POPpasswd3> is <username> here
You can then su, and run fetchmail which will poll the different accounts and deliver the mail to the correct users. When fetchmail exits it issues an exit code - the normal (error free) ones are 0 (mail retrieved) and 1 (no mail on server). If you want to see what fetchmail is doing, start fetchmail with the flag -v thus:
You can also adapt the sample fetchmail-up and fetchmail-down
given in /usr/doc/fetchmail, adding them to /etc/ppp/ip-up.d
to run and quit fetchmail when you connect/disconnect to your ISP.
Xemacs (a variant of the original GNU emacs) is a fully-featured environment which enables you, among many other things, to create, edit and spell-check text and html files; read, compose and send E-mail and, via W3, browse the Internet.
When you start Xemacs (and emacs) you will see two buffers - the main, larger, one ('scratch') and a mini-buffer at the bottom where commands appear and where commands can be entered. The basis of both emacs (and thus Xemacs) is the buffer - which is basically a 'container' which contains whatever you are working on, such as a file. It is possible to have many buffers open at the same time, and also have buffers open which are doing different things so that, for example, you can edit a file in one buffer, read and compose E-mail in another buffer, and browse the Internet in another one. As an editor, emacs/Xemacs has a very useful multiple undelete.
To open a file, click on the Open icon, then place the cursor over the directory or file that you want, left click once, then press the Return key. This will load the file - if it is a html file, it will open in html (code mode) and you will find a HTML icon on the menu which will allow you to view it in a browser.
To close the file, go to File menu, then Delete Buffer <file-name>. To create a new file, press the Control and x keys at the same time, then the Control and f keys and enter the path and file name in the mini-buffer at the bottom (where it will say find file). If you specify a htm or html extensio, a new html file will be created, with the html doc tags already inserted.
If you ever find that you seem to be 'hung' in a buffer and that
whatever you do you just get an error beep, press Control and the g key
together which will cancel whatever operation you may have started.
It is possible to set security levels when using W3 to browse the Internet. To start W3, from the Apps menu, go Browse the Web. To set your level, choose Preferences from the Edit menu, then Url, then Privacy level. Once there, place the cursor over the Value in [ ] brackets and right click. This will open a menu, and choose the level you require. Then click Save, then Done.
To set the default option (blank page/home page etc.) go Edit Preferences from the Options menus. Change, then save and exit. To fetch a URL, either press the Control and o keys at the same time, or from the File menu choose Open location. Then enter the URL you want in the mini-buffer at the bottom and press Return. If you have set the blank page option then when you start a new Browse session from xemacs you will find the main scratch buffer still open while the mini-buffer inserts the beginning of a URL - just enter the URL required and press Return.
Note than when using W3 to follow a link, place the cursor over the
link, then press the return key.
To start a ftp session, connect to your ISP, then enter, in an xterm (or switch to a text console)
followed by the ftp server you wish to connect to. For instance, for ftp.tripod.com it would be
When connected, you will be asked to login and provide a password. For
anonymous ftp, the login name is anonymous, and the password your E-mail
address. You will then get the ftp prompt:
To view files in directories, use the cd (change directory) command, then ls (list files).
When downloading files, make sure that if you are downloading binary (programme) files you are in binary mode - to make sure, at the ftp prompt enter
To retrieve text files, enter
To download, enter
get <remote file-name>
If you wish to upload a file:
put <localfile path and name>
If you want to upload a file and change its name:
send <local file name> <new remote file name>
It is useful to see download/upload progress - to do this, before you download/upload, enter the command
which prints to screen a # character for every 1024 bytes which are downloaded/uploaded.
To get several files use the mget command followed by a list of the files. To upload several files, the command is mput.
To quit, enter quit.
If you have several ISP accounts it is possible to configure Debian so that you can connect using
pon <ISP name>
1) You need to create a new file in /etc/ppp/peers and name it something like the name of your ISP - e.g. pipex. Then change the permissions (using Tkdesk is the easy way) to be
rw- r-- ---
The owner should be root and the group dip.
Copy over the the contents of the etc/ppp/provider file and then change only the user and the last part of the connect line. Change this last part from provider to the name you have given to the new file - e.g.. pipex.
2) Add the numbers of the ISP nameserver to the /etc/resolv.conf file, under the ones already there and in the same format.
3) Add your ISP name and password to the /etc/ppp/chap-secrets (or pap-secrets) file in the same format as those already there.
4) Create a new file in /etc/chatscripts/ and name it as in (1) - e.g. pipex. Copy over the contents of the /etc/chatscripts/provider file and change the telephone number to that of your ISP. Change the permissions etc. as you did for (1).
To connect to this ISP simply enter pon <name> - for example,
Disconnect in the usual way with poff.
Install eximon from the Slink CD's to graphically monitor exim.
To delete a message in the queue, and log this, enter
exim -Mg <message ID>
An ID will be similar to - 11iM3D-000cR-00. (Note: the g in the command stands for "give-up".)
To delete a message without any log entry:
exim -Mrm <message ID>
If you have changed the config file, enter the following to re-start exim with the new configuration
killall SIGHUP exim
In the re-write configuration section you can add r to
the Ffs options to re-write the Reply-to header.
When using dselect the following points might be helpful:
1) After placing a disc in the CD-ROM drive, wait until the drive light goes out/disc stops spinning before pressing the 'Enter'/Return key;
2) After selecting the install method from Access always run Update before selecting any packages.
To remove a package:
dpkg -r <package name>
To purge a package (the best way to remove as it removes the config files)
dpkg --purge <package name>
To report the status of a package
dpkg -s <package name>
If you wish to install Netscape the best way is to install the Debian Netscape installation package from the Slink CD's, then either fetch the Netscape tar.gz file via ftp, or copy it from a CD. Note: You can quit dselect, and ignore the error message about Netscape
The binary should copied to /tmp and it should be the x86 glibc2* version. After having copied the tar.gz file to /tmp you can then run Configure in dselect which will install Netscape.
The following should be noted when using Netscape:
(1) There are many bugs in Netscape - some to do with Java - so you
may find that Netscape sometimes crashes, does odd things, or not work
(2) If you have problems with Netscape, try disabling Java (Go 'Preferences' from the Edit menu).
(3) Netscape is not free software, and so therefore cannot be copied as the rest of the Debian packages can.
(4) There are GNU Copyleft browsers available such as Lynx, Xemacs-W3 and Amaya.
If others have access to the system it is important to enter a password in the /etc/lilo.conf file to prevent them gaining access to the root shell by entering commands at the LILO boot prompt. This facility is useful if you wish to debug/restore a crashed system or you have lost the root password (see below) but it is good security to set a password so only you can use this facility.
Password settings can be either general, to apply to the images booted,
or restricted, to apply when a boot prompt is requested through key presses
(usually the Alt key - see Part I). This is usually what is needed. Passwords
are case-sensitive. The following example /etc/lilo.conf file has
a restricted password setting:
The file should already be owned by root, and belong to group root, but you must change the permissions to
rw- --- ---
(Note: If you wish to make your system even more secure you should enter
a BIOS password, enable booting from hard disk only in BIOS, and disable
user access for both floppy and CD-ROM drives by removing them from the
which will bring you to a shell (console - no X). Then enter:
mount -n -o remount, rw /dev/hda(x)
[ Note: hda(x) is usually hda1 - where the root partition is. ] This re-mounts the filesystem read-write. Then enter
This starts the vi editor and loads the /etc/shadow file.
Then remove the password string for root (which is between the first and second colons - that is, between : ). Then save and quit (that is, :wq) then enter
Then wait a few moments and enter
You can then login as root without a password and set a new root password.
Note: sync writes the data in a buffer to disc - if you omit this,
you will find that your changes were not written to disc and you are back
where you started.
# Accelerated Servers
DefaultColorDepth <8, 16, 32>
Depth < >
You need to enter the depth you want after DefaultColorDepth. Note - there may be just a value here, such as 8. If so, enter DefaultColorDepth followed by the value.
The best way is to use the excellent apt-get method. It is necessary to add the source of the updated .deb packages you wish to install to the /etc/apt/sources.list file. Note: you need the http or ftp source of the updated .deb packages and make sure you copy the source address exactly or apt-get will return an error mesasage. For the sources of .debs try the Debian web-site (http://www.debian.org/).
You then need to connect to the Net, and run
After downloading, apt-get automatically unpacks the packages and installs them. To install an individual package, add the source to the apt sources file then enter
apt-get install <package name>
Copyright 1999 by Muhammad Yusuf.
This work may be freely distributed and freely republished in any format without any prior notification being required, provided the above copyright and this free distribution notice are added either at the beginning or the end of the distributed/published document.
There is no warranty or guarantee of any kind offered or implied in or by this work.