Network Component  Version 7.19.0
MDK Middleware for IPv4 and IPv6 Networking
NetTFTPs: TFTP Server

Events generated by the Network - TFTP Server functions. More...

Functions

__STATIC_INLINE void EvrNetTFTPs_InitServer (uint32_t num_sessions, uint16_t port, uint8_t firewall_en)
 Event on TFTP server initialize (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_ShowRootFolder (const char *root_folder, uint32_t length)
 Event on TFTP server display root folder (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_GetSocketFailed (uint8_t session)
 Event on TFTP server failed to allocate UDP socket (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_SetRootPath (const char *path, uint32_t length)
 Event on TFTP server netTFTPs_SetRootPath (API) More...
 
__STATIC_INLINE void EvrNetTFTPs_StartService (uint16_t port)
 Event on TFTP server start service (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_StopService (void)
 Event on TFTP server stop service (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_TimeoutExpiredAbort (uint8_t session)
 Event on TFTP server session timeout expired, abort transfer (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_SendBlock (uint8_t session, uint32_t block_nr, uint32_t length)
 Event on TFTP server send block (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_ReceiveFrame (int32_t socket, uint32_t length)
 Event on TFTP server receive frame (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_FrameTooShort (uint32_t length, uint32_t min_length)
 Event on TFTP server receive frame too short (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_UserAccessDenied (const void *net_addr)
 Event on TFTP server user denied access (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_AccessDeniedNoResources (void)
 Event on TFTP server denied client access on out of resources (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_ShowClientAddress (const void *net_addr)
 Event on TFTP server display client IP address and port number (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_OperationRequest (uint8_t session, uint16_t tftp_opcode)
 Event on TFTP server process operation request (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_SessionRestart (uint8_t session)
 Event on TFTP server session restart, maybe our response was lost (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_InvalidTransferId (uint8_t session)
 Event on TFTP server invalid transfer id (TID) detected (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_ErrorCodeReceived (uint8_t session, uint16_t error_code)
 Event on TFTP server error code received from the client (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_IllegalOpcodeReceived (uint8_t session, uint16_t tftp_opcode)
 Event on TFTP server illegal operation code received from the client (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_FileRequested (const char *fname, uint32_t length)
 Event on TFTP server received file request from the client (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_TransferBlockSize (uint8_t session, uint16_t block_size)
 Event on TFTP server display transfer block size (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_TransferModeNotBinary (uint8_t session)
 Event on TFTP server transfer mode not set to binary (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_LocalFileNotFound (uint8_t session)
 Event on TFTP server error, requested file not found on server (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_LocalFileCreateFailed (uint8_t session)
 Event on TFTP server local file create failed (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_ReceiveDataFrame (uint8_t session, uint32_t length)
 Event on TFTP server receive data frame (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_DataFrameTooShort (uint8_t session, uint32_t length, uint32_t min_length)
 Event on TFTP server receive data frame too short (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_DuplicateBlockReceived (uint8_t session, uint32_t block_nr)
 Event on TFTP server duplicate block received (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_TooManyRetries (uint8_t session)
 Event on TFTP server too many retransmissions (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_BlockReceived (uint8_t session, uint32_t block_nr)
 Event on TFTP server data block received (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_InvalidBlockReceived (uint8_t session, uint32_t block_nr)
 Event on TFTP server invalid block received (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_WriteErrorDiskFull (uint8_t session, uint32_t length)
 Event on TFTP server write local disk failed, disk full (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_BlockAckReceived (uint8_t session, uint32_t block_nr)
 Event on TFTP server block acknowledge received (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_BlockRetransmit (uint8_t session, uint32_t block_nr)
 Event on TFTP server block retransmit (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_InvalidBlockAck (uint8_t session, uint32_t block_nr)
 Event on TFTP server invalid block acknowledge received (Error) More...
 
__STATIC_INLINE void EvrNetTFTPs_ShowRequestMode (const uint8_t *mode, uint32_t length)
 Event on TFTP server display received request mode parameter (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_SendOptionAck (uint8_t session, uint32_t block_size)
 Event on TFTP server send option acknowledgment (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_SendBlockAck (uint8_t session, uint16_t block_nr)
 Event on TFTP server send block acknowledgment (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_SendError (uint8_t session, uint16_t error_nr)
 Event on TFTP server send error code (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_AbortSession (uint8_t session)
 Event on TFTP server abnormal session close on error (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_CloseSession (uint8_t session)
 Event on TFTP server normal session close (Op) More...
 
__STATIC_INLINE void EvrNetTFTPs_UninitServer (void)
 Event on TFTP server de-initialize (Op) More...
 

Description

Events generated by the Network - TFTP Server functions.

The TFTP server functions generate events that make it easier to troubleshoot errors, and allow the user to understand how the TFTP server works.

Function Documentation

◆ EvrNetTFTPs_AbortSession()

__STATIC_INLINE void EvrNetTFTPs_AbortSession ( uint8_t  session)

Event on TFTP server abnormal session close on error (Op)

Parameters
sessionsession number

The event AbortSession is created when the TFTP server terminates an active user session because an error occurred. The file operation is not complete.

Value in the Event Recorder shows:

  • session: TTFP server session.

◆ EvrNetTFTPs_AccessDeniedNoResources()

__STATIC_INLINE void EvrNetTFTPs_AccessDeniedNoResources ( void  )

Event on TFTP server denied client access on out of resources (Error)

The event AccessDeniedNoResources is created when the TFTP server rejects a pending connection request for the client, because the server can not assign a free session to manage the client connection. This means that the maximum number of concurrent user connections is currently active.

Value in the Event Recorder shows:

  • error

◆ EvrNetTFTPs_BlockAckReceived()

__STATIC_INLINE void EvrNetTFTPs_BlockAckReceived ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server block acknowledge received (Op)

Parameters
sessionsession number
block_nrblock number

The event BlockAckReceived is created when the TFTP server receives an acknowledgement of the sent data block. The server then sends the next data block.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_BlockReceived()

__STATIC_INLINE void EvrNetTFTPs_BlockReceived ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server data block received (Op)

Parameters
sessionsession number
block_nrblock number

The event BlockReceived is created when the TFTP server receives the data block on the data socket.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_BlockRetransmit()

__STATIC_INLINE void EvrNetTFTPs_BlockRetransmit ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server block retransmit (Op)

Parameters
sessionsession number
block_nrblock number

The event BlockRetransmit is created when the TFTP server receives an acknowledgement of a previously sent data block. This means that the last data block has been lost and is being resent.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_CloseSession()

__STATIC_INLINE void EvrNetTFTPs_CloseSession ( uint8_t  session)

Event on TFTP server normal session close (Op)

Parameters
sessionsession number

The event CloseSession is created when the TFTP server closes the active user session, because file operation is completed.

Value in the Event Recorder shows:

  • session: TTFP server session.

◆ EvrNetTFTPs_DataFrameTooShort()

__STATIC_INLINE void EvrNetTFTPs_DataFrameTooShort ( uint8_t  session,
uint32_t  length,
uint32_t  min_length 
)

Event on TFTP server receive data frame too short (Error)

Parameters
sessionsession number
lengthframe length in bytes
min_lengthminimum length of the frame

The event DataFrameTooShort is created when the TFTP server receives the data frame that is too short. The frame is then discarded.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • len: length of the received data frame in bytes.
  • min: minimum valid data frame length in bytes.

◆ EvrNetTFTPs_DuplicateBlockReceived()

__STATIC_INLINE void EvrNetTFTPs_DuplicateBlockReceived ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server duplicate block received (Op)

Parameters
sessionsession number
block_nrblock number

The event DuplicateBlockReceived is created when the TFTP server wants to inform that the received data block is a duplicate, ie that it has been received again. The data block is then discarded.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_ErrorCodeReceived()

__STATIC_INLINE void EvrNetTFTPs_ErrorCodeReceived ( uint8_t  session,
uint16_t  error_code 
)

Event on TFTP server error code received from the client (Error)

Parameters
sessionsession number
error_codeTFTP error code
  • 0: not defined error
  • 1: file not found error
  • 2: access violation error
  • 3: disk full error
  • 4: illegal opcode error
  • 5: unknown TID error
  • 6: file already exists error
  • 7: no such user error

The event ErrorCodeReceived is created when the TFTP server receives an error code from the client. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • code: error code (ERR_NOTDEF, ERR_NOTFOUND, ERR_NOACCESS, ERR_DISKFULL, ERR_ILLOPCOD, ERR_UNKNTID, ERR_FILEXIST, ERR_NOUSER).

◆ EvrNetTFTPs_FileRequested()

__STATIC_INLINE void EvrNetTFTPs_FileRequested ( const char *  fname,
uint32_t  length 
)

Event on TFTP server received file request from the client (Op)

Parameters
fnamename of the requested file
lengthlength of the fname string

The event FileRequested is created when the TFTP server tries to open the requested file for reading or writing on the server.

Value in the Event Recorder shows:

  • name: name of the file to open.

◆ EvrNetTFTPs_FrameTooShort()

__STATIC_INLINE void EvrNetTFTPs_FrameTooShort ( uint32_t  length,
uint32_t  min_length 
)

Event on TFTP server receive frame too short (Error)

Parameters
lengthframe length in bytes
min_lengthminimum length of the frame

The event FrameTooShort is created when the TFTP server receives the frame that is too short. The frame is then discarded.

Value in the Event Recorder shows:

  • len: length of the received frame in bytes.
  • min: minimum valid frame length in bytes.

◆ EvrNetTFTPs_GetSocketFailed()

__STATIC_INLINE void EvrNetTFTPs_GetSocketFailed ( uint8_t  session)

Event on TFTP server failed to allocate UDP socket (Error)

Parameters
sessionsession number (0= control session)

The event GetSocketFailed is created when the TFTP server is initialized, that is, when the function netInitialize is executed, and the service could not assign the UDP socket. To resolve this error, you must increase the number of available UDP sockets in the UDP socket configuration.

Value in the Event Recorder shows:

  • session: session that failed to allocate the socket.

◆ EvrNetTFTPs_IllegalOpcodeReceived()

__STATIC_INLINE void EvrNetTFTPs_IllegalOpcodeReceived ( uint8_t  session,
uint16_t  tftp_opcode 
)

Event on TFTP server illegal operation code received from the client (Error)

Parameters
sessionsession number
tftp_opcodeTFTP operation code
  • 1: read request
  • 2: write request
  • 3: data
  • 4: acknowledgment
  • 5: error
  • 6: option acknowledgment

The event IllegalOpcodeReceived is created when the TFTP server receives an invalid operation code from the client. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • opcode: operation code (RRQ, WRQ, DATA, ACK, ERR, OACK).

◆ EvrNetTFTPs_InitServer()

__STATIC_INLINE void EvrNetTFTPs_InitServer ( uint32_t  num_sessions,
uint16_t  port,
uint8_t  firewall_en 
)

Event on TFTP server initialize (Op)

Parameters
num_sessionsnumber of available TFTP sessions
portlistening port number
firewall_enfirewall support enable
  • 0: disabled
  • 1: enabled

The event InitServer is created when the TFTP server is initialized, that is, when the function netInitialize is executed.

Value in the Event Recorder shows:

  • sessions: number of TFTP sessions available.
  • port: port number to be used.
  • firewall_en: enable firewall support.

◆ EvrNetTFTPs_InvalidBlockAck()

__STATIC_INLINE void EvrNetTFTPs_InvalidBlockAck ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server invalid block acknowledge received (Error)

Parameters
sessionsession number
block_nrblock number

The event InvalidBlockAck is created when the TFTP server receives an acknowledgement of an invalid data block, that is, an out of order block. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_InvalidBlockReceived()

__STATIC_INLINE void EvrNetTFTPs_InvalidBlockReceived ( uint8_t  session,
uint32_t  block_nr 
)

Event on TFTP server invalid block received (Error)

Parameters
sessionsession number
block_nrblock number

The event InvalidBlockReceived is created when the TFTP server receives the data block with invalid sequence, that is, an out of order block. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_InvalidTransferId()

__STATIC_INLINE void EvrNetTFTPs_InvalidTransferId ( uint8_t  session)

Event on TFTP server invalid transfer id (TID) detected (Error)

Parameters
sessionsession number
Remarks
TID is treated in UDP socket as the source and destination port.

The event InvalidTransferId is created when the TFTP server receives an invalid transfer identification (TID) data frame. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.

◆ EvrNetTFTPs_LocalFileCreateFailed()

__STATIC_INLINE void EvrNetTFTPs_LocalFileCreateFailed ( uint8_t  session)

Event on TFTP server local file create failed (Error)

Parameters
sessionsession number

The event LocalFileCreateFailed is created when the requested file cannot be created on the TFTP server. A possible reason for this may be the write-protected SD card. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.

◆ EvrNetTFTPs_LocalFileNotFound()

__STATIC_INLINE void EvrNetTFTPs_LocalFileNotFound ( uint8_t  session)

Event on TFTP server error, requested file not found on server (Error)

Parameters
sessionsession number

The event LocalFileNotFound is created when the requested file cannot be found on the TFTP server. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.

◆ EvrNetTFTPs_OperationRequest()

__STATIC_INLINE void EvrNetTFTPs_OperationRequest ( uint8_t  session,
uint16_t  tftp_opcode 
)

Event on TFTP server process operation request (Op)

Parameters
sessionsession number
tftp_opcodeTFTP operation code
  • 1: read request
  • 2: write request
  • 3: data
  • 4: acknowledgment
  • 5: error
  • 6: option acknowledgment

The event OperationRequest is created when the TFTP server wants to display the operation code it receives from the client.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • opcode: operation code (RRQ, WRQ, DATA, ACK, ERR, OACK).

◆ EvrNetTFTPs_ReceiveDataFrame()

__STATIC_INLINE void EvrNetTFTPs_ReceiveDataFrame ( uint8_t  session,
uint32_t  length 
)

Event on TFTP server receive data frame (Op)

Parameters
sessionsession number
lengthframe length in bytes

The event ReceiveDataFrame is created when the TFTP server receives the data frame on the data socket.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • len: length of the received data frame in bytes.

◆ EvrNetTFTPs_ReceiveFrame()

__STATIC_INLINE void EvrNetTFTPs_ReceiveFrame ( int32_t  socket,
uint32_t  length 
)

Event on TFTP server receive frame (Op)

Parameters
socketassigned UDP socket
lengthframe length in bytes

The event ReceiveFrame is created when the TFTP server receives the frame.

Value in the Event Recorder shows:

  • sock: TFTP server socket.
  • len: length of the received frame in bytes.

◆ EvrNetTFTPs_SendBlock()

__STATIC_INLINE void EvrNetTFTPs_SendBlock ( uint8_t  session,
uint32_t  block_nr,
uint32_t  length 
)

Event on TFTP server send block (Op)

Parameters
sessionsession number
block_nrblock number
lengthlength of a block

The event SendBlock is created when the TFTP header is constructed and the data block is sent to the UDP socket for transmitting.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.
  • len: length of the data block.

◆ EvrNetTFTPs_SendBlockAck()

__STATIC_INLINE void EvrNetTFTPs_SendBlockAck ( uint8_t  session,
uint16_t  block_nr 
)

Event on TFTP server send block acknowledgment (Op)

Parameters
sessionsession number
block_nrblock number

The event SendBlockAck is created when the TFTP server sends an acknowledgement of the received data block. The transfer then continues with the download of the next block.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block: block sequence number.

◆ EvrNetTFTPs_SendError()

__STATIC_INLINE void EvrNetTFTPs_SendError ( uint8_t  session,
uint16_t  error_nr 
)

Event on TFTP server send error code (Op)

Parameters
sessionsession number
error_nrTFTP error number
  • 0: not defined error
  • 1: file not found error
  • 2: access violation error
  • 3: disk full error
  • 4: illegal opcode error
  • 5: unknown TID error
  • 6: file already exists error
  • 7: no such user error

The event SendError is created when the TFTP server sends an error message to the client. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • code: error code (ERR_NOTDEF, ERR_NOTFOUND, ERR_NOACCESS, ERR_DISKFULL, ERR_ILLOPCOD, ERR_UNKNTID, ERR_FILEXIST, ERR_NOUSER).

◆ EvrNetTFTPs_SendOptionAck()

__STATIC_INLINE void EvrNetTFTPs_SendOptionAck ( uint8_t  session,
uint32_t  block_size 
)

Event on TFTP server send option acknowledgment (Op)

Parameters
sessionsession number
block_sizeblock size

The event SendOptionAck is created when the TFTP server sends an acknowledgement of the proposed transfer block size option. The size is usually 512 bytes.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • block_size: block size in bytes.

◆ EvrNetTFTPs_SessionRestart()

__STATIC_INLINE void EvrNetTFTPs_SessionRestart ( uint8_t  session)

Event on TFTP server session restart, maybe our response was lost (Op)

Parameters
sessionsession number

The event SessionRestart is created when the TFTP server receives a retransmitted request. This usually means that initial server response was lost. The server session then restarts.

Value in the Event Recorder shows:

  • session: TFTP server restart session.

◆ EvrNetTFTPs_SetRootPath()

__STATIC_INLINE void EvrNetTFTPs_SetRootPath ( const char *  path,
uint32_t  length 
)

Event on TFTP server netTFTPs_SetRootPath (API)

Parameters
pathpath to server root folder
lengthlength of the path string

The event SetRootPath is created when the TFTP server changes the path to server files. This happens when the netTFTPs_SetRootPath function is executed.

Value in the Event Recorder shows:

  • path: path of the root directory to be set.

◆ EvrNetTFTPs_ShowClientAddress()

__STATIC_INLINE void EvrNetTFTPs_ShowClientAddress ( const void *  net_addr)

Event on TFTP server display client IP address and port number (Op)

Parameters
net_addrpointer to NET_ADDR address structure

The event ShowClientAddress is created when the TFTP server wants to display the contents of the network address structure, that is, the IP address and the port number of the client.

Value in the Event Recorder shows:

  • ip: IPv4 or IPv6 address of the client.
  • port: port number of the client.

◆ EvrNetTFTPs_ShowRequestMode()

__STATIC_INLINE void EvrNetTFTPs_ShowRequestMode ( const uint8_t *  mode,
uint32_t  length 
)

Event on TFTP server display received request mode parameter (Op)

Parameters
modemode parameter in text format
lengthlength of the mode string

The event ShowRequestMode is created when the TFTP server wants to display the contents of a received mode option.

Value in the Event Recorder shows:

  • mode: mode option in text format.

◆ EvrNetTFTPs_ShowRootFolder()

__STATIC_INLINE void EvrNetTFTPs_ShowRootFolder ( const char *  root_folder,
uint32_t  length 
)

Event on TFTP server display root folder (Op)

Parameters
root_folderpath to server root folder
lengthlength of the root_folder string

The event ShowRootFolder is created when the network library wants to display the path to the root folder that contains the TFTP server files. This event is generated only if the root folder is enabled in the TFTP server configuration.

Value in the Event Recorder shows:

  • root: path of the root directory.

◆ EvrNetTFTPs_StartService()

__STATIC_INLINE void EvrNetTFTPs_StartService ( uint16_t  port)

Event on TFTP server start service (Op)

Parameters
portlistening port number

The event StartService is created when the network library starts the TFTP server service. This happens automatically if the auto-start services are enabled, or when the netTFTPs_Start function is executed.

Value in the Event Recorder shows:

  • port: port number to be used.

◆ EvrNetTFTPs_StopService()

__STATIC_INLINE void EvrNetTFTPs_StopService ( void  )

Event on TFTP server stop service (Op)

The event StopService is created when the network library stops the TFTP server service. This happens when the netTFTPs_Stop function is executed.

◆ EvrNetTFTPs_TimeoutExpiredAbort()

__STATIC_INLINE void EvrNetTFTPs_TimeoutExpiredAbort ( uint8_t  session)

Event on TFTP server session timeout expired, abort transfer (Error)

Parameters
sessionsession number

The event TimeoutExpiredAbort is created when the TFTP server session expired due to client inactivity. The session is then aborted.

Value in the Event Recorder shows:

  • session: session that expired.

◆ EvrNetTFTPs_TooManyRetries()

__STATIC_INLINE void EvrNetTFTPs_TooManyRetries ( uint8_t  session)

Event on TFTP server too many retransmissions (Error)

Parameters
sessionsession number

The event TooManyRetries is created when the TFTP server receives or sends too many duplicate blocks. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.

◆ EvrNetTFTPs_TransferBlockSize()

__STATIC_INLINE void EvrNetTFTPs_TransferBlockSize ( uint8_t  session,
uint16_t  block_size 
)

Event on TFTP server display transfer block size (Op)

Parameters
sessionsession number
block_sizesize of transfer block

The event TransferBlockSize is created when the TFTP server wants to display the size of transfer block that is set for the session. The size is usually 512 bytes.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • size: block size in bytes.

◆ EvrNetTFTPs_TransferModeNotBinary()

__STATIC_INLINE void EvrNetTFTPs_TransferModeNotBinary ( uint8_t  session)

Event on TFTP server transfer mode not set to binary (Error)

Parameters
sessionsession number

The event TransferModeNotBinary is created when the TFTP server receives a request mode that is not "octet" or "netascii", so it is not a binary mode. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.

◆ EvrNetTFTPs_UninitServer()

__STATIC_INLINE void EvrNetTFTPs_UninitServer ( void  )

Event on TFTP server de-initialize (Op)

The event UninitServer is created when the function netUninitialize is executed.

Value in the Event Recorder shows:

  • tftp

◆ EvrNetTFTPs_UserAccessDenied()

__STATIC_INLINE void EvrNetTFTPs_UserAccessDenied ( const void *  net_addr)

Event on TFTP server user denied access (Error)

Parameters
net_addrpointer to NET_ADDR address structure

The event UserAccessDenied is created when the TFTP server rejects the pending connection request for the client, because the user application has denied connection for this client. This happens when the netTFTPs_AcceptClient function returns false.

Value in the Event Recorder shows:

  • ip: IPv4 or IPv6 address of the client.
  • port: port number of the client.

◆ EvrNetTFTPs_WriteErrorDiskFull()

__STATIC_INLINE void EvrNetTFTPs_WriteErrorDiskFull ( uint8_t  session,
uint32_t  length 
)

Event on TFTP server write local disk failed, disk full (Error)

Parameters
sessionsession number
lengthblock data length

The event WriteErrorDiskFull is created when the TFTP server failed to write data to a local file. This usually happens when the storage medium is full or when a write error occurs in netTFTPs_fwrite. The server session then terminates.

Value in the Event Recorder shows:

  • session: TFTP server session.
  • len: length of data to write.