                   BitDefender Antivirus Scanner for Unices
                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                                    README


                                                Copyright (c) 2014 BITDEFENDER

    Thank  you  for  choosing to install BitDefender Antivirus Scanner for
    Unices. You are strongly advised to read the entire document  and  the
    related documentation available for this product.

    For  any  question  related to the use of this software please contact
    our 24h Technical Support  Service  at  the  following  email  address
    <support@bitdefender.com>.



CONTENTS
========
  1. Product features
  2. Virus scanning
  3. Updates
  4. Product registration
  5. Support



1. Product features
===================

  The acquisition and installation of an antivirus product for the personal or
  company's systems is the most efficient way of preventing the infection of a
  computer  and  the  spreading of viruses inside the company, and outside the
  company as well.


1.1. BitDefender Antivirus Scanner for Unices
---------------------------------------------

  BitDefender Antivirus Scanner for Unices is the solution BITDEFENDER  offers
  for the  antivirus  protection  of  individual  Linux  systems. It uses  the
  most advanced multi-platform virus inspection  technology  which  scans  for
  viruses and other malware on your personal system.

  The  on-demand  scanner,  for command line or shell scripts, features manual
  scan of individual files or entire file systems,  malicious  code  detection
  and  removal.  After  each  scan,  the program displays a detailed report on
  positive virus detections.  Thanks  to  BitDefender  scan  engines  advanced
  features,   new,  undiscovered  threats  can  be  detected  and  immediately
  eliminated from the system.

  All  the  files  specified  in  the  command  line  are  scanned  using  the
  BitDefender  scan  engines.  This  technology  detects  all the viruses from
  common files, archives or mailboxes. BitDefender features  built-in  support
  for  more  than  80 packed files formats, including RAR, ZIP, ARJ, LZH, LHA,
  ACE, GZIP, TARGZ, JAR, UUE, MIME or CAB archives, no matter  how  they  were
  created (self-extractable, multivolume, etc).

  In case an infection is found, the file will be treated corresponding to the
  selected option (disinfection, deletion, isolation in the quarantine area or
  just reporting) and notifications will be sent to console, as well as to the
  log file.

  For ensuring a superior  and  efficient  antivirus  protection,  BitDefender
  Antivirus Scanner for Unices was designed with built-in update function.


1.2. Key Features
-----------------

    * Antivirus protection for the file system.
    * Automatic  and  incremental  update  of  virus  definitions and scanning
      engines directly from BitDefender servers.
    * Ability to isolate the infected files in the quarantine zone.
    * Detailed statistics and reports regarding the number of  scanned  files,
      the infected files, the deleted and disinfected files.



2. Virus scanning
=================

  BitDefender  Antivirus  Scanner  for Unices knows the best how to perform an
  antivirus scan on files and directories located on some filesystem. Here are
  some basic usage examples.


2.1. Scan a regular file
------------------------

  If  you just want to scan a simple file, you can run 'bdscan' specifying the
  path to the file.

  # bdscan --action=quarantine --verbose file.exe

  As you can see below, one file was scanned and found infected, the virus was
  identified  and  the  file  was moved to quarantine directory. Since verbose
  messages were asked, the name of the plugins used are also displayed.

  You could use another action, such as 'disinfect', to try to  disinfect  the
  file  first.  Since  not all files can be disinfected, you could try next to
  'quarantine' or even 'delete' it.

  Of course, you can use the 'ignore'  action  (which  is  equivalent  to  not
  specifying  an action at all) and you will only be prompted when viruses are
  found. This behavior is extremely useful on read-only filesystems,  such  as
  optical disks (CD-ROM, DVD) or network filesystems mounted read-only.

  BitDefender Antivirus Scanner v7.60124 Linux-i686
  Copyright (C) 1996-2014 BitDefender SRL. All rights reserved.
  This program is licensed for commercial use.

  Default action upon detecting an infected file: ignore action
  Default action upon detecting a suspected file: ignore action
  /t ... xe  infected: EICAR-Test-File (not a virus) <- cevakrnl.xmd


  Results:
  Folders           :0
  Files             :1
  Packed            :0
  Archives          :0
  Infected files    :1
  Suspect files     :0
  Warnings          :0
  Identified viruses:1
  I/O errors        :0



