X-Git-Url: https://git.distorted.org.uk/~mdw/adns/blobdiff_plain/504877d15de6fffb18b6f0f286e6cda83fdd01b2..3121b6a6a09b9ce77a5a8d6bb66e7bff8ff2e8b9:/src/adns.h

diff --git a/src/adns.h b/src/adns.h
index 63a46e8..028d83c 100644
--- a/src/adns.h
+++ b/src/adns.h
@@ -66,6 +66,7 @@
 #include <netinet/in.h>
 #include <sys/time.h>
 #include <unistd.h>
+#include <net/if.h>
 
 #ifdef __cplusplus
 extern "C" { /* I really dislike this - iwj. */
@@ -682,21 +683,27 @@ void adns_finish(adns_state ads);
  * they will be cancelled.
  */
 
-#define ADNS_ADDR2TEXT_BUFLEN (INET6_ADDRSTRLEN +1/*%*/ +9/*uint32*/ +1/*nul*/)
+#define ADNS_ADDR2TEXT_BUFLEN					\
+  (INET6_ADDRSTRLEN + 1/*%*/					\
+  + ((IF_NAMESIZE-1) > 9 ? (IF_NAMESIZE-1) : 9/*uint32*/)	\
+  + 1/* nul; included in IF_NAMESIZE */)
 
-int adns_addr2text(adns_state ads /* may be 0!  used for debug log only */,
-		   const struct sockaddr *sa, socklen_t salen,
+int adns_text2addr(const char *addr, uint16_t port, struct sockaddr *sa,
+		   socklen_t *salen /* set if OK or ENOSPC; otherwise undef */);
+int adns_addr2text(const struct sockaddr *sa,
 		   char *addr_buffer, int *addr_buflen /* set iff ENOSPC */,
-		   int *port_r);
-int adns_text2addr(adns_state ads /* may be 0!  used for debug log only */,
-		   const char *addr, int port, struct sockaddr *sa,
-		   socklen_t *salen /* set if OK or ENOSPC */);
-  /* These DO NOT return an adns_status.  Instead, 0 on success,
-   * or an errno value on failure.  Error values are:
+		   int *port_r /* may be 0 */);
+  /* Error return values are:
    *   EAFNOSUPPORT addr2text only
-   *   EINVAL       addr has invalid syntax
+   *   EINVAL       text2addr only: addr has invalid syntax
    *   ENOSPC       only if *buflen < _BUFLEN or *salen < sizeof(adns_sockaddr)
-   *   ENXIO        addr specifies a scope name and if_nametoindex failed
+   * Extra errors are possible from text2addr if addr specifies a scope
+   * name suffix (ie, it has a "%") and the scope suffix is not numeric:
+   *   ENOSYS       address is not link local
+   *   ENXIO        if_nametoindex said it wasn't a valid name
+   *   EIO          if_nametoindex went crazy (adns prints a message to stderr)
+   * Extra errors are possible from text2addr and addr2text with scopes:
+   *   any other    if_nametoindex failed
    * port is always in host byte order and is simply copied to and
    * from the appropriate sockaddr field (byteswapped as necessary).
    */