diff options
author | Laurent Bercot <ska-skaware@skarnet.org> | 2021-01-14 23:24:53 +0000 |
---|---|---|
committer | Laurent Bercot <ska-skaware@skarnet.org> | 2021-01-14 23:24:53 +0000 |
commit | f3d8514681a6a9a0664d3ad0b6b72eb87346f92f (patch) | |
tree | aa4c9c1110ab1e39b320f8e11e67196b70529f00 /doc | |
parent | 033e162e95fb13196b3df93b708c535a3977e201 (diff) | |
download | s6-dns-f3d8514681a6a9a0664d3ad0b6b72eb87346f92f.tar.xz |
Prepare for 2.3.5.0, s6dns_message_get_domain_nodecode() now public
Diffstat (limited to 'doc')
-rw-r--r-- | doc/index.html | 4 | ||||
-rw-r--r-- | doc/libs6dns/s6dns-message.html | 19 | ||||
-rw-r--r-- | doc/upgrade.html | 10 |
3 files changed, 28 insertions, 5 deletions
diff --git a/doc/index.html b/doc/index.html index 7af0349..f7b0ed7 100644 --- a/doc/index.html +++ b/doc/index.html @@ -46,7 +46,7 @@ point in the future. <li> A POSIX-compliant system with a standard C development environment </li> <li> GNU make, version 3.81 or later </li> <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> version -2.10.0.0 or later. It's a build-time requirement. It's also a run-time +2.10.0.1 or later. It's a build-time requirement. It's also a run-time requirement if you link against the shared version of the skalibs library. </li> </ul> @@ -60,7 +60,7 @@ requirement if you link against the shared version of the skalibs library. </li> <h3> Download </h3> <ul> - <li> The current released version of s6-dns is <a href="s6-dns-2.3.4.0.tar.gz">2.3.4.0</a>. </li> + <li> The current released version of s6-dns is <a href="s6-dns-2.3.5.0.tar.gz">2.3.5.0</a>. </li> <li> Alternatively, you can checkout a copy of the <a href="//git.skarnet.org/cgi-bin/cgit.cgi/s6-dns/">s6-dns git repository</a>: diff --git a/doc/libs6dns/s6dns-message.html b/doc/libs6dns/s6dns-message.html index 315b375..14c5527 100644 --- a/doc/libs6dns/s6dns-message.html +++ b/doc/libs6dns/s6dns-message.html @@ -134,9 +134,14 @@ the series of character-strings. </p> <p> -<code> unsigned int s6dns_message_get_domain (s6dns_domain_t *d, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br /> -Reads a domain and stores it, in string form, into *<em>d</em>. -Returns 1 on success and 0 on failure, and sets errno: +<code> size_t s6dns_message_get_domain_nodecode (char *out, size_t outmax, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br /> +Reads a domain and stores it, in packet form, into *<em>out</em>, which is a character +array that must have been preallocated by the user; <em>outmax</em> is the maximum +number of characters that can be stored in <em>out</em>. As a special +case, <em>out</em> can be NULL, in which case nothing will be written, but +the domain will still be parsed and <em>pos</em> will still be updated. +The function returns the number of characters written to <em>out</em> +(or that would have been). If 0, it denotes a failure, and errno is set: </p> <ul> @@ -145,9 +150,17 @@ Returns 1 on success and 0 on failure, and sets errno: misused. </li> <li> EPROTONOSUPPORT: the domain encoding uses an extension that the function does not recognize. </li> + <li> ENAMETOOLONG: the domain cannot be stored in <em>outmax</em> characters. </li> </ul> <p> +<code> unsigned int s6dns_message_get_domain (s6dns_domain_t *d, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br /> +Reads a domain and stores it, in string form, into *<em>d</em>. +Returns 1 on success and 0 on failure, and sets errno just like the +function above. +</p> + +<p> <code> int s6dns_message_get_hinfo (s6dns_message_rr_hinfo_t *p, char const *packet, unsigned int packetlen, unsigned int *pos) </code> <br /> Reads a HINFO RR and stores it into *<em>p</em>. Returns 1 on success or 0 on failure. diff --git a/doc/upgrade.html b/doc/upgrade.html index 5b7b9bb..496066e 100644 --- a/doc/upgrade.html +++ b/doc/upgrade.html @@ -18,6 +18,16 @@ <h1> What has changed in s6-dns </h1> +<h2> in 2.3.5.0 </h2> + +<ul> + <li> <a href="//skarnet.org/software/skalibs/">skalibs</a> +dependency bumped to 2.10.0.1. </li> + <li> The <tt>s6dns_message_get_domain_internal()</tt> function +has been made public under the name +<a href="libs6dns/s6dns-message.html">s6dns_message_get_domain_nodecode()</a>. </li> +</ul> + <h2> in 2.3.4.0 </h2> <ul> |