SIMS 4.0 Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
Sun Internet Mail Server™ 4.0 Reference Manual A Sun Microsystems, Inc. Business 901 San Antonio Road Palo Alto, CA 94303 USA 650 960-1300 fax 650 969-9131 Part No.: 805-7677-10 Revision A, July 1999 Copyright 1999 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California 94303 U.S.A. All rights reserved. Copyright 1992-1996 Regents of the University of Michigan. All Rights Reserved. Redistribution and use in source and binary forms are permitted provided that this notice is preserved and that due credit is given to the University of Michigan at Ann Arbor. The name of the University may not be used to endorse or promote products derived from this software or documentation without specific prior written permission. This product or document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this product or document may be reproduced in any form by any means without prior written authorization of Sun and its licensors, if any. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Parts of the product may be derived from Berkeley BSD systems, licensed from the University of California. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Sun, Sun Microsystems, the Sun logo, Solaris, Sun Internet Mail Server, HotJava, Java, Sun Workstation, OpenWindows, SunExpress, SunDocs, Sun Webserver are trademarks, registered trademarks, or service marks of Sun Microsystems, Inc. in the United States and in other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the United States and in other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. The OPEN LOOK and Sun™ Graphical User Interface was developed by Sun Microsystems, Inc. for its users and licensees. Sun acknowledges the pioneering efforts of Xerox in researching and developing the concept of visual or graphical user interfaces for the computer industry. Sun holds a non-exclusive license from Xerox to the Xerox Graphical User Interface, which license also covers Sun’s licensees who implement OPEN LOOK GUIs and otherwise comply with Sun’s written license agreements. RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S. Government is subject to restrictions of FAR 52.227-14(g)(2)(6/87) and FAR 52.227-19(6/87), or DFAR 252.227-7015(b)(6/95) and DFAR 227.7202-3(a). THIS PUBLICATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON- INFRINGEMENT. Copyright 1999 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, Californie 94303 Etatis-Unis. Tous droits réservés. Copyright 1992-1996 Régents de l’Université de Michigan. Tous droits réservés. La redistribution et l’utilisation sous forme de code source et de code binaire sont autorisées à condition que cette notice soit conservée et qu’il soit fait mention de l’Université de Michigan à Ann Arbor. Le nom de l’Université ne pourra être utilisé pour endosser ou promouvoir des produits derivés de ce logiciel ou de sa documentation sans autorisation écrite préalable. Ce produit ou document est protégé par un copyright et distribué avec des licences qui en restreignent l’utilisation, la copie et la décompilation. Aucune partie de ce produit ou de sa documentation associée ne peut être reproduite sous aucune forme, par quelque moyen que ce soit, sans l’autorisation préalable et écrite de Sun et de ses bailleurs de licence, s’il y en a. Le logiciel détenu par des tiers, et qui comprend la technologie relative aux polices de caractères, est protégé par un copyright et licencié par des fournisseurs de Sun. Des parties de ce produit pourront être dérivées des systèmes Berkeley BSD licenciés par l’Université de Californie. UNIX est une marque déposée aux Etats-Unis et dans d’autres pays et licenciée exclusivement par X/Open Company, Ltd. Sun, Sun Microsystems, le logo Sun, Solaris, Sun Internet Mail Server, HotJava, Java, Sun Workstation, OpenWindows, SunExpress, SunDocs, Sun Webserver sont des marques déposées, enregistrées, ou marques de service de Sun Microsystems, Inc. aux Etats-Unis et dans d’autres pays. Toutes les marques SPARC, utilisées sous licence, sont des marques déposées ou enregistrées de SPARC International, Inc. aux Etats-Unis et dans d’autres pays. Les produits portant les marques SPARC sont basés sur une architecture développée par Sun Microsystems, Inc. L’interface d’utilisation graphique OPEN LOOK et Sun™ a été développée par Sun Microsystems, Inc. pour ses utilisateurs et licenciés. Sun reconnaît les efforts de pionniers de Xerox pour la recherche et le développement du concept des interfaces d’utilisation visuelle ou graphique pour l’industrie de l’informatique. Sun détient une licence non exclusive de Xerox sur l’interface d’utilisation graphique Xerox, cette licence couvrant également les licenciés de Sun qui mettent en place l’interface d’utilisation graphique OPEN LOOK et qui en outre se conforment aux licences écrites de Sun. CETTE PUBLICATION EST FOURNIE "EN L’ETAT" ET AUCUNE GARANTIE, EXPRESSE OU IMPLICITE, N’EST ACCORDEE, Y COMPRIS DES GARANTIES CONCERNANT LA VALEUR MARCHANDE, L’APTITUDE DE LA PUBLICATION A REPONDRE A UNE UTILISATION PARTICULIERE, OU LE FAIT QU’ELLE NE SOIT PAS CONTREFAISANTE DE PRODUIT DE TIERS. CE DENI DE GARANTIE NE S’APPLIQUERAIT PAS, DANS LA MESURE OU IL SERAIT TENU JURIDIQUEMENT NUL ET NON AVENU. Please Recycle Contents Preface xxi 1. Commands Reference 25 SIMS Administration Commands 26 SIMS Monitoring 30 Message Access and Store 31 imaccessd 31 imbackup 31 imcheck 31 imdeluser 32 imexpire 32 imexportmbox 33 imimportmbox 33 iminitquota 34 impurge 34 imquotacheck 34 imrestore 35 imsasm 35 imsinit 35 Contents iii mkbackupdir 36 Sun Directory Services 38 dsserv 38 dsserv.conf 38 dsserv.acl.conf 39 dsserv.at.conf 39 dsserv.oc.conf 39 dsserv.replog 39 dsservcmd 40 dsprepush 40 dspushd 40 imldifsync 41 ldapadd 41 ldapdelete 42 ldapmodify 42 ldapsearch 42 ldbmcat 42 ldif 42 ldif2ldbm 43 Internet Message Transfer Agent 43 imta cache 45 imta chbuild 46 imta clbuild 47 imta cnbuild 47 imta counters -clear 49 imta counters -create 49 imta counters -show 49 iv Sun Internet Mail Server 4.0 Reference Manual • July 1999 imta counters -today 49 imta crdb 50 imta dirsync 50 imta find 50 imta process 51 imta program 51 imta purge 52 imta qm: Queue Management 52 imta queue 53 imta renamedb 53 imta restart 54 imta return 54 imta run 54 imta start 55 imta stop 55 imta submit 55 imta test -mapping 56 imta test -match 56 imta test -rewrite 57 imta view 58 imta version 58 Installation 58 setup-tty 59 uninstall 62 Contents v 2. IMTA Configuration 65 The IMTA Configuration Files 66 imta.cnf File 68 Structure of the imta.cnf File 68 Comments in the File 69 Including Other Files 69 Domain Rewriting Rules 70 Rewriting Rules Structure 70 Rewriting Rules Operation 71 Extracting the First Host or Domain Specification 72 Scanning the Rewrite Rules 74 Rewrite rule templates 75 Finishing the Rewriting Process 76 Rewrite Rule Failure 77 Syntax checks after rewriting 77 Template Substitutions 77 Customer-Supplied Routine Substitutions, $[...] 79 Source Channel-Specific Rewrite Rules ($M, $N) 80 Destination Channel-Specific Rewrite Rules ($C, $Q)80 Direction- and Location-Specific Rewrites ($B, $E, $F, $R)81 Host Location-Specific Rewrites ($A, $P, $S, $X)81 Single Field Substitutions ($&, $!, $*, $#)83 Handling Domain Literals 83 General Database Substitutions ($(...))84 Applying Specified Mapping (${...})85 vi Sun Internet Mail Server 4.0 Reference Manual • July 1999 Special Patterns and Tags 85 Controlling Error Messages Associated with Rewriting ($?)87 Rewrite Rule Control Sequences 88 Handling Large Numbers of Rewrite Rules 89 Testing Domain Rewriting Rules 90 Simple Configuration File 91 Channel Definitions 92 Channel Configuration Keywords 93 Address Interpretation (bangoverpercent, nobangoverpercent) 100 Routing Information in Addresses (exproute, noexproute, improute, noimproute) 100 Address Rewriting Upon Message Dequeue (connectalias, connectcanonical) 101 Channel Directionality (master, slave, bidirectional) 102 Channel Service Periodicity (immediate, immnonurgent, immnormal, immurgent, periodic, period) 102 Message Size Affecting Priority (urgentblocklimit, normalblocklimit, nonurgentblocklimit) 103 Channel Connection Information Caching (cacheeverything, cachesuccesses, cachefailures, nocache) 103 Priority of Messages Handled by Periodic Jobs (minperiodicnonurgent, minperiodicnormal, minperiodicurgent, maxperiodicnonurgent, maxperiodicnormal, maxperiodicurgent) 104 Number of Addresses or Message Files to Handle per Service Job or File (addrsperjob, filesperjob, maxjobs) 105 Multiple Addresses (multiple, addrsperfile, single, single_sys) 106 Expansion of Multiple Addresses (expandlimit) 107 Multiple Subdirectories (subdirs) 107 Service Job Queue (queue) 108 Contents vii Deferred Delivery Dates (deferred, nodeferred) 108 Undeliverable Message Notification Times (notices) 108 Returned Messages (sendpost, nosendpost, copysendpost, errsendpost) 109 Warning Messages (warnpost, nowarnpost, copywarnpost, errwarnpost) 110 Postmaster Returned Message Content (postheadonly, postheadbody) 111 Including Altered Addresses in Notification Messages (includefinal,