/usr/share/doc/libopendmarc-dev/docs/opendmarc_policy_query_dmarc.html is in libopendmarc-dev 1.2.0+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 | <html>
<head><title>opendmarc_policy_query_dmarc()</title></head>
<body>
<!--
$Id: opendmarc_policy_query_dmarc.html,v 1.5 2010/07/24 04:52:15 cm-msk Exp $
-->
<h1>opendmarc_policy_query_dmarc()</h1>
<p align="right"><a href="index.html">[back to index]</a></p>
<table border="0" cellspacing=4 cellpadding=4>
<!---------- Synopsis ----------->
<tr><th valign="top" align=left width=150>SYNOPSIS</th><td>
<pre>
#include <dmarc.h>
<a href="opendmarc_status_t.html"><tt>OPENDMARC_STATUS_T</tt></a> opendmarc_policy_query_dmarc(
<a href="dmarc_policy_t.html"><tt>DMARC_POLICY_T</tt></a> *pctx,
u_char *domain
);
</pre>
Cause the DMARC record to be looked up using DNS.
</td></tr>
<!----------- Description ---------->
<tr><th valign="top" align=left>DESCRIPTION</th><td>
<table border="1" cellspacing=1 cellpadding=4>
<tr align="left" valign=top>
<th width="80">Called When</th>
<td><tt>opendmarc_policy_query_dmarc()</tt>
may be called either before you have stored the From: domain, or in place of storing that domain.
</tr>
</table>
<!----------- Arguments ---------->
<tr><th valign="top" align=left>ARGUMENTS</th><td>
<table border="1" cellspacing=0>
<tr bgcolor="#dddddd"><th>Argument</th><th>Description</th></tr>
<tr valign="top"><td>pctx</td>
<td>The address of a structure of type <a href="dmarc_policy_t.html">
<tt>DMARC_POLICY_T</tt></a> as returned from <a href="opendmarc_policy_connect_init.html">opendmarc_policy_connect_init()</a>.
</td></tr>
<tr valign="top"><td>domain</td>
<td>A string containing the domain to look up. If not NULL, should be the domain from the From: header. If NULL, you must already
have stored the From: domain using <a href="opendmarc_policy_store_from_domain.html">opendmarc_policy_store_from_domain()</a>.
</td></tr>
</table>
</td></tr>
<!----------- Return Values ---------->
<tr>
<th valign="top" align=left>RETURN VALUES</th>
<td>
<ul>
<li><tt>DMARC_PARSE_OKAY</tt> -- Success.
<li><tt>DMARC_PARSE_ERROR_NULL_CTX</tt> -- If you passed in a <tt>pctx</tt> value that was NULL.
<li><tt>DMARC_PARSE_ERROR_EMPTY</tt> -- if domain was NULL and there was no From: domain.
<li><tt>DMARC_PARSE_ERROR_NO_DOMAIN</tt> -- if domain wasn't really a domain name.
<li><tt>DMARC_DNS_ERROR_NXDOMAIN</tt> -- No such domain found in DNS.
<li><tt>DMARC_DNS_ERROR_TMPERR</tt> -- DNS returned a temporary failure.
<li><tt>DMARC_DNS_ERROR_NO_RECORD</tt> -- The domain exists but no DMARC record was found, either at that domain or a found organizational domain.
</ul>
</td>
</tr>
<!----------- Notes ---------->
<tr>
<th valign="top" align=left>NOTES</th>
<td>
<ul>
<li>If the DMARC record is found it is parsed, so this function can also return the values of <a href="opendmarc_policy_parse_dmarc.html">opendmarc_policy_parse_dmarc()</a>.
<li>This function uses the standard resolver library. As of this release there are no hooks for an asynchronous resolver library.
</ul>
</td>
</tr>
</table>
<hr size="1">
<font size="-1">
Copyright (c) 2012, The Trusted Domain Project. All rights reserved.
<br>
By using this file, you agree to the terms and conditions set
forth in the license.
</font>
</body>
</html>
|