Lines with ### are used for navigation by the program's help system. ###0### DbEwarnViewC v1.0. A console application for drawing statistics. Usage: dbewarnviewc [OPTIONS] If DbEwarnViewC starts without any option, it tries to get all the options from dbewarnviewc.ini. In options defining filename/directory, either "\" or "/" can be used as a divider of directories. OPTIONS (position doesn't matter, except for -? & -lang): -? - Help, must be the first option in the comm. line, shows help about the next option, for example: -? -tstart. If there is no option after -?, then the general help is shown (this text). To get help in Russian, the -lang option must be put before -?. For example, to get help about -lang itself in Russian, options in the comm. line should go like this: -lang=ru -? -lang If Russian chars are shown incorrectly, a default encoding can be changed (see help on the -lang option); -lang - Language of the interface, help & e-mails. To get help in Russian, -lang must be the first in the comm. line, otherwise its position doesn't matter; -log - Log filename (default: dbewarnviewc.log); -maxlogsize - Max log-file size (default: 3 Mb); -dir - Directory for log files (has a higher priority than -log); -ini - Ini-file with options (default: dbewarnviewc.ini); -stlib - A path to the dynamic library, which draws statistics (default: dbewarndl.* in the curr. dir, extension depends on OS); -stini - Ini-file with options for drawing statistics (default: the same as in the ini option); ###0### Options of the command line and ini-file. ------------------------------------------------------------------------------- ###?### OPTION -? FORMAT: -? [-_other_option_] EXAMPLE: -? -sta Get the help about "_other_option_". -? must be the first option in the comm. line, the next (second) option is the one, you want to read a help about. The second option must be put without value (i.e. just -? -sta, and not -? -sta=...). The -? option can go second, olny when a Russina help is desired. In that case the -lang option (specifying a language and, if needed, an ecoding of the console) goes first. Encoding can be specified, if Russian symbols are shown incorrectly, i.e., if the console's encoding is different from the one used by the program. For details see help on the -lang option. The -lang option ca also be specified in the ini-file, then it can be ommited in the command line. This particular help topic is shown, when "dbewarnviewc -? -?" is executed. If _other_option_ is not specified, then the general help is shown. ###?### ------------------------------------------------------------------------------- ###lang### OPTION -lang FORMAT: -lang=language[:encoding] EXAMPLES: -lang=ru:UTF-16 -lang=ru:1251 -lang=ru:cp866 The language of the interface, help & e-mails. To get help in Russian, -lang must be put first in th command line, otherwise its position doesn't matter. Default: en. The language can be "en" (English) or "ru" (Russian). The Russian language's encoding can be one of the following (in fact, all that Qt supports): 1. IBM 866 2. KOI8-R 3. KOI8-U 4. Windows-1250 to 1258 5. UTF-8 6. UTF-16 7. UTF-16BE 8. UTF-16LE 9. UTF-32 10. UTF-32BE 11. UTF-32LE 12. Apple Roman 13. Big5 14. Big5-HKSCS 15. CP949 16. EUC-JP 17. EUC-KR 18. IBM 850 19. IBM 874 20. ISO 2022-JP 21. JIS X 0201 22. JIS X 0208 23. MuleLao-1 24. ISO 8859-1 to 10 25. ROMAN8 26. Shift-JIS 27. TIS-620 28. ISO 8859-13 to 16 29. TSCII 30. WINSAMI2 31. GB18030-0 32. Iscii-Bng, Dev, Gjr, Knd, Mlm, Ori, Pnj, Tlg, and Tml For items 1, 4, 15, 18, 19 a number or "cp"+number can be specified. "cp" (in English leters) means "code page". If the encoding is ommited, then the default encoding is used: for Windows: IBM 866 (DOS' Russian encoding); for other OS's (MacOS, Unix's): UTF-8. This "encoding" doesn't affect the encoding of the log-file & e-mails - for those Windows-1251 is always used. The -lang option can also be specified in the ini-file, then it can be ommited in the command line. ###lang### ------------------------------------------------------------------------------- ###log### OPTION -log FORMAT: -log=log_file EXAMPLE: -log="c:\tmp 2\log1.txt" Log filename (default: dbewarnviewc.log in the program's directory). It's better to use an extension (log, txt), that can be immediately openned by a text editor. If the -dir option is specified, then -log is ignored. ###log### ------------------------------------------------------------------------------- ###maxlogsize### OPTION -maxlogsize FORMAT: -maxlogsize=max_size EXAMPLES: -maxlogsize=20m -maxlogsize=7d Max size of a log file (default: 3 Mb). 1. If the -dir option is NOT specified: 1.1. If -maxlogsize is specified with simply a number, or a number with letters K/k/M/m after it: When a log file begins to exceed this size, its upper lines are deleted until the log file's size is less than -maxlogsize. The max size is specified in bytes (a number w/o any letters), kilobytes (an English "k" or "K" is added to the number) or megabytes (an English "m"/"M" is added), but it can't be < 16 Kb. "k" - a multiplication by 1024, m - a multiplication by 1024*1024=1048576. 1.2. If -maxlogsize is specified with a letter D/d: The upper lines with dates <= current system date minus a number of days from -maxlogsize (7d - seven days), are deleted. It can't be less than one day. 2. If the -dir option is specified: 2.1. If -maxlogsize is specified with simply a number, or a number with letters K/k/M/m after it: A combined size of 1-day files is calculated, starting from the current system date and moving back to the past. When a combined size starts to exceed -maxlogsize, a deletion of 1-day log files starts (excluding the log file, which was the first to make a combined size exceed -maxlogsize). 2.2. If -maxlogsize is specified with a letter D/d: All log files with dates <= current system date minus a number of days from -maxlogsize, are deleted. ###maxlogsize### ------------------------------------------------------------------------------- ###dir### OPTION -dir FORMAT: -dir=directory EXAMPLE: -dir="c:\log 2" A directory, in which log files (a separate file for every day) will be written. That is, logs of every complete run of the program of one day are written to the same log file. Logs of complete runs of the next day will be writen to a new file, etc. Log filenames are constucted using this pattern: yyyy_mm_dd.log If the -dir option is specified, the -log option is ignored (-dir has a higher priority). ###dir### ------------------------------------------------------------------------------- ###ini### OPTION -ini FORMAT: -ini=ini_file EXAMPLE: -ini="c:\tmp 2\111.ini" Ini filename (default: dbewarnviewc.ini in the program's directory). Ini-file can contain fields with the names, identical to the names of options of the command line, in the sections described below. Command line's options have a higher priority, than options with the same names in ini-file. Ini-file's sections and options inside of them: [LOG] - LOG (the same name as the section's), MAXLOGSIZE, DIR; [SYSTEM] - LANG, STLIB, STINI. ###ini### ------------------------------------------------------------------------------- ###stlib### OPTION -stlib FORMAT: -stlib=dyn_lib_file EXAMPLE: -stlib="c:\tmp 2\dbe.dll" The dynamic library, that is resposible for creating all of the statistic html-pages and pictures. This option makes sense, when the same library is used by a number of programs (for example, by both DbEwarnView and DbEwarn). ###stlib### ------------------------------------------------------------------------------- ###stini### OPTION -stini FORMAT: -stini=ini_file EXAMPLE: -stini="c:\tmp 2\111.ini" Default: the same as in the ini option. This ini-file should contain all the option for creating html-pages of statistics. ###stini###