mirror/lwip
1
0
Fork 0
mirror of https://github.com/lwip-tcpip/lwip.git synced 2024-07-07 13:29:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve TFTP comments

Browse Source
This commit is contained in:
Dirk Ziegelmeier 2018-10-08 12:48:16 +02:00
parent 6c2fd2d25d
commit 5a8bd37509
2 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
contrib/examples/tftp/tftp_example.c
View File

@ -77,6 +77,7 @@ tftp_write(void* handle, struct pbuf* p)
return 0;
}
/* For TFTP client only */
static int
tftp_error(void* handle, int err, const char* msg, int size)
{

12
src/include/lwip/apps/tftp_common.h
View File

@ -55,7 +55,7 @@ extern "C" {
*/
struct tftp_context {
/**
* Open file for read/write.
* Open file for read/write (server mode only).
* @param fname Filename
* @param mode Mode string from TFTP RFC 1350 (netascii, octet, mail)
* @param write Flag indicating read (0) or write (!= 0) access
@ -64,12 +64,12 @@ struct tftp_context {
void* (*open)(const char* fname, const char* mode, u8_t write);
/**
* Close file handle
* @param handle File handle returned by open()
* @param handle File handle returned by open()/tftp_put()/tftp_get()
*/
void (*close)(void* handle);
/**
* Read from file
* @param handle File handle returned by open()
* @param handle File handle returned by open()/tftp_put()/tftp_get()
* @param buf Target buffer to copy read data to
* @param bytes Number of bytes to copy to buf
* @returns >= 0: Success; < 0: Error
@ -77,7 +77,7 @@ struct tftp_context {
int (*read)(void* handle, void* buf, int bytes);
/**
* Write to file
* @param handle File handle returned by open()
* @param handle File handle returned by open()/tftp_put()/tftp_get()
* @param pbuf PBUF adjusted such that payload pointer points
* to the beginning of write data. In other words,
* TFTP headers are stripped off.
@ -85,8 +85,8 @@ struct tftp_context {
*/
int (*write)(void* handle, struct pbuf* p);
/**
* Error response
* @param handle File handle set by tftp_get/tftp_put
* Error response (client mode only)
* @param handle File handle set by tftp_get()/tftp_put()
* @param err error code from server
* @param msg error message from server
* @param size size of msg