diff options
Diffstat (limited to 'src/include/usr/mbox/mboxif.H')
-rw-r--r-- | src/include/usr/mbox/mboxif.H | 25 |
1 files changed, 24 insertions, 1 deletions
diff --git a/src/include/usr/mbox/mboxif.H b/src/include/usr/mbox/mboxif.H index f9846cbc3..1f56d6c95 100644 --- a/src/include/usr/mbox/mboxif.H +++ b/src/include/usr/mbox/mboxif.H @@ -5,7 +5,9 @@ /* */ /* OpenPOWER HostBoot Project */ /* */ -/* COPYRIGHT International Business Machines Corp. 2012,2014 */ +/* Contributors Listed Below - COPYRIGHT 2012,2014 */ +/* [+] International Business Machines Corp. */ +/* */ /* */ /* Licensed under the Apache License, Version 2.0 (the "License"); */ /* you may not use this file except in compliance with the License. */ @@ -131,6 +133,27 @@ namespace MBOX */ errlHndl_t resume(); + /** + * Allocate storage for mailbox message extra_data for asynchronous + * messages. + * + * @param[in] Number of bytes to allocate + * @return pointer to storage + * + * @note This call may block until memory becomes available if the memory + * sum of of all mbox messages is excessive. + * + * @note a call to MOX::send(..) will release the storage. + */ + void * allocate(size_t); + + /** + * Deallocate storage for a mailbox message extra_data + * + * @param[in] pointer to storage + */ + void deallocate(void * i_ptr); + }; // end namespace MBOX #endif |