diff options
author | Randall Spangler <rspangler@chromium.org> | 2012-08-09 13:47:26 -0700 |
---|---|---|
committer | Gerrit <chrome-bot@google.com> | 2012-08-09 17:40:37 -0700 |
commit | 371d06bbfdf56fad142539c9a72759e53d5bc26a (patch) | |
tree | 0fe36ffa1485b319a7b0d3e59db9c722f97ce020 /include/shared_mem.h | |
parent | 019f50590e5c0d49baaf9dbe980c22f8e1e19df1 (diff) | |
download | chrome-ec-371d06bbfdf56fad142539c9a72759e53d5bc26a.tar.gz |
Tidy shared memory module
Adds shmem command to print amount of shared memory. This is also a
useful indicator of how much IRAM is left, since shared memory will
expand to fill all unused IRAM.
Removes never-implemented wait param to shared_mem_acquire().
BUG=none
TEST=shmem
Change-Id: I798ff644d701dcba52219b70bec99c06a23d03ec
Signed-off-by: Randall Spangler <rspangler@chromium.org>
Reviewed-on: https://gerrit.chromium.org/gerrit/29809
Reviewed-by: Bill Richardson <wfrichar@chromium.org>
Diffstat (limited to 'include/shared_mem.h')
-rw-r--r-- | include/shared_mem.h | 49 |
1 files changed, 30 insertions, 19 deletions
diff --git a/include/shared_mem.h b/include/shared_mem.h index 14b6613a9a..f7b8bcbccb 100644 --- a/include/shared_mem.h +++ b/include/shared_mem.h @@ -3,37 +3,48 @@ * found in the LICENSE file. */ -/* Shared memory interface for Chrome EC. +/* + * Shared memory interface for Chrome EC. * - * This is intended to supply a relatively large block of memory for - * use by a task for a relatively short amount of time. For example, - * verified boot may need a buffer to hold signature data during a - * verification operation. It is NOT intended for allocating - * long-term buffers; those should in general be static variables - * allocated at compile-time. It is NOT a full-featured replacement - * for malloc() / free(). */ + * This is intended to supply a relatively large block of memory for use by a + * task for a relatively short amount of time. For example, verified boot may + * need a buffer to hold signature data during a verification operation. It is + * NOT intended for allocating long-term buffers; those should in general be + * static variables allocated at compile-time. It is NOT a full-featured + * replacement for malloc() / free(). + */ #ifndef __CROS_EC_SHARED_MEM_H #define __CROS_EC_SHARED_MEM_H #include "common.h" -/* Initializes the module. */ +/** + * Initializes the module. + */ int shared_mem_init(void); -/* Returns the maximum amount of shared memory which can be acquired, - * in bytes. */ +/** + * Returns the maximum amount of shared memory which can be acquired, in + * bytes. + */ int shared_mem_size(void); -/* Acquires a shared memory area of the requested size in bytes. If - * wait != 0, will wait for the area to be available; if wait == 0, - * will fail with EC_ERROR_BUSY if the request cannot be fulfilled - * immediately. On success, sets *dest_ptr to the start of the memory - * area and returns EC_SUCCESS. */ -int shared_mem_acquire(int size, int wait, char **dest_ptr); +/** + * Acquires a shared memory area of the requested size in bytes. + * + * @param size Number of bytes requested + * @param dest_ptr If successful, set on return to the start of the + * granted memory buffer. + * + * @return EC_SUCCESS if successful, EC_ERROR_BUSY if buffer in use, or + * other non-zero error code. + */ +int shared_mem_acquire(int size, char **dest_ptr); -/* Releases a shared memory area previously allocated via - * shared_mem_acquire(). */ +/** + * Releases a shared memory area previously allocated via shared_mem_acquire(). + */ void shared_mem_release(void *ptr); #endif /* __CROS_EC_SHARED_MEM_H */ |