]> oss.titaniummirror.com Git - tinyos-2.x.git/blobdiff - tos/interfaces/LogWrite.nc
Update tos-bsl for win32 python
[tinyos-2.x.git] / tos / interfaces / LogWrite.nc
index cf1736d12f860270b668e0611068d8821712113b..7a15915193a75db63a7b0c9955444316246ddcef 100644 (file)
@@ -44,7 +44,7 @@ interface LogWrite {
    * Append data to a given volume. On SUCCESS, the <code>appendDone</code> 
    * event will signal completion of the operation.
    * 
-   * @param buf buffer to write data from.
+   * @param 'void* COUNT(len) buf' buffer to write data from.
    * @param len number of bytes to write.
    * @return 
    *   <li>SUCCESS if the request was accepted, 
@@ -58,12 +58,15 @@ interface LogWrite {
    * guaranteed to survive a power-cycle unless a commit operation has
    * been completed.
    *
-   * @param buf buffer that written data was read from.
+   * @param 'void* COUNT(len) buf' buffer that written data was read from.
    * @param len number of bytes actually written (valid even in case of error)
+   * @param records_lost TRUE if this append destroyed some old records from
+   *   the beginning of the log (only possible for circular logs).
    * @param error SUCCESS if append was possible, ESIZE if the (linear) log
    *    is full and FAIL for other errors.
    */
-  event void appendDone(void* buf, storage_len_t len, error_t error);
+  event void appendDone(void* buf, storage_len_t len, bool recordsLost,
+                       error_t error);
   
   /**
    * Return a "cookie" representing the current append offset within the