next up previous contents
Next: Phases underneath tcsim Up: Invocation Previous: Invocation   Contents


Usage

tcsim $[$-c$]$ $[$-d $[$-d$]]$ $[$-g$]$ $[$-j$]$ $[$-k threshold$]$ $[$-n$]$ $[$-p$]$ $[$-q$]$ $[$-s snap_len$]$ $[$-v $\ldots]$ $[$-Xphase,arg$]$ $[$cpp_option $\ldots]$ $[$file$]$

tcsim -V

-c
only check syntax, don't execute commands
-d
print all kernel messages (printk). By default, tcsim only prints messages with severity KERN_INFO or higher.
-d -d
also print tcsim debugging messages
-g
print generation numbers instead of skb addresses. This is mainly useful in regression tests, where output is compared with the output of previous runs.
-j
print time in jiffies, the kernel's internal unit of time, not seconds
-k threshold
set the kernel logging threshold to the specified number. -k overrides -d.
-n
do not include default.tcsim. By default, tcsim includes this file, which in turn includes the files described in section 6.5. This can be undesirable, e.g. if operating in a non-TCP/IP context, or if using a different default include file with application-specific definitions. In the latter case, the following options should be used:
tcsim $\ldots$ -n $\ldots$ -XP,--include -XP,/directory/file $\ldots$
-p
preserve attributes across links (see section 6.4)
-q
quiet operation. tcsim does not generate output for E or D events, or echo commands. See sections 6.2.7 and 6.6.1.
-s snap_len
limit packet content dumped in trace output to snap_len bytes. See also section 6.6.1.
-v
enable function result tracing
-v -v
also trace function invocation
-v -v -v
also trace internal element state
-V
print the version numbers of tcsim and of the kernel and iproute2 embedded in it, and exit
-Xphase,argument
verbatim argument for specific build phase. See section 6.1.2 for details.
cpp_option
one of the following options for the C pre-processor: -Idir, -Dname$[$=value$]$, or -Uname

Examples:

A normal simulation run (we enqueue three packets in the order A, B, C, and they are dequeued in the order A, C, B):

tcsim -s 20 examples/prio+rsvp

The same simulation, with full tracing enabled:

tcsim -s 20 -v -v examples/prio+rsvp


next up previous contents
Next: Phases underneath tcsim Up: Invocation Previous: Invocation   Contents
Martin A. Brown 2003-11-06