avscan(1)

Usage

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

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

Overview

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

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.