#-------------------------------------------------------------------------- # LDAP Schema for amavisd-new Jacques Supcik, PhD #----------------------------- IP-Plus Internet Services # Release 1.2.2 Swisscom Enterprise Solutions Ltd # 30 May 2004 3050 Bern - Switzerland #-------------------------------------------------------------------------- # Copyright (c) 2004 Jacques Supcik, Swisscom Enterprise Solutions Ltd. # Permission is granted to copy, distribute and/or modify this document # under the terms of the GNU Free Documentation License, Version 1.2 # or any later version published by the Free Software Foundation; # with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. # A copy of the license is included in the section entitled "GNU # Free Documentation License". #-------------------------------------------------------------------------- # Changes made to LDAP Schema to make it import and play nicely with # Novell NDS - Michael Tracey, SONOPRESS USA, LLC April 07 2005 # ( uncomment each dn:, changetype:, add:, add X-NDS-NAME attribute, replace # "attributetype" by "attributetypes:" and "objectclasse" by "objectclasses:" # (plural,colon), and unwrap each attributetypes: and objectclasses: ) #-------------------------------------------------------------------------- # 1.3.6.1.4.1.15312 Jozef Stefan Institute's OID # 1.3.6.1.4.1.15312.2 amavisd-new # 1.3.6.1.4.1.15312.2.2 amavisd-new LDAP Elements # 1.3.6.1.4.1.15312.2.2.1 AttributeTypes # 1.3.6.1.4.1.15312.2.2.2 ObjectClasses # 1.3.6.1.4.1.15312.2.2.3 Syntax Definitions #-------------------------------------------------------------------------- # Attribute Types #----------------- #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.1 NAME 'amavisVirusLover' DESC 'Virus Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.2 NAME 'amavisBannedFilesLover' DESC 'Banned Files Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.3 NAME 'amavisBypassVirusChecks' DESC 'Bypass Virus Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.4 NAME 'amavisBypassSpamChecks' DESC 'Bypass Spam Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.5 NAME 'amavisSpamTagLevel' DESC 'Spam Tag Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.6 NAME 'amavisSpamTag2Level' DESC 'Spam Tag2 Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.7 NAME 'amavisSpamKillLevel' DESC 'Spam Kill Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.8 NAME 'amavisSpamModifiesSubj' DESC 'Modifies Subject on spam - no longer in use since 2.7.0' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.9 NAME 'amavisWhitelistSender' DESC 'White List Sender' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.10 NAME 'amavisBlacklistSender' DESC 'Black List Sender' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.11 NAME 'amavisSpamQuarantineTo' DESC 'Spam Quarantine to' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.12 NAME 'amavisSpamLover' DESC 'Spam Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.13 NAME 'amavisBadHeaderLover' DESC 'Bad Header Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.14 NAME 'amavisBypassBannedChecks' DESC 'Bypass Banned Files Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.15 NAME 'amavisBypassHeaderChecks' DESC 'Bypass Header Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.16 NAME 'amavisVirusQuarantineTo' DESC 'Virus quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.17 NAME 'amavisBannedQuarantineTo' DESC 'Banned Files quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.18 NAME 'amavisBadHeaderQuarantineTo' DESC 'Bad Header quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.19 NAME 'amavisLocal' DESC 'Is user considered local' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.20 NAME 'amavisMessageSizeLimit' DESC 'Message size limit' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.21 NAME 'amavisWarnVirusRecip' DESC 'Notify virus recipients' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.22 NAME 'amavisWarnBannedRecip' DESC 'Notify banned file recipients' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.23 NAME 'amavisWarnBadHeaderRecip' DESC 'Notify bad header recipients' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.24 NAME 'amavisVirusAdmin' DESC 'Virus admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.25 NAME 'amavisNewVirusAdmin' DESC 'New virus admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.26 NAME 'amavisSpamAdmin' DESC 'Spam admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.27 NAME 'amavisBannedAdmin' DESC 'Banned file admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.28 NAME 'amavisBadHeaderAdmin' DESC 'Bad header admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.29 NAME 'amavisBannedRuleNames' DESC 'Banned rule names' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.30 NAME 'amavisSpamDsnCutoffLevel' DESC 'Spam DSN Cutoff Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.31 NAME 'amavisSpamQuarantineCutoffLevel' DESC 'Spam Quarantine Cutoff Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.32 NAME 'amavisSpamSubjectTag' DESC 'Spam Subject Tag' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.33 NAME 'amavisSpamSubjectTag2' DESC 'Spam Subject Tag2' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.34 NAME 'amavisArchiveQuarantineTo' DESC 'Archive quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.35 NAME 'amavisAddrExtensionVirus' DESC 'Address Extension for Virus' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.36 NAME 'amavisAddrExtensionSpam' DESC 'Address Extension for Spam' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.37 NAME 'amavisAddrExtensionBanned' DESC 'Address Extension for Banned' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.38 NAME 'amavisAddrExtensionBadHeader' DESC 'Address Extension for Bad Header' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) # NEW since 2.7.0: #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.39 NAME 'amavisSpamTag3Level' DESC 'Spam Tag3 Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.40 NAME 'amavisSpamSubjectTag3' DESC 'Spam Subject Tag3' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.41 NAME 'amavisUncheckedQuarantineTo' DESC 'Virus quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.42 NAME 'amavisCleanQuarantineTo' DESC 'Clean quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.43 NAME 'amavisUncheckedLover' DESC 'Unchecked Files Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.44 NAME 'amavisForwardMethod' DESC 'Forward / next hop destination' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.45 NAME 'amavisSaUserConf' DESC 'SpamAssassin user preferences configuration filename' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) #dn: cn=schema #changetype: modify #add: attributetypes attributetype ( 1.3.6.1.4.1.15312.2.2.1.46 NAME 'amavisSaUserName' DESC 'SpamAssassin username (for Bayes and AWL lookups)' EQUALITY caseExactIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) # Classes #--------- # amavisAccount # This class is an auxiliary class, this mean that the class will be added # to a structural class. Usually, the structural class is the class that # represent the mail account itself (e.g. an inetOrgPerson) #dn: cn=schema #changetype: modify #add: objectclasses objectclass ( 1.3.6.1.4.1.15312.2.2.2.1 NAME 'amavisAccount' AUXILIARY DESC 'Amavisd Account' SUP top MAY ( amavisVirusLover $ amavisBypassVirusChecks $ amavisSpamLover $ amavisBypassSpamChecks $ amavisBannedFilesLover $ amavisBypassBannedChecks $ amavisBadHeaderLover $ amavisBypassHeaderChecks $ amavisSpamTagLevel $ amavisSpamTag2Level $ amavisSpamKillLevel $ amavisWhitelistSender $ amavisBlacklistSender $ amavisSpamQuarantineTo $ amavisVirusQuarantineTo $ amavisBannedQuarantineTo $ amavisBadHeaderQuarantineTo $ amavisArchiveQuarantineTo $ amavisSpamModifiesSubj $ amavisLocal $ amavisMessageSizeLimit $ amavisWarnVirusRecip $ amavisWarnBannedRecip $ amavisWarnBadHeaderRecip $ amavisVirusAdmin $ amavisNewVirusAdmin $ amavisSpamAdmin $ amavisBannedAdmin $ amavisBadHeaderAdmin $ amavisBannedRuleNames $ amavisSpamDsnCutoffLevel $ amavisSpamQuarantineCutoffLevel $ amavisSpamSubjectTag $ amavisSpamSubjectTag2 $ amavisAddrExtensionVirus $ amavisAddrExtensionSpam $ amavisAddrExtensionBanned $ amavisAddrExtensionBadHeader $ amavisSpamTag3Level $ amavisSpamSubjectTag3 $ amavisUncheckedQuarantineTo $ amavisCleanQuarantineTo $ amavisUncheckedLover $ amavisForwardMethod $ amavisSaUserConf $ amavisSaUserName $ cn $ description ) ) #-------------------------------------------------------------------------- # # GNU Free Documentation License # Version 1.2, November 2002 # # # Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. # 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # Everyone is permitted to copy and distribute verbatim copies # of this license document, but changing it is not allowed. # # # 0. PREAMBLE # # The purpose of this License is to make a manual, textbook, or other # functional and useful document "free" in the sense of freedom: to # assure everyone the effective freedom to copy and redistribute it, # with or without modifying it, either commercially or noncommercially. # Secondarily, this License preserves for the author and publisher a way # to get credit for their work, while not being considered responsible # for modifications made by others. # # This License is a kind of "copyleft", which means that derivative # works of the document must themselves be free in the same sense. It # complements the GNU General Public License, which is a copyleft # license designed for free software. # # We have designed this License in order to use it for manuals for free # software, because free software needs free documentation: a free # program should come with manuals providing the same freedoms that the # software does. But this License is not limited to software manuals; # it can be used for any textual work, regardless of subject matter or # whether it is published as a printed book. We recommend this License # principally for works whose purpose is instruction or reference. # # # 1. APPLICABILITY AND DEFINITIONS # # This License applies to any manual or other work, in any medium, that # contains a notice placed by the copyright holder saying it can be # distributed under the terms of this License. Such a notice grants a # world-wide, royalty-free license, unlimited in duration, to use that # work under the conditions stated herein. The "Document", below, # refers to any such manual or work. Any member of the public is a # licensee, and is addressed as "you". You accept the license if you # copy, modify or distribute the work in a way requiring permission # under copyright law. # # A "Modified Version" of the Document means any work containing the # Document or a portion of it, either copied verbatim, or with # modifications and/or translated into another language. # # A "Secondary Section" is a named appendix or a front-matter section of # the Document that deals exclusively with the relationship of the # publishers or authors of the Document to the Document's overall subject # (or to related matters) and contains nothing that could fall directly # within that overall subject. (Thus, if the Document is in part a # textbook of mathematics, a Secondary Section may not explain any # mathematics.) The relationship could be a matter of historical # connection with the subject or with related matters, or of legal, # commercial, philosophical, ethical or political position regarding # them. # # The "Invariant Sections" are certain Secondary Sections whose titles # are designated, as being those of Invariant Sections, in the notice # that says that the Document is released under this License. If a # section does not fit the above definition of Secondary then it is not # allowed to be designated as Invariant. The Document may contain zero # Invariant Sections. If the Document does not identify any Invariant # Sections then there are none. # # The "Cover Texts" are certain short passages of text that are listed, # as Front-Cover Texts or Back-Cover Texts, in the notice that says that # the Document is released under this License. A Front-Cover Text may # be at most 5 words, and a Back-Cover Text may be at most 25 words. # # A "Transparent" copy of the Document means a machine-readable copy, # represented in a format whose specification is available to the # general public, that is suitable for revising the document # straightforwardly with generic text editors or (for images composed of # pixels) generic paint programs or (for drawings) some widely available # drawing editor, and that is suitable for input to text formatters or # for automatic translation to a variety of formats suitable for input # to text formatters. A copy made in an otherwise Transparent file # format whose markup, or absence of markup, has been arranged to thwart # or discourage subsequent modification by readers is not Transparent. # An image format is not Transparent if used for any substantial amount # of text. A copy that is not "Transparent" is called "Opaque". # # Examples of suitable formats for Transparent copies include plain # ASCII without markup, Texinfo input format, LaTeX input format, SGML # or XML using a publicly available DTD, and standard-conforming simple # HTML, PostScript or PDF designed for human modification. Examples of # transparent image formats include PNG, XCF and JPG. Opaque formats # include proprietary formats that can be read and edited only by # proprietary word processors, SGML or XML for which the DTD and/or # processing tools are not generally available, and the # machine-generated HTML, PostScript or PDF produced by some word # processors for output purposes only. # # The "Title Page" means, for a printed book, the title page itself, # plus such following pages as are needed to hold, legibly, the material # this License requires to appear in the title page. For works in # formats which do not have any title page as such, "Title Page" means # the text near the most prominent appearance of the work's title, # preceding the beginning of the body of the text. # # A section "Entitled XYZ" means a named subunit of the Document whose # title either is precisely XYZ or contains XYZ in parentheses following # text that translates XYZ in another language. (Here XYZ stands for a # specific section name mentioned below, such as "Acknowledgements", # "Dedications", "Endorsements", or "History".) To "Preserve the Title" # of such a section when you modify the Document means that it remains a # section "Entitled XYZ" according to this definition. # # The Document may include Warranty Disclaimers next to the notice which # states that this License applies to the Document. These Warranty # Disclaimers are considered to be included by reference in this # License, but only as regards disclaiming warranties: any other # implication that these Warranty Disclaimers may have is void and has # no effect on the meaning of this License. # # # 2. VERBATIM COPYING # # You may copy and distribute the Document in any medium, either # commercially or noncommercially, provided that this License, the # copyright notices, and the license notice saying this License applies # to the Document are reproduced in all copies, and that you add no other # conditions whatsoever to those of this License. You may not use # technical measures to obstruct or control the reading or further # copying of the copies you make or distribute. However, you may accept # compensation in exchange for copies. If you distribute a large enough # number of copies you must also follow the conditions in section 3. # # You may also lend copies, under the same conditions stated above, and # you may publicly display copies. # # # 3. COPYING IN QUANTITY # # If you publish printed copies (or copies in media that commonly have # printed covers) of the Document, numbering more than 100, and the # Document's license notice requires Cover Texts, you must enclose the # copies in covers that carry, clearly and legibly, all these Cover # Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on # the back cover. Both covers must also clearly and legibly identify # you as the publisher of these copies. The front cover must present # the full title with all words of the title equally prominent and # visible. You may add other material on the covers in addition. # Copying with changes limited to the covers, as long as they preserve # the title of the Document and satisfy these conditions, can be treated # as verbatim copying in other respects. # # If the required texts for either cover are too voluminous to fit # legibly, you should put the first ones listed (as many as fit # reasonably) on the actual cover, and continue the rest onto adjacent # pages. # # If you publish or distribute Opaque copies of the Document numbering # more than 100, you must either include a machine-readable Transparent # copy along with each Opaque copy, or state in or with each Opaque copy # a computer-network location from which the general network-using # public has access to download using public-standard network protocols # a complete Transparent copy of the Document, free of added material. # If you use the latter option, you must take reasonably prudent steps, # when you begin distribution of Opaque copies in quantity, to ensure # that this Transparent copy will remain thus accessible at the stated # location until at least one year after the last time you distribute an # Opaque copy (directly or through your agents or retailers) of that # edition to the public. # # It is requested, but not required, that you contact the authors of the # Document well before redistributing any large number of copies, to give # them a chance to provide you with an updated version of the Document. # # # 4. MODIFICATIONS # # You may copy and distribute a Modified Version of the Document under # the conditions of sections 2 and 3 above, provided that you release # the Modified Version under precisely this License, with the Modified # Version filling the role of the Document, thus licensing distribution # and modification of the Modified Version to whoever possesses a copy # of it. In addition, you must do these things in the Modified Version: # # A. Use in the Title Page (and on the covers, if any) a title distinct # from that of the Document, and from those of previous versions # (which should, if there were any, be listed in the History section # of the Document). You may use the same title as a previous version # if the original publisher of that version gives permission. # B. List on the Title Page, as authors, one or more persons or entities # responsible for authorship of the modifications in the Modified # Version, together with at least five of the principal authors of the # Document (all of its principal authors, if it has fewer than five), # unless they release you from this requirement. # C. State on the Title page the name of the publisher of the # Modified Version, as the publisher. # D. Preserve all the copyright notices of the Document. # E. Add an appropriate copyright notice for your modifications # adjacent to the other copyright notices. # F. Include, immediately after the copyright notices, a license notice # giving the public permission to use the Modified Version under the # terms of this License, in the form shown in the Addendum below. # G. Preserve in that license notice the full lists of Invariant Sections # and required Cover Texts given in the Document's license notice. # H. Include an unaltered copy of this License. # I. Preserve the section Entitled "History", Preserve its Title, and add # to it an item stating at least the title, year, new authors, and # publisher of the Modified Version as given on the Title Page. If # there is no section Entitled "History" in the Document, create one # stating the title, year, authors, and publisher of the Document as # given on its Title Page, then add an item describing the Modified # Version as stated in the previous sentence. # J. Preserve the network location, if any, given in the Document for # public access to a Transparent copy of the Document, and likewise # the network locations given in the Document for previous versions # it was based on. These may be placed in the "History" section. # You may omit a network location for a work that was published at # least four years before the Document itself, or if the original # publisher of the version it refers to gives permission. # K. For any section Entitled "Acknowledgements" or "Dedications", # Preserve the Title of the section, and preserve in the section all # the substance and tone of each of the contributor acknowledgements # and/or dedications given therein. # L. Preserve all the Invariant Sections of the Document, # unaltered in their text and in their titles. Section numbers # or the equivalent are not considered part of the section titles. # M. Delete any section Entitled "Endorsements". Such a section # may not be included in the Modified Version. # N. Do not retitle any existing section to be Entitled "Endorsements" # or to conflict in title with any Invariant Section. # O. Preserve any Warranty Disclaimers. # # If the Modified Version includes new front-matter sections or # appendices that qualify as Secondary Sections and contain no material # copied from the Document, you may at your option designate some or all # of these sections as invariant. To do this, add their titles to the # list of Invariant Sections in the Modified Version's license notice. # These titles must be distinct from any other section titles. # # You may add a section Entitled "Endorsements", provided it contains # nothing but endorsements of your Modified Version by various # parties--for example, statements of peer review or that the text has # been approved by an organization as the authoritative definition of a # standard. # # You may add a passage of up to five words as a Front-Cover Text, and a # passage of up to 25 words as a Back-Cover Text, to the end of the list # of Cover Texts in the Modified Version. Only one passage of # Front-Cover Text and one of Back-Cover Text may be added by (or # through arrangements made by) any one entity. If the Document already # includes a cover text for the same cover, previously added by you or # by arrangement made by the same entity you are acting on behalf of, # you may not add another; but you may replace the old one, on explicit # permission from the previous publisher that added the old one. # # The author(s) and publisher(s) of the Document do not by this License # give permission to use their names for publicity for or to assert or # imply endorsement of any Modified Version. # # # 5. COMBINING DOCUMENTS # # You may combine the Document with other documents released under this # License, under the terms defined in section 4 above for modified # versions, provided that you include in the combination all of the # Invariant Sections of all of the original documents, unmodified, and # list them all as Invariant Sections of your combined work in its # license notice, and that you preserve all their Warranty Disclaimers. # # The combined work need only contain one copy of this License, and # multiple identical Invariant Sections may be replaced with a single # copy. If there are multiple Invariant Sections with the same name but # different contents, make the title of each such section unique by # adding at the end of it, in parentheses, the name of the original # author or publisher of that section if known, or else a unique number. # Make the same adjustment to the section titles in the list of # Invariant Sections in the license notice of the combined work. # # In the combination, you must combine any sections Entitled "History" # in the various original documents, forming one section Entitled # "History"; likewise combine any sections Entitled "Acknowledgements", # and any sections Entitled "Dedications". You must delete all sections # Entitled "Endorsements". # # # 6. COLLECTIONS OF DOCUMENTS # # You may make a collection consisting of the Document and other documents # released under this License, and replace the individual copies of this # License in the various documents with a single copy that is included in # the collection, provided that you follow the rules of this License for # verbatim copying of each of the documents in all other respects. # # You may extract a single document from such a collection, and distribute # it individually under this License, provided you insert a copy of this # License into the extracted document, and follow this License in all # other respects regarding verbatim copying of that document. # # # 7. AGGREGATION WITH INDEPENDENT WORKS # # A compilation of the Document or its derivatives with other separate # and independent documents or works, in or on a volume of a storage or # distribution medium, is called an "aggregate" if the copyright # resulting from the compilation is not used to limit the legal rights # of the compilation's users beyond what the individual works permit. # When the Document is included in an aggregate, this License does not # apply to the other works in the aggregate which are not themselves # derivative works of the Document. # # If the Cover Text requirement of section 3 is applicable to these # copies of the Document, then if the Document is less than one half of # the entire aggregate, the Document's Cover Texts may be placed on # covers that bracket the Document within the aggregate, or the # electronic equivalent of covers if the Document is in electronic form. # Otherwise they must appear on printed covers that bracket the whole # aggregate. # # # 8. TRANSLATION # # Translation is considered a kind of modification, so you may # distribute translations of the Document under the terms of section 4. # Replacing Invariant Sections with translations requires special # permission from their copyright holders, but you may include # translations of some or all Invariant Sections in addition to the # original versions of these Invariant Sections. You may include a # translation of this License, and all the license notices in the # Document, and any Warranty Disclaimers, provided that you also include # the original English version of this License and the original versions # of those notices and disclaimers. In case of a disagreement between # the translation and the original version of this License or a notice # or disclaimer, the original version will prevail. # # If a section in the Document is Entitled "Acknowledgements", # "Dedications", or "History", the requirement (section 4) to Preserve # its Title (section 1) will typically require changing the actual # title. # # # 9. TERMINATION # # You may not copy, modify, sublicense, or distribute the Document except # as expressly provided for under this License. Any other attempt to # copy, modify, sublicense or distribute the Document is void, and will # automatically terminate your rights under this License. However, # parties who have received copies, or rights, from you under this # License will not have their licenses terminated so long as such # parties remain in full compliance. # # # 10. FUTURE REVISIONS OF THIS LICENSE # # The Free Software Foundation may publish new, revised versions # of the GNU Free Documentation License from time to time. Such new # versions will be similar in spirit to the present version, but may # differ in detail to address new problems or concerns. See # http://www.gnu.org/copyleft/. # # Each version of the License is given a distinguishing version number. # If the Document specifies that a particular numbered version of this # License "or any later version" applies to it, you have the option of # following the terms and conditions either of that specified version or # of any later version that has been published (not as a draft) by the # Free Software Foundation. If the Document does not specify a version # number of this License, you may choose any version ever published (not # as a draft) by the Free Software Foundation.