clamscan/clamscan.c
e3aaff8e
 /*
e1cbc270
  *  Copyright (C) 2013-2019 Cisco Systems, Inc. and/or its affiliates. All rights reserved.
  *  Copyright (C) 2007-2013 Sourcefire, Inc.
086eab5c
  *
  *  Authors: Tomasz Kojm
e3aaff8e
  *
  *  This program is free software; you can redistribute it and/or modify
bb34cb31
  *  it under the terms of the GNU General Public License version 2 as
  *  published by the Free Software Foundation.
e3aaff8e
  *
  *  This program is distributed in the hope that it will be useful,
  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  *  GNU General Public License for more details.
  *
  *  You should have received a copy of the GNU General Public License
  *  along with this program; if not, write to the Free Software
48b7b4a7
  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
  *  MA 02110-1301, USA.
e3aaff8e
  */
 
6d6e8271
 #if HAVE_CONFIG_H
 #include "clamav-config.h"
 #endif
 
e3aaff8e
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
9a03413e
 #include <signal.h>
 
288057e9
 #ifdef HAVE_UNISTD_H
e3aaff8e
 #include <unistd.h>
34f71e0e
 #endif
4cd80898
 #ifndef _WIN32
e3aaff8e
 #include <sys/time.h>
34f71e0e
 #endif
e3aaff8e
 #include <time.h>
7a2997f1
 #ifdef C_LINUX
 #include <sys/resource.h>
 #endif
e3aaff8e
 
 #include "others.h"
7a2997f1
 #include "global.h"
e3aaff8e
 #include "manager.h"
afb48b28
 
7a2997f1
 #include "shared/misc.h"
 #include "shared/output.h"
ee6702ab
 #include "shared/actions.h"
269d520d
 #include "shared/optparser.h"
fc56deed
 
24555841
 #include "libclamav/str.h"
ec6429ab
 #include "libclamav/clamav.h"
24555841
 
e3aaff8e
 void help(void);
 
7a2997f1
 struct s_info info;
9c025fb3
 short recursion = 0, bell = 0;
 short printinfected = 0, printclean = 1;
58bcf502
 
7b8edc5c
 int main(int argc, char **argv)
