contrib/bind-9.5.2/bin/named/include/named/notify.h

   1 /*
   2  * Copyright (C) 2004, 2005, 2007, 2009  Internet Systems Consortium, Inc. ("ISC")
   3  * Copyright (C) 1999-2001  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and/or distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
  10  * REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  11  * AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
  12  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  13  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
  14  * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  15  * PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 /* $Id: notify.h,v 1.14.128.2 2009/01/19 23:47:01 tbox Exp $ */
  19
  20 #ifndef NAMED_NOTIFY_H
  21 #define NAMED_NOTIFY_H 1
  22
  23 #include <named/types.h>
  24 #include <named/client.h>
  25
  26 /***
  27  ***    Module Info
  28  ***/
  29
  30 /*! \file
  31  * \brief
  32  *      RFC1996
  33  *      A Mechanism for Prompt Notification of Zone Changes (DNS NOTIFY)
  34  */
  35
  36 /***
  37  ***    Functions.
  38  ***/
  39
  40 void
  41 ns_notify_start(ns_client_t *client);
  42
  43 /*%<
  44  *      Examines the incoming message to determine appropriate zone.
  45  *      Returns FORMERR if there is not exactly one question.
  46  *      Returns REFUSED if we do not serve the listed zone.
  47  *      Pass the message to the zone module for processing
  48  *      and returns the return status.
  49  *
  50  * Requires
  51  *\li   client to be valid.
  52  */
  53
  54 #endif /* NAMED_NOTIFY_H */
  55