define list container api

Signed-off-by: Serge Hallyn <serge.hallyn@ubuntu.com>