Sun Internet Mail Server 3.5 Reference Manual
Total Page:16
File Type:pdf, Size:1020Kb
Sun™ Internet Mail Server™ 3.5 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-4379-10 Revision 10, September 1998 Copyright 1998 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 1998 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 xix 1. Overview 1 What Is Sun Internet Mail Server? 1 Key Features 2 Departmental Edition 3 Enterprise Edition 3 2. Commands Reference 5 How the Commands Are Organized 5 Using the Commands 6 Message Access and Store 6 imaccessd 6 imbackup 8 imcheck 10 imdeluser 14 imexpire 15 imexportmbox 17 imimportmbox 18 iminitquota 19 Contents iii impurge 21 imquotacheck 23 imrestore 24 imsasm 27 imsinit 28 mkbackupdir 29 Sun Directory Services 31 Specifying a Distinguished Name 32 Specifying an LDAP Filter 32 idxgen 32 imldifsync 33 ldapadd 59 ldapdelete 61 ldapmodify 62 ldapmodrdn 66 ldapsearch 68 ldbmcat 72 ldif 73 ldif2ldbm 74 slapd 76 slapdcmd 77 slapdrepl 78 slurpd 79 snmpslapd 81 Internet Message Transfer Agent 82 imta cache 83 imta chbuild 86 iv Sun Internet Mail Server 3.5 Reference Manual • September 1998 imta cnbuild 88 imta counters -clear 90 imta counters -create 90 imta counters -delete 91 imta counters -show 91 imta crdb 93 imta dirsync 95 imta dumpdb 97 imta process 98 imta program 99 imta purge 101 imta queue 102 imta renamedb 103 imta restart 104 imta return 105 imta run 106 imta start 107 imta stop 108 imta submit 108 imta test -rewrite 109 imta version 114 Security and Authentication 114 Configuring Secure Socket Layers 114 ▼ To Delete a Key Package 115 ▼ To Delete the Root CA Key Package 115 ▼ To Change a Key Pair or Distinguished Name for a Certificate 115 Installation 116 Contents v setup-tty 116 uninstall 120 Sun Messaging Connectivity Services 122 Starting the Sun Messaging Connectivity Services 122 Client Configuration Applications 125 cc:Mail Client Applications 125 Microsoft Mail Client Applications 126 PROFS Client Applications 128 3. IMTA Configuration 129 imta.cnf Configuration File 130 Structure of the imta.cnf File 130 Comments in the File 130 Including Other Files 131 Channels 131 Channel Queue Formats 132 Message Structure 133 Domain Rewriting Rules 134 Rewriting Rules Structure 134 Rewriting Rules Operation 135 Extracting the First Host/Domain Specification 136 Scanning the Rewrite Rules 138 Testing Domain Rewriting Rules 139 Simple Configuration File 140 Template Substitutions 141 Customer-Supplied Routine Substitutions, $[...] 142 Source Channel-Specific Rewrite Rules ($M, $N) 143 Destination Channel-Specific Rewrite Rules ($C, $Q) 144 vi Sun Internet Mail Server 3.5 Reference Manual • September 1998 Direction- and Location-Specific Rewrites ($B, $E, $F, $R) 145 Host Location-Specific Rewrites ($A, $P, $S, $X) 145 Single Field Substitutions ($&, $!, $*, $#) 146 Handling Domain Literals 147 General Database Substitutions ($(...)) 147 Apply Specified Mapping (${...}) 148 Controlling Error Messages Associated With Rewriting ($?) 148 Rewrite Rule Control Sequences 149 Channel Definitions 150 Channel Configuration Keywords 151 Address Interpretation (bangoverpercent, nobangoverpercent) 151 Routing Information in Addresses (exproute, noexproute, improute, noimproute) 152 Address Rewriting Upon Message Dequeue (connectalias, connectcanonical) 153 Channel Directionality (master, slave, bidirectional) 153 Channel Service Periodicity (immediate, immnonurgent, immnormal, immurgent, periodic, period) 153 Message Size Affecting Priority (urgentblocklimit, normalblocklimit, nonurgentblocklimit) 154 Channel Connection Information Caching (cacheeverything, cachesuccesses, cachefailures, nocache) 155 Number of Addresses or Message Files to Handle per Service Job or File (addrsperjob, filesperjob, maxjobs) 155 Multiple Addresses (multiple, addrsperfile, single, single_sys) 156 Expansion of Multiple Addresses (expandlimit) 157 Multiple Subdirectories (subdirs) 158 Service Job Queue (queue) 158 Deferred Delivery Dates (deferred, nodeferred) 158 Contents vii Undeliverable Message Notification Times (notices) 159 Returned Messages (sendpost, nosendpost, copysendpost, errsendpost) 160 Warning Messages