summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorØyvind Harboe <oyvind.harboe@zylin.com>2010-02-09 21:54:55 +0100
committerØyvind Harboe <oyvind.harboe@zylin.com>2010-02-09 21:57:23 +0100
commitc646b767971f5750b32f0bc8290a2eea351cb514 (patch)
treee1112486cb7ecc048ae85da935fa783315942c37 /src
parentf899c2aa9767ba7bf731e6c6c1af2c437af97dac (diff)
downloadopenocd_libswd-c646b767971f5750b32f0bc8290a2eea351cb514.tar.gz
openocd_libswd-c646b767971f5750b32f0bc8290a2eea351cb514.tar.bz2
openocd_libswd-c646b767971f5750b32f0bc8290a2eea351cb514.tar.xz
openocd_libswd-c646b767971f5750b32f0bc8290a2eea351cb514.zip
target: add todo in target_write_memory() about alignment
target_write_buffer() does not align "buffer" in host memory passed to target_write_memory(). Signed-off-by: Øyvind Harboe <oyvind.harboe@zylin.com>
Diffstat (limited to 'src')
-rw-r--r--src/target/target.h15
1 files changed, 13 insertions, 2 deletions
diff --git a/src/target/target.h b/src/target/target.h
index da91d464..7400b7e1 100644
--- a/src/target/target.h
+++ b/src/target/target.h
@@ -2,7 +2,7 @@
* Copyright (C) 2005 by Dominic Rath *
* Dominic.Rath@gmx.de *
* *
- * Copyright (C) 2007-9 Øyvind Harboe *
+ * Copyright (C) 2007-2010 Øyvind Harboe *
* oyvind.harboe@zylin.com *
* *
* Copyright (C) 2008 by Spencer Oliver *
@@ -371,7 +371,18 @@ int target_read_memory(struct target *target,
uint32_t address, uint32_t size, uint32_t count, uint8_t *buffer);
/**
* Write @a count items of @a size bytes to the memory of @a target at
- * the @a address given.
+ * the @a address given. @a address must be aligned to @a size
+ * in target memory.
+ *
+ * The endianness is the same in the host and target memory for this
+ * function.
+ *
+ * \todo TODO:
+ * Really @a buffer should have been defined as "const void *" and
+ * @a buffer should have been aligned to @a size in the host memory.
+ *
+ * This is not enforced via e.g. assert's today and e.g. the
+ * target_write_buffer fn breaks this assumption.
*
* This routine is wrapper for target->type->write_memory.
*/