e3aaff8e
 {
288057e9
     int ds, dms, ret;
     double mb, rmb;
     struct timeval t1, t2;
4cd80898
 #ifndef _WIN32
288057e9
     sigset_t sigset;
34f71e0e
 #endif
288057e9
     struct optstruct *opts;
     const struct optstruct *opt;
e3aaff8e
 
01eebc13
     if (check_flevel())
288057e9
         exit(2);
bca0b679
 
4cd80898
 #if !defined(_WIN32) && !defined(C_BEOS)
9a03413e
     sigemptyset(&sigset);
     sigaddset(&sigset, SIGXFSZ);
     sigprocmask(SIG_SETMASK, &sigset, NULL);
 #endif
 
d4a7c3a0
     cl_initialize_crypto();
 
288057e9
     if ((opts = optparse(NULL, argc, argv, 1, OPT_CLAMSCAN, 0, NULL)) == NULL) {
         mprintf("!Can't parse command line options\n");
         return 2;
7b8edc5c
     }
 
288057e9
     if (optget(opts, "verbose")->enabled) {
         mprintf_verbose = 1;
         logg_verbose    = 1;
afb48b28
     }
e3aaff8e
 
288057e9
     if (optget(opts, "quiet")->enabled)
         mprintf_quiet = 1;
e3aaff8e
 
288057e9
     if (optget(opts, "stdout")->enabled)
         mprintf_stdout = 1;
7b8edc5c
 
288057e9
     if (optget(opts, "debug")->enabled) {
fc56deed
 #if defined(C_LINUX)
288057e9
         /* njh@bandsman.co.uk: create a dump if needed */
         struct rlimit rlim;
fc56deed
 
288057e9
         rlim.rlim_cur = rlim.rlim_max = RLIM_INFINITY;
         if (setrlimit(RLIMIT_CORE, &rlim) < 0)
             perror("setrlimit");
fc56deed
 #endif
288057e9
         cl_debug(); /* enable debug messages */
fc56deed
     }
d4d14218
 
3ca11170
     if (optget(opts, "gen-mdb")->enabled) {
         cl_always_gen_section_hash();
     }
 
288057e9
     if (optget(opts, "version")->enabled) {
         print_version(optget(opts, "database")->strarg);
         optfree(opts);
         return 0;
e3aaff8e
     }
 
288057e9
     if (optget(opts, "help")->enabled) {
         optfree(opts);
         help();
         return 0;
e3aaff8e
     }
 
288057e9
     if (optget(opts, "recursive")->enabled)
         recursion = 1;
e3aaff8e
 
288057e9
     if (optget(opts, "infected")->enabled)
         printinfected = 1;
e3aaff8e
 
288057e9
     if (optget(opts, "suppress-ok-results")->enabled)
         printclean = 0;
9c025fb3
 
288057e9
     if (optget(opts, "bell")->enabled)
         bell = 1;
af22ece1
 
e3aaff8e
     /* initialize logger */
288057e9
     if ((opt = optget(opts, "log"))->enabled) {
         logg_file = opt->strarg;
         if (logg("#\n-------------------------------------------------------------------------------\n\n")) {
             mprintf("!Problem with internal logger.\n");
             optfree(opts);
             return 2;
         }
     } else
         logg_file = NULL;
 
     if (actsetup(opts)) {
         optfree(opts);
         logg_close();
         exit(2);
ee6702ab
     }
7b8edc5c
 
7a2997f1
     memset(&info, 0, sizeof(struct s_info));
e3aaff8e
 
b8f3f028
     gettimeofday(&t1, NULL);
34f71e0e
 
269d520d
     ret = scanmanager(opts);
e3aaff8e
 
288057e9
     if (!optget(opts, "no-summary")->enabled) {
         gettimeofday(&t2, NULL);
 
         ds  = t2.tv_sec - t1.tv_sec;
         dms = t2.tv_usec - t1.tv_usec;
         ds -= (dms < 0) ? (1) : (0);
         dms += (dms < 0) ? (1000000) : (0);
         logg("\n----------- SCAN SUMMARY -----------\n");
         logg("Known viruses: %u\n", info.sigs);
         logg("Engine version: %s\n", get_version());
         logg("Scanned directories: %u\n", info.dirs);
         logg("Scanned files: %u\n", info.files);
         logg("Infected files: %u\n", info.ifiles);
         if (info.errors)
             logg("Total errors: %u\n", info.errors);
         if (notremoved) {
             logg("Not removed: %u\n", notremoved);
         }
         if (notmoved) {
             logg("Not %s: %u\n", optget(opts, "copy")->enabled ? "moved" : "copied", notmoved);
         }
         mb = info.blocks * (CL_COUNT_PRECISION / 1024) / 1024.0;
         logg("Data scanned: %2.2lf MB\n", mb);
         rmb = info.rblocks * (CL_COUNT_PRECISION / 1024) / 1024.0;
         logg("Data read: %2.2lf MB (ratio %.2f:1)\n", rmb, info.rblocks ? (double)info.blocks / (double)info.rblocks : 0);
         logg("Time: %u.%3.3u sec (%u m %u s)\n", ds, dms / 1000, ds / 60, ds % 60);
e3aaff8e
     }
 
269d520d
     optfree(opts);
f9afc309
 
c32360c1
     return ret;
e3aaff8e
 }
 
 void help(void)
 {
     mprintf_stdout = 1;
 
     mprintf("\n");
e098cdc5
     mprintf("                       Clam AntiVirus: Scanner %s\n", get_version());
964a1e73
     printf("           By The ClamAV Team: https://www.clamav.net/about.html#credits\n");
e1cbc270
     printf("           (C) 2019 Cisco Systems, Inc.\n");
e098cdc5
     mprintf("\n");
     mprintf("    clamscan [options] [file/directory/-]\n");
     mprintf("\n");
     mprintf("    --help                -h             Show this help\n");
a36e6e5c
     mprintf("    --version             -V             Print version number\n");
5def21ff
     mprintf("    --verbose             -v             Be verbose\n");
248c2f4d
     mprintf("    --archive-verbose     -a             Show filenames inside scanned archives\n");
a36e6e5c
     mprintf("    --debug                              Enable libclamav's debug messages\n");
     mprintf("    --quiet                              Only output error messages\n");
edb23158
     mprintf("    --stdout                             Write to stdout instead of stderr. Does not affect 'debug' messages.\n");
a36e6e5c
     mprintf("    --no-summary                         Disable summary at end of scanning\n");
     mprintf("    --infected            -i             Only print infected files\n");
9c025fb3
     mprintf("    --suppress-ok-results -o             Skip printing OK files\n");
a36e6e5c
     mprintf("    --bell                               Sound bell on virus detection\n");
e3aaff8e
     mprintf("\n");
a9082ea2
     mprintf("    --tempdir=DIRECTORY                  Create temporary files in DIRECTORY\n");
269d520d
     mprintf("    --leave-temps[=yes/no(*)]            Do not remove temporary files\n");
e098cdc5
     mprintf("    --gen-json[=yes/no(*)]               Generate JSON description of scanned file(s). JSON will be printed and also-\n");
     mprintf("                                         dropped to the temp directory if --leave-temps is enabled.\n");
     mprintf("    --database=FILE/DIR   -d FILE/DIR    Load virus database from FILE or load all supported db files from DIR\n");
208ceae5
     mprintf("    --official-db-only[=yes/no(*)]       Only load official signatures\n");
a9ebff44
     mprintf("    --log=FILE            -l FILE        Save scan report to FILE\n");
269d520d
     mprintf("    --recursive[=yes/no(*)]  -r          Scan subdirectories recursively\n");
1feaa72a
     mprintf("    --allmatch[=yes/no(*)]   -z          Continue scanning within file after finding a match\n");
2086dc5c
     mprintf("    --cross-fs[=yes(*)/no]               Scan files and directories on other filesystems\n");
8c57a6c1
     mprintf("    --follow-dir-symlinks[=0/1(*)/2]     Follow directory symlinks (0 = never, 1 = direct, 2 = always)\n");
     mprintf("    --follow-file-symlinks[=0/1(*)/2]    Follow file symlinks (0 = never, 1 = direct, 2 = always)\n");
c2b6681b
     mprintf("    --file-list=FILE      -f FILE        Scan files from FILE\n");
269d520d
     mprintf("    --remove[=yes/no(*)]                 Remove infected files. Be careful!\n");
5def21ff
     mprintf("    --move=DIRECTORY                     Move infected files into DIRECTORY\n");
c6d2bbbc
     mprintf("    --copy=DIRECTORY                     Copy infected files into DIRECTORY\n");
266f3967
     mprintf("    --exclude=REGEX                      Don't scan file names matching REGEX\n");
66ceca09
     mprintf("    --exclude-dir=REGEX                  Don't scan directories matching REGEX\n");
266f3967
     mprintf("    --include=REGEX                      Only scan file names matching REGEX\n");
66ceca09
     mprintf("    --include-dir=REGEX                  Only scan directories matching REGEX\n");
e3aaff8e
     mprintf("\n");
c4910836
     mprintf("    --bytecode[=yes(*)/no]               Load bytecode from the database\n");
62315ce6
     mprintf("    --bytecode-unsigned[=yes/no(*)]      Load unsigned bytecode\n");
8c57a6c1
     mprintf("    --bytecode-timeout=N                 Set bytecode timeout (in milliseconds)\n");
c94a95b8
     mprintf("    --statistics[=none(*)/bytecode/pcre] Collect and print execution statistics\n");
269d520d
     mprintf("    --detect-pua[=yes/no(*)]             Detect Possibly Unwanted Applications\n");
b023c36d
     mprintf("    --exclude-pua=CAT                    Skip PUA sigs of category CAT\n");
     mprintf("    --include-pua=CAT                    Load PUA sigs of category CAT\n");
269d520d
     mprintf("    --detect-structured[=yes/no(*)]      Detect structured data (SSN, Credit Card)\n");
5fe6e72b
     mprintf("    --structured-ssn-format=X            SSN format (0=normal,1=stripped,2=both)\n");
     mprintf("    --structured-ssn-count=N             Min SSN count to generate a detect\n");
     mprintf("    --structured-cc-count=N              Min CC count to generate a detect\n");
269d520d
     mprintf("    --scan-mail[=yes(*)/no]              Scan mail files\n");
c6cea234
     mprintf("    --phishing-sigs[=yes(*)/no]          Enable email signature-based phishing detection\n");
     mprintf("    --phishing-scan-urls[=yes(*)/no]     Enable URL signature-based phishing detection\n");
     mprintf("    --heuristic-alerts[=yes(*)/no]       Heuristic alerts\n");
269d520d
     mprintf("    --heuristic-scan-precedence[=yes/no(*)] Stop scanning as soon as a heuristic match is found\n");
e098cdc5
     mprintf("    --normalize[=yes(*)/no]              Normalize html, script, and text files. Use normalize=no for yara compatibility\n");
269d520d
     mprintf("    --scan-pe[=yes(*)/no]                Scan PE files\n");
     mprintf("    --scan-elf[=yes(*)/no]               Scan ELF files\n");
     mprintf("    --scan-ole2[=yes(*)/no]              Scan OLE2 containers\n");
     mprintf("    --scan-pdf[=yes(*)/no]               Scan PDF files\n");
1e41fdba
     mprintf("    --scan-swf[=yes(*)/no]               Scan SWF files\n");
269d520d
     mprintf("    --scan-html[=yes(*)/no]              Scan HTML files\n");
ea9ffd29
     mprintf("    --scan-xmldocs[=yes(*)/no]           Scan xml-based document files\n");
     mprintf("    --scan-hwp3[=yes(*)/no]              Scan HWP3 files\n");
269d520d
     mprintf("    --scan-archive[=yes(*)/no]           Scan archive files (supported by libclamav)\n");
c6cea234
     mprintf("    --alert-broken[=yes/no(*)]           Alert on broken executable files (PE & ELF)\n");
     mprintf("    --alert-encrypted[=yes/no(*)]        Alert on encrypted archives and documents\n");
     mprintf("    --alert-encrypted-archive[=yes/no(*)] Alert on encrypted archives\n");
     mprintf("    --alert-encrypted-doc[=yes/no(*)]    Alert on encrypted documents\n");
     mprintf("    --alert-macros[=yes/no(*)]           Alert on OLE2 files containing VBA macros\n");
     mprintf("    --alert-exceeds-max[=yes/no(*)]      Alert on files that exceed max file size, max scan size, or max recursion limit\n");
     mprintf("    --alert-phishing-ssl[=yes/no(*)]     Alert on emails containing SSL mismatches in URLs\n");
     mprintf("    --alert-phishing-cloak[=yes/no(*)]   Alert on emails containing cloaked URLs\n");
     mprintf("    --alert-partition-intersection[=yes/no(*)] Alert on raw DMG image files containing partition intersections\n");
5cc4cb86
     mprintf("    --nocerts                            Disable authenticode certificate chain verification in PE files\n");
7209997f
     mprintf("    --dumpcerts                          Dump authenticode certificate chain in PE files\n");
a36e6e5c
     mprintf("\n");
a5d91be7
     mprintf("    --max-filesize=#n                    Files larger than this will be skipped and assumed clean\n");
269d520d
     mprintf("    --max-scansize=#n                    The maximum amount of data to scan for each container file (**)\n");
     mprintf("    --max-files=#n                       The maximum number of files to scan for each container file (**)\n");
     mprintf("    --max-recursion=#n                   Maximum archive recursion level for container file (**)\n");
14dee074
     mprintf("    --max-dir-recursion=#n               Maximum directory recursion level\n");
b2726a53
     mprintf("    --max-embeddedpe=#n                  Maximum size file to check for embedded PE\n");
     mprintf("    --max-htmlnormalize=#n               Maximum size of HTML file to normalize\n");
     mprintf("    --max-htmlnotags=#n                  Maximum size of normalized HTML file to scan\n");
     mprintf("    --max-scriptnormalize=#n             Maximum size of script file to normalize\n");
     mprintf("    --max-ziptypercg=#n                  Maximum size zip to type reanalyze\n");
4b5895b8
     mprintf("    --max-partitions=#n                  Maximum number of partitions in disk image to be scanned\n");
067bce5f
     mprintf("    --max-iconspe=#n                     Maximum number of icons in PE file to be scanned\n");
731c8e62
     mprintf("    --max-rechwp3=#n                     Maximum recursive calls to HWP3 parsing function\n");
050f1036
 #if HAVE_PCRE
     mprintf("    --pcre-match-limit=#n                Maximum calls to the PCRE match function.\n");
     mprintf("    --pcre-recmatch-limit=#n             Maximum recursive calls to the PCRE match function.\n");
877bca9b
     mprintf("    --pcre-max-filesize=#n               Maximum size file to perform PCRE subsig matching.\n");
050f1036
 #endif /* HAVE_PCRE */
779c0fdc
     mprintf("    --disable-cache                      Disable caching and cache checks for hash sums of scanned files.\n");
ec6429ab
     mprintf("\n");
e098cdc5
     mprintf("Pass in - as the filename for stdin.\n");
     mprintf("\n");
269d520d
     mprintf("(*) Default scan settings\n");
     mprintf("(**) Certain files (e.g. documents, archives, etc.) may in turn contain other\n");
     mprintf("   files inside. The above options ensure safe processing of this kind of data.\n\n");
e3aaff8e
 }