Scans

Quick link: Scan profiles

Run On-demand scan from a Terminal window

Syntax: /opt/eset/eea/bin/odscan [OPTIONS..]

Options - short form

Options - long form

Description

-l

--list

Show currently running scans

 

--list-profiles

Show all available scan profiles

 

--all

Show also scans executed by other user (requires root privileges)

-r

--resume=session_id

Resume previously paused scan identified by session_id

-p

--pause=session_id

Pause scan identified by session_id

-t

--stop=session_id

Stop scan identified by session_id

-s

--scan

Start scan

 

--profile=PROFILE

Scan with selected PROFILE

 

--profile-priority=PRIORITY

Task will be run with the  specified priority.
Priority can be: normal, lower, lowest, idle

 

--readonly

Scan without cleaning

 

--local

Scan local drives

 

--network

Scan network drives

 

--removable

Scan removable media

 

--boot-local

Scan the boot sectors of local drive

 

--boot-removable

Scan the boot sectors of removable media

 

--boot-main

Scan the main boot sector

 

--exclude=FILE

Skip selected file or directory

 

--ignore-exclusions

Scan also excluded paths and extensions

Exclusion paths

/root/* - The "root" directory and all of its sub-directories and their content.

/root - The "root" directory only.

/root/file.txt - The file.txt in  "root" directory only.

 

example

Wildcards in the middle of a path

We highly recommend that you do not use wildcards in the middle of a path (for example /home/user/*/data/file.dat) unless your system infrastructure requires it. See the following Knowledgebase article for more information.

Example

Run On-demand scan of /root/ directory recursively with "@Smart scan" scan profile as a background process:

/opt/eset/eea/bin/odscan --scan --profile="@Smart scan" /root/ &

Run On-demand scan with "@Smart scan" scan profile regarding multiple destinations recursively:

/opt/eset/eea/bin/odscan --scan --profile="@Smart scan" /root/ /tmp/ /home/

List all running scans

/opt/eset/eea/bin/odscan -l

Pause scan with session-id "15". Each scan has its own unique session-id generated when it is started.

/opt/eset/eea/bin/odscan -p 15

Stop scan with session-id "15". Each scan has its own unique session-id generated when it is started.

/opt/eset/eea/bin/odscan -t 15

Run On-demand scan with an excluded directory /root/exc_dir and an excluded file /root/eicar.com:

/opt/eset/eea/bin/odscan --scan --exclude=/root/exc_dir --exclude=/root/eicar.com

Scan the boot sector of removable devices. Execute the command below as a privileged user.

sudo /opt/eset/eea/bin/odscan --scan --profile="@In-depth scan" --boot-removable

Exit codes

From ESET Endpoint Antivirus for Linux version 7.1, the odscan utility displays an exit code upon completed scan.

Exit codes

Meaning

0

No threat found

1

Threat found and cleaned

10

Some files could not be scanned (may be threats)

50

Threat found

100

Error

Scan profiles

Your preferred scan parameters (Threatsense parameters) can be saved for future scanning. We recommend that you create a different profile (with various scan targets, scan methods and other parameters) for each regularly used scan.

Create a new profile through ESET Security Management Center

1.In  ESET Security Management Center click Policies > New policy and type a name for the policy.

2.Click Settings, and select ESET Endpoint for Linux (V7+) from the drop-down menu.

3.Click Malware scans > On-demand scan, and click Edit next to List of profiles.

4.Enter the desired name of the new profile, click Add and then click Save.

5.In the Selected profile drop-down menu, select the new profile you created and adjust scan-related settings in the Malware scans section.

6.Navigate to Assign, click Assign...,  select the desired group of computers the policy will apply to.

7.Click Ok and then Finish.