Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mail::dkim::dns(3) [mojave man page]

Mail::DKIM::DNS(3)					User Contributed Perl Documentation					Mail::DKIM::DNS(3)

NAME

       Mail::DKIM::DNS - performs DNS queries for Mail::DKIM

DESCRIPTION

       This is the module that performs DNS queries for Mail::DKIM.

CONFIGURATION

       This module has a couple configuration settings that the caller may want to use to customize the behavior of this module.

   $Mail::DKIM::DNS::TIMEOUT
       This global variable specifies the maximum amount of time (in seconds) to wait for a single DNS query to complete. The default is 10.

   Mail::DKIM::DNS::resolver()
       Use this global subroutine to get or replace the instance of Net::DNS::Resolver that Mail::DKIM uses. If set to undef (the default), then a
       brand new default instance of Net::DNS::Resolver will be created the first time a DNS query is needed.

       You will call this subroutine if you want to specify non-default options to Net::DNS::Resolver, such as different timeouts, or to enable
       use of a persistent socket. For example:

	 # first, construct a custom DNS resolver
	 my $res = Net::DNS::Resolver->new(
			   udp_timeout => 3, tcp_timeout => 3, retry => 2,
			);
	 $res->udppacketsize(1240);
	 $res->persistent_udp(1);

	 # then, tell Mail::DKIM to use this resolver
	 Mail::DKIM::DNS::resolver($res);

   Mail::DKIM::DNS::enable_EDNS0()
       This is a convenience subroutine that will construct an appropriate DNS resolver that uses EDNS0 (Extension mechanisms for DNS) to support
       large DNS replies, and configure Mail::DKIM to use it. (As such, it should NOT be used in conjunction with the resolver() subroutine
       described above.)

	 Mail::DKIM::DNS::enable_EDNS0();

       Use of EDNS0 is recommended, since it reduces the need for falling back to TCP when dealing with large DNS packets. However, it is not
       enabled by default because some Internet firewalls which do deep inspection of packets are not able to process EDNS0-enabled packets. When
       there is a firewall on a path to a DNS resolver, the EDNS0 feature should be specifically tested before enabling.

AUTHOR

       Jason Long, <jlong@messiah.edu>

COPYRIGHT AND LICENSE

       Copyright (C) 2006-2007, 2012-2013 by Messiah College

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.18.2							    2013-02-07							Mail::DKIM::DNS(3)

Check Out this Related Man Page

Mail::DKIM(3)						User Contributed Perl Documentation					     Mail::DKIM(3)

NAME

       Mail::DKIM - Signs/verifies Internet mail with DKIM/DomainKey signatures

SYNOPSIS

	 # verify a message
	 use Mail::DKIM::Verifier;

	 # create a verifier object
	 my $dkim = Mail::DKIM::Verifier->new();

	 # read an email from stdin, pass it into the verifier
	 while (<STDIN>)
	 {
	     # remove local line terminators
	     chomp;
	     s/15$//;

	     # use SMTP line terminators
	     $dkim->PRINT("$_1512");
	 }
	 $dkim->CLOSE;

	 # what is the result of the verify?
	 my $result = $dkim->result;

DESCRIPTION

       This module implements the various components of the DKIM and DomainKeys message-signing and verifying standards for Internet mail.  It
       currently tries to implement these specifications:

       RFC4871, for DKIM
       RFC4870, for DomainKeys

       The module uses an object-oriented interface. You use one of two different classes, depending on whether you are signing or verifying a
       message. To sign, use the Mail::DKIM::Signer class. To verify, use the Mail::DKIM::Verifier class. Simple, eh?

SEE ALSO

       Mail::DKIM::Signer, Mail::DKIM::Verifier

       http://dkimproxy.sourceforge.net/

KNOWN BUGS

       Problems passing `make test' seem to usually point at a faulty DNS configuration on your machine, or something weird about your OpenSSL
       libraries.

       The "author signing policy" component is still under construction. The author signing policy is supposed to identify the practice of the
       message author, so you could for example reject a message from an author who claims they always sign their messages. See
       Mail::DKIM::Policy.

AUTHOR

       Jason Long, <jlong@messiah.edu>

COPYRIGHT AND LICENSE

       Copyright (C) 2006-2007, 2009 by Messiah College

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.12.1							    2010-01-23							     Mail::DKIM(3)
Man Page