as_add_containing()

Synopsis:

unsigned as_add_containing(paddr_t start,
                           paddr_t end, 
                           unsigned attr, 
                           const char *name, 
                           const char *container);

Description:

Add new entries to the asinfo section, with the owner field set to whatever entries are named by the string pointed to by container. This function can add multiple entries because the start and end values are constrained to stay within the start and end of the containing entry (e.g. they get clipped such that they don't go outside the parent). If more than one entry is added, the AS_ATTR_CONTINUED bit will be turned on in all but the last. Returns the offset from the start of the section for the first entry added.

For more information and an example, see “Typed memory” in the Interprocess Communication (IPC) chapter of the System Architecture guide.

Returns:

>0: Success.
-1: Error