Please document the userspace API (added linux-api and linux-man to CC for sugestions), especially including the odd effects of the per-inode settings.
Also I would highly recommend to use different fcntl commands for the file vs inode hints to avoid any strange behavior.
