* Initiate a write operation within a given volume. On SUCCESS, the
* <code>writeDone</code> event will signal completion of the
* operation.
+ * <p>
+ * Between two erases, no byte may be written more than once.
*
* @param addr starting address to begin write.
* @param buf buffer to write data from.
/**
* Signals the completion of a write operation. However, data is not
- * guaranteed to survive a power-cycle unless a commit operation has
+ * guaranteed to survive a power-cycle unless a sync operation has
* been completed.
*
* @param addr starting address of write.
event void eraseDone(error_t error);
/**
- * Initiate a commit operation and finialize any additional writes
- * to the volume. A verify operation from <code>BlockRead</code> can
- * be done to check if the data has been modified since. A commit
- * operation must be issued to ensure that data is stored in
- * non-volatile storage. On SUCCES, the <code>commitDone</code>
- * event will signal completion of the operation.
+ * Initiate a sync operation and finialize any additional writes to
+ * the volume. A sync operation must be issued to ensure that data is
+ * stored in non-volatile storage. On SUCCES, the
+ * <code>syncDone</code> event will signal completion of the
+ * operation.
*
* @return
* <li>SUCCESS if the request was accepted,
* <li>EBUSY if a request is already being processed.
*/
- command error_t commit();
+ command error_t sync();
/**
- * Signals the completion of a commit operation. All written data is
+ * Signals the completion of a sync operation. All written data is
* flushed to non-volatile storage after this event.
*
* @param error SUCCESS if the operation was successful, FAIL if
* it failed
*/
- event void commitDone(error_t error);
+ event void syncDone(error_t error);
}