New Fields in FILEHOOK

Add new fields chan, location and lineno to the ST_HOOK_ENV structure passed to the hook SBX. These are mostly motivated by the desire to use the hook mechanism more for application forensics than for traditional purposes (export, data audit); i.e. they allow the hook return to more information about the context in which the file operation occurred.

The end of the ST_HOOK_ENV structure now looks like this:

map2 user,s,24      ! user name

map2 chan,b,4       ! actual file channel (may not match fileid)

map2 location,b,4   ! location counter

map2 lineno,b,2     ! last line #

 

Note that the expanded structure does not break compatibility with existing hook routines, nor do hook routines using the expanded structure lose their backwards compatibility. The new fields just won't be available.

See ASHINC:HOOK.DEF for the updated structure and related symbol defintions.