ares_dns.h 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123
  1. /* MIT License
  2. *
  3. * Copyright (c) Massachusetts Institute of Technology
  4. * Copyright (c) The c-ares project and its contributors
  5. *
  6. * Permission is hereby granted, free of charge, to any person obtaining a copy
  7. * of this software and associated documentation files (the "Software"), to deal
  8. * in the Software without restriction, including without limitation the rights
  9. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. * copies of the Software, and to permit persons to whom the Software is
  11. * furnished to do so, subject to the following conditions:
  12. *
  13. * The above copyright notice and this permission notice (including the next
  14. * paragraph) shall be included in all copies or substantial portions of the
  15. * Software.
  16. *
  17. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  20. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  21. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  22. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  23. * SOFTWARE.
  24. *
  25. * SPDX-License-Identifier: MIT
  26. */
  27. #ifndef HEADER_CARES_DNS_H
  28. #define HEADER_CARES_DNS_H
  29. /*
  30. * NOTE TO INTEGRATORS:
  31. *
  32. * This header is made public due to legacy projects relying on it.
  33. * Please do not use the macros within this header, or include this
  34. * header in your project as it may be removed in the future.
  35. */
  36. /*
  37. * Macro DNS__16BIT reads a network short (16 bit) given in network
  38. * byte order, and returns its value as an unsigned short.
  39. */
  40. #define DNS__16BIT(p) ((unsigned short)((unsigned int) 0xffff & \
  41. (((unsigned int)((unsigned char)(p)[0]) << 8U) | \
  42. ((unsigned int)((unsigned char)(p)[1])))))
  43. /*
  44. * Macro DNS__32BIT reads a network long (32 bit) given in network
  45. * byte order, and returns its value as an unsigned int.
  46. */
  47. #define DNS__32BIT(p) ((unsigned int) \
  48. (((unsigned int)((unsigned char)(p)[0]) << 24U) | \
  49. ((unsigned int)((unsigned char)(p)[1]) << 16U) | \
  50. ((unsigned int)((unsigned char)(p)[2]) << 8U) | \
  51. ((unsigned int)((unsigned char)(p)[3]))))
  52. #define DNS__SET16BIT(p, v) (((p)[0] = (unsigned char)(((v) >> 8) & 0xff)), \
  53. ((p)[1] = (unsigned char)((v) & 0xff)))
  54. #define DNS__SET32BIT(p, v) (((p)[0] = (unsigned char)(((v) >> 24) & 0xff)), \
  55. ((p)[1] = (unsigned char)(((v) >> 16) & 0xff)), \
  56. ((p)[2] = (unsigned char)(((v) >> 8) & 0xff)), \
  57. ((p)[3] = (unsigned char)((v) & 0xff)))
  58. #if 0
  59. /* we cannot use this approach on systems where we can't access 16/32 bit
  60. data on un-aligned addresses */
  61. #define DNS__16BIT(p) ntohs(*(unsigned short*)(p))
  62. #define DNS__32BIT(p) ntohl(*(unsigned long*)(p))
  63. #define DNS__SET16BIT(p, v) *(unsigned short*)(p) = htons(v)
  64. #define DNS__SET32BIT(p, v) *(unsigned long*)(p) = htonl(v)
  65. #endif
  66. /* Macros for parsing a DNS header */
  67. #define DNS_HEADER_QID(h) DNS__16BIT(h)
  68. #define DNS_HEADER_QR(h) (((h)[2] >> 7) & 0x1)
  69. #define DNS_HEADER_OPCODE(h) (((h)[2] >> 3) & 0xf)
  70. #define DNS_HEADER_AA(h) (((h)[2] >> 2) & 0x1)
  71. #define DNS_HEADER_TC(h) (((h)[2] >> 1) & 0x1)
  72. #define DNS_HEADER_RD(h) ((h)[2] & 0x1)
  73. #define DNS_HEADER_RA(h) (((h)[3] >> 7) & 0x1)
  74. #define DNS_HEADER_Z(h) (((h)[3] >> 4) & 0x7)
  75. #define DNS_HEADER_RCODE(h) ((h)[3] & 0xf)
  76. #define DNS_HEADER_QDCOUNT(h) DNS__16BIT((h) + 4)
  77. #define DNS_HEADER_ANCOUNT(h) DNS__16BIT((h) + 6)
  78. #define DNS_HEADER_NSCOUNT(h) DNS__16BIT((h) + 8)
  79. #define DNS_HEADER_ARCOUNT(h) DNS__16BIT((h) + 10)
  80. /* Macros for constructing a DNS header */
  81. #define DNS_HEADER_SET_QID(h, v) DNS__SET16BIT(h, v)
  82. #define DNS_HEADER_SET_QR(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 7))
  83. #define DNS_HEADER_SET_OPCODE(h, v) ((h)[2] |= (unsigned char)(((v) & 0xf) << 3))
  84. #define DNS_HEADER_SET_AA(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 2))
  85. #define DNS_HEADER_SET_TC(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 1))
  86. #define DNS_HEADER_SET_RD(h, v) ((h)[2] |= (unsigned char)((v) & 0x1))
  87. #define DNS_HEADER_SET_RA(h, v) ((h)[3] |= (unsigned char)(((v) & 0x1) << 7))
  88. #define DNS_HEADER_SET_Z(h, v) ((h)[3] |= (unsigned char)(((v) & 0x7) << 4))
  89. #define DNS_HEADER_SET_RCODE(h, v) ((h)[3] |= (unsigned char)((v) & 0xf))
  90. #define DNS_HEADER_SET_QDCOUNT(h, v) DNS__SET16BIT((h) + 4, v)
  91. #define DNS_HEADER_SET_ANCOUNT(h, v) DNS__SET16BIT((h) + 6, v)
  92. #define DNS_HEADER_SET_NSCOUNT(h, v) DNS__SET16BIT((h) + 8, v)
  93. #define DNS_HEADER_SET_ARCOUNT(h, v) DNS__SET16BIT((h) + 10, v)
  94. /* Macros for parsing the fixed part of a DNS question */
  95. #define DNS_QUESTION_TYPE(q) DNS__16BIT(q)
  96. #define DNS_QUESTION_CLASS(q) DNS__16BIT((q) + 2)
  97. /* Macros for constructing the fixed part of a DNS question */
  98. #define DNS_QUESTION_SET_TYPE(q, v) DNS__SET16BIT(q, v)
  99. #define DNS_QUESTION_SET_CLASS(q, v) DNS__SET16BIT((q) + 2, v)
  100. /* Macros for parsing the fixed part of a DNS resource record */
  101. #define DNS_RR_TYPE(r) DNS__16BIT(r)
  102. #define DNS_RR_CLASS(r) DNS__16BIT((r) + 2)
  103. #define DNS_RR_TTL(r) DNS__32BIT((r) + 4)
  104. #define DNS_RR_LEN(r) DNS__16BIT((r) + 8)
  105. /* Macros for constructing the fixed part of a DNS resource record */
  106. #define DNS_RR_SET_TYPE(r, v) DNS__SET16BIT(r, v)
  107. #define DNS_RR_SET_CLASS(r, v) DNS__SET16BIT((r) + 2, v)
  108. #define DNS_RR_SET_TTL(r, v) DNS__SET32BIT((r) + 4, v)
  109. #define DNS_RR_SET_LEN(r, v) DNS__SET16BIT((r) + 8, v)
  110. #endif /* HEADER_CARES_DNS_H */