38.2. TFTP diagnostic, statistics and debug

38.2. TFTP diagnostic, statistics and debug
	Chapter 38. TFTP - Trivial File Transfer Protocol

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:

`CHR`	Incoming/outgoing characters from/to UDP.
`FRM`	Incoming/outgoing packets from/to UDP.
`LONG`	Lost incoming/outgoing packets with too long length.
`LOST`	Lost incoming/outgoing packets: buffer is full.
`BAD-FMT`	Lost incoming/outgoing packets with bad format.
`DENIED-IP`	Lost 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.
`ERRORS`	Received packet with error opcode.
`TOUT`	Number of timeouts.
`RETRANS`	Number 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
	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


38.1. TFTP - Trivial File Transfer Protocol		Chapter 39. HTTP - HyperText Transfer Protocol