log

The log command creates a wave log format (WLF) file containing simulation data for all HDL items whose names match the provided specifications. Items (VHDL signals and variables, and Verilog nets and registers) that are displayed using the add list and add wave commands are automatically recorded in the WLF file. The log is stored in a WLF file (formerly a WAV file) in the working directory. By default the file is named vsim.wlf. You can change the default name using the -wlf option of the vsim command.

If no port mode is specified, the WLF file contains data for all items in the selected region whose names match the item name specification.

The WLF file is the source of data for the List and Wave windows. An item that has been logged and is subsequently added to the List or Wave window will have its complete history back to the start of logging available for listing and waving.

Limitations: Verilog memories and VHDL variables can be logged using the variable's full name only (no wildcards).

Syntax

log

[-recursive] [-in] [-out] [-inout] [-ports] [-internal] [-howmany] <item_name>

Arguments

-recursive

Specifies that the scope of the search is to descend recursively into subregions. Optional; if omitted, the search is limited to the selected region.

-in

Specifies that the WLF file is to include data for ports of mode IN whose names match the specification. Optional.

-out

Specifies that the WLF file is to include data for ports of mode OUT whose names match the specification. Optional.

-inout

Specifies that the WLF file is to include data for ports of mode INOUT whose names match the specification. Optional.

-ports

Specifies that the scope of the search is to include all ports. Optional.

-internal

Specifies that the WLF file is to include data for internal items whose names match the specification. Optional.

-howmany

Returns an integer indicating the number of signals found. Optional.

<item_name>

Specifies the item name which you want to log. Required. Multiple item names may be specified. Wildcard characters are allowed.

Examples

log -r /*

Logs all items in the design.

log -out *

Logs all output ports in the current design unit.

See also

add list, add wave, nolog, and "Wildcard characters"

Note: The log command is also known as the "add log" command.

Model Technology Incorporated Voice: (503) 641-1340 Fax: (503)526-5410 www.model.com sales@model.com