show stack zero-touch ipc

Displays information on stack zero-touch inter-processor communication (IPC) statistics.
Syntax
show stack zero-touch ipc
Modes

Privileged EXEC mode

Usage Guidelines

The command shows the number of stack interactive-setup/zero-touch packets sent and received.

Be sure to check the "possible errors" field. If the number is increasing, a problem is indicated.

The active controller uses the Rel-mail field to send reload information to discovered new units. Even though the field indicates a failure due to lack of acknowledgment, the reload may be successful.

The show stack zero-touch ipc command displays the following information:

Output field Description
V3 Version number
src Source MAC address of egress IPC packets (MAC address of this unit).
max_pkt_size Maximum packet size allowed in network.
recv Total packets received.
send Total packets sent.
Send message types Totals for each type of message sent, displayed in the following format: [ x ] = total, where "x" represents the number of a message type from the Message types have callbacks list in the command output.
Recv message types Totals for each type of message received, displayed in the format [ x ] = total, where "x" represents the number of a message type from the Message types have callbacks list in the command output.
Statistics:
send pkt num Total number of packets sent. One packet may contain multiple messages.
recv pkt num Total number of packets received. One packet may contain multiple messages.
recv msg num Total number of received messages related to Zero-touch interactive-setup (see list of types in output).
send pkt-msg num Total number of packets containing Zero-touch interactive-setup messages sent.
send msg num Total number of Zero-touch interactive-setup messages sent.
pkt buf alloc Packet buffer allocation size.
Reliable mail Reliable-mail messages are used for essential communications, for example, to assign unit IDs or reload the system.

Reliable-mail message statistics for specified target types:

  • send: number of reliable-mail messages sent
  • success: number of successful reliable-mail messages (sent and acknowledged)
  • receive: number of packets received
  • duplic: number of duplicate packets sent
  • T-ms: Average time in milliseconds between packet transmission and receipt of acknowledgment

target MAC Number of reliable-mail messages sent using the MAC address as the target address. (Reliable-mail messages are re-transmitted until acknowledgment is received.)
unrel target MAC Number of unreliable-mail messages using the MAC address as the target address. (Unreliable-mail messages are sent only once.)
Possible errors: Warnings or errors detected, if any.
Examples

The following example shows output for the show stack zero-touch ipc command.

device# show stack zero-touch ipc
V3, , src=cc4e.246d.9e00, max_pkt_size=1468, recv 168, send 204
Message types have callbacks:
 3: ZTP-probe                         4: ZTP-request                      
 5: unreliable-mail                   6: reliable-mail                    
 7: test ipc packets                  8: cmd-to-new-unit                  
 9: KA-new-unit                      

Send message types:
   [4]=200,          [6]=4,            
Recv message types:
   [3]=160,          [6]=8,            

Statistics:
   send pkt num          :       204,    send pkt-msg num      :       204,    
   recv pkt num          :       168,    send msg num          :       204,    
   recv msg num          :       168,    pkt buf alloc         :       204,    

    Reliable-mail        send  success  receive   duplic  T-ms
    target MAC              2        2        0        0     2
    unrel target MAC        0                 0         

Possible errors:
device#
History
Release version Command history
08.0.90 This command was introduced.