| SYNOPSIS |
#include <dmarc.h>
u_char ** opendmarc_policy_fetch_rua(
DMARC_POLICY_T *pctx,
u_char *list_buf, size_t size_of_buf, int constant
);
Query the library to find the list of rua= values from the DMARC record.
|
|---|
| DESCRIPTION |
| Called When |
opendmarc_policy_fetch_rua()
is called after the DMARC record has been fetched and parsed.
|
|
|---|
| ARGUMENTS |
| Argument | Description |
|---|
| pctx |
The address of a structure of type
DMARC_POLICY_T as returned from opendmarc_policy_connect_init().
|
| list_buf |
If not NULL, the address of a buffer to receive a comma delimited list as a single string.
|
| size_of_buf |
If list_buf was not NULL, the the length of that buffer in bytes.
|
| constant |
This function returns an argv-style array of stings. Set this to 0 if you will free that array
when you are finished with it. Set this to 1 if you want to treat that array as const and have
the library magically free it for you.
|
|
|---|
| RETURN VALUES |
- != NULL -- On success.
- NULL -- The pctp pointer was NULL.
- NULL -- If the DMARC record contained no rua=
|
| NOTES |
- If you set constant to 1, you must not free the array returned. To do so will have unpredictable results.
- Call this function only after a DMARC record was fetched and parsed with
opendmarc_policy_query_dmarc()
or supplied to the library with
opendmarc_policy_store_dmarc().
- Note that each returned record is looked up using DNS to find if it is accepting reports for the from_domain. If not, it is eliminated from the returned list.
|