Fortinet white logo
Fortinet white logo

CLI Reference

scand av

scand av

Use this command to monitor and troubleshoot the antivirus (AV) scanning framework. In this architecture, AV scanning is offloaded from the Proxyd process to a dedicated Dlpd daemon, which manages multiple child processes (avscan) for asynchronous, non-blocking payload inspection.

This design ensures that if a scanning child process crashes or hangs, it is automatically terminated and restarted by Dlpd without impacting the main WAF traffic flow. Administrators can also manually verify file scanning behavior using the standalone tool # /bin/avscan <file | dir>.

Syntax

execute scand av {clear-cache | clear-stats | show-cache-summary | show-stats}

Variable Description Default

clear-cache

Clears all entries currently stored in the AV verdict hash table.

Note: The AV cache is not automatically cleared when configurations change; you must manually execute this command to apply new settings to files already stored in the cache.

No default.

clear-stats

Resets all AV scanning performance and error counters to zero.

No default.

show-cache-summary

Displays a summary of the AV verdict cache, which reduces redundant processing by storing scan results.

  • max — The maximum capacity of the hash table (50K, 100K, or 200K depending on the platform).

  • cur_cnt — Number of entries currently in the cache.

  • pending_cnt — Number of requests currently awaiting a verdict.

  • clean_cnt — Count of files identified as clean.

  • virus_cnt — Count of files identified as malicious.

  • stuck_cnt — Number of entries that reached a timeout state during scanning.

  • peak_time — The longest scan duration processed.

  • peak_size — The largest file size processed.

No default.

show-stats

Displays detailed operational statistics for backend workers and request queues.

  • scan_worker_number — The number of configured backend scan processes.

  • scan_worker_timeout — The timeout value for backend scans.

  • verdict_req_cnt — Total verdict requests received from WAF modules.

  • verdict_req_found_cnt — Count of requests satisfied by the verdict cache.

  • scan_req_cnt — Total unique scan requests sent to backend workers.

  • scan_req_input_err_cnt — Count of scan request input errors.

  • scan_req_enq_err_cnt — Count of scan request enqueue errors.

  • scan_enq_cnt — Count of items added to the scan input queue.

  • scan_deq_cnt — Count of items removed from the scan input queue.

  • pending_verdict_hash_insert_cnt — Count of pending entries inserted into the verdict hash table.

  • pending_verdict_hash_insert_err_cnt — Count of errors when inserting pending entries into the hash table.

  • verdict_enq_cnt — Count of results received from avscan child processes added to the result queue.

  • verdict_hash_found_cnt — Count of verdict entries successfully found and updated in the hash table.

  • verdict_hash_insert_cnt — Count of verdict entries successfully added to the hash table.

  • verdict_hash_insert_err_cnt — Count of errors when adding verdict entries to the hash table.

  • wkr_timeout_cnt — Total number of backend scan timeouts.

  • child_restart_tx_error_cnt — Count of child process restarts due to transmission errors.

  • child_restart_rx_error_cnt — Count of child process restarts due to reception errors.

  • child_restart_rx_timeout_cnt — Count of child process restarts due to reception timeouts.

  • child_start_but_not_ready_cnt — Count of child process restarts when a newly started child becomes stuck.

  • child_restart_but_not_ready_cnt — Count of child process restarts when a restarted child becomes stuck.

  • wkr_current_busy_cnt — Number of worker threads currently waiting for results from a child process.

  • cfg_update_enq_cnt — Count of antivirus configuration updates added to the queue.

  • cfg_update_deq_cnt — Count of antivirus configuration updates removed from the queue.

  • pkg_update_enq_cnt — Count of AV package updates added to the queue.

  • pkg_update_deq_cnt — Count of AV package updates removed from the queue.

  • update_timeout_cnt — Count of configuration or package update timeouts.

  • clear_stats_cnt — Number of times the execute scand av clear-stats command has been used.

No default.

scand av

scand av

Use this command to monitor and troubleshoot the antivirus (AV) scanning framework. In this architecture, AV scanning is offloaded from the Proxyd process to a dedicated Dlpd daemon, which manages multiple child processes (avscan) for asynchronous, non-blocking payload inspection.

This design ensures that if a scanning child process crashes or hangs, it is automatically terminated and restarted by Dlpd without impacting the main WAF traffic flow. Administrators can also manually verify file scanning behavior using the standalone tool # /bin/avscan <file | dir>.

Syntax

execute scand av {clear-cache | clear-stats | show-cache-summary | show-stats}

Variable Description Default

clear-cache

Clears all entries currently stored in the AV verdict hash table.

Note: The AV cache is not automatically cleared when configurations change; you must manually execute this command to apply new settings to files already stored in the cache.

No default.

clear-stats

Resets all AV scanning performance and error counters to zero.

No default.

show-cache-summary

Displays a summary of the AV verdict cache, which reduces redundant processing by storing scan results.

  • max — The maximum capacity of the hash table (50K, 100K, or 200K depending on the platform).

  • cur_cnt — Number of entries currently in the cache.

  • pending_cnt — Number of requests currently awaiting a verdict.

  • clean_cnt — Count of files identified as clean.

  • virus_cnt — Count of files identified as malicious.

  • stuck_cnt — Number of entries that reached a timeout state during scanning.

  • peak_time — The longest scan duration processed.

  • peak_size — The largest file size processed.

No default.

show-stats

Displays detailed operational statistics for backend workers and request queues.

  • scan_worker_number — The number of configured backend scan processes.

  • scan_worker_timeout — The timeout value for backend scans.

  • verdict_req_cnt — Total verdict requests received from WAF modules.

  • verdict_req_found_cnt — Count of requests satisfied by the verdict cache.

  • scan_req_cnt — Total unique scan requests sent to backend workers.

  • scan_req_input_err_cnt — Count of scan request input errors.

  • scan_req_enq_err_cnt — Count of scan request enqueue errors.

  • scan_enq_cnt — Count of items added to the scan input queue.

  • scan_deq_cnt — Count of items removed from the scan input queue.

  • pending_verdict_hash_insert_cnt — Count of pending entries inserted into the verdict hash table.

  • pending_verdict_hash_insert_err_cnt — Count of errors when inserting pending entries into the hash table.

  • verdict_enq_cnt — Count of results received from avscan child processes added to the result queue.

  • verdict_hash_found_cnt — Count of verdict entries successfully found and updated in the hash table.

  • verdict_hash_insert_cnt — Count of verdict entries successfully added to the hash table.

  • verdict_hash_insert_err_cnt — Count of errors when adding verdict entries to the hash table.

  • wkr_timeout_cnt — Total number of backend scan timeouts.

  • child_restart_tx_error_cnt — Count of child process restarts due to transmission errors.

  • child_restart_rx_error_cnt — Count of child process restarts due to reception errors.

  • child_restart_rx_timeout_cnt — Count of child process restarts due to reception timeouts.

  • child_start_but_not_ready_cnt — Count of child process restarts when a newly started child becomes stuck.

  • child_restart_but_not_ready_cnt — Count of child process restarts when a restarted child becomes stuck.

  • wkr_current_busy_cnt — Number of worker threads currently waiting for results from a child process.

  • cfg_update_enq_cnt — Count of antivirus configuration updates added to the queue.

  • cfg_update_deq_cnt — Count of antivirus configuration updates removed from the queue.

  • pkg_update_enq_cnt — Count of AV package updates added to the queue.

  • pkg_update_deq_cnt — Count of AV package updates removed from the queue.

  • update_timeout_cnt — Count of configuration or package update timeouts.

  • clear_stats_cnt — Number of times the execute scand av clear-stats command has been used.

No default.