# Mail services info for Elm ME+
#
# Format:
#
# @charset = <character-set>
#
# <name>    imap            <parameters>
# <name>    pop             <parameters>
# <name>    submission      <parameters>
# <name>    smtp            <parameters>
# <name>    *               <parameters>
# <name>    imaps	    <parameters>
# <name>    pops	    <parameters>
# <name>    smtps           <parameters>
# <name>    submissions     <parameters>
#
# <name> is canonical name for host.
# <parameters> are in general following forms:
#
#             <parameter>=<value>; <parameter>=<value>; ...
#             <paramater>; <parameter>; ...
#
#       Following <parameter> names are recognized
#
#                alias                           gives alias for host
#                                                (value can be quoted)
#                addr                            gives ip-address
#                                                (or hostname) for service
#                port                            gives port for service;
#						may be on decimal form
#						or named (usually 
#						from /etc/services) 
#		verify-tls-certificate		connection must use tls
#						(STARTTLS or similar) and 
#						and server certificate
#						must have valid
#		require-tls-peer-name		connection must use tls
#						(STARTTLS or similar) and
#						certificates's CN must
#						match
#		use-tls-checks			With value "no" disables global
#						verify-tls-certificate
#						and 'require-tls-peer-name given
#						on use-tls elmrc option
#               <tag>:<paramater>               Valid <tag> are these
#                                               which are given with
#                                                use-library -elmrc
#                                                option or
#                                                use-*-library -elmrc
#                                                options.
#
#         Following forms for specify of "addr" can be used:
#
#                addr=<hostname>
#                addr="<hostname>"
#                addr=ip:<A.B.C.D>
#                addr=ip:"<A.B.C.D>"		 
#                addr=ip:<A.B.C.D>/<port>
#                addr=ip:"<A.B.C.D>"/<port>
#
#	 If <name> is literal ip-address, then "addr" can not given.
#
#        <hostname> is name of that host which corresponding ip-address
#        (or addresses) should be used, <A.B.C.D> is literal ip-address,
#        <port> is port number in decimal.
#
#	 Literal ip-address <A.B.C.D> can be
#	 	 - IPv4 address like 216.58.209.132
#		 - IPv6 address like 2a00:1450:400f:804::2004
#		   or IPv6 address with scope like
#		       fe80:1450:400f:804::2004%3
#	 IPv6 address must be given inside of quotes.
#
#        Following forms for specify of "port" can be used:
#		
#                port=<service>
#		 port="<service>"
#		 port=<ddd>
#
#	<service> is name  of that host which corresponding port
#	should be used, <ddd> is port number in decimal.
#
#       ("smtps" requires explict port=<...> or addr=ip:<A.B.C.D>/<port> 
#        to be given. Originally port 465 was reserved for smtps, but 
#        this was revoked and that port is now reserved for 
#        "URL Rendesvous Directory for SSM" instead. TCP port 465
#        is later registered for "Message Submission over TLS protocol"
#        or submissions also. )
#
#	Parameter 'verify-tls-certificate' does not check certificate 
#	name. CN (common name) of certificate subject can be given with 
#       "require-tls-peer-name" parameter. 
#
#	If parameter "require-tls-peer-name" withot value is given,
#       that CN (common name) of certificate subject must match to
#       value given on {name} column.
#
#       Check for "require-tls-peer-name" is currently case sensitive.
#       This also do not check agaist wildcards (*) on certificate 
#       name -- * on certificate name is treated as regular character.
#
#	Parameter 'use-tls-checks=no' do not affact to 'verify-tls-certificate'
#	and 'require-tls-peer-name' parameters, but only disables flags with
#	same name given on use-tls elmrc option.
#
#  There is no advantage for using "imaps" over "imap" or "pops" over "pop"
#  or "submissions" over "submission". However with use-tls elmrc option value
#  'implicit-tls' services"imaps", "pops" or "submissions" is tried before
#  "imap", "pop" or  "submission" with same ip address.
#
#  Just use "verify-tls-certificate" if regular imap or pop -port is not blocked 
#  and mail server supports encryption (via imap's STARTTLS or pop's STLS).
