Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Mail::DMARC::Report::UUser)Contributed Perl DocumenMail::DMARC::Report::URI(3)

NAME
       Mail::DMARC::Report::URI	- a DMARC report URI

VERSION
       version 1.20190308

SYNOPSIS
	 use Mail::DMARC::URI;
	 my $duri = Mail::DMARC::URI->new;
	 my $uri_ref = $duri->parse('mailto:rua@example.com,mailto:rua@external.otherdomain.com');
	 foreach my $u ( @$uri_ref ) {
	     my	$method	= $u->{uri};
	     my	$max	= $u->{max_bytes};
	     ... do some URI stuff ...
	 };

DESCRIPTION
       defines a generic syntax	for identifying	a resource.  The DMARC
       mechanism uses this as the format by which a Domain Owner specifies the
       destination for the two report types that are supported.

       The place such URIs are specified (see Section 6.2) allows a list of
       these to	be provided.  A	report is to be	sent to	each listed URI.  Mail
       Receivers MAY impose a limit on the number of URIs that receive
       reports,	but MUST support at least two.	The list of URIs is separated
       by commas (ASCII	0x2C).

       Each URI	can have associated with it a maximum report size that may be
       sent to it.  This is accomplished by appending an exclamation point
       (ASCII 0x21), followed by a maximum size	indication, before a
       separating comma	or terminating semi-colon.

       Thus, a DMARC URI is a URI within which any commas or exclamation
       points are percent-encoded per [URI], followed by an OPTIONAL
       exclamation point and a maximum size specification, and,	if there are
       additional reporting URIs in the	list, a	comma and the next URI.

       For example, the	URI "mailto:reports@example.com!50m" would request a
       report be sent via email	to "reports@example.com" so long as the	report
       payload does not	exceed 50 megabytes.

       A formal	definition is provided in Section 6.3.

ABNF
	 dmarc-uri = URI [ "!" 1*DIGIT [ "k" / "m" / "g" / "t" ] ]
		   ; "URI" is imported from [URI]; commas (ASCII 0x2c)
		   ; and exclamation points (ASCII 0x21) MUST be encoded

       URI is imported from RFC	3986: https://www.ietf.org/rfc/rfc3986.txt

       Only mailto, http, and https URIs are currently supported, examples:

	   https://www.ietf.org/rfc/rfc3986.txt
	   mailto:John.Doe@example.com

       With an optional	size limit (see	SIZE LIMIT).

SIZE LIMIT
       A size limitation in a dmarc-uri, if provided, is interpreted as	a
       count of	units followed by an OPTIONAL unit size	("k" for kilobytes,
       "m" for megabytes, "g" for gigabytes, "t" for terabytes).  Without a
       unit, the number	is presumed to be a basic byte count.  Note that the
       units are considered to be powers of two; a kilobyte is 2^10, a
       megabyte	is 2^20, etc.

AUTHORS
       o   Matt	Simerson <msimerson@cpan.org>

       o   Davide Migliavacca <shari@cpan.org>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2018 by Matt Simerson.

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.0			  2019-03-08	   Mail::DMARC::Report::URI(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | ABNF | SIZE LIMIT | AUTHORS | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Mail::DMARC::Report::URI&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help