---
name: "avscan"
section: "1"
platform: "linux"
package: "avscan"
version: "1.1.2-openssl-1etch1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/avscan"
---

# avscan(1)

Clam AntiVirus scanner front end

## NAME

avscan - Clam AntiVirus scanner front end

## SYNTAX

**avscan** \<*path(s)...*\> \[*options*\]

**avscan** **--scan** \<*path(s)...*\> \[*options*\]

## DESCRIPTION

Front end for the Clam AntiVirus (ClamAV) scanner that uses the GIMP Toolkit and Endeavour Mark II.

The \<*path(s)...*\> specifies the full paths to the file(s) and/or directory(ies) to scan at startup.

The **--scan** option specifies to perform a scan in text-mode. This is typically used internally by this program to call itself in order to perform a scan process when it is running in GUI mode.

## OPTIONS

- **--recursive**

  Recurse into subdirectories.

- **-r**

  Same as **--recursive**.

- **--executables-only**

  Scan executable files only.

- **-x**

  Same as **--executables-only**.

- **--ignore-links**

  Do not scan links.

- **-l**

  Same as **--ignore-links**.

- **--database** \<*path*\>

  Set the virus database to \<*path*\> (this may be a file or directory).

- **-db** \<*path*\>

  Same as **--database**.

- **--scan**

  Use text-mode scanning. This option is intended for AVScan to call itself in order to perform the scan on a separate process.

- **--help**

  Prints (this) help screen and exits.

- **--version**

  Prints version information and exits.

## FILES

- **/usr/lib/endeavour2/bin/avscan**

  Program.

- **/usr/man/man1/avscan.1.bz2**

  Manual page.

- **/usr/share/endeavour2/icons/icon\_avscan\_48x48.xpm**

  Icon.

- **$HOME/.endeavour2/avscan.ini**

  Configuration.

- **$HOME/.endeavour2/avscan\_scan\_list.ini**

  Scan list.

- **/usr/bin/freshclam**

  Clam AntiVirus database update program.

- **/etc/clamav.conf**

  Clam AntiVirus configuration.

- **/usr/share/clamav**

  Clam AntiVirus database directory.

## ENVIRONMENT VARIABLES

- **DISPLAY**

  Specifies the host address, display number, and screen number to connect to the X server.

- **PATH**

  Specifies the search path, a string containing a list of paths separated by ; characters

- **USERNAME**

  Specifies the user's name.

- **USER**

  Fallback for **USERNAME**.

- **HOME**

  Specifies the absolute path to the user's home directory.

- **EDITOR**

  Specifies the command to execute the preferred text editor.

- **EDIT**

  Fallback for **EDITOR**.

- **VIEWER**

  Specifies the command to execute the preferred file viewer.

- **VIEW**

  Fallback for **VIEWER**.

- **BROWSER**

  Specifies the command to execute the preferred web browser.

- **HELPBROWSER**

  Specifies the command to execute the preferred help browser (if this is not set then it will fall back to **BROWSER**).

- **TMPDIR**

  Specifies the path to the temporary files directory.

## EXAMPLES

To run this program, type:

\# avscan &

To scan the directory /home/me recursively, type:

\# avscan /home/me -r

To scan the directory /home/me recursively and specify the virus database from the command line (no GUI), type:

\# avscan --scan /home/me -db /usr/share/clamav -r

## RETURN CODES

- **0**

  Success.

- **1**

  Virus detected or general error.

- **2**

  Invalid value.

- **3**

  Systems error or memory allocation error.

- **4**

  User aborted.

- **5**

  User responded with "no" to a query.

- **6**

  An identical operation is already in progress.

- **8**

  Segmentation fault.

## AUTHORS

http://wolfpack.twu.net/contacts.html

## SEE ALSO

[endeavour2(1)](/endeavour2/1.md) [clamscan(1)](/clamscan/1.md) [clamdscan(1)](/clamdscan/1.md) [freshclam(1)](/freshclam/1.md) clamav.conf(5)