* Update HACKING

[catta] / avahi-common / rr.h

diff --git a/avahi-common/rr.h b/avahi-common/rr.h
index 7a5c0e3fc3ac422320007ada16dc3784d0b2cf6c..f5349e9fefed567fb6084e8e6c158bd6bb103233 100644 (file)
--- a/avahi-common/rr.h
+++ b/avahi-common/rr.h
@@ -26,7 +26,11 @@
 
 #include <avahi-common/strlst.h>
 #include <avahi-common/address.h>
+#include <avahi-common/cdecl.h>
 
+/** \file rr.h Functions and definitions for manipulating DNS resource record (RR) data. */
+
+AVAHI_C_DECL_BEGIN
 
 /** DNS record types, see RFC 1035 */
 enum {
@@ -64,7 +68,7 @@ enum {
 typedef struct {
     guint ref;         /**< Reference counter */
     gchar *name;       /**< Record name */
-    guint16 class;     /**< Record class, one of the AVAHI_DNS_CLASS_xxx constants */
+    guint16 clazz;     /**< Record class, one of the AVAHI_DNS_CLASS_xxx constants */
     guint16 type;      /**< Record type, one of the AVAHI_DNS_TYPE_xxx constants */
 } AvahiKey;
 
@@ -78,13 +82,11 @@ typedef struct  {
     guint32 ttl;     /**< DNS TTL of this record */
 
     union {
-
         
         struct {
             gpointer data;
             guint16 size;
         } generic; /**< Generic record data for unknown types */
-
         
         struct {
             guint16 priority;
@@ -119,7 +121,7 @@ typedef struct  {
 } AvahiRecord;
 
 /** Create a new AvahiKey object. The reference counter will be set to 1. */
-AvahiKey *avahi_key_new(const gchar *name, guint16 class, guint16 type);
+AvahiKey *avahi_key_new(const gchar *name, guint16 clazz, guint16 type);
 
 /** Increase the reference counter of an AvahiKey object by one */
 AvahiKey *avahi_key_ref(AvahiKey *k);
@@ -150,7 +152,7 @@ guint avahi_key_hash(const AvahiKey *k);
 AvahiRecord *avahi_record_new(AvahiKey *k, guint32 ttl);
 
 /** Create a new record object. Record data should be filled in right after creation. The reference counter is set to 1. */
-AvahiRecord *avahi_record_new_full(const gchar *name, guint16 class, guint16 type, guint32 ttl);
+AvahiRecord *avahi_record_new_full(const gchar *name, guint16 clazz, guint16 type, guint32 ttl);
 
 /** Increase the reference counter of an AvahiRecord by one. */
 AvahiRecord *avahi_record_ref(AvahiRecord *r);
@@ -160,7 +162,7 @@ void avahi_record_unref(AvahiRecord *r);
 
 /** Return a textual representation of the specified DNS class. The
  * returned pointer points to a read only internal string. */
-const gchar *avahi_dns_class_to_string(guint16 class);
+const gchar *avahi_dns_class_to_string(guint16 clazz);
 
 /** Return a textual representation of the specified DNS class. The
  * returned pointer points to a read only internal string. */
@@ -196,4 +198,12 @@ gint avahi_record_lexicographical_compare(AvahiRecord *a, AvahiRecord *b);
 /** Return TRUE if the specified record is an mDNS goodbye record. i.e. TTL is zero. */
 gboolean avahi_record_is_goodbye(AvahiRecord *r);
 
+/** Check whether the specified key is valid */
+gboolean avahi_key_valid(AvahiKey *k);
+
+/** Check whether the specified record is valid */
+gboolean avahi_record_valid(AvahiRecord *r);
+
+AVAHI_C_DECL_END
+
 #endif