1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013
|
REM ****************************************************************************
REM Project: GUYMAGER
REM ****************************************************************************
REM Programmer: Guy Voncken
REM Police Grand-Ducale
REM Service de Police Judiciaire
REM Section Nouvelles Technologies
REM ****************************************************************************
REM Main configuration file
REM ****************************************************************************
REM Copyright 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018
REM Guy Voncken
REM
REM This file is part of Guymager.
REM
REM Guymager is free software: you can redistribute it and/or modify
REM it under the terms of the GNU General Public License as published by
REM the Free Software Foundation, either version 2 of the License, or
REM (at your option) any later version.
REM
REM Guymager is distributed in the hope that it will be useful,
REM but WITHOUT ANY WARRANTY; without even the implied warranty of
REM MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
REM GNU General Public License for more details.
REM
REM You should have received a copy of the GNU General Public License
REM along with Guymager. If not, see <http://www.gnu.org/licenses/>.
REM ATTENTION
REM ---------
REM Do not edit this file; put all your changes into /etc/guymager/local.cfg instead!
REM See the notes at the end of this file.
SECTION GUYMAGER
REM How this configuration file works
REM ---------------------------------
REM Guymager user interface
REM -----------------------
REM
REM The parameter Language contains the language code (for example 'de', 'fr', 'en'). If Guymager doesn't
REM find the corresponding language file it switches to english instead. Contact the author of Guymager if
REM your language is missing. The language files are named guymager_xx.qm, where xx is the language code.
REM If you installed a Debian package, they can be found in directory /usr/share/guymager.
REM Set the parameter Language to AUTO in order to detect the language in use on your system automatically.
REM
REM CheckRootRights decides whether or not Guymager shows the user a warning dialog when starting it without
REM root rights.
REM
REM The StartupXxx parameters configure the position and size of the main guymager window at startup.
REM StartupSize can be set to one of the following:
REM STANDARD Let the X-Window manager choose what it thinks is best
REM MAXIMISED or MAXIMIZED Maximum size
REM FULLSCREEN Maximum size and take away the title bar
REM MANUAL Use the values specified for StartupSizeManualX, StartupSizeManualY,
REM StartupSizeManualDx and StartupSizeManualDy.
REM The final result always slightly depends on the X-Window manager in use. For instance, there might be
REM window managers that can't distinguish MAXIMISED and FULLSCREEN.
REM
REM The dialog that appears when chooosing the image destination path can be adjusted in a similar way by
REM of the parameters FileDialogSize, FileDialogSizeManualDx, FileDialogSizeManualDy. Unfortunately, this
REM only works when using the alternative file dialog, not the Qt file dialog (see UseFileDialogFromQt
REM below).
REM
REM NumberStyle influences the way how numbers are displayed in guymager. There 3 possible values:
REM Locale Use the value of the system LOCALE to determine the format (set the LANG environment
REM correctly).
REM DecimalComma The format would look like 78.234,56 (normal format)
REM DecimalPoint The format would look like 78,234.56 (unusual american format)
REM Remark: Using Locale, more differences are possible. Thus, with the environment variable LANG set to
REM fr_FR, the number would be displayed as 78 234,56 (space as thousands separator). Setting NumberStyle
REM to something else than Locale is not recommended (you may use it if you are too lazy to set up your
REM LANG variable correctly).
REM
REM ScreenRefreshInterval [ms] Some screen fields (speed, remaining time, ...) are refreshed regularly.
REM ScreenRefreshInterval specifies how often this should occur.
REM
REM UseFileDialogFromQt When set to Yes, guymager uses the standard Qt file/directory selection dialogs.
REM There once was a Qt version with a bug in its dialog and an alternative dialog
REM was quickly added to guymager. The bug should have gone by now and this
REM configuration parameter should be set to Yes (the Qt dialogs are better then
REM the alternative programmed by the author of guymager).
REM Adjusting the dialog size (see configuration parameters FileDialogSize,
REM FileDialogSizeManualDx and FileDialogSizeManualDy) only works with the
REM alternative dialog.
REM
REM WarnAboutImageSize Check if image would fit uncompressed to the destination at the moment where
REM the acquisition is started. If not, show a warning.
REM
REM WarnAboutSegmentFileCount Check if the number of segment files would exceed 14972 if the data was stored
REM uncompressed in EWF format. If yes, show a warning. Remark: The 14972th segment
REM would have the file extension ZZZ and thus, more than 14972 segments may lead to
REM problems as there is no clear standard for EWF file names.
REM
REM DeleteAbortedImageFiles In case an acquisition/verification is aborted, Guymager opens a confirmation dialog
REM containing a checkbox for knowing what to do with the already created image files.
REM This configuration parameter allows to set the checkbox default:
REM Yes - The checkbox is ticked (image files will be removed).
REM No - The checkbox is not ticked (image files will be kept).
REM Auto - Guymager sets the tick if the acquisition was aborted while still running
REM (i.e. the image was incomplete) and doesn't if aborted during verification.
REM
REM AutoExit This parameter controls the default setting of the menu point "Misc/Exit" after
REM all acquisitions have completed.
REM
REM AutoExitCountdown = 60 If the autoexit feature becomes active (i.e. the menu flag is set and the acquisitions
REM end), a popup appears with a countdown. AutoExitCountdown allows to set start value
REM of the countdown (in seconds).
Language='auto'
CheckRootRights=yes
StartupSize = MANUAL
StartupSizeManualX = 130
StartupSizeManualY = 250
StartupSizeManualDx = 1000
StartupSizeManualDy = 500
FileDialogSize = MANUAL
FileDialogSizeManualDx = 800
FileDialogSizeManualDy = 500
NumberStyle=Locale
ScreenRefreshInterval = 1500
UseFileDialogFromQt = Yes
WarnAboutImageSize = Yes
WarnAboutSegmentFileCount = Yes
DeleteAbortedImageFiles = Auto
AutoExit = Off
AutoExitCountdown = 60
REM Table Fonts
REM The font configuration table allows choosing own fonts for different GUI elements of Guymager. The left
REM most column of the table below specifies the object. It may be one of the following:
REM Menu The main Guymager menus, its submenus as well as the table popup menu.
REM Toolbar The toolbar just below the menu bar.
REM Table The main Guymager table and the table shown in the clone dialog.
REM InfoField The information field in the lower part of the Guymager window.
REM AcquisitionDialogs The dialogs for normally acquiting and cloning devices.
REM MessageDialogs Other message dialogs.
REM DialogData Dialogs with data areas (such as the device info dialog) use this font for
REM their data area. A monospaced font should be used, for example 'Courier' or
REM 'Ubuntu Mono'. All other parts of the dialog are using the font specified
REM under MessageDialogs.
REM The remaining table columns specify the font to use (Family, Size, Weight and Italic). Column 'Italic'
REM may contain YES or NO. Weight is a number between 0 and 100. The following weights are copied from
REM the Qt documentation:
REM Light 25
REM Normal 50
REM DemiBold 63
REM Bold 75
REM Black 87
REM In order to use the default system font comment out the correspdong line or indicate an empty
REM family name.
TABLE Fonts None
REM Object Family Size Weight Italic
REM --------------- --------------------------------------------
REM Menu 'Arial' 8 75 no
REM Toolbar 'Arial' 8 75 no
REM Table 'Arial' 8 75 no
REM InfoField 'Arial' 8 75 no
REM AcquisitionDialogs 'Arial' 8 75 no
REM MessageDialogs 'Arial' 8 75 no
REM DialogData 'Courier' 8 50 no
ENDTABLE
REM Table Columns
REM This table controls the columns that are to be shown in the main Guymager table as well as in the clone
REM dialog. The table reflects the column order, i.e. the top most column in the configuration table is shown
REM as the first one left in the GUI. Columns may also be repeated in order to have them displayed more
REM than once.
REM ColumnName The column name reference. This may be one of the following: SerialNr, LinuxDevice,
REM Model, NativePath, ByPath, Interface, State, AdditionalStateInfo, Size, HiddenAreas,
REM BadSectors, Progress, AverageSpeed, TimeRemaining, FifoUsage, SectorSizeLog, SectorSizePhys,
REM CurrentSpeed, Examiner and UserField. See below for further details on column UserField.
REM Alignment Alignment inside the table cell: LEFT, RIGHT or CENTER.
REM MinWidth On startup, Guymager gives every column the size it needs for showing its contents. But
REM certain columns change their content length while Guymager is running. As it might be
REM annoying to enlarge the corresponding column manually everytime its text gets longer,
REM this parameter allows for setting a bigger intial width than the one used normally.
REM Set to 0 for default width.
REM ShowInMainTable Decides whether the column should be shown in the main table; set to ON or OFF.
REM ShowInCloneTable Decides whether the column should be shown in the clone dialog table; set to ON or OFF.
REM Eventhough each one of the columns might be set to ON, there's no sense in switching on
REM columns like CurrentSpeed, for example, as the clone dialog is not updated dynamically.
REM
REM The purpose of the special column UserField is to provide the user with a field for its own remarks. For
REM example, some people use Guymager in machines connected to disk racks. They take UserField for entering the
REM disk slot number in order to have a better overview. The column name may be configured to any string:
REM
REM UserFieldName Specify the name that should be displayed for the UserField column. If the string is left
REM empty, the column's name simply is 'UserField'.
REM
REM AdditionalStateInfoName Similar to UserFieldName, this parameter allows for changing the name of the
REM column AdditionalStateInfo. Leave it empty for the default name.
TABLE Columns None
REM ColumnName Alignment MinWidth ShowIn ShowIn
REM MainTable CloneTable
REM ------------------------------------------------------------------------------
'SerialNr' LEFT 0 YES YES
'LinuxDevice' LEFT 0 YES YES
'Model' LEFT 0 YES YES
'NativePath' LEFT 0 NO NO
'ByPath' LEFT 0 NO NO
'Interface' LEFT 0 NO NO
'State' LEFT 200 YES NO
'AdditionalStateInfo' LEFT 0 NO NO
'Size' RIGHT 0 YES YES
'HiddenAreas' RIGHT 0 YES NO
'BadSectors' RIGHT 0 YES NO
'Progress' LEFT 0 YES NO
'AverageSpeed' RIGHT 0 YES NO
'TimeRemaining' CENTER 0 YES NO
'FifoUsage' LEFT 0 YES NO
'SectorSizeLog' LEFT 0 NO NO
'SectorSizePhys' LEFT 0 NO NO
'CurrentSpeed' LEFT 0 NO NO
'UserField' LEFT 0 NO NO
'Examiner' LEFT 0 NO NO
ENDTABLE
UserFieldName = ''
AdditionalStateInfoName = ''
REM Table Colors
REM The table contains color settings for different items on the screen:
REM LocalDevices Color to be used for marking local devices (i.e. devices with serial numbers found in
REM configuration table LocalDevices, see above) in the user interface. The whole row gets
REM this color.
REM AdditionalStateX (where X is a number) Devices maybe marked by this color depending on the values in
REM the additional state info. See description of configuration parameter
REM CommandGetAddStateInfo for more information.
REM
REM All other entries refer to the colored dot of the acquisition state field for reflecting the current state:
REM StateIdle Nothing has been done with this device yet.
REM StateAcquire Acquisition running
REM StateAcquirePaused Acquisition interrupted (device cannot be accessed any longer)
REM StateVerify Verfication running
REM StateVerifyPaused Verfication interrupted (device cannot be accessed any longer)
REM StateCleanup Acquisition has been aborted by user and Guymager is removing partial files
REM StateFinished Finished successfully
REM StateFinishedBadVerify Finished, but the MD5 check while re-reading the source after acquisition failed.
REM This state only can occur if MD5 verification was switched on in the acquisition dialog.
REM StateAbortedUser Acquisition or verification aborted by user. Not an error, as it is the user's wish.
REM StateAbortedOther Acquisition or verification aborted for some other reason (for instance, if writing to
REM the destination fails). This is an error.
TABLE Colors None
REM Color R G B
REM ----------------------------------------
LocalDevices 255 197 189
AdditionalState1 186 255 174
AdditionalState2 255 254 137
AdditionalState3 255 213 66
AdditionalState4 255 126 126
StateIdle 255 255 255
StateQueued 186 206 253
StateAcquire 15 73 205
StateAcquirePaused 255 150 0
StateVerify 78 132 255
StateVerifyPaused 255 150 0
StateCleanup 228 0 255
StateFinished 54 255 0
StateFinishedBadVerify 255 30 0
StateFinishedDuplicateFailed 255 234 0
StateAbortedUser 255 255 255
StateAbortedOther 255 30 0
ENDTABLE
REM Image creation
REM --------------
REM
REM EwfFormat The EWF format (alias E01 format) differs depending on which software created
REM it. With this parameter, you can control which EWF subformat Guymager should use.
REM The subformats available depend on the Guymager compilation:
REM - If compiled with support for libewf: Encase1, Encase2, Encase3,
REM Encase4, Encase5, Encase6, FTK,
REM Linen5, Linen6 and Smart.
REM See libewf for more information.
REM - If compiled with support for libewf >= 20130416: The values above, plus Encase7,
REM Linen7 and EWFX.
REM See libewf for more information.
REM - No matter if compiled with libewf support or not: Guymager (or AEWF, an alias for
REM the same).
REM When choosing "Guymager", the program uses its own EWF generation functions, which
REM require only very little RAM and still are as fast as libewf. With any other setting,
REM the program uses libewf in order to create the EWF images.
REM Generating images with segment files above 2GiB is not possible with older EWF
REM subformats. Select "Guymager" or at least "Encase6" for doing so.
REM The default and preferred setting is "Guymager".
REM
REM EwfCompression The compression level for EWF images. Possible values are:
REM None No compression at all, images become very big. Not recommended.
REM Empty With this setting, Guymager does no compression, except if a block contains
REM zero bytes only. Such blocks are replaced by their compressed equivalent.
REM Optimal settings for slow systems.
REM Fast Fast Z compression. Optimal setting for most imagers.
REM Best Best Z compression. Images normally become slightly smaller than
REM with setting "Fast", but CPU load grows heavily. Not recommended.
REM
REM EwfCompressionThreshold This threshold indicates a minimal compression ratio that must be achieved or else the
REM data is stored uncompressed. The default value is 0.999 which means, that a chunk will
REM be stored compressed if the compressed data is less than 99.9% in size of the original
REM data. This parameter has been added to avoid mmessages about "inefficiency" in XWF.
REM
REM EwfNaming EWF images are subdivided into segments, starting with extension E01 for the first
REM segment. Subsequent segments get the filename extension E02-E99, then EAA-EZZ, then
REM FAA-ZZZ. After that, it is unclear how to continue (there is no clear standard for the
REM EWF file naming).
REM Guymager supports two ways for naming segments beyond ZZZ:
REM Old Continue with ZZZxxx, where xxx represents characters from 000 to ZZZ in base36
REM notation (i.e. 0-9 and A-Z). After that, it would continue with ZZZxxxx and so on.
REM Guymager version <= 0.6.9 used this naming scheme.
REM FTK After ZZZ follows E14972, E14973 and so on. This naming system is the default for
REM Guymager version 0.6.10 and later.
REM Attention: This parameter only has effect if EwfFormat is set to Guymager.
REM
REM AffEnabled Simson Garfinkel, the inventor of the AFF format, recommends not to use AFF any longer.
REM Therefore, this switch has been introduced and it is 'false' by default. You might use EWF
REM instead.
REM Switch AffEnabled on in case you need to generate AFF images.
REM
REM AffCompression The compression level for AFF images. Valid range: 1 - 9. A value of 1 results in a
REM fast, minimal compression and 9 in a slow, high compression.
REM See aff documentation for more information.
REM
REM AffMarkBadSectors Aff supports a possibility for marking bad sectors. If this parameter is enabled and
REM a bad sector is encountered, then the bad sector is written with a special content to
REM the image ("BAD SECTOR\0" followed by 501 random bytes). If this parameter is disabled,
REM then bad sectors are replaced by 512 zero bytes.
REM This parameter only influences images in AFF format.
REM
REM SpecialFilenameChars By default, guymager only allows the characters a-z, A-Z, 0-9 and _ to figure
REM in the image filenames. If you wannt to allow special chars and you are sure
REM that your destination file system can handle them, you might add them to
REM the parameter SpecialFilenameChars. Example: SpecialFilenameChars = '.- '
REM would allow you to use the characters . and - as well as spaces.
REM
REM CalcImageFileMD5 Switch the parameter on in order to have Guymager calculate the MD5 hashes of the image
REM file(s). The calculation is done over the whole file(s), not just the contents.
REM NOTE: The MD5 hashes are calculated during image verification and therefore, it only
REM is done if the checkbox for image verification is set in the acquisition dialog window.
REM Switching this parameter on is interesting for checking the individual files of an image.
REM
REM The Guymager info file can be passed directly to md5sum for image file verfication. In case
REM you want to do so, please observe one detail: The info file uses CR/LF for beginning a new
REM line (the reason is that many Windows applications fail badly when using the LF standard).
REM Therefore, do not use md5sum -c myimage.info but one of the following commands:
REM cat myimage.info | tr -d '\r' | md5sum -c
REM or
REM cat myimage.info | dos2unix | md5sum -c
REM Both do the same: Eliminate the DOS-CR and pass the rest to the md5sum command. You
REM may ignore md5sum's warnings about improperly formatted lines (these are simply the all
REM the other text lines found in the info file).
REM
REM DuplicateImage Enable Guymager to produce duplicate images, i.e. generate two identical images during
REM an acquisition. When switched on, the acquisition dialog has an additional button named
REM "Duplicate image...".
REM Switch this parameter off if you always want to do single images.
REM
REM DirectoryFieldEditing The destination directory for images and info files normally is selected by mouse by means
REM of a dialog and the directory field is not directy editable. This is the safest way as it
REM ensures that you never a select a non-existent directory.
REM Switch this parameter on if you like to be able to directly type the directory path into
REM the corresponding field. This might be a faster solution for people who know their
REM directories by heart. At the same time it's less safe in case of typos.
REM If ever you enter a non-existent directory then Guymager by default asks if you would like
REM to create it (see parameter ConfirmDirectoryCreation).
REM
REM AllowPathInFilename The parameter is switched off by default and entering parts of the path in the filename field
REM is forbidden. In case you think in relative paths it might be interesting to switch this
REM parameter on and thus allow entering parts of the path together with the filename.
REM Example: You set the directory field to "/mycases/case_0815/images" and enter the filename
REM "JohnDoe/Laptop". The image/info files would then be stored under
REM "/mycases/case_0815/images/JohnDoe/Laptop.xxx".
REM
REM ConfirmDirectoryCreation If ever the entered destination directory does not exist, Guymager tries to create it. If
REM this parameter is switched on then Guymager only does so after asking the user. When set to
REM 'off' it automatically creates the directories without asking.
REM Attention: Setting this parameters to 'off' might lead to uncontrolled directory creation in
REM case of typing errors.
REM Normally, this parameter only has an effect if DirectoryFieldEditing or AllowPathInFilename
REM are switched on. Otherwise, the destination directory should always exist as it has been selected
REM by the file selection dialog and thus doesn't need to be created (except in the unlikely case
REM where the directory had been deleted in the meantime).
REM
REM AvoidEncaseProblems Encase produces strange error messages if the EWF internal fields "Imager Version" and
REM "OS Version" contain more than 11 or 23 characters, respectively. Leave this flag OFF
REM if you don't work with Encase (default setting). Set it to ON if ever you work with
REM Encase and want to avoid the Encase problems.
REM
REM AvoidCifsProblems Some NAS systems have problems for closing files (function fclose) when running under heavy
REM load (i.e., running several acquisitions in parallel, for example). This may result in
REM acquisitions aborting with errors. The problem only has been observed on systems attached via
REM Cifs/Samba so far. NFS systems seem to run fine. When switching parameter AvoidCifsProblems
REM on, Guymager flushes and synchronizes buffers before closing image files. The thus can be
REM avoided. The downside is a performance loss, which can be reduced by choosing a large image
REM file segment size.
EwfFormat = Guymager
EwfCompression = FAST
EwfCompressionThreshold = 0.999
EwfNaming = FTK
AffEnabled = false
AffCompression = 1
AffMarkBadSectors = TRUE
SpecialFilenameChars = ''
CalcImageFileMD5 = off
DuplicateImage = on
DirectoryFieldEditing = off
AllowPathInFilename = off
ConfirmDirectoryCreation = on
AvoidEncaseProblems = off
AvoidCifsProblems = off
REM Acquisition dialog
REM ------------------
REM DefaultFormat This parameter decides, which forensic format should be chosen by default for the
REM first acquisition after starting Guymager. For subsequent acquisitions, the format
REM of the previous acquisition will be selected by default.
REM Possible values are DD, AFF and EWF.
DefaultFormat = EWF
REM InfoFieldsForDd The dd format has no possibility for storing meta information about an image. Hence, the
REM fields examiner, notes, etc. usually are greyed out in the acquisition dialog when selecting
REM dd format. By switching on this parameter, those entry fields become available for dd images
REM also. The strings entered will then be written to the info file.
InfoFieldsForDd = disabled
REM The parameters below all refer to the acquisition dialog entry fields. Let us explain the different
REM fields first. There are 2 fields related to image file fragmentation:
REM SplitFileSwitch Decides whether the image file fragmentation is on or off. For EWF images, it
REM is always on and for AFF images always off. For DD images, the user may choose
REM himself.
REM SplitFileSize The max. size of the fragments (sometimes called segments) in MiB. The maximum
REM value for EWF images is 2047.
REM 2047 is a good choice. For EWF images, the number of files will be reduced to
REM the minimum. For DD images, the fragments stay below the FAT limitation (2GiB).
REM There are 5 fields defined by the EWF file format, their names are self-explaining:
REM EwfCaseNumber
REM EwfEvidenceNumber
REM EwfExaminer
REM EwfDescription
REM EwfNotes
REM Guymager uses these fields when choosing the EWF or the AFF format. When choosing the dd format, they
REM are of no use and decativated.
REM
REM There are 4 other important entry fields in the acquisition dialog:
REM DestImageDirectory The directory that will be used for storing the image files
REM DestInfoDirectory The directory that will be used for storing the info file
REM DestImageFilename The filename of the image files (without the extension)
REM DestInfoFilename The filename of the info file (without the extension)
REM
REM Finally, there are some checkboxes in the acquisition dialog that are controlled by the following
REM entry fields:
REM HashCalcMD5 The checkbox for MD5 hash
REM HashCalcSHA1 The checkbox for SHA-1 hash
REM HashCalcSHA256 The checkbox for SHA-256 hash
REM HashVerifySrc The checkbox for the source verification (re-read source and chek if it
REM returns the same data than during acquisition)
REM HashVerifyDst The checkbox for the imager verification (read and check the image after
REM the acquisition has been done)
REM
REM For each one of these fields, there is an entry in configuration table DlgAcquireField. It has the
REM following structure:
REM FieldName The name of the field, as indicated above
REM
REM EntryMode Determine the bevahiour of each field; the following entry modes are available:
REM Hide The corresponding field is not shown in the acquisition dialog.
REM Nevertheless, it exists and it is always set to its default value
REM (see below). This mode useful if a certain EWF field always should
REM be filled in with the same standard value.
REM
REM ShowDefault The field is visible in the acquisiton dialog and it is automatically
REM filled in with the default value.
REM
REM ShowLast The field is shown in the acquisiton dialog. When the acquisition
REM dialog is opened for the first time after guymager startup, the field
REM is filled in with the default value. On subsequent acquisition dialog
REM appearances, the field contains the value entered previously (which
REM may still be the default value, if it was not edited).
REM
REM DefaultValue The default value for the field. It may contain any text you like (for the checkboxes: See
REM below). Guymager knows several special sequences, that will be replaced automatically.
REM See "Special Tokens" below.
REM
REM Checkboxes: Simply put '1' if you want to have the checkbox enabled or '0' for having it
REM disabled. Attention: Putting other values may lead to unpredictable results.
REM
REM Note that each and every field must be contained exactely once in the configuration table DlgAcquireField.
REM
REM *** Example A ***
REM TABLE DlgAcquireField NoName
REM REM Field Entry Default
REM REM name mode value
REM REM -------------------------------------------------------------------------
REM ...
REM 'EwfNotes' Hide 'Acquisition done by guymager %version%'
REM ...
REM ENDTABLE
REM The field EwfNotes would not be shown in the acquisition dialog. As it has a default value, it would always
REM be initialised with that string. The special sequence %version% would be replaced and the string written to
REM the EWF image files would be sometheing like 'Acquisition done by guymager 0.3.1'
REM
REM *** Example B **
REM TABLE DlgAcquireField NoName
REM REM Field Entry Default
REM REM name mode value
REM REM -------------------------------------------------------------------------
REM ...
REM 'EwfExaminer' Show 'Marc Murrsky acquired it on %d%. %MMMM% %yyyy%'
REM ...
REM ENDTABLE
REM With this setting, the acquisition dialog would open up with the examiner field preset to
REM something similar to 'Marc Murrsky acquired it on 5. December 2007'
TABLE DlgAcquireField NoName
REM Field Entry mode Entry mode Default
REM name image clone value
REM ------------------------------------------------------------------------------------
'SplitFileSwitch' ShowLast Hide '1'
'SplitFileSize' ShowLast Hide '2047'
'SplitFileUnit' ShowLast Hide 'MiB'
'EwfCaseNumber' ShowLast Hide ''
'EwfEvidenceNumber' ShowDefault Hide ''
'EwfExaminer' ShowLast Hide ''
'EwfDescription' ShowDefault Hide ''
'EwfNotes' ShowDefault Hide '%serial%'
'UserField' Hide Hide ''
'DestImageDirectory' ShowLast Hide ''
'DestInfoDirectory' Hide ShowLast ''
'DestImageFilename' ShowDefault Hide ''
'DestInfoFilename' ShowDefault ShowDefault ''
'HashCalcMD5' ShowLast ShowLast '1'
'HashCalcSHA1' ShowLast ShowLast '0'
'HashCalcSHA256' ShowLast ShowLast '0'
'HashVerifySrc' ShowLast ShowLast '0'
'HashVerifyDst' ShowLast ShowLast '1'
ENDTABLE
REM There is a another configuration table, DlgAcquireRule, which allows to copy the contents of some
REM fields automatically to others while typing. The entries in this table are processed one after the
REM other everytime you hit a key in any of the 8 fields.
REM
REM TriggerFieldName The trigger field is field where the action happens (i.e. which has the focus
REM while you are typing). If the trigger field name doesn't match, the the line
REM is ignored. If it matches, we have a trigger and Guymager does what the rest
REM of the line says.
REM
REM DestinationFieldName On trigger, this field will be filled in with the value indicated in column
REM Value.
REM
REM Value The string to be written to the field DestinationFieldName if there's a trigger.
REM The value may contain the same special sequences than the ones described
REM above. Additionally, there are special sequences for referring to other fields.
REM These are constructed by putting the field name between two percent signs (for
REM example '%EwfNotes%')
REM
REM *** Example A ***
REM The info filename should always be the same than the image filename, i.e. when typing in the field
REM for the image filename, the contents should automatically be copied to the field for the info
REM filename:
REM TABLE DlgAcquireRule NoName
REM REM Trigger Destination Value
REM REM field name field name
REM REM ----------------------------------------------------------------------
REM 'DestImageFilename' 'DestInfoFilename' '%DestImageFilename%'
REM ENDTABLE
REM Read the entry like this: Everytime a key in DestImageFilename is hit, refresh DestInfoFilename with the
REM value %DestImageFilename%, which would be interpreted as a special sequence and corresponds to the
REM contents of DestImageFilename.
REM It still would be possible to edit the info filename separately and thus different image and info
REM filenames.
REM
REM *** Example B ***
REM Like example A, but do the same when editing te info filename; when typing in it, the image filename
REM should be changed to the new name typed for the info file:
REM TABLE DlgAcquireRule NoName
REM REM Trigger Destination Value
REM REM field name field name
REM REM ---------------------------------------------------------------------
REM 'DestInfoFilename' 'DestImageFilename' '%DestImageFilename%'
REM ENDTABLE
REM
REM *** Example C ***
REM Set the info field to the examiner name, the case name plus the date:
REM TABLE DlgAcquireRule NoName
REM REM Trigger Destination Value
REM REM field name field name
REM REM ----------------------------------------------------------------------------------------------
REM 'EwfExaminer' 'EwfNotes' 'Acquired by %EwfExaminer for case %EwfCaseNumber% on %d%.%MM%.%yyyy%'
REM 'EwfCaseNumber' 'EwfNotes' 'Acquired by %EwfExaminer for case %EwfCaseNumber% on %d%.%MM%.%yyyy%'
REM ENDTABLE
REM Note that we have to enter the same value twice here, as we have 2 triggers.
TABLE DlgAcquireRule NoName
REM Trigger Destination Value
REM field name field name
REM ----------------------------------------------------------------------
'DestImageDirectory' 'DestInfoDirectory' '%DestImageDirectory%'
'DestImageFilename' 'DestInfoFilename' '%DestImageFilename%'
ENDTABLE
REM Special tokens
REM --------------
REM Guymager uses special tokens whenever text needs to replaced automatically according to the user's instructions.
REM Currently, these tokens are used in the configuration tables DlgAcquireRule and DlgAcquireField, RunStats module
REM and configuration parameter CommandAcquisitionEnd.
REM Date and time tokens
REM %d% the day as a number without a leading zero (1 to 31)
REM %dd% the day as a number with a leading zero (01 to 31)
REM %ddd% the abbreviated localized day name (e.g. 'Mon' to 'Sun')
REM %dddd% the long localized day name (e.g. 'Monday' to 'Sunday')
REM %M% the month as a number without a leading zero (1-12)
REM %MM% the month as a number with a leading zero (01-12)
REM %MMM% the abbreviated localized month name (e.g. 'Jan' to 'Dec')
REM %MMMM% the long localized month name (e.g. 'January' to 'December')
REM %yy% the year as two digit number (00-99)
REM %yyyy% the year as four digit number
REM
REM %h% the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)
REM %hh% the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)
REM %m% the minute without a leading zero (0 to 59)
REM %mm% the minute with a leading zero (00 to 59)
REM %s% the second without a leading zero (0 to 59)
REM %ss% the second with a leading zero (00 to 59)
REM %z% the milliseconds without leading zeroes (0 to 999)
REM %zzz% the milliseconds with leading zeroes (000 to 999)
REM %AP% use AM/PM display. %AP% will be replaced by either "AM" or "PM".
REM %ap% use am/pm display. %ap% will be replaced by either "am" or "pm".
REM Remark: The date/time tokens have been copied from Trolltech's Qt documentation.
REM
REM Static tokens
REM %Version% Guymager software version
REM %MacAddr% MAC address of the 1st ethernet card found
REM %HostName% Computer's host name
REM
REM Device / acquisition related tokens
REM %Dev% Device, for example /dev/sdf
REM %Size% Device size in bytes
REM %SizeHuman% Device size in human readable format (e.g. '247G', '32M')
REM %SizeHumanNoSep% Like %SizeHuman%, but wihtout thousands separator
REM %State% The acquisition state
REM %ExtendedState% The acquisition state as shwon in the main GUI
REM %Serial% Serial number of the device
REM %Model% Device model
REM %LocalDevice% Device is part of the local PC, value is YES or NO (see configutaion table LocalDevices)
REM %CurrentSpeed% Current speed, unit MB/s
REM %AverageSpeed% Average speed, unit MB/s
REM %Progress% Progress, unit %
REM %TimeRemaining% Estimated time remaining to accomplish acquisition (format hh:mm:ss)
REM %BadSectors% Number of bad sectors
REM %HiddenAreas% The information about hidden areas as shown in the GUI
REM %SplitFileSize% File size of image fragmnets
REM %VerifySrc% Verify source, value is YES or NO
REM %CalcMD5% MD5 calculation enabled, value is YES or NO
REM %CalcSHA1% SHA1 calculation enabled, value is YES or NO
REM %CalcSHA256% SHA256 calculation enabled, value is YES or NO
REM %Clone% Device is cloned, MD5 value is YES or NO
REM %Duplicate% A duplicate image is written, value is YES or NO
REM %UserField% Contents of the user field
REM %AddStateInfo% Additional state information
REM The following tokens are related to the acquisition dialog input fields. They all exist a second time with a "2"
REM appended, for example "%CaseNumber%" and "%CaseNumber2%". The second one only is set if %Duplicate% is YES. It's empty
REM otherwise.
REM %CaseNumber% Case number \
REM %Examiner% Examiner | as entered in the
REM %EvidenceNumber% Evidence number | corresponding field
REM %Description% Description | of the acqusition dialog
REM %Notes% Notes /
REM %Image% Path and file name of image
REM %InfoFile% Path and file name of .info file
REM %VerifyDst% Verify image, value is YES or NO
REM
REM Not all tokens are meaningful in every position. For example, there's no sense in specifying token %Progress%
REM in configuration table DlgAcquireRule, as the acquisition is not even started yet when the acquisition dialog
REM is shown.
REM
REM The special token %DEVICE_BLOCK% only can be used for the Runstats module. See the description of the RunStats
REM module below.
REM Guymager internals
REM ------------------
REM
REM Device list scanning
REM --------------------
REM DeviceScanMethod Guymager knows 3 methods for getting the list of the available memory devices: The old one,
REM that uses libparted, the new one that uses DBUS/HAL and the even newer one that uses
REM DeviceKit-Disks. Select your method by setting this parameter to:
REM
REM libudev The newest method (recommended for Ubuntu >= 15.10). See remarks for
REM UDisks below.
REM
REM DBusDevKit or UDisks Recommended for 9.04 <= Ubuntu <= 15.04. You need a Linux system
REM supporting UDisks for this setting. In older versions, UDisks was named
REM DeviceKit (in Ubuntu 9.04 and 9.10 for instance). From guymager's point
REM view, UDisks and DeviceKit are both the same. Newer distributions switched
REM from UDisks to UDisks2, but UDisks2 is incompatible and unusable. Guymager
REM therefore should be run with libudev on those systems.
REM
REM DBusHAL Use the previous method (recommended for systems like Ubuntu 8.10).
REM
REM libparted Use the old method. It was observed that the internal scan function hung
REM while an acquisition was running. This leads to the problem that the devices
REM shown in guymager possibly cannot be updated while an acquisition is running.
REM When using this method, the command specified in configuration parameter
REM CommandGetSerialNumber (see below) is used for finding the serial number of
REM each device (not really elegant). Again, DBusHAL is the recommended setting.
REM When choosing an unsupported scan method, Guymager shows the user a dialog asking to fall back
REM to a supported one.
REM
REM CommandGetSerialNumber is used to extract the serial number from a device when setting DeviceScanMethod to libparted (not
REM recommended). When choosing another scan method, the command will never be called, except if parameter
REM ForceCommandGetSerialNumber is set (see below). The placeholder %dev in the command string will be replaced
REM by the device (/dev/hda or /dev/sdc for instance). Examples:
REM CommandGetSerialNumber = 'bash -c "smartctl -i %dev | grep -i serial | awk ''{print $3 $4 $5 $6 $7 $8 $9}'' "'
REM CommandGetSerialNumber = 'bash -c "hdparm -I %dev | grep -i ''Serial Number'' | awk ''{print $3 $4 $5 $6 $7 $8 $9}'' "'
REM
REM ForceCommandGetSerialNumber Use CommandGetSerialNumber not only when DeviceScanMethod is libparted, but also for others. This
REM can be interesting in case wrong serial numbers are displayed, which was observed to happen with
REM certain USB adapter devices.
REM
REM CommandGetAddStateInfo contains the command to be executed in order to gather additional state information. By default, CommandGetAddStateInfo
REM simply is an empty string and no additional information is read nor displayed. If set, the command executed
REM is expected to return its information in three separate lines (separated by \n):
REM 1st line: Information text. This text is displayed in the device specific screen area of Guymager
REM (bottom area of the main window).
REM 2nd line: A value of 0 tells Guymager that the device cannot be acquired. Guymager forbids the
REM acquisition of the device in that case. Any other value enables device acquisition.
REM If this parameter is missing, the device can be acquired.
REM 3rd line: An integer number indicating the color to be used for marking the device. The number
REM refers to the colors named AdditionalStateX in the configuration table Colors (see
REM above), where X corresponds to the color returned by the command. If this parameter
REM is missing, the default color (wite) is used.
REM The command may include the two placeholders %dev and %local which will be replaced accordingly. See
REM the description of CommandGetSerialNumber above for the use of %dev. %local will be replaced by 1
REM if the %dev refers to a local device and 0 otherwise.
REM
REM If you plan to use this feature, you may do a first test with the configuration setting
REM CommandGetAddStateInfo='bash -c "/usr/share/guymager/stateinfo.sh %dev"'
REM where the file /usr/share/guymager/stateinfo.sh is executable and contains the lines
REM echo "Moie Welt! - $1"
REM echo "0"
REM echo "2"
REM
REM CommandAcquisitionEnd The command given is called whenever an acquisition ends. Guymager knows several special tokens (chraracter sequences)
REM that will be replaced automatically. See "Special tokens" above.
REM The parameter is left empty by default and no script called in that case.
REM
REM ScanInterval Speficies how often an automatic device scan (for detecting newly connected devices)
REM should launched. Unit: Seconds. Keep in mind, that the device scan can be launched as well manually.
REM
REM QueryDeviceMediaInfo Guymager has the possibility to gather extended media info about the connected devices. The media info
REM mainly includes HPA/DCO settings. Some non-standard devices do not expect the corresponding ATA
REM commands and may even need to be resetted when trying to query media info. In such cases,
REM QueryDeviceMediaInfo may be switched off. By default, it is on.
REM
REM DirectIO Decides whether Guymager reads data in direct IO mode or not. Normally, direct mode should be a little
REM faster, but it was observed that reading from SSDSs may be much slower in direct mode. The default
REM setting therefore is "off".
REM IMPORTANT:
REM 1) DirectIO only can be switched on if parameter FifoMemoryManager is also on.
REM 2) Linux does not read single sectors when DirectIO is off. While this is good for speed, it's a
REM problem for disks with bad sectors ("contagious error"). Therefore, Guymager switches DirectIO
REM on when it encounters bad sectors, disregarding the DirectIO configuration parameter. After
REM the bad sectors area has been read, it switched back to the configured DirectIO mode.
REM See also www.elsevierscitech.com/pdfs/Contagious_errors.pdf for more information about the
REM contagious error problem.
DeviceScanMethod = libudev
CommandGetSerialNumber = 'bash -c "smartctl -i %dev | grep -i serial | awk ''{print $3 $4 $5 $6 $7 $8 $9}'' "'
ForceCommandGetSerialNumber = false
CommandGetAddStateInfo = ''
CommandAcquisitionEnd = ''
ScanInterval = 6000
QueryDeviceMediaInfo = on
DirectIO = off
REM The RunStats module allows to forward information about Guymager's current state to users or applications.
REM Principally, Guymager takes a user provided template file, modifies its contents according to the
REM instructions given in the template file and writes the result to the output file. The template and output
REM are specified by the parameters RunStatsTemplateActive and RunStatsOutput.
REM
REM RunStatsTemplateActive contains the filename for the active template, i.e. the template used when Guymager
REM is running. When Guymager ends, it modifies the output file one last time just before exiting according to
REM the contents of another template file, specified by parameter RunStatsTemplateEnded. If parameter
REM RunStatsTemplateEnded is empty or doesn't point to a valid file, Guymager leaves the output with the content
REM it last wrote before exiting.
REM
REM The template file may contain special tokens which are to be replaced by Guymager. All other text is
REM transferred directly to the output file. Tokens always start and end with the % character, see "Token list"
REM above.
REM
REM The token %DEVICE_BLOCK% is specififc to the Runstats module. This token must appear twice in the RunStats
REM template file. The part in between is repeated as many times as there are devices shown in Guymager's main
REM device table.
REM
REM If you installed Guymager from a Debian package (usual way for installing programs on a Debian, Ubuntu
REM or other Debian based system) you find examples of RunStats template files in /usr/share/doc/guymager/
REM or /usr/share/doc/guymager-beta/ .
REM
REM Parameter RunStatsInterval specifies how often the output file is to be updated (unit: seconds). Guymager
REM reads the template at startup and after every 10 output file updates, thus allowing for template file changes
REM to in the appear in the output file without restarting Guymager.
REM
REM In order to switch off the Runstats module, set RunStatsInterval to 0 ot set the active template or output
REM file to an empty string.
RunStatsTemplateActive = ''
RunStatsTemplateEnded = ''
RunStatsOutput = ''
RunStatsInterval = 60
REM Other settings
REM --------------
REM Block sizes: Guymager works internally with threads for doing the different jobs (read, hash calculation, compression,
REM write) and forwards the data in blocks through fifos from one thread to another. The block size may be adjusted individually
REM for the different forensic formats. There's only one exception: When using EWF with mult-threaded compression the block size
REM is 32768 bytes (32KB).
REM It is recommended to use a multiple of kilobytes or megabytes for the block sizes, because the block size corresponds to size
REM of the data read at once from the source drive and most drive's caches perform best with such "round" numbers. So, if you want
REM to work with a block size of 10 kilobyte, specify 10240 (instead of 10000).
REM
REM FifoBlockSizeDD The block size for dd images (in bytes). Recommended value: 262144 (256K).
REM
REM FifoBlockSizeEWF The block size for EWF images (in bytes). Recommended value: 32768 (32K). ATTENTION: Tests have shown
REM that the software "X-Ways Forensics" is not able to handle EWF images with a block size above 256K. Thus,
REM the recommended maximum value for FifoBlockSizeEWF is 262144.
REM
REM FifoBlockSizeAFF The block size for AFF images (in bytes). Recommended value: 16777216 (16M).
REM
REM FifoMaxMem The amount of memory used for the internal FIFO queues of an acquisition. The value is indicated in
REM Megabytes. If you set it to 0, Guymager uses 1/8 of the available RAM, maximally 64MB per acquisition.
REM Keep in mind, that the total amount of memory used by Guymager may be much higher: With a value of
REM 256 and 4 acquisitions running in parallel, a total of 1GB RAM would be used by Guymager - only for
REM the FIFOs, not counting the overhead required by Guymager and the libs it uses (Qt, libewf, ...).
REM The recommended value is 0 (automatic memory usage calculation).
REM
REM FifoMemoryManager Set to on to use the internal FIFO memory manager. If switched off, the classical C functions malloc and
REM free are used. FifoMemoryManager must be switched on in order to use direct IO (see parameter DirectIO).
REM It should be switched off for debug purposes only.
REM
REM UseSeparatehashThread The hash calculation can be done in a separate thread or in the read thread (i.e. the thread reading
REM the data from the source). Using a separate thread led to a slight performance advantage on the
REM developer's machine.
REM
REM CompressionThreads The number of threads for parallel compression. The recommended value is the number of processors.
REM This parameter has a significant performance influence when working with compressed file format
REM (EWF format). It has no impact on other formats (dd).
REM Set to AUTO will use the number of CPUs installed in the system (recommended).
REM Set to 0 for disabling multi-threaded compression and build EWF file the conventional way.
REM
REM BadSectorLogThreshold This parameter has been introduced in order to prevent Guymager from writing excessively big log files
REM when acquiring devices with many (millions) bad sectors. As soon as the threshold has been reached,
REM Guymager does not any longer log every single bad sector it encounters but only logs from time to time.
REM The number of log entries after reaching BadSectorLogThreshold depends on parameter BadSectorLogModulo.
REM When setting BadSectorLogModulo to 1000, then only every 1000th bad sector will be logged after reaching
REM BadSectorLogThreshold.
REM A value of 0 deactivates the bad sector log threshold feature.
REM
REM BadSectorLogModulo Only active if BadSectorLogThreshold is not zero.
REM See BadSectorLogThreshold for explanations.
REM
REM LimitJobs Limit the number of acquisitions running in parallel to the value specified in this parameter. If
REM the number of acquisitions started exceeds the value given by LimitJobs, the ones started last are
REM queued and will be held until a former acquisition ends.
REM The reason for this parameter is that some users observed degraded performance with heavy SATA IO load.
REM They claimed, that the overall performance is better when limiting the number of parallel jobs. However,
REM the author of Guymager has not been presented any performance test results up until now.
REM Setting this parameter OFF results in starting acqusitions immediately. A value of AUTO corresponds
REM to half the number of CPUs installed, with a maximum of value 4.
REM
REM JobMaxBadSectors Only active if LimitJobs is ON.
REM With the introduction of the job queue, a problem arises with faulty disks. It could happen that healthy
REM disks are not going to be acquired because of faulty disks blocking the job queue. JobMaxBadSectors prevents
REM from this by ending acquisitions exceeding the given number of bad sectors.
REM Set JobMaxBadSectors to 0 in order not to end acquisitions because of bad sectors.
REM
REM JobDisconnectTimeout Only active if LimitJobs is ON.
REM See remarks for JobMaxBadSectors. JobDisconnectTimeout works in a similar way. It ends acquisitions
REM which have been in state "disconnected" (i.e. which can no longer be accessed) for too long.
REM Set JobDisconnectTimeout to 0 in order not to end acquisitions because of switching to state
REM disconnected. Unit: Seconds.
FifoBlockSizeDD = 262144
FifoBlockSizeEWF = 32768
FifoBlockSizeAFF = 16777216
FifoMaxMem = 0
FifoMemoryManager = On
UseSeparatehashThread = Yes
CompressionThreads = AUTO
BadSectorLogThreshold = 0
BadSectorLogModulo = 1000
LimitJobs = OFF
JobMaxBadSectors = 200
JobDisconnectTimeout = 10000
REM Debug settings
REM --------------
REM SignalHandling For debug purpose only. Switch off SignalHandling only when working with debuggers (gdb).
REM Recommended value: Enabled.
REM
REM WriteToDevNull For debug purpose only. Writes image to /dev/null instead of the indicated file. This switch can
REM be used for performance tests. Only used when creating a dd images.
REM
REM UseMemWatch For debug purpose only. Uses the memwatch malloc/free functions for finding dynamic memory problems.
REM Creates a file named memwatch.log when enabled in the directory where guymager is started. MemWatch
REM may slow down guymager significantly.
REM
REM VerboseLibewf For debug purpose only. Have libewf output internal messages to stderr.
REM
REM CheckEwfData For debug purpose only. When using the EWF format and working with separate compression thread(s),
REM Guymager does a special check on the data if this parameter is set. The check is done just before
REM passing the data to the EWF library function that writes it to the image. It checks if the data can
REM be uncompressed correctly, if the lengths match and if the CRC is ok.
SignalHandling = Enabled
WriteToDevNull = false
UseMemWatch = false
VerboseLibewf = false
CheckEwfData = false
REM Device info commands
REM --------------------
REM In order to get a complete set of information for each acquired drives, guymager executes several standard Linux
REM commands. These commands are contained in the list named DeviceInfoCommands, see below. They are executed when
REM - selecting the "Info" menu point for a device (results are shown in a dialog window)
REM - starting an acquisition (results are written to the .info file)
REM They are executed in the order they appear. The string %dev will be replaced by the corresponding device path
REM (i.e. /dev/sdb for instance). Examples of interesting commands:
REM 'bash -c "smartctl -s on %dev ; smartctl -a %dev"' -- for switching SMART interface on and showing SMART info
REM 'bash -c "hdparm -I %dev"' -- for showing other identification info
TABLE DeviceInfoCommands NoName
REM Command
REM -------------------------------------------
'bash -c "search="`basename %dev`: H..t P.......d A..a de.....d" && dmesg | grep -A3 "$search" || echo "No kernel HPA messages for %dev""'
'bash -c "smartctl -s on %dev ; smartctl -a %dev"'
'bash -c "hdparm -I %dev"'
'bash -c "CIDFILE=/sys/block/$(basename %dev)/device/cid; echo -n "CID: " ; if [ -e $CIDFILE ] ; then cat $CIDFILE ; else echo "not available" ; fi "'
REM 'bash -c disk_stat %dev'
ENDTABLE
REM Tables LocalDevices and HiddenDevices
REM The local devices may be entered here. Guymager will mark them colored and will not allow to acquire them. The
REM table allows for entering the Linux device path, serial number, model, native path or by path. Examples:
REM '/dev/sda'
REM 'S042J10XC57542'
REM
REM Table HiddenDevices works the same way, except that devices listed here won't appear at all in the Guymaer GUI.
REM
REM LocalHiddenDevicesUseRegExp defines whether the given strings for local and hidden devices should be interpreted
REM as regular expressions or not. Example: With LocalHiddenDevicesUseRegExp switched on, the following string would
REM match all loop devices in the range 10-15 (i.e. /dev/loop10 .. /dev/loop15):
REM '/dev/loop1[0-5]'
REM
REM For both (reg. exp. on and off) the comparison is case independent.
LocalHiddenDevicesUseRegExp = false
TABLE LocalDevices NoName
REM Device
REM -------------------------------------------
ENDTABLE
TABLE HiddenDevices NoName
REM Device
REM -------------------------------------------
ENDTABLE
REM Below we include a local configuration file. All entries in the local configuration file will override the ones above.
REM
REM If ever you want to change some of the settings above, don't do it directly here, as all your changes would be
REM gone when installing a new version of guymager. Edit /etc/guymager/local.cfg instead.
INCLUDE_OPTIONAL /etc/guymager/local.cfg
INCLUDE_OPTIONAL ./local.cfg
ENDSECTION
|