fam_next_event() returns the next pending FAM event. The function will block until an event is available which can be checked for using fam_pending().
fam_next_event() will return an array that contains
a FAM event code in element '
code', the path of the
file this event applies to in element '
optionally a hostname in element '
The possible event codes are described in detail in the constants part of this section.
See also fam_pending().