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)