gawk: AWKLIBPATH Variable

 
 2.5.2 The 'AWKLIBPATH' Environment Variable
 -------------------------------------------
 
 The 'AWKLIBPATH' environment variable is similar to the 'AWKPATH'
 variable, but it is used to search for loadable extensions (stored as
 system shared libraries) specified with the '-l' option rather than for
 source files.  If the extension is not found, the path is searched again
 after adding the appropriate shared library suffix for the platform.
 For example, on GNU/Linux systems, the suffix '.so' is used.  The search
 path specified is also used for extensions loaded via the '@load'
 keyword (SeeLoading Shared Libraries).
 
    If 'AWKLIBPATH' does not exist in the environment, or if it has an
 empty value, 'gawk' uses a default path; this is typically
 '/usr/local/lib/gawk', although it can vary depending upon how 'gawk'
 was built.
 
    SeeShell Startup Files, for information on functions that help
 to manipulate the 'AWKLIBPATH' variable.
 
    'gawk' places the value of the search path that it used into
 'ENVIRON["AWKLIBPATH"]'.  This provides access to the actual search path
 value from within an 'awk' program.
 
    Although you can change 'ENVIRON["AWKLIBPATH"]' within your 'awk'
 program, this has no effect on the running program's behavior.  This
 makes sense: the 'AWKLIBPATH' environment variable is used to find any
 requested extensions, and they are loaded before the program starts to
 run.  Once your program is running, all the extensions have been found,
 and 'gawk' no longer needs to use 'AWKLIBPATH'.