PMDF System Manager's Guide
PMDF-REF-6.0

Contents (Chapter 2)

• 2.1 Structure of the configuration file
  • 2.1.1 Blank lines in the configuration file
  • 2.1.2 Comments in the configuration file
  • 2.1.3 Continuation lines in the configuration file
  • 2.1.4 Including other files in the configuration file
• 2.2 Domain Rewriting Rules
  • 2.2.1 The purpose of domain rewriting rules
  • 2.2.2 Location and format of domain rewriting rules
  • 2.2.3 Application of domain rewriting rules to addresses
    • 2.2.3.1 Extraction of the first host/domain specification
    • 2.2.3.2 Scanning the rewrite rules
    • 2.2.3.3 Applying the rewrite rule template
    • 2.2.3.4 Finishing the rewriting process
    • 2.2.3.5 Rewrite rule failure
    • 2.2.3.6 Syntax checks after rewriting
    • 2.2.3.7 Handling of domain literals
  • 2.2.4 Patterns and tags
    • 2.2.4.1 A rule to match percent hacks
    • 2.2.4.2 A rule to match bang-style (UUCP) addresses
    • 2.2.4.3 A rule to match any address
    • 2.2.4.4 Tagged rewrite rule sets
  • 2.2.5 Templates
    • 2.2.5.1 Ordinary rewriting templates, A@B or A%B@C
    • 2.2.5.2 Repeated rewritings template, A%B
    • 2.2.5.3 Specified route rewriting templates, A@B@C or A@B@C@D
    • 2.2.5.4 Case sensitivity in rewrite rule templates
  • 2.2.6 Template substitutions and rewrite rule control sequences
    • 2.2.6.1 Username and subaddress substitution, $U, $0U, $1U
    • 2.2.6.2 Host/domain and IP literal substitutions, $D, $H, $nD, $nH, $L
    • 2.2.6.3 Literal character substitutions, $$, $%, $@
    • 2.2.6.4 LDAP query URL substitutions, $]...[
    • 2.2.6.5 General database substitutions, $(...)
    • 2.2.6.6 Apply specified mapping, ${...}
    • 2.2.6.7 Customer-supplied routine substitutions, $[...]
    • 2.2.6.8 Single field substitutions, $&, $!, $*, $#
    • 2.2.6.9 Unique string substitutions
    • 2.2.6.10 Source channel-specific rewrite rules, $M, $N
    • 2.2.6.11 Destination channel-specific rewrite rules, $C, $Q
    • 2.2.6.12 Direction and location-specific rewrites, $B, $E, $F, $R
    • 2.2.6.13 Host location-specific rewrites, $A, $P, $S, $X
    • 2.2.6.14 Changing the current tag value, $T
    • 2.2.6.15 Controlling error messages associated with rewriting, $?
  • 2.2.7 Rewrite rules example
  • 2.2.8 Testing domain rewriting rules
  • 2.2.9 Handling large numbers of rewrite rules
  • 2.2.10 Using rewrites to illegal addresses
  • 2.2.11 Other address manipulations
• 2.3 The Channel/host Table
  • 2.3.1 Overview
  • 2.3.2 Channel definitions: the channel/host table
    • 2.3.2.1 First line: Channel name and keywords
    • 2.3.2.2 Second line: System name and local host alias
    • 2.3.2.3 Additional lines: Systems reachable via the channel
  • 2.3.3 Envelope vs. header addresses: channel-level name translations
  • 2.3.4 Channel table keywords
    • 2.3.4.1 Address types and conventions (822, 733, uucp, header_822, header_733, header_uucp)
    • 2.3.4.2 Address interpretation (bangoverpercent, nobangoverpercent)
    • 2.3.4.3 Routing information in addresses (exproute, noexproute, improute, noimproute)
    • 2.3.4.4 Short circuiting rewriting of routing addresses (routelocal)
    • 2.3.4.5 Address rewriting upon message dequeue (connectalias, connectcanonical)
    • 2.3.4.6 Channel-specific rewrite rules (rules, norules)
    • 2.3.4.7 Channel directionality (master, slave, bidirectional)
    • 2.3.4.8 Channel operation type (submit)
    • 2.3.4.9 Channel service periodicity (immediate, immnonurgent, immnormal, immurgent, periodic, period)
    • 2.3.4.10 Message size affecting priority (urgentblocklimit, normalblocklimit, nonurgentblocklimit)
    • 2.3.4.11 Priority of messages to be handled by periodic jobs (minperiodicnonurgent, minperiodicnormal, minperiodicurgent, maxperiodicnonurgent, maxperiodicnormal, maxperiodicurgent)
    • 2.3.4.12 Immediate delivery job service actions (serviceall, noserviceall)
    • 2.3.4.13 Channel connection information caching (cacheeverything, cachesuccesses, cachefailures, nocache)
    • 2.3.4.14 Number of addresses or message files to handle per service job or file (addrsperjob, filesperjob, maxjobs)
    • 2.3.4.15 Multiple addresses (multiple, addrsperfile, single, single_sys)
    • 2.3.4.16 Expansion of multiple addresses (expandlimit, expandchannel, holdlimit)
    • 2.3.4.17 Multiple subdirectories (subdirs)
    • 2.3.4.18 Service job queue usage and job deferral (queue, nonurgentqueue, normalqueue, urgentqueue, after)
    • 2.3.4.19 Deferred delivery dates (deferred, nodeferred)
    • 2.3.4.20 Undeliverable message notification times (notices, nonurgentnotices, normalnotices, urgentnotices)
    • 2.3.4.21 Returned messages (sendpost, nosendpost, copysendpost, errsendpost)
    • 2.3.4.22 Warning messages (warnpost, nowarnpost, copywarnpost, errwarnpost)
    • 2.3.4.23 Postmaster returned message content (postheadonly, postheadbody)
    • 2.3.4.24 Delivery receipt request style (reportboth, reportheader, reportnotary, reportsuppress)
    • 2.3.4.25 Passing read receipt requests to the VMS MAIL mailbox (OpenVMS) (readreceiptmail)
    • 2.3.4.26 Gold-Mail compatible read receipts (OpenVMS) (goldmail, nogoldmail)
    • 2.3.4.27 Including altered addresses in notification messages (includefinal, suppressfinal)
    • 2.3.4.28 Protocol streaming (streaming)
    • 2.3.4.29 Triggering new threads in multithreaded SMTP channel (threaddepth)
    • 2.3.4.30 Channel protocol selection (smtp, nosmtp)
    • 2.3.4.31 SMTP EHLO command (ehlo, checkehlo, noehlo)
    • 2.3.4.32 Sending an SMTP ETRN command (sendetrn, nosendetrn)
    • 2.3.4.33 Receiving an SMTP ETRN command (allowetrn, blocketrn, disableetrn, domainetrn, silentetrn)
    • 2.3.4.34 Sending an SMTP VRFY command (domainvrfy, localvrfy, novrfy)
    • 2.3.4.35 Responding to SMTP VRFY commands (vrfyallow, vrfydefault, vrfyhide)
    • 2.3.4.36 TCP/IP port number and interface address (interfaceaddress, port)
    • 2.3.4.37 TCP/IP nameserver and MX record support (mx, nomx, nodns, defaultmx, randommx, nonrandommx, nameservers, defaultnameservers)
    • 2.3.4.38 Specify a last resort host (lastresort)
    • 2.3.4.39 Reverse DNS and IDENT lookups on incoming SMTP connections (identtcp, identtcplimited, identtcpnumeric, identtcpsymbolic, identnone, identnonelimited, identnonenumeric, identnonesymbolic, forwardchecknone, forwardchecktag, forwardcheckdelete)
    • 2.3.4.40 Verify that the domain on the MAIL FROM: line is in the DNS (mailfromdnsverify, nomailfromdnsverify)
    • 2.3.4.41 Select an alternate channel for incoming mail (switchchannel, allowswitchchannel, noswitchchannel)
    • 2.3.4.42 SMTP authentication and SASL (maysaslserver, mustsaslserver, nosasl, nosaslserver, saslswitchchannel, nosaslswitchchannel)
    • 2.3.4.43 Use authenticated address from SMTP AUTH in header (authrewrite)
    • 2.3.4.44 Transport Layer Security (maytls, maytlsclient, maytlsserver, musttls, musttlsclient, musttlsserver, notls, notlsclient, notlsserver, tlsswitchchannel)
    • 2.3.4.45 MS Exchange gateway channels (msexchange, nomsexchange)
    • 2.3.4.46 Host name to use when correcting incomplete addresses (remotehost, noremotehost, defaulthost, nodefaulthost)
    • 2.3.4.47 Legalizing messages that lack any recipient headers (missingrecipientpolicy)
    • 2.3.4.48 Strip illegal blank recipient headers (dropblank)
    • 2.3.4.49 Eight bit capability (eightbit, eightnegotiate, eightstrict, sevenbit)
    • 2.3.4.50 Automatic character set labelling (charset7, charset8, charsetesc)
    • 2.3.4.51 Restrictions on message line lengths (linelength)
    • 2.3.4.52 Delivering foreign format messages to VMS MAIL (OpenVMS) (foreign, noforeign)
    • 2.3.4.53 Conversion of application/octet-stream material (convert_octet_stream, noconvert_octet_stream)
    • 2.3.4.54 Channel-specific use of the reverse database (reverse, noreverse)
    • 2.3.4.55 Inner header rewriting (noinner, inner)
    • 2.3.4.56 Restricted mailbox encoding (restricted, unrestricted)
    • 2.3.4.57 Additional message header lines in VMS MAIL (headerbottom, headerinc, headeromit)
    • 2.3.4.58 Trimming message header lines (headertrim, noheadertrim, headerread, noheaderread, innertrim, noinnertrim)
    • 2.3.4.59 Encoding header (ignorencoding, interpretencoding)
    • 2.3.4.60 Generation of X-Envelope-to: header lines (x_env_to, nox_env_to)
    • 2.3.4.61 Envelope to address in Received: header (receivedfor, noreceivedfor, receivedfrom, noreceivedfrom)
    • 2.3.4.62 Postmaster address (aliaspostmaster, returnaddress, noreturnpersonal, returnpersonal, noreturnpersonal)
    • 2.3.4.63 Blank envelope return addresses (returnenvelope)
    • 2.3.4.64 Mapping Reply-to: header (usereplyto)
    • 2.3.4.65 Mapping Resent- headers when gatewaying to non RFC 822 environments (useresent)
    • 2.3.4.66 Comments in address message headers (commentinc, commentomit, commentstrip, commenttotal, sourcecommentinc, sourcecommentomit, sourcecommentstrip, sourcecommenttotal)
    • 2.3.4.67 Personal names in address message headers (personalinc, personalomit, personalstrip, sourcepersonalinc, sourcepersonalomit, sourcepersonalstrip)
    • 2.3.4.68 Alias file and alias database probes (aliaslocal)
    • 2.3.4.69 Validating local part of address (validatelocalnone, validatelocalsystem)
    • 2.3.4.70 Subaddresses (subaddressexact, subaddressrelaxed, subaddresswild)
    • 2.3.4.71 Two or four digit date conversion (datefour, datetwo)
    • 2.3.4.72 Day of week in date specifications (dayofweek, nodayofweek)
    • 2.3.4.73 Automatic splitting of long header lines (maxheaderaddrs, maxheaderchars)
    • 2.3.4.74 Header alignment and folding (headerlabelalign, headerlinelength)
    • 2.3.4.75 Automatic defragmentation of message/partial messages (defragment, nodefragment)
    • 2.3.4.76 Automatic fragmentation of large messages (maxblocks, maxlines)
    • 2.3.4.77 Absolute message size limits (blocklimit, noblocklimit, linelimit, nolinelimit, sourceblocklimit)
    • 2.3.4.78 Specify maximum length header that PMDF will rewrite (maxprocchars)
    • 2.3.4.79 Mail delivery to over quota users (exquota, noexquota, holdexquota)
    • 2.3.4.80 Gateway daemons (daemon)
    • 2.3.4.81 Processing account or Message Router mailbox (user)
    • 2.3.4.82 Multiple gateways on a single channel (multigate, nomultigate)
    • 2.3.4.83 Grey Book address formatting (grey, nogrey)
    • 2.3.4.84 Message logging (logging)
    • 2.3.4.85 Debugging channel master and slave programs (master_debug, nomaster_debug, slave_debug, noslave_debug)
    • 2.3.4.86 Filter file location (filter, nofilter, channelfilter, nochannelfilter, destinationfilter, nodestinationfilter, sourcefilter, nosourcefilter, fileinto, nofileinto)
    • 2.3.4.87 Channel description field (description)
    • 2.3.4.88 Sensitivity checking (sensitivitynormal, sensitivitypersonal, sensitivityprivate, sensitivitycompanyconfidential)
    • 2.3.4.89 Access rights and privileges (network)
  • 2.3.5 Using defaults and nodefaults channel blocks to simplify configurations
  • 2.3.6 Available channels
  • 2.3.7 Header option files
    • 2.3.7.1 Header option file location
    • 2.3.7.2 Header option file format
• 2.4 Some example configuration files
  • 2.4.1 A simple configuration file
  • 2.4.2 Routing non-local mail to a central mail hub
  • 2.4.3 Basic configuration for a system on the Internet
  • 2.4.4 Handling systems on a local DECnet (OpenVMS)