Variables Set in backup.ini
Note: To restore the default values of all variables listed in backup.ini, do the following:
After this, a new backup.ini file will be generated, where all variables will have their default values.
This variable determines nnBackup's behavior during synchronisation of directories. By default, nnBackup copies to the target directory all the new files from the source directory as well all files with updated creation or modification date. By setting variable AnyDifference to ON, you can instruct nnBackup to also copy those files whose creation/modification date has been changed to an earlier one, as well as those files whose size has been changed (even if creation/modification date remains the same).
Analogue of command line option -ad.
To cancel the effect of variable AnyDifference for a specific backing up session, use command line option -ad-.
Allowed values:
AnyDifference OFF
ClearArchiveAttribute <ON/OFF>
This variable forces nnBackup to clear 'archive' file-attribute after copying.
Analogue of command line option -A.
To cancel the effect of variable ClearArchiveAttribute for a specific backing up session, use command line option-A-.
Allowed values:
ClearArchiveAttribute OFF
Instructs nnBackup to copy access rights. (Works on NTFS only)
Analogue of command line option -sa.
To cancel the effect of variable CopyAccessRights for a specific backing up session, use command line option -sa-.
Allowed values:
CopyAccessRights OFF
By default, nnBackup doesn't copy empty directories. To change this behavior, set CopyEmptyDirs to ON.
Analogue of command line option -e.
To cancel the effect of variable CopyEmptyDirs for a specific backing up session, use command line option -e-.
Allowed values:
CopyEmptyDirs OFF
When this variable is on, nnBackup will remove from the backup copy the files that are absent in the source directory while synchronising directories.
Analogue of command line option -da.
To cancel the effect of variable DelAbsent for a specific backing up session, use command line option -da-.
Allowed values:
DelAbsent OFF
This variable determines program's behavior during synchronising directories in situation when some directory was removed from the source directory but is present in the backup copy. Set DelAbsentDir в OFF to prevent removal of absent directories during the synchronisation.
Analogue of command line option -nd.
To cancel the effect of variable DelAbsentDir for a specific backing up session, use command line option -nd-.
Allowed values:
DelAbsentDir ON
Sets the name and the location of the file, containing the dates of previous backup sessions in dump mode.
Analogue of command line option -ddf.
DumpDatesFile: "%HOME-DIR%\etc\dumpdates.txt"
This variable controls the behaviour of the dump mode. When DumpLevelLE is set to ON nnBackup is copying the files that were created or changed since the time of the last dump whose number is less than the current dump. When DumpLevelLE is set to OFF nnBackup copies only those files that were created or changed since the time of the last dump whose number is less than or equal to the current dump.
Analogue of command line option -dumple.
To cancel the effect of variable DumpLevelLE for a specific backing up session, use command line option -dumple-.
Allowed values:
DumpLevelLE OFF
ExtZip: <ArchiverName> <file-list-encoding> <Commandline-to-eol>
Use this variable to set the command line external archiver for using with the -extzip nnBackup option. <ArchiverName> should be exactly the same, as the filename extension, which is used by your archiver ('7z' for 7-zip, 'rar' for RAR, 'zip' for ZIP etc). <file-list-encoding> values: 0 - ANSI, 1 - OEM, 65001 - UTF-8.
%ZIP-FILENAME% and %ZIP-LIST% are nnBackup internal variables, filled with the name of archive to be created and list of the files to be compressed by external archiver.
Use several ExtZip: variables to set the command line switches for different external archivers.
ExtZip: 7z 65001 7z.exe a -scsUTF-8 -r -mx=%ZipLevel @% "%ZIP-FILENAME%" "@%ZIP-LIST%"
ExtZip: RAR 1 rar.exe a %Verbose @ ?S" -inul"% "%ZIP-FILENAME%" "@%ZIP-LIST%"
ExtZip: TAR 0 tar.exe -c --files-from="C:\Users\VK\AppData\Roaming\nnBackup\etc\zip-list-15072.txt" -f "\0_2008-12-23.zip"
Use this variable to set the default directory where nnBackup configuration (backup.ini), temporary (dumpdates.txt, %ZIP-FILENAME%, %ZIP-FILELIST%) and log files are stored. This variable fills the %HOME-DIR% value.
Analogue of command line option -hd.
If you are using WinNT/2000/XP, HomeDir is set by default to the program directory (where nnbackup.exe is located). If you are using Windows Vista, the HomeDir is set to %UserAppData%\nnBackup.
HomeDir: "%NNBACKUP-DIR%"
This variable determines whether or not the backup process will be stopped if a file error is found. Set IgnoreErrors to ON if you want backup process to continue without stopping when an error is found.
Analogue of command line option -с.
To cancel the effect of variable IgnoreErrors for a specific backing up session, use command line option -c-.
Allowed values:
IgnoreErrors OFF
If this variable is set to ON, then during copying a file to the target directory nnBackup will create a directory tree in the target directory corresponding to the file's path in the source directory, with the specified depth. (See also KeepPathLevel:).
Analogue of command line option -p.
To cancel the effect of variable KeepPath for a specific backing up session, use command line option -p-.
Allowed values:
KeepPath OFF
This variable sets the maximum nestling level during creation of a directory structure, if variable KeepPath is set to ON.
Allowed values:
KeepPathLevel: 999
This variable specifies the language in which nnBackup's messages are displayed. You can examine the list of currently available languages by taking a look in res subfolder of nnBackup home directory.
Analogue of command line option -lang.
Language: English
This variables instructs nnBackup to write its messages to the specified log file. See also Logtime:
Analogue of command line option -log.
To cancel writing to log file for a specific backing up session, use command line option -log-.
LogFile: "%HOME-DIR%\log\nnbackup.log"
This variable specifies format in which current time is recorded in a log file. Here you can find a description of variables used by Logtime.
Comment out this variable if you don't want the time to be written to the log file.
Logtime: "%WW% %DD%.%MMM%.%YYYY% %hh%:%mm%"
This variable specifies if the short statistics will be outputted to the log file and the console window. Total number of processed files/folders and total amount of copied data (in bytes) is available.
Analogue of command line option -stat.
To cancel the effect of variable NeedStatistic for a specific backing up session, use command line option -stat-.
Allowed values:
NeedStatistic OFF
When this variable is on, nnBackup will not compress the dumps being created into zip archives; instead, it will save the data in directories with corresponding names.
Analogue of command line option -nozip.
To cancel the effect of variable NoZipDump for a specific backing up session, use command line option -nozip-.
Allowed values:
NoZipDump OFF
This variables specifies behavior of nnBackup during copying directories into a stack. Set PushChanged to ON if you want nnBackup to "push" the directory stack only if it has found any changes in source directory (modified, added or deleted files).
Analogue of command line option -pc.
To cancel the effect of variable PushChanged for a specific backing up session, use command line option -pc-.
Allowed values:
PushChanged OFF
This variables prohibits displaying messages in console (quiet mode). This variable does not affect information written to a log file.
Analogue of command line option -q.
To cancel the effect of variable Quiet for a specific backing up session, use command line option -q-.
Allowed values:
Quiet OFF
By default, nnBackup doesn't take into account the subdirectories when backing up files. Set SubTree to ON to if you want it to always back up all subdirectories.
Analogue of command line option -s.
To cancel the effect of variable SubTree for a specific backing up session, use command line option -s-.
Allowed values:
SubTree OFF
By default, nnBackup checks the directory attributes when backing up files. Set TestDirAttrib to OFF if you don't want it to check the directory attributes.
Analogue of command line option -tda.
To cancel the effect of variable TestDirAttrib for a specific backing up session, use command line option -tda-.
Allowed values:
TestDirAttrib ON
By default, nnBackup doesn't check the directory creation/modification time when backing up files. Set TestDirTime to ON to if you want it to check the directory creation/modification time together with the creation/modification time of the files.
Analogue of command line option -TD.
To cancel the effect of variable TestDirTime for a specific backing up session, use command line option -TD-.
Allowed values:
TestDirTime OFF
This variables specifies behavior of nnBackup during synchronisation of directories.
By default, when nnBackup compares times, it takes in account even milliseconds (NTFS time format). Set TwoSecondsPrecision to ON, if you want nnBackup to always use 2-second precision (FAT time format) when comparing file modification times; it would be wise to use this limitation to ignore minor differences in times which appear when a file is moved from FAT to NTFS and vice versa.
Analogue of command line option -t2.
To cancel the effect of variable TwoSecondsPrecision for a specific backing up session, use command line option -t2-.
Allowed values:
TwoSecondsPrecision OFF
This variable controls how the backing up information is displayed on screen and in the log file. Set Verbose to ON if you want nnBackup to print to console (unless option -q is used) and to write to the log file (if option -log is used) the full paths of the files being copied.
Analogue of command line option -v.
To cancel the effect of variable Verbose for a specific backing up session, use command line option -v-.
Allowed values:
Verbose OFF
Sets the and the location of the file-list passed to the external command line archiver (see -extzip).
Analogue of command line option -zlf.
ZipListFile: "%HOME-DIR%\etc\zip-list-%GetCurrentProcessId%.txt"