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