( resource fam )
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 'filename' and
optionally a hostname in element 'hostname'.
The possible event codes are described in detail in the
constants part of this section.
See also fam_pending().