2.2. Scan a directory
---------------------

  The  path  to  scan  can  be  not  only a path towards some file, but to any
  directory. BitDefender Antivirus Scanner for Unices can scan  recursively  a
  directories  tree,  with  unlimited recursive level. You can change this, by
  setting a fixed depth level or by disabling the recursion at all.

  Let's suppose we have the following tree structure, with one  file  and  two
  sub-directories, each sub-directory containing some other files.

  top_dir
  |-- documents
  |   |-- document1.doc
  |   `-- document2.doc
  |-- programs
  |   |-- program1.exe
  |   `-- program2.exe
  `-- file.exe


  We  want  to  scan  the  'downloaded_files'  directory,  but  not  the  sub-
  directories,  therefore  the  recursion  level  is  '1'.  We  also  want  to
  quarantine the infected files, to study them later.

  # bdscan --action=quarantine --recursive-level=1 top_dir

  The  next  screen output shows the files scanned, found infected and finally
  quarantined. You can notice the two sub-directories were not scanned.

  BitDefender Antivirus Scanner v7.60124 Linux-i686
  Copyright (C) 1996-2014 BitDefender SRL. All rights reserved.
  This program is licensed for commercial use.

  Default action upon detecting an infected file: ignore action
  Default action upon detecting a suspected file: ignore action
  /tmp/top_dir/file.exe  infected: EICAR-Test-File (not a virus)
  /tmp/top_d ... ument1.doc  infected: EICAR-Test-File (not a virus)
  /tmp/top_d ... ument2.doc  infected: EICAR-Test-File (not a virus)
  /tmp/top_d ... ogram1.exe  infected: EICAR-Test-File (not a virus)
  /tmp/top_d ... ogram2.exe  infected: EICAR-Test-File (not a virus)


  Results:
  Folders           :3
  Files             :5
  Packed            :0
  Archives          :0
  Infected files    :5
  Suspect files     :0
  Warnings          :0
  Identified viruses:1
  I/O errors        :0




3. Updates
==========

  BitDefender Antivirus Scanner for Unices was designed with capabilities  for
  triggered update. At the present time, the risk of getting infected is high,
  both because new viruses appear and the existing  ones  keep  on  spreading.
  This is why your antivirus must be kept up-to-date, by periodically checking
  the BitDefender servers for new updates.


3.1. Run the triggered update
-----------------------------

  BitDefender  Antivirus  Scanner  for  Unices   is   configured   to   update
  automatically, when triggered, using the following command:

  # bdscan --update

  The output should be the following.

  BitDefender Antivirus Scanner v7.60124 Linux-i686
  Copyright (C) 1996-2014 BitDefender SRL. All rights reserved.
  This program is licensed for commercial use.

  /opt/BitDefender-scanner/var/lib/scan/Plugins/emalware.ivd ........
  /opt/BitDefender/var/lib/scan/Plugins/update.txt  updated
  Update succeeded.



3.2. HTTP proxy
---------------

  You  may  use  a HTTP proxy server to connect to Internet. In this case, the
  triggered update may fail, since the BitDefender update server  can  not  be
  reached.

  To  specify  a  proxy  server to be used when updating, you have to open the
  configuration          file,          usually           located           at
  '/etc/BitDefender-scanner/bdscan.conf',  and  add  the  following  line. You
  should replace the sample values according to your conditions.

  HttpProxy = your.proxy.server:port



4. Product registration
=======================

  The product is delivered with a trial  registration  key  valid  for  thirty
  days.  At  the  end  of  the trial period, if you want to continue using the
  program, you have to provide a new license key.

  When  you  have  the   new   key,   open   the   configuration   file   from
  '/etc/BitDefender-scanner/bdscan.conf' (for a default Linux installation) or
  from '/usr/local/etc/bitdefender/bdscan.conf' on FreeBSD  systems  and  find
  the line similar to this one.

  Key =  00112233445566778899

  Simply replace the old key value with the new one and save the file.

  NOTE: Check the expiration date

        If  you  want  to  check  the key expiration date, you have to run the
        following command and watch the output.

        # bdscan --info


4.1. Trial License
------------------

  The product comes by default with a trial key which allows the user  to  use
  it  in  any  way  or any environment whatsoever for 30 days from the install
  time. When the trial period expires, all  product  features  regarding  scan
  actions  (disinfect,  delete)  will  be  disabled  and the user will have to
  either go online to www.bitdefender.com and register for a personal  license
  or purchase a commercial one from the nearest BitDefender dealer.


4.2. License for home or personal use
-------------------------------------

  This license is free and can be retrieved from the BitDefender website after
  filling a short form. It allows  the  user  to  use  the  product  only  for
  personal  use with no commercial implications whatsoever. For example, using
  the Personal License, you are  allowed  to  scan  your  personal  laptop  or
  desktop  computer  but  YOU  ARE  NOT  ALLOWED  TO  USE  IT  IN A PRODUCTION
  ENVIRONMENT LIKE AN OFFICE COMPUTER OR COMPANY SERVER.


4.3. License for commercial use
-------------------------------

  If you plan on using BitDefender Antivirus Scanner for Unices with your  own
  integration  system  or  pre-designed  scripts,  then  you must purchase the
  Commercial License. The commercial license allows unlimited and unrestricted
  usage  of  the product in any environment whatsoever. The Commercial License
  is sold per user, depending on how many users  benefit  from  the  product's
  features.



5. Support
==========

5.1. Support department
-----------------------

  As  a  valued provider, BITDEFENDER strives to provide its customers with an
  unparallel level of fast and accurate support.  The  Support  Center  listed
  below  is  continually  being updated with the newest virus descriptions and
  answers to common questions, so that you obtain the necessary information in
  a timely manner.

  At BITDEFENDER, dedication  to  saving  its  customers  time  and  money  by
  providing the most advanced products at the fairest prices has  always  been
  a top priority. Moreover, we think that a successful business is based on  a
  good communication and a commitment to excellence in customer support.

  You are welcome to ask for support at  <support@bitdefender.com>  any  time.
  For  a  prompt response, please include in your email as many details as you
  can about your BitDefender, about your system and describe  the  problem  as
  accurate as possible.


5.2. BitDefender Knowledge Base
-------------------------------

  The  BitDefender Knowledge Base is an online repository of information about
  BitDefender products. It stores, in an easily accessible format  reports  on
  the results of the ongoing technical support and bugfixing activities of the
  BitDefender support and development teams, along with more general  articles
  about virus prevention, the management of BitDefender solutions and detailed
  explanations, and many other articles.

  The BitDefender Knowledge Base is open to the public and freely  searchable.
  This  welth  of  information  is  yet  another  way  to  provide BitDefender
  customers with the technical knowledge and  insight  they  need.  All  valid
  requests  for  information  or  bug  reports coming from BitDefender clients
  eventually find their way into the BitDefender  Knowledge  Base,  as  bugfix
  reports,  workaround  cheatsheets  or  informational  articles to supplement
  product helpfiles.

  The   BitDefender   Knowledge   Base    is    available    any    time    at
  http://kb.bitdefender.com.


5.3. Contact information
------------------------

  Efficient communication is the key to a successful business. For the past 10
  years BITDEFENDER has established an indisputable  reputation  in  exceeding
  the expectations  of  clients  and  partners,  by  constantly  striving  for
  better communications. Please do not hesitate to contact  us  regarding  any
  issues or questions you might have


5.3.1. Web addresses

    Sales department: <sales@bitdefender.com>
    Technical support: <support@bitdefender.com>
    Documentation: <documentation@bitdefender.com>
    Security reports: <security@bitdefender.com>
    Product web site: http://linux.bitdefender.com
    Product archives: http://download.bitdefender.com/linux
    Local distributors: http://www.bitdefender.com/partner_list
    BitDefender Knowledge Base: http://kb.bitdefender.com


5.3.2. Address

  The  BitDefender  offices  are  ready  to respond to any inquiries regarding
  their areas of operations, in matters both  commercial  and  general.  Their
  respective adresses and contacts are listed below.

  Germany
    BitDefender GmbH
    Karlsdorfer Stra�e 56 88069
    Tettnang
    Technischer Support: <support@bitdefender.de>
    Vertrieb: <vertrieb@bitdefender.de>
    Phone: 07542/94 44 44
    Fax: 07542/94 44 99
    Product web site: http://www.bitdefender.de

  Spain
    Constelaci�n Negocial, S.L
    C/ Balmes 195, 2� planta, 08006
    Barcelona
    Soporte t�cnico: <soporte@bitdefender-es.com>
    Ventas: <comercial@bitdefender-es.com>
    Phone: +34 932189615
    Fax: +34 932179128
    Sitio web del producto: http://www.bitdefender-es.com

  U.S.A
    BitDefender LLC
    6301 NW 5th Way, Suite 3500
    Fort Lauderdale, Florida 33308
    Technical support: <support@bitdefender.us>
    Sales: <sales@bitdefender.us>
    Phone: 954 776 62 62,  800 388 80 62
    Fax: 954 776 64 62,  800 388 80 64
    Product web site: http://www.bitdefender.us

  Romania
    BitDefender
    24 Delea Veche Street
    Office Building A, 7th floor
    Bucharest
    Technical support: <suport@bitdefender.ro>
    Sales: <sales@bitdefender.ro>
    Phone: +40 21 2330780
    Fax: +40 21 2330763
    Product web site: http://www.bitdefender.ro


--
 BitDefender
 http://www.bitdefender.com/
