GDNSD-PLUGIN-EXTFILE(8)              gdnsd             GDNSD-PLUGIN-EXTFILE(8)


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

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

         service_types => {
           ext1 => {
             plugin => "extfile",
             file => "/var/tmp/ext1data", # required
             direct => true, # default false
             def_down => false, # default false
             def_ttl => 600, # default max (limited by zonefile RRs)
           }
           ext2 => {
             plugin => "extfile",
             file => "ext2data", # def dir: //lib/gdnsd/extfile/
           },
         }

       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> service_types<?><?>:

         plugins => {
           multifo => {
             www1 => {
               service_types => ext2,
               lb01 => 192.0.2.200,
               lb02 => 192.0.2.201,
               lb03 => 192.0.2.202,
             }
             www2 => {
               service_types => [ ext1, http_status ],
               lb01 => 192.0.2.203,
               lb02 => 192.0.2.204,
               lb03 => 192.0.2.205,
             }
           },
           weighted => {
             wwwcn => {
               service_types => ext1,
               lb01 = [ lb01.example.com., 99 ],
               lb02 = [ lb02.example.com., 15 ],
               lb03 = [ lb03, 1 ],
             }
             wwwz => {
               service_types => ext1,
               lb01 => [ 192.0.2.203, 10 ],
               lb02 => [ 192.0.2.204, 15 ],
               lb03 => [ 192.0.2.205, 20 ],
             }
           }
         }

       <?><?><?><?><?> <?><?><?><?><?><?><?><?> extfile <?><?> <?><?><?><?><?>
       <?> service_types <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>:

         /var/tmp/ext1data:
           192.0.2.203 => UP/300
           192.0.2.204 => DOWN/242
           192.0.2.205 => DOWN/102
           lb01.example.com. => UP/60
           lb02.example.com. => UP/30
           lb03 => UP/45

         //lib/gdnsd/extfile/ext2data:
           192.0.2.200 => DOWN
           192.0.2.201 => UP
           192.0.2.202 => UP

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

<?><?><?><?><?><?><?> (MODES)
       <?><?> service_type <?><?><?><?><?> <?><?> extfile
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>:

       <?><?><?><?> <?><?><?><?> (Monitor Mode - <?><?><?><?><?><?><?>)
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> "interval" <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> TTL
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>).

           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> (<?><?><?><?><?> http_status) <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (resolution
           plugins)<?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> ("up_thresh"<?>
           "down_thresh"<?> "ok_thresh") <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> (anti-flap) <?><?><?><?><?><?> <?><?>.

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

       <?><?><?><?> <?><?><?><?><?><?> (Direct Mode)
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?> "interval" <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> (hint) <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> (<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?><?> <?><?> inotify())
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?>.

           <?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> (~<?> <?><?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           (<?><?><?><?><?> <?>/<?><?> TTL <?><?><?><?> <?><?> <?><?><?><?>)
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> (<?><?><?> <?><?> <?><?><?><?><?> <?><?> gdnsd)
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> (anti-flap) <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?> <?><?><?><?> (FILE FORMAT)
       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> "vscf" <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> geoip <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>-<?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> IP
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> CNAME <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> "state[/ttl]"
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> state <?><?><?><?><?>
       <?><?> "UP" <?><?> "DOWN" <?><?><?><?> <?> ttl <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> TTL <?><?><?>.
       <?><?><?><?><?><?> TTL <?><?><?><?> <?><?><?><?> service_type<?><?><?>
       <?><?> <?><?><?><?> "direct" <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> "monitor"
       <?><?><?><?><?> TTL <?><?> <?><?><?> <?><?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> - <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       (CONFIGURATION - PER-SERVICE-TYPE)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> service_type <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>: "up_thresh"<?> "ok_thresh"<?> "down_thresh" <?>
       "interval" (<?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> "interval").  <?><?><?><?><?><?><?> "timeout"
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> extfile:

       direct
           <?><?><?><?> (Boolean)<?> <?><?><?><?><?><?><?> false. <?><?>
           <?><?><?><?> true<?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>
           "direct" <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> "monitor" <?><?><?><?>
           <?><?><?><?><?><?><?>.

       file
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?> //lib/gdnsd/extfile/ <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>.

       def_ttl
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> TTL<?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> (<?><?>
           <?><?><?><?> <?><?><?><?><?><?> TTL <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> RR <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?>). <?><?> <?><?><?><?>
           "direct"<?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> TTL <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> TTL <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?> <?><?><?><?>
           "monitor" <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>.

       def_down
           <?><?><?><?> (Boolean)<?> <?><?><?><?><?><?><?> false. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> (<?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>). <?><?><?> true
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> "DOWN"
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> "UP" <?><?><?><?>
           <?><?><?><?><?><?><?><?>.

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

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

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

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

       <?><?><?><?><?><?><?><?><?> gdnsd <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?>: <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> (GNU GPL) <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?>
       <?><?><?><?> <?> <?><?> (<?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>)
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

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

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

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