GDNSD-PLUGIN-EXTMON(8)               gdnsd              GDNSD-PLUGIN-EXTMON(8)


<?><?><?> (NAME)
       gdnsd-plugin-extmon - <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       gdnsd

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>:

         service_types => {
           wget_ssl_index => {
             plugin => "extmon",
             timeout => 15,
             interval => 30,
             cmd => ["/usr/bin/wget", "-T", "3", "-q", "-O", "/dev/null", "https://%%ITEM%%/index.html"]
           },
           svc_alwaysok => {
             plugin => "extmon",
             timeout => 1,
             direct => true,
             cmd => ["/bin/sh", "-c", "exit 0"]
           },
           svc_alwaysfail_via_timeout => {
             plugin => "extmon",
             timeout => 2,
             max_proc => 10,
             cmd => ["/bin/sh", "-c", "sleep 5"]
           }
         }

         # <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>...
         plugins => {
           extmon => { helper_path => "/usr/lib/gdnsd/gdnsd_extmon_helper" }
         }

<?><?><?><?><?><?><?> (DESCRIPTION)
       gdnsd-plugin-extmon <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> - <?><?><?><?><?><?> (CONFIGURATION - GLOBAL)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> "plugins => { extmon
       => { ... } }" <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       helper_path
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           gdnsd_extmon_helper <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           libexec <?><?><?> <?><?><?> <?><?>
           /usr/lib/gdnsd/gdnsd_extmon_helper <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?>.  <?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>)<?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       helper_failure_action
           <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?> "stasis"
           <?><?> "kill_daemon".  <?><?><?><?><?><?><?> "stasis" <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?> gdnsd_extmon_helper
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> syslog <?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>.

           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> "stasis"<?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> syslog <?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?>.

           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> "kill_daemon"<?>
           <?><?> <?><?><?><?> gdnsd <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> - <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       (CONFIGURATION - PER-SERVICE-TYPE)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> service_type <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>: "up_thresh"<?> "ok_thresh"<?> "down_thresh"<?>
       "interval"<?> "plugin" <?> "timeout". <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> gdnsd.config(5) <?><?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       "extmon" <?><?><?><?><?>:

       cmd <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> execv()
           <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>). <?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> ""/bin/sh", "-c", ..."
           <?><?><?><?> <?><?><?><?>.

           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           "%%ITEM%%" (<?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?> IP <?><?> <?><?><?> CNAME
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       direct
           <?><?><?><?><?> <?><?><?><?><?><?><?> false.

           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> extmon
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> (anti-flap) <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> HTTP <?> TCP <?><?>
           <?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           ("ok_thresh"<?> "up_thresh" <?> "down_thresh") <?><?><?><?><?> <?>
           <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> (resolution) <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>.

           <?><?><?> "direct" <?><?><?> "true" <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> extmon <?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?> extmon <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?>.

       max_proc
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> 0
           (<?><?><?><?><?><?><?>).

           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>.
           <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> 0.1
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?>
           <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

<?><?><?><?> <?><?><?><?> (EXECUTION ENVIRONMENT)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> gdnsd_extmon_helper
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?> (pipe)
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       (<?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>)
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?>.  <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> pthreads <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (userid) <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> stdout<?> stdin <?>
       stderr <?><?><?><?><?><?><?> <?><?><?> /dev/null <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?>. <?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> "-f start" <?><?><?><?>
       <?><?><?> <?><?><?><?><?> stdout <?> stderr <?><?><?><?> <?><?><?>
       <?><?> tty <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       gdnsd.config(5)<?> gdnsd(8)

       <?><?><?><?><?><?><?> gdnsd.

<?><?> <?><?><?> <?> <?><?><?><?> (COPYRIGHT AND LICENSE)
       Copyright (c) 2012 Brandon L Black <blblack@gmail.com>

       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> gdnsd <?><?><?>.

       <?><?><?><?><?><?> gdnsd <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?>: <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> (GNU General Public License)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?> <?><?><?> <?><?><?><?>
       <?><?> (<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?>/<?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?> gdnsd <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> gdnsd
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <http://www.gnu.org/licenses> <?><?><?><?><?><?> <?><?><?><?>.

gdnsd 3.8.3                       2026-04-04            GDNSD-PLUGIN-EXTMON(8)