NAME

       guymager - a forensic acquisition program

SYNOPSIS

       guymager [log=log_file] [cfg=configuration_file] [options]

DESCRIPTION

       Guymager is a Qt-based forensic imager. It is capable of producing image files in EWF, AFF and dd format.
       Its  main  strenghs are the easy user interface, the high imaging speed and the extended acquisition info
       file.

       The internal structure is based on separate threads for  reading,  hash  calculation  (MD5  and  SHA256),
       writing  and  includes  a  parallelised compression engine, thus making full usage of multi-processor and
       hyper-threading machines.

       Guymager should be run with root privileges, as other users  do  not  have  access  to  physical  devices
       normally.

OPTIONS

       log=log_file
              By default, guymager uses /var/log/guymager.log as its log file. This option allows for specifying
              a different file.

       cfg=configuration_file
              The  default configuration file is /etc/guymager/guymager.cfg. This option allows for specifying a
              different file. Guymager creates a template configuration file when the  option  -cfg=template.cfg
              is given.

       All  other  configuration  options may be specified on the command line and/or in the configuration file.
       See /etc/guymager/guymager.cfg for a description of all possible options. In case an option is  specified
       in the configuration file and on the command line, the command line dominates.

EXIT CODES

       Guymager normally returns an exit code of 0. Exit code 1 means that Guymager terminated because the
       AutoExit function became active. All other exit codes are related to internal Guymager or Qt errors.

EXAMPLES

       Write all log entries to ./my.log:
              guymager log=my.log

       Create a template configuration file
              guymager cfg=template.cfg

       Read the configuration from my.cfg and use 4 threads for parallelised compression:
              guymager cfg=my.cfg CompressionThreads=4

       See /etc/guymager/guymager.cfg for details about option CompressionThreads and all other options as well.

AUTHOR

       Guy Voncken (develop (at) faert.net)

version 0.8.13-2build2                             2024-04-01                                        guymager(1)