38.2. TFTP diagnostic, statistics and debug

38.2.1. TFTP diagnostic

This command reports the current situation of the FTP resource:

[11:37:57] ABILIS_CPX:d d tftp

RES:Tftp ----------------------------------------------------------------------
       Trivial_File_Transfer_protocol
       STATE:ACTIVE
       CUR-SESS:0      PEAK-SESS:0      MAX-SESS:10
       ------------------------------------------------------------------------
       SES  RemAdd-RemPort
       ------------------------------------------------------------------------
       0    000.000.000.000-0
       1    000.000.000.000-0
       2    000.000.000.000-0
       3    000.000.000.000-0
       4    000.000.000.000-0
       5    000.000.000.000-0
       6    000.000.000.000-0
       7    000.000.000.000-0
       8    000.000.000.000-0
       9    000.000.000.000-0

The meaning:

STATE

The TFTP driver state:

  • INACTIVE - configuration parameter ACT:NO.

  • DOWN - registration to lower UDP ports fail, better said when the "use" of UDP service is not possible.

  • ACTIVE - the driver is fully ready to work.

CUR-SESS

Current used TFTP sessions.

PEAK-SESS

The peak of used TFTP sessions.

MAX-SESS

The number of maximum TFTP sessions.

SES

The TFTP session's identifier.

RemAdd-RemPort

The remote IP address and UDP port of TFTP session.

38.2.2. TFTP statistics

This command can help to understand what is happening, in case of troubles:

[11:46:13] ABILIS_CPX:d s tftp

RES:Tftp ----------------------------------------------------------------------
       Trivial_File_Transfer_protocol                                          
       --- Cleared 0 days 12:00:45 ago, on 20/10/2017 at 01:06:12 -------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |         60|         54|FRM        |          2|          2|
       LONG       |          0|          2|LOST       |          0|          2|
       BAD-FMT    |          1|          2|DENIED-IP  |          0|           |
       ERRORS     |          0|           |TOUT       |          0|           |
       RETRANS    |           |          0|
       ------------------------------------------------------------------------
[11:48:03] ABILIS_CPX:d se tftp

RES:Tftp ----------------------------------------------------------------------
       Trivial_File_Transfer_protocol                                          
       --- Cleared 0 days 12:00:51 ago, on 20/10/2017 at 01:06:12 -------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |         60|         54|FRM        |          2|          2|
       LONG       |          0|          2|LOST       |          0|          2|
       BAD-FMT    |          1|          2|DENIED-IP  |          0|           |
       ERRORS     |          0|           |TOUT       |          0|           |
       RETRANS    |           |          0|
       ------------------------------------------------------------------------
       SES:0
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|         54|FRM        |          0|          2|
       ERRORS     |          0|           |TOUT       |          0|           |
       RETRANS    |           |          0|
       ------------------------------------------------------------------------
       SES:1
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CHR        |          0|          0|FRM        |          0|          0|
       ERRORS     |          0|           |TOUT       |          0|           |
       RETRANS    |           |          0|
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 0 days 12:00:51 ago») these counters show the number of:

CHRIncoming/outgoing characters from/to UDP.
FRMIncoming/outgoing packets from/to UDP.
LONG Lost incoming/outgoing packets with too long length.
LOSTLost incoming/outgoing packets: buffer is full.
BAD-FMTLost incoming/outgoing packets with bad format.
DENIED-IPLost incoming packets with source IP address which not allowed. The not-allowed is a client whose IP address is not present in IPSRC and IPSRCLIST parameters configuration.
ERRORSReceived packet with error opcode.
TOUTNumber of timeouts.
RETRANSNumber of retransmissions.

38.2.3. TFTP debug

Type the following command to view the commands allowed:

[15:29:42] ABILIS_CPX:debug res:tftp

RES:Tftp ----------------------------------------------------------------------
       Trivial_File_Transfer_protocol                                          
       BufferLength:64512  Date/Time:20/10/2017 13:09:40 TraceTime:43406494

DEBUG RES:<TFTP>
  LSN:0                    - This help
  LSN:1                    - Complete debug
  LSN:2                    - Statistics
  LSN:3                    - TFTP log
  LSN:3 CMD:CLR            - Clear TFTP log
  LSN:3 CMD:SET:[DFT,FULL] - Set log event level
            DFT  - Log default events (reduced)
            FULL - Log all events (dump of packets)
[Note]Note

To use these commands you need to have administrator or super user rights.

Type the following command to view the TFTP session log:

[15:34:42] ABILIS_CPX:debug res:tftp lsn:3

RES:Tftp ----------------------------------------------------------------------
       Trivial_File_Transfer_protocol                                          
       BufferLength:64512  Date/Time:20/10/2017 13:10:03 TraceTime:43430129

20/10 01:06:09  UDP port:69 opened
20/10 13:03:29  Request received from 192.168.020.107/61997
20/10 13:03:29  OPCODE:RRQ
20/10 13:03:29 ID:0   192.168.020.107/61997 File C:\APP\TFTP\Kalimba.mp3 is not present
20/10 13:04:46  Request received from 192.168.020.107/62804
20/10 13:04:46  OPCODE:WRQ
20/10 13:04:46 ID:0   192.168.020.107/62804 WRITE OPEARTIONS DISABLED