Installation guide

Dialogic
®
System Release 6.1 CompactPCI for Windows
®
Release Update 46
New and Enhanced Command Line Options
Two new command line options, -a and -m, have been added for PDK Trace, and the -f
option has been enhanced to allow log file management as follows:
-a#
Log file array size, specifies the maximum number of log files to maintain (optional).
The default value is 1, and the maximum value is 10.
Example:
pdktrace -b0 -f[ExampleLog] -a5
If left default (or explicitly set to 1), then PDK Trace creates a single log file that grows
without bound (that is, no limit to the log file size).
If set greater than 1 (up to 10), then PDK Trace creates an initial log file at startup.
When the log file reaches the maximum file size (either the default maximum log file
size or the value specified via the -m command line option), the log file is closed and
saved, and a new log file is created.
When the maximum number of log files (as specified by this setting) is reached, the
oldest log file is deleted and a new log file is created to replace it.
Note: When the -a option is specified, any PDK Trace log files that exist prior to
running this particular PDK Trace session are not deleted or modified in any
way.
-m#
Specifies the maximum log file size in bytes (optional). The default depends on the
setting of the -a option, as follows:
• For -a1 (one log file), the default maximum file size is unlimited.
• For -a2 through -a10 (multiple log files), the default maximum file size is 100
megabytes.
The minimum that can be specified with the -m option is 100 kilobytes, and the
maximum is 100 megabytes.
Example:
pdktrace -b0 -f[ExampleLog] -a5 -m500000
-f[filename]
Specifies the name of a file on the host system to write the trace data to (optional).
The default is pdktrace.log. The “.log” extension is appended to the specified file
name string when creating the file.
If just a file name is specified, the log file will be created in the current directory where
PDK Trace is being run from. However, if a path (either relative or absolute) is
specified with the file name, then the log file will be created in the specified directory.
This option existed in the previous version of PDK Trace. However, the processing
associated with this option has been modified to include date and time information, for
management of multiple log files.
When the -a or -m option is used, the file name will automatically have a timestamp
with the current date and time added to it. The “.log” extension will be appended to the
end of the log file name. A file name with a timestamp has the following format:
filename-MMDDYYYY-xxhyymzzs.log
where:
• filename - the name specified with the -f option (or the default if -f is not used)
• MM - month (01=January, 02=February, 03=March, … 12=December)