NAME

       plugin.config - Traffic Server global plugin configuration file

DESCRIPTION

       The  plugin.config file controls run-time loadable plugins available to Traffic Server, as
       well as their configuration.  Plugins listed in  this  file  are  referred  to  as  global
       plugins  because  they  are  always loaded and have global effect.  This is in contrast to
       plugins specified in remap.config, whose effects are limited to the specific mapping rules
       to which they are applied.

       Each  configuration  line  consists  of  a  path  to  an .so file. This path can either be
       absolute, or relative to the plugin directory (usually  /usr/local/libexec/trafficserver).
       Failure  to load a plugin is fatal, and will cause Traffic Server to abort. In general, it
       is not possible to know whether it is safe for the service to  run  without  a  particular
       plugin, since plugins can have arbitrary effects on caching and authorization policies.

       IMPORTANT:
          Plugins  should  only be listed once. The order in which the plugins are listed is also
          the order in which they are chained for request processing.

       An option list of whitespace-separated arguments may follow the plugin  name.   These  are
       passed  as  an  argument  vector  to the plugin's initialization function, TSPluginInit().
       Arguments  that  begin  with  the  $  character  designate  Traffic  Server  configuration
       variables.  These  arguments  will  be  replaced  with  the  value  of  the  corresponding
       configuration variable before the plugin is loaded.   When  using  configuration  variable
       expansion,  note  that  most  Traffic  Server  configuration  can  be changed. If a plugin
       requires the current value, it must obtain that using the management API.

EXAMPLES

          # Comments start with a '#' and continue to the end of the line
          # Blank lines are ignored
          #
          # test-plugin.so arg1 arg2 arg3
          #
          plugins/iwx/iwx.so
          plugins/abuse/abuse.so etc/trafficserver/abuse.config
          plugins/icx/icx.so etc/trafficserver/icx.config $proxy.config.http.connect_attempts_timeout

SEE ALSO

       TSAPI(3ts), TSPluginInit(3ts), remap.config(5)

COPYRIGHT

       2023, dev@trafficserver.apache.org