Returns the next pending FAM event.
The function will block until an event is available which can be checked for using fam_pending().
A resource representing a connection to the FAM service returned by fam_open()
Returns an array that contains a FAM event code in the
code' element, the path of the file this event applies
to in the '
filename' element and optionally a hostname
in the '
The possible event codes are described in detail in the constants part of this section.