Description
array 
fam_next_event ( 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().