Manual & Help 2004 - 2007 Russell Phillips

ClamWin program code 2004 - 2007 ClamWin Development eam

!pdated to ClamWin "ree #ntivirus 0$%0$2$&
'''$clam'in$com
Table of Contents
(ntroduction$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ )
(nstallation (nstructions$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 4
Con*iguration$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+
,eneral$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+
"ilters$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ -
(nternet !pdates$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 7
Pro./$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 0
1cheduled 1cans$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ %
2mail #lerts$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &0
#rchives$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &&
"ile 3ocations$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &2
Reports$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &)
2mail 1canning$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &4
#dvanced$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &4
!sage$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &-
Run *rom the 1tart Menu$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &-
Run *rom the s/stem tra/ icon$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &-
1cheduled 1cans$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &7
M1 4utloo5 (ntegration$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &7
Windo's 2.plorer (ntegration$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$&7
#dvanced 4peration$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &0
Modi*/ing ClamWin6s De*ault Con*iguration$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &0
Running a 7irus 1can *rom the Command 3ine$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$&0
!pdating the 7irus Data8ase *rom the Command 3ine$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &0
,etting !pdates *rom a 3ocal 1erver$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ &%
Manuall/ !pdating the 7irus Data8ase$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$&%
"#9: "re;uentl/ #s5ed 9uestions$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 20
rou8leshooting$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$2&
#ppendi. # : Ho' to Run ClamWin *rom CD or !1<$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$2)
!sing the CD=!1<$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$2+
#ppendi. < : ,>! ,2>2R#3 P!<3(C 3(C2>12$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$2-
Introduction
ClamWin is a graphical *ront-end to the Clam#7 anti-virus so*t'are that runs on Microso*t
Windo's$ #n eas/ to use installer program is provided$
"eatures include:
1cheduler - set up scans to run at a de*ined time
#utomatic virus data8ase updates via the (nternet
#utomatic noti*ications o* ne' ClamWin releases
1tandalone virus scanner
1canning o* programs that are loaded in memor/
Conte.t menu integration to Microso*t Windo's 2.plorer - right clic5 on a *ile to scan it
Microso*t 4utloo5 add-in to scan incoming and outgoing e-mails
Please note that ClamWin #ntivirus does not include an on-access real-time scanner? that is? /ou
need to manuall/ scan a *ile in order to detect a virus$ he Microso*t 4utloo5 add-in? ho'ever? 'ill
delete a virus-in*ected attachment automaticall/? 'ithout an/ intervention *rom the user$
Installation Instructions
Do'nload the latest installer *rom '''$clam'in$com$ Close all running programs @especiall/
4utloo5 and ClamWinA? then dou8le-clic5 on the do'nloaded *ile to run it$ (* /ou alread/ have a
cop/ o* ClamWin installed? /ou can upgrade it 8/ simpl/ running the installer *or a later version?
and installing on top o* the e.isting version$
#*ter clic5ing Next on the initial screen? the licence terms 'ill 8e displa/ed$ his program is
released under the ,>! ,eneral Pu8lic 3icense$ Bou must agree to the terms o* this licence to use
this program$ he installation program 'ill also install 8inar/ *iles *rom Clam #nti-7irus
@'''$clamav$netA? 'hich is also distri8uted under the ,>! ,eneral Pu8lic 3icense$
4n the ne.t screen the installer 'ill as5 /ou 'hether /ou 'ant to ma5e ClamWin availa8le to ever/
user o* the computer? or Cust to /oursel*$ he recommended setting here is D#n/one 'ho uses this
computerE$
>e.t? /ou 'ill 8e as5ed 'here /ou 'ould li5e ClamWin to 8e installed$ he de*ault option is
sensi8le? and /ou should onl/ change it i* /ou have a particular reason to do so$
>e.t? /ou 'ill 8e as5ed 'hich parts o* the program to install$
'o selections @Clam#7 "iles and ClamWin "ilesA are gre/ed out and cannot 8e de-selected$ his
is 8ecause these *iles are essential *or the program6s correct operation$ he other options are as
*ollo's:
Integration with Windows Explorer: (* this option is selected? an e.tra option is added to
Windo's 2.plorer6s right-clic5 menu? allo'ing *iles to 8e scanned ;uic5l/ and easil/$
Integration with Microsoft Outlook: (* this option is selected? and i* Microso*t 4utloo5 is
installed? an 4utloo5 add-in 'ill 8e installed? 'hich 'ill chec5 all incoming and outgoing e-mails
*or viruses automaticall/$ >ote that this option 'ill onl/ appear i* Microso*t 4utloo5 @not M1
4utloo5 2.pressA is installed$
International Help Files: his section has su8-sections *or di**erent languages$ #lthough
ClamWin is not /et availa8le in localised versions? mem8ers o* the communit/ have provided
translations o* the help *iles and=or manual$ 1electing the relevant languages in this section 'ill
install these translated help *iles=manuals$
>e.t? /ou 'ill 8e as5ed 'hich 1tart Menu *older ClamWin6s icons should 8e placed in$ </ de*ault?
a ne' *older named ClamWin Antiirus 'ill 8e created? and the icons placed in that$
he ne.t screen as5s i* /ou 'ould li5e to do'nload virus data8ase *iles as soon as the program is
installed$ (t is a good idea to update the virus data8ase *iles as soon as possi8le$ >ote ho'ever that
i* /ou connect to the internet using a pro./? /ou should *irst con*igure the pro./ settings 8e*ore /ou
can do'nload the updates? so /ou 'ill need to do this at a later stage$
his screen also gives /ou the option to have a shortcut icon placed on the des5top$
he last screen displa/s a summar/ o* the options that have 8een selected$ o install ClamWin 'ith
the selected options? clic5 Install$ o go 8ac5 and change some options? clic5 ! "ack$
(* /ou selected #ownload $irus #ata%ase Files? this 'ill 8e done once the program is installed$
Bou 'ill need to 8e connected to the (nternet$
Configuration
o con*igure ClamWin? either right-clic5 on the s/stem tra/ icon and select Configure ClamWin?
or? *rom the main program 'indo'? select &references *rom the 'ools menu$ # dialogue 'ith
eleven ta8s 'ill 8e displa/ed @i* /ou do not have the Microso*t add-in installed? the ta8 D2mail
1canningE 'ill not 8e displa/edA$ Clic5ing O( 'ill close the dialogue 8o. and save an/ changes
made$ Clic5ing Cancel 'ill close the dialogue 8o. 'ithout saving an/ changes$
2ach o* the ta8s is discussed 8elo'$
General
his ta8 has options that control ClamWin6s 8ehaviour 'hen scanning? and 'hat ClamWin should
do a8out in*ected *iles$ he )canning Options control ClamWin6s 8ehaviour 'hen scanning$ #n/
com8ination o* options can 8e selected$ he options are as *ollo's:
#ispla* Infected Files Onl*+ When ClamWin is running a scan? it displa/s the names o* the *iles
as it scans them$ (* this option is selected? ClamWin 'ill onl/ displa/ the names o* *iles that have
8een detected as in*ected$ 1electing this option ma/ slightl/ increase scanning speed$
)can In )u%directories+ 1elect this option to have ClamWin scan su8directories as 'ell as the
director/ speci*ied$
#ispla* File )canned , &rogress Indicator+ (* this option is selected? ClamWin 'ill displa/ the
name o* the *ile that is at that moment 8eing scanned? 'ith the progress in percentages 8et'een
8rac5ets$ "or archives? a rotating line 'ill 8e sho'n? indicating the scan is proceeding$
he Infected Files options control determine 'hat action ClamWin should ta5e i* it detects a virus$
4nl/ one option can 8e selected$ he options are:
-eport Onl*+ (* this option is selected? ClamWin onl/ reports that a virus 'as *ound$
-emoe ./se Carefull*0+ (* this option is selected? ClamWin 'ill permanently delete the in*ected
*ile$ he *ile 'ill not 8e placed in Windo's6 Rec/cle <in$
Moe 'o 1uarantine Folder+ (* this option is selected? ClamWin 'ill move the in*ected *ile to the
designated *older$ o change the *older? enter the path in the te.t 8o.? or clic5 on the 222 8utton to
8ro'se to a *older$
(* a *ile 'ith the same name is alread/ present in the ;uarantine *older? then ClamWin 'ill append a
dot *ollo'ed 8/ a num8er to the ne' *ile? to avoid over-'riting the e.isting *ile$ 2$g$ i* a *ile named
eicar.com is in the ;uarantine *older? and a virus is *ound in a *ile named eicar.com? then the
second cop/ 'ill 8e moved to the ;uarantine *older and renamed to eicar.com.000? a third
cop/ 'ould 8e moved and renamed to eicar.com.001? etc$
"inall/? the /nload Infected &rograms from Computer Memor* option determines 'hether
ClamWin should tr/ to unload a *ile *rom memor/? i* it detects it to 8e in*ected 'hile per*orming a
memor/ scan$ his is necessar/ to success*ull/ ;uarantine such a *ile$
Filters
4n this ta8? ClamWin can 8e con*igured to scan onl/ certain t/pes o* *iles? or to ignore certain t/pes
o* *iles$ he t'o can 8e com8ined to give greater control over 'hat t/pes o* *iles are scanned$
1peci*ic *iles can 8e *iltered 8/ speci*/ing the *ull path? e$g$:
C:\Path\to\folder\File.ext
"olders can 8e *iltered 8/ speci*/ing the path? and including a F at the end? e$g$:
C:\Path\to\folder\*
Note that * will not match \, so if you want to include or exclude a folder with all sub-folders
you need to use a regular expression syntax and add .* (dot star) at the end
<C:\\Path\\to\\folder\\.*>
!egular expressions are enclosed in "# tags and \\ is needed because \ is a reser$ed
character.
Regular e.pressions can 8e used *or greater *le.i8ilit/? 8ut must 8e contained 'ithin angle 8rac5ets
@GRegular2.pressionHA$ (n*ormation a8out regular e.pressions? including tutorials? are readil/
availa8le on the 'e8$ Iust use /our *avourite search engine to search *or regular expression
tutorial$
</ de*ault? the *ollo'ing patterns are e.cluded *rom virus scans:
F$d8. @used 8/ Microso*t 4utloo5 2.press to store e-mails etc$A
F$t88 @used 8/ Ritla8s he <atJ to store e-mails etc$A
F$pst @used 8/ Microso*t 4utloo5 to store dataA
F$dat
F$log
F$evt
F$ns*
F$nt*
F$chm @Windo's help *ilesA
Internet Updates
4n this ta8? /ou can control ho' ClamWin gets updates to the virus data8ase$
Ena%le Automatic $irus #ata%ase /pdates+ When this option is selected? then ClamWin 'ill
automaticall/ chec5 *or and do'nload data8ase updates$ Ho' o*ten it chec5s and at 'hat time can
8e set 8/ the user$
(* ClamWin is not running @or the computer is s'itched o**A at the time speci*ied? the update 'ill 8e
applied the ne.t time ClamWin is started @'hich 'ill normall/ 8e the ne.t time the computer is
s'itched onA$ he onl/ e.ception is i* the update *re;uenc/ is set to K'or5da/sK? in 'hich case it
'on6t do an/thing until Monda/$
he address o* the server to 8e ;ueried can 8e set manuall/$ Most users 'ill 'ant to leave this at the
de*ault setting @data8ase$clamav$netA$ Ho'ever? i* /ou have a local server that mirrors
data8ase$clamav$net? /ou can enter its address instead$ "or a list o* mirrors? chec5 out
http:=='''$clamav$net$
Warn if $irus data%ase is Out of #ate+ (* this option is selected? ClamWin 'ill 'arn /ou 'hen
/our data8ase is not actual an/more$
/pdate $irus #ata%ase On 3ogon+ (* this option is selected? ClamWin 'ill chec5 *or data8ase
updates 'hen a user logs on to the PC$
Notif* A%out New ClamWin -eleases+ (* this option is selected? ClamWin 'ill chec5 *or ne'
releases$ his chec5 is run *ive minutes a*ter startup o* ClamWin? and ever/ 24 hours a*ter that$
Proxy
(* /ou connect to the (nternet via a pro./ server? enter the details on this ta8$ (* not? leave the details
8lan5$ Most users do not use a pro./ server? and so can sa*el/ ignore this ta8$
Scheduled Scans
his ta8 allo's the user to con*igure ClamWin to run scans at certain times$ Details o* scheduled
scans are displa/ed$ o add a scan? clic5 the Add 8utton? then set the description? *re;uenc/? time?
and *older to scan$
#n e.isting scheduled scan can 8e changed 8/ clic5ing the Edit 8utton? or removed 8/ clic5ing the
-emoe 8utton$
1cheduled scans can 8e activated or deactivated 8/ clic5ing on the appropriate 8utton$ #
deactivated scan 'ill not run at the scheduled time$
Email Alerts
o have ClamWin send an e-mail report 'hen a virus is detected? chec5 the )end Email Alert On
$irus #etection option$ "ill in the details *or /our 1MP server? and the details *or the message
@su8Cect? *rom address? to addressA$
>ote: some 1MP servers do not re;uire a user name & pass'ord$ (* this is the case? leave these
settings 8lan5$
o test the settings? clic5 the )end 'est Email 8utton$
When this option is selected? ClamWin 'ill send an e-mail report 'henever a virus is *ound$ his e-
mail 'ill include the name o* the computer that the e-mail 'as sent *rom? and a cop/ o* the scan
log$
Archives
ClamWin can chec5 the *iles in archive *iles @such as $Lip *ilesA *or viruses$
his ta8 allo's the user to select 'hether or not ClamWin should chec5 inside archive *iles? and set
the ma.imum siLe o* archive *iles to 8e chec5ed? the ma.imum num8er o* *iles to 8e e.tracted? and
the ma.imum num8er o* su8-archives to 8e e.tracted$
(t should 8e noted that scanning 'ithin archives can slo' do'n a scan? so disa8ling scanning o*
archives ma/ reduce the time ta5en *or a scan to complete$
File Locations
his ta8 allo's the locations o* the Clam1can program *ile? "reshClam program *ile @the program
used to retrieve data8ase updatesA and the virus data8ase to 8e altered$
hese values are set during installation? and should not normall/ need to 8e altered$ Do not change
these settings unless you know what you are doing$ (* the/ are incorrectl/ set? ClamWin 'ill stop
'or5ing$
Reports
his ta8 allo's the user to change the location & name o* the log *iles$ Most users 'ill not need to
change these settings$
Bou can also ena8le or disa8le the displa/ o* pop-up noti*ication messages on this ta8$ </ de*ault?
such messages are ena8led$ !nchec5ing the #ispla* &op4up Notification Messages In 'ask%ar
chec58o. 'ill prevent status messages appearing 'hen viruses are detected? the virus data8ase is
updated? etc$
Email Scanning
his ta8 is displa/ed onl/? i* the Microso*t 4utloo5 add-in is installed$
he user can decide to scan *or incoming email messages and=or outgoing email messages$
Advanced
his ta8 has *our settings$ he de*ault settings 'ill 8e *ine *or most users$
'reat Files As Mail%oxes+ (* selected? ClamWin 'ill parse all *iles as i* the/ 'ere M(M2 e-mail
messages @e$g$ !ni.=3inu. mail8o.es? $eml *iles saved *rom 4utloo5 2.pressA$ >ote that non-
M(M2 *iles can 8e scanned 'ith this option selected? 8ut this 'ill slo' the scan do'n$
Extract Attachments and Macros from M) Office #ocuments+ (* selected? ClamWin 'ill chec5
*or macro viruses in M1 4**ice documents$
'r* to )can Executa%le Files Onl*+ (* selected? ClamWin 'ill chec5 onl/ e.ecuta8le *iles$
Additional Clamscan Command 3ine &arameters+ (* /ou 'ant to use Clamscan command line
options that are not currentl/ supported 8/ ClamWin? /ou can add them here$
3imit 3og File )i5e 'o+ 4lder logs 'ill 8e deleted 'hen necessar/ to 5eep the log *ile 'ithin the
speci*ied siLe$
)canner &riorit*+ his can 8e set to 3o' or >ormal? and determines ho' the CP! c/cles are split
8et'een ClamWin and other running applications$ he de*ault setting is 3o' 'hich ma/ ma5e
scans slo'er? 8ut should have less impact on other applications$
Usage
here are several 'a/s to use ClamWin:
Run *rom the 1tart menu
Run *rom the s/stem tra/ icon
1cheduled scans
4utloo5 integration
Windo's 2.plorer integration
his section 'ill discuss each method in turn
Run from the Start enu
</ de*ault? during installation? a program group named KClamWin #ntivirusK is created? 'hich
contains K7irus 1cannerK? help=manual and uninstaller$ 1electing D7irus 1cannerE 'ill start
ClamWin 'ith the main 'indo' open? as sho'n 8elo':
o scan a *ile or a *older? simpl/ select it in the main 'indo'? and clic5 the )can 8utton @or clic5
File 6 )can Files in the menu or clic5 the last icon in the tool8arA$ Multiple *iles=*olders can 8e
selected 8/ holding do'n the Control or )hift 5e/ 'hilst clic5ing$
o scan all programs that are currentl/ loaded in memor/? select File 6 )can Memor*$ Memor/
scanning can also 8e started using the third icon in the tool8ar$
Run from the system tray icon
o run ClamWin *rom the s/stem tra/ icon? either dou8le-clic5 on the icon or right-clic5 and select
Open ClamWin$ ClamWin 'ill 8e started 'ith the main 'indo' open? as a8ove$
he s/stem tra/ icon allo's other options to 8e selected on right-clic5:
#ownload $irus #ata%ase /pdate: his 'ill cause
ClamWin to chec5 *or updates to the virus data8ase? and
do'nload an/ updates that are availa8le$
Configure ClamWin: his 'ill displa/ ClamWin6s
pre*erences dialogue? 'here ClamWin6s settings can 8e
altered$
)cheduler: (* the mouse is moved over this option? a su8-
menu 'ill 8e displa/ed$ "rom this su8-menu? scheduled scans
can 8e con*igured? alread/ con*igured scheduled scans can 8e
run? or running scans can 8e stopped$
#ispla* -eports: (* the mouse is moved over this option? a su8-menu 'ill 8e displa/ed$ "rom this
su8-menu? the D7irus Data8ase !pdate ReportE or D7irus 1can ReportE can 8e vie'ed$
Check 3atest $ersion: his 'ill open the de*ault 8ro'ser at the ClamWin 'e8 site? and chec5 the
installed version o* ClamWin$ he page 'ill displa/ a message sho'ing the latest version availa8le?
and 'hether or not the latest version is installed? along 'ith a lin5 to the do'nload page? so that a
ne'er version can 8e do'nloaded i* re;uired$
$isit ClamWin We%site: his 'ill open the de*ault 8ro'ser at the ClamWin 'e8 site$
Scheduled Scans
1cheduled scans can 8e set up in the pre*erences dialogue @ools H Pre*erences H 1cheduled 1cansA
or *rom s/stem tra/ icon @1cheduler H Con*igure 1chedulerA$ (* a scheduled scan is set up?
ClamWin 'ill run a scan at the speci*ied time? 'ithout interrupting the user$ (* a virus is *ound? a
8alloon noti*ication 'ill appear a8ove the s/stem tra/ icon @note: the 8alloon noti*ication *eature
does not 'or5 in Windo's %0A$ he action ta5en 8/ ClamWin on detecting a virus 'ill 8e
determined 8/ 'hat has 8een set in the 7eneral ta8 o* the pre*erences dialogue$
S !utloo" Integration
(* 4utloo5 is installed on the computer? and the Integration with Microsoft Outlook option 'as
selected during the installation o* ClamWin? then ClamWin 'ill scan all incoming and outgoing e-
mails *or viruses$ his is done entirel/ automaticall/? 'ith no user intervention re;uired$ (* an
incoming e-mail has a virus attached? the virus attachment is replaced 'ith a report *ile$
#indo$s Explorer Integration
(* the Integration with Windows Explorer option 'as selected during the installation o*
ClamWin? an e.tra option @)can For $iruses With ClamWinA 'ill 8e added to the Windo's
2.plorer right-clic5 menu$ Right-clic5ing on a *ile or *older and selecting this option 'ill scan the
*ile or *older *or viruses? providing a ;uic5 and simple 'a/ to scan suspicious *iles$
Advanced Operation
his section has details *or more advanced users$
odifying %lam#in&s 'efault %onfiguration
(* a cop/ o* clam'in$con* is in the ClamWin e.ecuta8le *iles director/ @KC:MProgram
"ilesMClamWinM8inK on a de*ault installationA? then the *irst time a user runs ClamWin? it 'ill use
the contents o* this *ile as the de*ault con*iguration$
(* /ou are to set up several ne' user accounts on a computer? or i* /ou have Cust installed ClamWin
on a s/stem 'ith multiple users? it is recommended that /ou set up a de*ault con*iguration and cop/
the clam'in$con* *ile to this location$
Running a (irus Scan from the %ommand Line
ClamWin can 8e run *rom the command line? *rom a 8atch *ile *or instance$ "or a *ull list o*
parameters? navigate to the director/ containing the e.ecuta8le *iles @KC:MProgram
"ilesMClamWinM8inK on a de*ault installationA and run
clamscan.exe --help
%he database directory must be specified, using the --database=F!"#$% parameter.
&n a default installation, the command to scan the entire C: dri$e would be
clamscan.exe --database=&C:\Pro'ram Files\Clam(in\db& --rec)rsi*e C:\
Note the use of the --rec)rsi*e parameter to ensure that sub-directories are scanned.
'hen run from the command line, a $alue will be returned, indicating whether or not a
$irus was detected. &f no $irus is found, the return $alue will be (. &f a $irus is found, the
return $alue is ). *ny other return $alue indicates an error.
Updating the (irus 'ata)ase from the %ommand Line
ClamWin uses freshclam.exe to update the virus data8ase$ #s 'ith the clamscan.exe
scanning program? this can 8e run *rom a command line? 8atch *ile? etc$ "or a *ull list o* parameters?
navigate to the director/ containing the e.ecuta8le *iles @KC:MProgram "ilesMClamWinM8inK on a
de*ault installationA and run
freshclam.exe +help
+oth the database directory and the configuration file must be specified. ,lam'in
generates a freshclam configuration file on the fly, so you will ha$e to create your own.
%he configuration file is a text file. -ee the ,lam*. documentation for full details of what
can be included. * simple freshclam configuration file would ha$e the following lines (lines
beginning with a / are comments)
, -%! of ser*er .here database )pdates are to be do.nloaded from
, f this option is 'i*en m)ltiple times/ each .ill be tried in
, the order 'i*en )ntil an )pdate is s)ccessf)ll0 do.nloaded
$atabase1irror database.clama*.net
, 2)mber of times to tr0 each mirror before mo*in' to the next one
1ax3ttempts 4
0nce a freshclam configuration file has been created, freshclam can be run with a
command similar to the one below
freshclam --datadir=&C:\$oc)ments and 5ettin's\3ll -sers\.clam.in\db& --
confi'-file=&C:\Pro'ram Files\Clam(in\bin\freshclam.conf&
Getting Updates from a Local Server
&f you ha$e ,lam'in running on se$eral networ1ed computers, you may wish to ha$e a
single computer downloading updates from the &nternet, with the others getting updates
o$er the local networ1. %his can be done in the following way
-et up a web ser$er that has the main.c$d and daily.c$d files in the web root directory. &t
should be possible to download these files to the client pc2s by pointing a webbrowser at
http33405!-6!.6!N*763main.c$d and http33405!-6!.6!N*763daily.c$d.
&n ,lam'in2s Internet Updates configuration tab on the clients, enter the web ser$er2s &8
address or domain name in the Download Site text box. 9o not include anything other
than the &8 address or domain name (eg 167.189.1.1 is correct,
http:##167.189.1.1# is wrong). ,lam'in will then :uery the local web ser$er for
updates, instead of a remote &nternet ser$er.
%he files are a$ailable from www.clama$.net. 4ou can create a batch script that
automatically downloads these files to the root of your webser$er using a tool such as
wget, li1e
.'et http:##:$;<1%%=%:#main.c*d -= &:(";%==>:\main.c*d&
.'et http:##:$;<1%%=%:#dail0.c*d -= &:(";%==>:\dail0.c*d&
Note that differential updates are currently impossible. 4ou would ha$e to mirror
database.clama$.net, which is not supported for pri$ate use.
anually Updating the (irus 'ata)ase
%o update the $irus database manually, download the $irus database files main.c*d and
dail0.c*d and copy them to ,lam'in2s $irus database folder, o$er-writing the existing files.
%he $irus database files can be downloaded from ,lam*.2s home page at www.clama$.net
FAQ: Frequentl As!ed Questions
Please see online version of FA* located at+
http+,,$$$-clam$in-com,content,category,.,/,0/,
Troubles"ooting
Pro)lem+ #hen trying to send a test e1mail alert2 a message similar to the follo$ing
appears
Co)ld not send the email. Please ens)re 0o) are connected to the
internet. "rror: 51>P instance has no attrib)te ?soc@?
or
Co)ld not send the email. Please ens)re 0o) are connected to the
internet. "rror: 51>P 3->A extension not s)pported b0 ser*er
1olution: he 1MP server settings are 'rong$ >ote that man/ (1P6s do not re;uire a user name &
pass'ord *or the 1MP server$ r/ leaving these settings 8lan5$
E1mail clients that store messages in a single file
1ome e-mail clients @e$g$ he <atJA store all messages in a single *ile$ 4thers store each e-mail as a
separate *ile$ (* ClamWin *inds a virus attached to an e-mail? it 'ill consider the entire *ile @i$e$ all
the e-mails in that *ileA to 8e in*ected$ here*ore? the entire *ile 'ill 8e removed or moved to
;uarantine$ Bou ma/ 'ish to set the "ilters @see the instructions on con*iguring ClamWinA so that
these *iles are not scanned$
!sers o* he <atJ ma/ 8e interested to 5no' that Marco Pontello has 'ritten a plug-in that allo's
he <atJ to use ClamWin to scan attachments$ More details are availa8le at Marco6s 'e8 site$
3his chapter descri)es solutions to the follo$ing issues+
When tr/ing to send a test e-mail alert? a message similar to the *ollo'ing
appears
2-mail clients that store messages in a single *ile
Con*licts 'ith some versions o* #ctiveP/thon
4utloo5 2000 does not restore 'hen minimised
If your desired topic is not included here2 please see the FA* located at+
http+,,$$$-clam$in-com,content,category,.,/,0/,
%onflicts $ith ActivePython
Having p/thon installed should not 8e a pro8lem i* /ou have p/thon 2$) and p/'in)2-20&
@http:==source*orge$net=proCects=p/'in)2=A installed$
(t seems that versions o* #ctive1tate p/thon that come 'ith 'in)2all-&-) @no' p/'in)2A create a
D33 con*lict$ 1o i* /ou have #ctiveP/thon 2$)? Cust install p/'in)2 and it should 8e *ine$
!utloo" 0444 does not restore $hen minimised
When ClamWin is installed? 4utloo5 2000 ma/ not restore properl/ *rom 8eing minimiLed$
(nstalling 4**ice 2000 1ervice Release &a @1R-&aA 'ill *i. this pro8lem? and is generall/
recommended? as it includes a num8er o* 8ug *i.es and securit/ *i.es$ "ull details and do'nloads
are availa8le at http:=='''$microso*t$com=do'nloads=details$asp.N"amil/(DO#"-C0D0)-7-))-
4+<4-#<%--7%+22-+-"2#2&displa/langO2> or
http:==tin/url$com=.s/.
Appendi# A : $ow to %un Cla&'in fro& CD or US(
Introduction
his tutorial e.plains ho' to create a CD or !1< 5e/ 'ith ClamWin? to allo' a Windo's PC to 8e
scanned *or viruses 'ithout having to install ClamWin$ >ote that the CD=!1< 5e/ is not 8oota8le?
and so can onl/ 8e used on a 'or5ing Windo's PC$
he PC that is used to create the CD=!1< 'ill need to have ClamWin installed? and 8e a8le to cop/
*iles=*olders to a CD or !1< 5e/$
T"e eas wa : )ortable Cla&'in
he eas/ 'a/ is to use the pre-8uilt porta8le version o* ClamWin? 'hich can 8e *ound at
http:==porta8leapps$com=apps=utilities=clam'inPporta8le$
>ote that the maintainers o* this Porta8le ClamWin are not a**iliated 'ith the ClamWin team? so the
team might not 8e a8le to ans'er all /our ;uestions regarding this version$ #lso? ClamWin
Porta8le might 8e some versions 8ehind the o**icial ClamWin release$
)reparation
1tart 8/ installing the latest version o* ClamWin? and do'nload the latest virus de*initions$ 1ee the
ClamWin manual *or *ull details on ho' to do this$
>ote that? i* /ou are going to create a CD? /ou 'ill not 8e a8le to update the virus de*initions
'ithout creating a ne' CD? since a CD is read-onl/$
Cop Folders
Create a 'or5ing *older in a convenient location to hold the *iles that are to 8e copied onto
CD=!1<? e$g$ C:\Clam(in-C$$
(n the 'or5ing *older? create a *older named Clam(in$
Cop/ the contents o* the ClamWin program *older into C:\Clam(in-C$\Clam(in$ </ de*ault?
the ClamWin program *older is installed to C:\Pro'ram Files\Clam(in
Create *olders named lo'? db and B)arantine in C:\Clam(in-C$\Clam(in.
Cop/ the ClamWin data8ase *iles @all *iles in the db *olderA into C:\Clam(in-
C$\Clam(in\db$ (n Windo's 2000=QP? the ClamWin data8ase *older de*aults to
C:\$oc)ments and 5ettin's\-5"%231"\.clam.in\db? 'here -5"%231" is /our
login name @i* it 'as installed *or a single userA or C:\$oc)ments and 5ettin's\3ll
-sers\.clam.in\db @i* it 'as installed *or all usersA$
Cop/ the *ollo'ing into a te.t *ile named C:\Clam(in-C$\Clam(in\bin\clam.in.conf
C5ched)leD
path = .\
CClam3ED
clamscan = .\clamscan.exe
enablembox = 0
maxfiles = F00
infectedonl0 = 0
database = ..\db
incl)depatterns =
scanole7 = 1
excl)depatterns = *.dbxGC!31(2<5"PG*.tbbGC!31(2<5"PG*.pstGC!31(2<5"PG*.datG
C!31(2<5"PG*.lo'GC!31(2<5"PG*.nsfGC!31(2<5"PG*.ntfGC!31(2<5"PG*.chm
maxsiHe = 10
scanarchi*es = 1
priorit0 = !o.
maxrec)rsion = F
maxlo'siHe = 1
mo*einfected = 0
deb)' = 0
lo'file = ..\lo'\Clam5can!o'.txt
scanrec)rsi*e = 1
freshclam = .\freshclam.exe
B)arantinedir = ..\B)arantine
remo*einfected = 0
C-D
reportinfected = 1
tra0notif0 = 0
standalone = 1
C-pdatesD
db)pdatelo'file = ..\lo'\Clam-pdate!o'.txt
enable = 1
dbmirror = database.clama*.net
)pdateonlo'on = 0
freB)enc0 = $ail0
.ee@da0 = 7
time = 17:00:00
C"mail3lertsD
enable = 0
from = clam.inI0o)rdomain
to = adminI0o)rdomain
smtppass.ord =
smtp)ser =
smtphost =
smtpport = 7F
s)bJect = Clam(in Eir)s 3lert
CProx0D
host =
pass.ord =
port = 4179
)ser =
Bou should no' have the *ollo'ing *olders:
C:\Clam(in-C$
C:\Clam(in-C$\Clam(in\bin
C:\Clam(in-C$\Clam(in\db
C:\Clam(in-C$\Clam(in\lib
C:\Clam(in-C$\Clam(in\lo'
C:\Clam(in-C$\Clam(in\B)arantine
Cop Files to CD*US(
>o' /ou Cust need to cop/ the contents o* C:\Clam(in-C$ to a CD or !1< 5e/$ Do not cop/
the C:\Clam(in-C$ *older itsel*? onl/ the contents$ 2.actl/ ho' this is done 'ill depend on
'hether a CD or !1< 5e/ is to 8e used? and 'hat so*t'are is to 8e used$
Using the %',US5
o use it? insert the CD=!1< into the PC to 8e scanned$ Run ClamWin 8/ dou8le-clic5ing on the
Clam(in.exe *ile in the Clam(in\bin *older$
ClamWin should operate normall/? 8ut i* run *rom CD or read-onl/ !1< drive? it 'ill have the
*ollo'ing restrictions:
"iles 'ill not 8e ;uarantined
(nternet updates 'ill not 'or5
Pre*erences cannot 8e changed
hese restrictions 'ill not appl/ i* it is run *rom a !1< drive 'ith read-'rite permissions$
Appendi# ( : +,U +-,-%A. )U(.IC .IC-,S-
7ersion 2? Iune &%%&
Cop/right @CA &%0%? &%%& "ree 1o*t'are "oundation? (nc$
+% emple Place? 1uite ))0? <oston? M# 02&&&-&)07 !1#
2ver/one is permitted to cop/ and distri8ute ver8atim copies o* this license document? 8ut changing
it is not allo'ed$
)rea&ble
he licenses *or most so*t'are are designed to ta5e a'a/ /our *reedom to share and change it$ </
contrast? the ,>! ,eneral Pu8lic 3icense is intended to guarantee /our *reedom to share and
change *ree so*t'are - to ma5e sure the so*t'are is *ree *or all its users$ his ,eneral Pu8lic
3icense applies to most o* the "ree 1o*t'are "oundation6s so*t'are and to an/ other program 'hose
authors commit to using it$ @1ome other "ree 1o*t'are "oundation so*t'are is covered 8/ the ,>!
3i8rar/ ,eneral Pu8lic 3icense instead$A Bou can appl/ it to /our programs? too$
When 'e spea5 o* *ree so*t'are? 'e are re*erring to *reedom? not price$ 4ur ,eneral Pu8lic
3icenses are designed to ma5e sure that /ou have the *reedom to distri8ute copies o* *ree so*t'are
@and charge *or this service i* /ou 'ishA? that /ou receive source code or can get it i* /ou 'ant it?
that /ou can change the so*t'are or use pieces o* it in ne' *ree programsR and that /ou 5no' /ou
can do these things$
o protect /our rights? 'e need to ma5e restrictions that *or8id an/one to den/ /ou these rights or
to as5 /ou to surrender the rights$ hese restrictions translate to certain responsi8ilities *or /ou i*
/ou distri8ute copies o* the so*t'are? or i* /ou modi*/ it$
"or e.ample? i* /ou distri8ute copies o* such a program? 'hether gratis or *or a *ee? /ou must give
the recipients all the rights that /ou have$ Bou must ma5e sure that the/? too? receive or can get the
source code$ #nd /ou must sho' them these terms so the/ 5no' their rights$
We protect /our rights 'ith t'o steps: @&A cop/right the so*t'are? and @2A o**er /ou this license
'hich gives /ou legal permission to cop/? distri8ute and=or modi*/ the so*t'are$
#lso? *or each author6s protection and ours? 'e 'ant to ma5e certain that ever/one understands that
there is no 'arrant/ *or this *ree so*t'are$ (* the so*t'are is modi*ied 8/ someone else and passed
on? 'e 'ant its recipients to 5no' that 'hat the/ have is not the original? so that an/ pro8lems
introduced 8/ others 'ill not re*lect on the original authors6 reputations$
"inall/? an/ *ree program is threatened constantl/ 8/ so*t'are patents$ We 'ish to avoid the danger
that redistri8utors o* a *ree program 'ill individuall/ o8tain patent licenses? in e**ect ma5ing the
program proprietar/$ o prevent this? 'e have made it clear that an/ patent must 8e licensed *or
ever/one6s *ree use or not licensed at all$
he precise terms and conditions *or cop/ing? distri8ution and modi*ication *ollo'$
+,U +eneral )ublic .icense Ter&s and Conditions for Coping/
Distribution and 0odification
0$ his 3icense applies to an/ program or other 'or5 'hich contains a notice placed 8/ the
cop/right holder sa/ing it ma/ 8e distri8uted under the terms o* this ,eneral Pu8lic 3icense$ he
KProgramK? 8elo'? re*ers to an/ such program or 'or5? and a K'or5 8ased on the ProgramK means
either the Program or an/ derivative 'or5 under cop/right la': that is to sa/? a 'or5 containing the
Program or a portion o* it? either ver8atim or 'ith modi*ications and=or translated into another
language$ @Hereina*ter? translation is included 'ithout limitation in the term Kmodi*icationK$A 2ach
licensee is addressed as K/ouK$
#ctivities other than cop/ing? distri8ution and modi*ication are not covered 8/ this 3icenseR the/
are outside its scope$ he act o* running the Program is not restricted? and the output *rom the
Program is covered onl/ i* its contents constitute a 'or5 8ased on the Program @independent o*
having 8een made 8/ running the ProgramA$ Whether that is true depends on 'hat the Program
does$
&$ Bou ma/ cop/ and distri8ute ver8atim copies o* the Program6s source code as /ou receive
it? in an/ medium? provided that /ou conspicuousl/ and appropriatel/ pu8lish on each cop/ an
appropriate cop/right notice and disclaimer o* 'arrant/R 5eep intact all the notices that re*er to this
3icense and to the a8sence o* an/ 'arrant/R and give an/ other recipients o* the Program a cop/ o*
this 3icense along 'ith the Program$
Bou ma/ charge a *ee *or the ph/sical act o* trans*erring a cop/? and /ou ma/ at /our option o**er
'arrant/ protection in e.change *or a *ee$
2$ Bou ma/ modi*/ /our cop/ or copies o* the Program or an/ portion o* it? thus *orming a
'or5 8ased on the Program? and cop/ and distri8ute such modi*ications or 'or5 under the terms o*
1ection & a8ove? provided that /ou also meet all o* these conditions:
aA Bou must cause the modi*ied *iles to carr/ prominent notices stating that /ou changed the *iles
and the date o* an/ change$
8A Bou must cause an/ 'or5 that /ou distri8ute or pu8lish? that in 'hole or in part contains or is
derived *rom the Program or an/ part thereo*? to 8e licensed as a 'hole at no charge to all third
parties under the terms o* this 3icense$
cA (* the modi*ied program normall/ reads commands interactivel/ 'hen run? /ou must cause it?
'hen started running *or such interactive use in the most ordinar/ 'a/? to print or displa/ an
announcement including an appropriate cop/right notice and a notice that there is no 'arrant/ @or
else? sa/ing that /ou provide a 'arrant/A and that users ma/ redistri8ute the program under these
conditions? and telling the user ho' to vie' a cop/ o* this 3icense$ @2.ception: i* the Program itsel*
is interactive 8ut does not normall/ print such an announcement? /our 'or5 8ased on the Program is
not re;uired to print an announcement$A
hese re;uirements appl/ to the modi*ied 'or5 as a 'hole$ (* identi*ia8le sections o* that 'or5 are
not derived *rom the Program? and can 8e reasona8l/ considered independent and separate 'or5s in
themselves? then this 3icense? and its terms? do not appl/ to those sections 'hen /ou distri8ute them
as separate 'or5s$ <ut 'hen /ou distri8ute the same sections as part o* a 'hole 'hich is a 'or5
8ased on the Program? the distri8ution o* the 'hole must 8e on the terms o* this 3icense? 'hose
permissions *or other licensees e.tend to the entire 'hole? and thus to each and ever/ part
regardless o* 'ho 'rote it$
hus? it is not the intent o* this section to claim rights or contest /our rights to 'or5 'ritten entirel/
8/ /ouR rather? the intent is to e.ercise the right to control the distri8ution o* derivative or collective
'or5s 8ased on the Program$
(n addition? mere aggregation o* another 'or5 not 8ased on the Program 'ith the Program @or 'ith
a 'or5 8ased on the ProgramA on a volume o* a storage or distri8ution medium does not 8ring the
other 'or5 under the scope o* this 3icense$
)$ Bou ma/ cop/ and distri8ute the Program @or a 'or5 8ased on it? under 1ection 2A in
o8Cect code or e.ecuta8le *orm under the terms o* 1ections & and 2 a8ove provided that /ou also do
one o* the *ollo'ing:
aA #ccompan/ it 'ith the complete corresponding machine-reada8le source code? 'hich must 8e
distri8uted under the terms o* 1ections & and 2 a8ove on a medium customaril/ used *or so*t'are
interchangeR or?
8A #ccompan/ it 'ith a 'ritten o**er? valid *or at least three /ears? to give an/ third part/? *or a
charge no more than /our cost o* ph/sicall/ per*orming source distri8ution? a complete machine-
reada8le cop/ o* the corresponding source code? to 8e distri8uted under the terms o* 1ections & and
2 a8ove on a medium customaril/ used *or so*t'are interchangeR or?
cA #ccompan/ it 'ith the in*ormation /ou received as to the o**er to distri8ute corresponding
source code$ @his alternative is allo'ed onl/ *or noncommercial distri8ution and onl/ i* /ou
received the program in o8Cect code or e.ecuta8le *orm 'ith such an o**er? in accord 'ith
1u8section 8 a8ove$A
he source code *or a 'or5 means the pre*erred *orm o* the 'or5 *or ma5ing modi*ications to it$
"or an e.ecuta8le 'or5? complete source code means all the source code *or all modules it contains?
plus an/ associated inter*ace de*inition *iles? plus the scripts used to control compilation and
installation o* the e.ecuta8le$ Ho'ever? as a special e.ception? the source code distri8uted need not
include an/thing that is normall/ distri8uted @in either source or 8inar/ *ormA 'ith the maCor
components @compiler? 5ernel? and so onA o* the operating s/stem on 'hich the e.ecuta8le runs?
unless that component itsel* accompanies the e.ecuta8le$
(* distri8ution o* e.ecuta8le or o8Cect code is made 8/ o**ering access to cop/ *rom a designated
place? then o**ering e;uivalent access to cop/ the source code *rom the same place counts as
distri8ution o* the source code? even though third parties are not compelled to cop/ the source along
'ith the o8Cect code$
4$ Bou ma/ not cop/? modi*/? su8license? or distri8ute the Program e.cept as e.pressl/
provided under this 3icense$ #n/ attempt other'ise to cop/? modi*/? su8license or distri8ute the
Program is void? and 'ill automaticall/ terminate /our rights under this 3icense$ Ho'ever? parties
'ho have received copies? or rights? *rom /ou under this 3icense 'ill not have their licenses
terminated so long as such parties remain in *ull compliance$
+$ Bou are not re;uired to accept this 3icense? since /ou have not signed it$ Ho'ever?
nothing else grants /ou permission to modi*/ or distri8ute the Program or its derivative 'or5s$
hese actions are prohi8ited 8/ la' i* /ou do not accept this 3icense$ here*ore? 8/ modi*/ing or
distri8uting the Program @or an/ 'or5 8ased on the ProgramA? /ou indicate /our acceptance o* this
3icense to do so? and all its terms and conditions *or cop/ing? distri8uting or modi*/ing the
Program or 'or5s 8ased on it$
-$ 2ach time /ou redistri8ute the Program @or an/ 'or5 8ased on the ProgramA? the recipient
automaticall/ receives a license *rom the original licensor to cop/? distri8ute or modi*/ the Program
su8Cect to these terms and conditions$ Bou ma/ not impose an/ *urther restrictions on the recipients6
e.ercise o* the rights granted herein$ Bou are not responsi8le *or en*orcing compliance 8/ third
parties to this 3icense$
7$ (*? as a conse;uence o* a court Cudgment or allegation o* patent in*ringement or *or an/
other reason @not limited to patent issuesA? conditions are imposed on /ou @'hether 8/ court order?
agreement or other'iseA that contradict the conditions o* this 3icense? the/ do not e.cuse /ou *rom
the conditions o* this 3icense$ (* /ou cannot distri8ute so as to satis*/ simultaneousl/ /our
o8ligations under this 3icense and an/ other pertinent o8ligations? then as a conse;uence /ou ma/
not distri8ute the Program at all$ "or e.ample? i* a patent license 'ould not permit ro/alt/-*ree
redistri8ution o* the Program 8/ all those 'ho receive copies directl/ or indirectl/ through /ou?
then the onl/ 'a/ /ou could satis*/ 8oth it and this 3icense 'ould 8e to re*rain entirel/ *rom
distri8ution o* the Program$
(* an/ portion o* this section is held invalid or unen*orcea8le under an/ particular circumstance? the
8alance o* the section is intended to appl/ and the section as a 'hole is intended to appl/ in other
circumstances$
(t is not the purpose o* this section to induce /ou to in*ringe an/ patents or other propert/ right
claims or to contest validit/ o* an/ such claimsR this section has the sole purpose o* protecting the
integrit/ o* the *ree so*t'are distri8ution s/stem? 'hich is implemented 8/ pu8lic license practices$
Man/ people have made generous contri8utions to the 'ide range o* so*t'are distri8uted through
that s/stem in reliance on consistent application o* that s/stemR it is up to the author=donor to decide
i* he or she is 'illing to distri8ute so*t'are through an/ other s/stem and a licensee cannot impose
that choice$
his section is intended to ma5e thoroughl/ clear 'hat is 8elieved to 8e a conse;uence o* the rest o*
this 3icense$
0$ (* the distri8ution and=or use o* the Program is restricted in certain countries either 8/
patents or 8/ cop/righted inter*aces? the original cop/right holder 'ho places the Program under
this 3icense ma/ add an e.plicit geographical distri8ution limitation e.cluding those countries? so
that distri8ution is permitted onl/ in or among countries not thus e.cluded$ (n such case? this
3icense incorporates the limitation as i* 'ritten in the 8od/ o* this 3icense$
%$ he "ree 1o*t'are "oundation ma/ pu8lish revised and=or ne' versions o* the ,eneral
Pu8lic 3icense *rom time to time$ 1uch ne' versions 'ill 8e similar in spirit to the present version?
8ut ma/ di**er in detail to address ne' pro8lems or concerns$
2ach version is given a distinguishing version num8er$ (* the Program speci*ies a version num8er o*
this 3icense 'hich applies to it and Kan/ later versionK? /ou have the option o* *ollo'ing the terms
and conditions either o* that version or o* an/ later version pu8lished 8/ the "ree 1o*t'are
"oundation$ (* the Program does not speci*/ a version num8er o* this 3icense? /ou ma/ choose an/
version ever pu8lished 8/ the "ree 1o*t'are "oundation$
&0$ (* /ou 'ish to incorporate parts o* the Program into other *ree programs 'hose
distri8ution conditions are di**erent? 'rite to the author to as5 *or permission$ "or so*t'are 'hich is
cop/righted 8/ the "ree 1o*t'are "oundation? 'rite to the "ree 1o*t'are "oundationR 'e
sometimes ma5e e.ceptions *or this$ 4ur decision 'ill 8e guided 8/ the t'o goals o* preserving the
*ree status o* all derivatives o* our *ree so*t'are and o* promoting the sharing and reuse o* so*t'are
generall/$
,o 'arrant
&&$ <2C#!12 H2 PR4,R#M (1 3(C2>12D "R22 4" CH#R,2? H2R2 (1 >4
W#RR#>B "4R H2 PR4,R#M? 4 H2 2Q2> P2RM(2D <B #PP3(C#<32 3#W$
2QC2P WH2> 4H2RW(12 1#2D (> WR((>, H2 C4PBR(,H H43D2R1 #>D=4R
4H2R P#R(21 PR47(D2 H2 PR4,R#M K#1 (1K W(H4! W#RR#>B 4" #>B
S(>D? 2(H2R 2QPR2112D 4R (MP3(2D? (>C3!D(>,? <! >4 3(M(2D 4? H2
(MP3(2D W#RR#>(21 4" M2RCH#>#<(3(B #>D "(>211 "4R # P#R(C!3#R
P!RP412$ H2 2>(R2 R(1S #1 4 H2 9!#3(B #>D P2R"4RM#>C2 4" H2
PR4,R#M (1 W(H B4!$ 1H4!3D H2 PR4,R#M PR472 D2"2C(72? B4! #11!M2
H2 C41 4" #33 >2C211#RB 12R7(C(>,? R2P#(R 4R C4RR2C(4>$
&2$ (> >4 272> !>3211 R29!(R2D <B #PP3(C#<32 3#W 4R #,R22D 4 (>
WR((>, W(33 #>B C4PBR(,H H43D2R? 4R #>B 4H2R P#RB WH4 M#B
M4D("B #>D=4R R2D(1R(<!2 H2 PR4,R#M #1 P2RM(2D #<472? <2 3(#<32
4 B4! "4R D#M#,21? (>C3!D(>, #>B ,2>2R#3? 1P2C(#3? (>C(D2>#3 4R
C4>129!2>(#3 D#M#,21 #R(1(>, 4! 4" H2 !12 4R (>#<(3(B 4 !12 H2
PR4,R#M @(>C3!D(>, <! >4 3(M(2D 4 3411 4" D## 4R D## <2(>,
R2>D2R2D (>#CC!R#2 4R 341121 1!1#(>2D <B B4! 4R H(RD P#R(21 4R #
"#(3!R2 4" H2 PR4,R#M 4 4P2R#2 W(H #>B 4H2R PR4,R#M1A? 272> ("
1!CH H43D2R 4R 4H2R P#RB H#1 <22> #D7(12D 4" H2 P411(<(3(B 4" 1!CH
D#M#,21$
2>D 4" 2RM1 #>D C4>D((4>1
$ow to Appl T"ese Ter&s to 1our ,ew )rogra&s
(* /ou develop a ne' program? and /ou 'ant it to 8e o* the greatest possi8le use to the pu8lic? the
8est 'a/ to achieve this is to ma5e it *ree so*t'are 'hich ever/one can redistri8ute and change
under these terms$
o do so? attach the *ollo'ing notices to the program$ (t is sa*est to attach them to the start o* each
source *ile to most e**ectivel/ conve/ the e.clusion o* 'arrant/R and each *ile should have at least
the Kcop/rightK line and a pointer to 'here the *ull notice is *ound$
Gone line to give the program6s name and a 8rie* idea o* 'hat it does$H Cop/right @CA G/earH
Gname o* authorH
his program is *ree so*t'areR /ou can redistri8ute it and=or modi*/ it under the terms o* the ,>!
,eneral Pu8lic 3icense as pu8lished 8/ the "ree 1o*t'are "oundationR either version 2 o* the
3icense? or @at /our optionA an/ later version$
his program is distri8uted in the hope that it 'ill 8e use*ul? 8ut W(H4! #>B W#RR#>BR
'ithout even the implied 'arrant/ o* M2RCH#>#<(3(B or "(>211 "4R # P#R(C!3#R
P!RP412$ 1ee the ,>! ,eneral Pu8lic 3icense *or more details$
Bou should have received a cop/ o* the ,>! ,eneral Pu8lic 3icense along 'ith this programR i*
not? 'rite to the "ree 1o*t'are "oundation? (nc$? +% emple Place? 1uite ))0? <oston? M# 02&&&-
&)07 !1#
#lso add in*ormation on ho' to contact /ou 8/ electronic and paper mail$
(* the program is interactive? ma5e it output a short notice li5e this 'hen it starts in an interactive
mode:
,nomovision version -%? Cop/right @CA /ear name o* author ,nomovision comes 'ith
#<143!23B >4 W#RR#>BR *or details t/pe Tsho' '6$ his is *ree so*t'are? and /ou are
'elcome to redistri8ute it under certain conditionsR t/pe Tsho' c6 *or details$
he h/pothetical commands Tsho' '6 and Tsho' c6 should sho' the appropriate parts o* the ,eneral
Pu8lic 3icense$ 4* course? the commands /ou use ma/ 8e called something other than Tsho' '6 and
Tsho' c6R the/ could even 8e mouse-clic5s or menu items - 'hatever suits /our program$
Bou should also get /our emplo/er @i* /ou 'or5 as a programmerA or /our school? i* an/? to sign a
Kcop/right disclaimerK *or the program? i* necessar/$ Here is a sampleR alter the names:
Bo/od/ne? (nc$? here8/ disclaims all cop/right interest in the program T,nomovision6 @'hich ma5es
passes at compilersA 'ritten 8/ Iames Hac5er$
Gsignature o* / CoonH? & #pril &%0% / Coon? President o* 7ice
his ,eneral Pu8lic 3icense does not permit incorporating /our program into proprietar/ programs$
(* /our program is a su8routine li8rar/? /ou ma/ consider it more use*ul to permit lin5ing
proprietar/ applications 'ith the li8rar/$ (* this is 'hat /ou 'ant to do? use the ,>! 3i8rar/
,eneral Pu8lic 3icense instead o* this 3icense$