NetBurner 3.5.0
PDF Version
 
Stream Update

Topics

 Stream Update Return Values
 

Functions

int ReadBinaryApplicationCodeFromStream (int fd)
 Read a binary application image from an input stream and program flash memory.
 
int ReadS19ApplicationCodeFromStream (int fd)
 Read an ASCII application image in s-record .s19 format from an input stream and program flash memory.
 

Detailed Description

#include< StreamUpdate.h >

Functions to read an application form a source with a file descriptor. Useful for programming/updating an application image from sources such as flash memory cards, posts from other devices, and files received from FTP.

Function Documentation

◆ ReadBinaryApplicationCodeFromStream()

int ReadBinaryApplicationCodeFromStream ( int fd)

#include <StreamUpdate.h>

Read a binary application image from an input stream and program flash memory.

Read a binary application image from an input stream and program the application image in flash memory. Flash memory will not be modified unless the entire application is received without error.

A reboot is required to run the new application. Before any reboot, the running application should free, close and clean up any items necessary to put the device in a safe state. For example, it would be better to close active TCP or FTP connections rather than just reset so that any connected clients can close normally. If you wish to reboot from a running application you can use the

void ForceReboot()
void ForceReboot(bool bFromException=false)
Forces the system hardware to perform a soft reset.

function ForceReboot().

Parameters
fdThe File Descriptor to read the input data stream from
Returns
Stream Update Return Values

◆ ReadS19ApplicationCodeFromStream()

int ReadS19ApplicationCodeFromStream ( int fd)

#include <StreamUpdate.h>

Read an ASCII application image in s-record .s19 format from an input stream and program flash memory.

Read a ASCII application image in s-record .s19 format from an input stream and program the application image in flash memory. Flash memory will not be modified unless the entire application is received without error.

A reboot is required to run the new application. Before any reboot, the running application should free, close and clean up any items necessary to put the device in a safe state. For example, it would be better to close active TCP or FTP connections rather than just reset so that any connected clients can close normally. If you wish to reboot from a running application you can use the

void ForceReboot()

function ForceReboot().

Parameters
fdThe File Descriptor to read the input data stream from
Returns
Stream Update Return Values