The host can invoke the write command for each file opened for write. For nonsecure files, the write command can be done to random offsets. For secure files, the write operation also encrypts the file, thus writing secure files requires writing to sequential offsets, or writing to a 16-byte-aligned offset buffer, which is also 16-byte-aligned in size.

The file system sets the actual file size as the higher offset than was written; the actual file size can be retrieved by the sl_FsGetInfo() function.

The return value of the write function is the number of bytes written, and a negative value is an error number.

Table 9-6 shows a partial list of errors that might be returned by the write function.

Example:

_i32              FileHdl;
_i32              Status;
_u32              Offset = 0;
unsigned char     pData[100];
_u32              Len = 0;
Status = sl_FsWrite( FileHdl, Offset, pData, Len );
if( Status < 0 )
{
    /* error */
    /* abort */
    sl_FsClose(FileHdl,0,'A',1);
}