instverify

Package: WA2L/WinTools 1.2.08
Section: Library Commands (3)
Updated: 14 September 2024
Index Return to Main Contents

 

NAME

instverify - verify package installation

 

SYNOPSIS

WA2LWinTools/lib/instverify [ -h | -V ]

instverify [ -v ][ -n ]

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

with the instverify command it can be verified that all files of the WA2L/WinTools package are installed and are unchanged. Therefore it can be checked if the installation is complete and correct.

The verification is done thru checking the MD5 checksum of each installed file against a reference checksum.

All files whose checksum do not match against the reference or which do not exist on the system are printed to stdout.

During setup or upgrade of the WA2L/WinTools package, the instverify is also used automatically to verify the installation.

 

OPTIONS

-h
help message.

-V
print program version.

-v
verbose output printing also the files which are OK to stdout.

-n
non-interactive execution.

Where the interactive part is only a keypress at the end of the execution when the command is double clicked in the explorer.

When executing instverify from the console the execution is always non-interactive.

Therefore the -n option will be of minor importance in normal use.

 

ENVIRONMENT

-

 

EXIT STATUS

0
no error.

1
the installation could not be verified successfully completely against the reference.

There can be files missing or the checksum of files do not match with the reference.

Missing files can be caused thru manual deletion by the user (by error) of by "false positive" reports of Antivirus programs which remove potential virus infected files from the system.

See also section BUGS related to "false positive" problems.

4
usage printed.

5
version printed.

 

FILES

lib/revision.md5
MD5 checksums of all files that are part of the WA2L/WinTools package. This file is updated by the pack command.

lib/src/vscan/vscan.zip
virus scan reports of virustotal.com for all executable (.exe, .com, .dll, .a, .cmd, .awk, .ps1, .vbs and .zip) files.

lib/src/vscan/vscan.ziprpt/result.txt
consolidated virus scan result report.

Use make lsreport to view the report without uncompressing the vscan.zip file.

 

EXAMPLES

-

 

SEE ALSO

wintoolsintro(1), inststats(3), pack(1m), md5sum(1), wintoolsdownload(1m), wintoolsrevisionnotifier(1m), https://en.wikipedia.org/wiki/Checksum (https://en.wikipedia.org/wiki/index.php?oldid=927259087), https://de.wikipedia.org/wiki/Pr%C3%BCfsumme (https://de.wikipedia.org/wiki/index.php?oldid=188188075), https://virustotal.com

 

NOTES

-

 

BUGS

 

Antivirus false positive Problems

It has been experienced recently that some Antivirus programs report commands I developed by myself as being Virus/Trojan infected. Which of course is not the case.

As the WA2L/WinTools package is Open Source, all commands I developed are either realised as scripts or when using a programming language that need compilation the source code is included in the package and is available in the lib/src/ directory.

I could also eliminate the speculation that the file was infected during transfer or installation, due to the fact that the checksum did not change since the compiled version on my system (which is also protected by a Antivirus program).

Even a re-compilation directly on the system reporting the thread fired immediately a virus alert, which is very illogical, especially when looking at the very simple code of one program that causes a "false positive" alert:

  #include <stdio.h>
  #define ProgName "ebook-convert"

  int main(int argc, char *argv[]) {
      printf("%s-ERROR: Calibre '%s.exe' not found.\n",ProgName,ProgName);
      printf("%s-INFO:  Calibre can be downloaded from 'https://calibre-ebook.com/download_portable'.\n",ProgName);
      printf("%s-INFO:  see in manual pages on how to set '..._CALIBRE_PATH=' in WA2L/WinTools configuration files.\n",ProgName);
  } // main

False positive reporting was observed on the following executables: lib/ebook-convert.exe, lib/put.exe.

 

More Information

See more information about Antivirus "false positive" issues:

[1]
NirBlog Homepage, Antivirus companies cause a big headache to small developers, 24.11.2019, URL: https://blog.nirsoft.net/2009/05/17/antivirus-companies-cause-a-big-headache-to-small-developers/
[2]
NirBlog Homepage, Archive for the 'Antivirus Issues' Category, 24.11.2019, URL: https://blog.nirsoft.net/category/antivirus-issues/

[3]
Techadvisor Homepage, How to deal with an antivirus false positive, 24.11.2019, URL: https://www.techadvisor.co.uk/how-to/security/how-deal-with-antivirus-false-positive-3689720/

[4]
Datenschutz-Praxis Homepage, False Positives: Wenn sich die IT-Sicherheit irrt, 24.11.2019, URL: https://www.datenschutz-praxis.de/fachartikel/fehlalarm-wenn-die-anti-viren-software-zum-risiko-wird/

 

AUTHOR

instverify was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2019 Christian Walther

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
Antivirus false positive Problems
More Information
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:32:11 GMT, September 14, 2024