Something like this? http://maemo.org/development/sdks/ma...arm_framework/
Alarm events and the functions to manage them are defined in libalarm.h header file located in /usr/include/alarmd. It is a part of the libalarm-dev debian package.