File: guymager.cfg

package info (click to toggle)
guymager 0.6.7-3
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 1,500 kB
  • sloc: cpp: 13,963; makefile: 50; sh: 17
file content (607 lines) | stat: -rw-r--r-- 36,673 bytes parent folder | download
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
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 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
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-Wndow 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 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 eaturebecomes active (i.e. the menu flag is set and the acquisition 
REM                         ends), a popup appears with a countdown. AutoExitCountdown allows to set start value
REM                         of the countdown (in seconds).


Language='auto'

StartupSize = MANUAL
StartupSizeManualX  = 130
StartupSizeManualY  = 250
StartupSizeManualDx = 1000
StartupSizeManualDy = 500

FileDialogSize = MANUAL
FileDialogSizeManualDx = 800
FileDialogSizeManualDy = 500

NumberStyle=Locale

ScreenRefreshInterval = 1500

UseFileDialogFromQt = Yes

AutoExit          = Off
AutoExitCountdown = 60

REM Table Fonts
REM Not in use yet. Will be used later on for adjusting the fonts used by guymager.

TABLE Fonts <TableName>
   REM Object          Family           Size   Weight Italic
   REM ------------------------------------------------------------------------------------------
       Menu           'Arial'           10     75     no
       DialogDefault  'Arial'           10     75     no
ENDTABLE


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    Devices maybe marked by this color depending on the values in the additional state info.
REM                        See description of configuration parameter 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
       StateAcquire           78  132 255
       StateAcquirePaused     255 174   0
       StateVerify            78  132 255
       StateVerifyPaused      255 174   0
       StateCleanup           228   0 255
       StateFinished           54 255   0
       StateFinishedBadVerify 255  30   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 style guymager should follow.
REM                       Possible values are: Encase1, Encase2, Encase3, Encase4, Encase5, Encase6, Smart,
REM                       FTK, Linen5, Linen6 and Guymager. See libewf for more information.
REM                       When chosing "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 i order to create the EWF images.
REM                       Select Guymager or Encase6 in order to be able to produce segment files bigger than 2GiB.
REM
REM EwfCompression        The compression level for EWF images. Possible values are: None, Fast, Best.
REM                       See ewflib for more information.
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
REM AvoidEncaseProblems   Encase produces strange error messages if the EWF internal fields "Imager Version" and
REM                       "OS Version" contain more than 11 or 23 chracters, respectively. Leave this flag off
REM                       if you don't work wth Encase (default setting). Set it to 1 if ever you work with
REM                       Encase and want to avoid the Encase problems.



EwfFormat             = Guymager
EwfCompression        = FAST
AffCompression        = 1
AffMarkBadSectors     = TRUE
SpecialFilenameChars  = ''
CalcImageFileMD5      = off
AvoidEncaseProblems   = 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 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    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:
REM                 see below). Guymager knows several special sequences, that will be replaced automatically:
REM                    %d%       the day as number without a leading zero (1 to 31)
REM                    %dd%      the day as 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 number without a leading zero (1-12)
REM                    %MM%      the month as 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
REM                    %serial%  the serial number of the device
REM                    %model%   the model name of the device
REM                    %size%    the device's size in human readable format (e.g. '247G', '32M')
REM                    %version% guymager software version
REM                 Remark: The date/time sequences have been copied from Trolltech's Qt documentation.
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 all the 8 fields must by contained exactely once in the configuration table DlgAcquireField.
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%'
       'DestImageDirectory' ShowLast    Hide        ''
       'DestInfoDirectory'  Hide        ShowLast    ''
       'DestImageFilename'  ShowDefault Hide        ''
       'DestInfoFilename'   ShowDefault ShowDefault ''
       'HashCalcMD5'        ShowLast    ShowLast    '1'
       '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 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                            DBusDevKit or UDisks   Use the newest method (recommended for Ubuntu >= 9.04). You need a Linux 
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.
REM
REM                            DBusHAL                Use the new 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 chossing 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). The placeholder %dev in the command string will be replaced by the device
REM                         (/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 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 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                         Note that direct IO only can be switched on if parameter FifoMemoryManager is also on.

DeviceScanMethod       = UDisks
CommandGetSerialNumber = 'bash -c "smartctl -i %dev | grep -i serial | awk ''{print $3 $4 $5 $6 $7 $8 $9}'' "'
CommandGetAddStateInfo = ''
ScanInterval           = 6000
QueryDeviceMediaInfo   = on
DirectIO               = off

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 to work
REM 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).
REM
REM FifoBlockSizeAFF        The block size for AFF images (in bytes). Recommended value: 65536 (64K).
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
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

FifoBlockSizeDD   = 262144
FifoBlockSizeEWF  = 32768
FifoBlockSizeAFF  = 65536
FifoMaxMem        = 0
FifoMemoryManager = On

UseSeparatehashThread = Yes
CompressionThreads    = AUTO


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/hdb for instance). Examples for 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"'
   REM 'bash -c disk_stat %dev'
ENDTABLE



REM Table LocalDevices
REM The local devices may be entered here. Guymager will not allow to acquire these devices. The table allows for
REM entering the Linux device path as well as the serial number. Examples:
REM    '/dev/hda'
REM    'S042J10XC57542'


TABLE LocalDevices NoName
   REM Device
   REM -------------------------------------------

ENDTABLE


REM At the of this configuration, we include a local configuration file. All entries in the local
REM configuration file will override the ones above.

REM If ever you want to cange the settings above, don't do directly here, as all your changes would be
REM gone when installing a new version of guymager.
REM Edit /etc/guymager/local.cfg instead.

INCLUDE_OPTIONAL /etc/guymager/local.cfg
INCLUDE_OPTIONAL ./local.cfg

ENDSECTION