1#-------------------------------------------------------------------------- 2# LDAP Schema for amavisd-new Jacques Supcik, PhD 3#----------------------------- IP-Plus Internet Services 4# Release 1.2.2 Swisscom Enterprise Solutions Ltd 5# 30 May 2004 3050 Bern - Switzerland 6#-------------------------------------------------------------------------- 7# Copyright (c) 2004 Jacques Supcik, Swisscom Enterprise Solutions Ltd. 8# Permission is granted to copy, distribute and/or modify this document 9# under the terms of the GNU Free Documentation License, Version 1.2 10# or any later version published by the Free Software Foundation; 11# with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. 12# A copy of the license is included in the section entitled "GNU 13# Free Documentation License". 14#-------------------------------------------------------------------------- 15# Changes made to LDAP Schema to make it import and play nicely with 16# Novell NDS - Michael Tracey, SONOPRESS USA, LLC April 07 2005 17# ( uncomment each dn:, changetype:, add:, add X-NDS-NAME attribute, replace 18# "attributetype" by "attributetypes:" and "objectclasse" by "objectclasses:" 19# (plural,colon), and unwrap each attributetypes: and objectclasses: ) 20#-------------------------------------------------------------------------- 21# 1.3.6.1.4.1.15312 Jozef Stefan Institute's OID 22# 1.3.6.1.4.1.15312.2 amavisd-new 23# 1.3.6.1.4.1.15312.2.2 amavisd-new LDAP Elements 24# 1.3.6.1.4.1.15312.2.2.1 AttributeTypes 25# 1.3.6.1.4.1.15312.2.2.2 ObjectClasses 26# 1.3.6.1.4.1.15312.2.2.3 Syntax Definitions 27#-------------------------------------------------------------------------- 28# 29# Attribute Types 30#----------------- 31# 32# AUTO-GENERATED FILE - DO NOT EDIT!! Use ldapmodify. 33dn: cn=amavisd,cn=schema,cn=config 34objectClass: olcSchemaConfig 35cn: amavisd 36olcAttributeTypes: {0}( 1.3.6.1.4.1.15312.2.2.1.1 NAME 'amavisVirusLover' DE 37 SC 'Virus Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 38 SINGLE-VALUE ) 39olcAttributeTypes: {1}( 1.3.6.1.4.1.15312.2.2.1.2 NAME 'amavisBannedFilesLov 40 er' DESC 'Banned Files Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466 41 .115.121.1.7 SINGLE-VALUE ) 42olcAttributeTypes: {2}( 1.3.6.1.4.1.15312.2.2.1.3 NAME 'amavisBypassVirusChe 43 cks' DESC 'Bypass Virus Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.146 44 6.115.121.1.7 SINGLE-VALUE ) 45olcAttributeTypes: {3}( 1.3.6.1.4.1.15312.2.2.1.4 NAME 'amavisBypassSpamChec 46 ks' DESC 'Bypass Spam Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466. 47 115.121.1.7 SINGLE-VALUE ) 48olcAttributeTypes: {4}( 1.3.6.1.4.1.15312.2.2.1.5 NAME 'amavisSpamTagLevel' 49 DESC 'Spam Tag Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5Subst 50 ringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 51olcAttributeTypes: {5}( 1.3.6.1.4.1.15312.2.2.1.6 NAME 'amavisSpamTag2Level' 52 DESC 'Spam Tag2 Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5Sub 53 stringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 54olcAttributeTypes: {6}( 1.3.6.1.4.1.15312.2.2.1.7 NAME 'amavisSpamKillLevel' 55 DESC 'Spam Kill Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5Sub 56 stringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 57olcAttributeTypes: {7}( 1.3.6.1.4.1.15312.2.2.1.8 NAME 'amavisSpamModifiesSu 58 bj' DESC 'Modifies Subject on spam - no longer in use since 2.7.0' EQUALITY 59 booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) 60olcAttributeTypes: {8}( 1.3.6.1.4.1.15312.2.2.1.9 NAME 'amavisWhitelistSende 61 r' DESC 'White List Sender' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA 62 5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) 63olcAttributeTypes: {9}( 1.3.6.1.4.1.15312.2.2.1.10 NAME 'amavisBlacklistSend 64 er' DESC 'Black List Sender' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreI 65 A5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) 66olcAttributeTypes: {10}( 1.3.6.1.4.1.15312.2.2.1.11 NAME 'amavisSpamQuaranti 67 neTo' DESC 'Spam Quarantine to' EQUALITY caseIgnoreIA5Match SUBSTR caseIgno 68 reIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE 69 ) 70olcAttributeTypes: {11}( 1.3.6.1.4.1.15312.2.2.1.12 NAME 'amavisSpamLover' D 71 ESC 'Spam Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 72 SINGLE-VALUE ) 73olcAttributeTypes: {12}( 1.3.6.1.4.1.15312.2.2.1.13 NAME 'amavisBadHeaderLov 74 er' DESC 'Bad Header Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.1 75 15.121.1.7 SINGLE-VALUE ) 76olcAttributeTypes: {13}( 1.3.6.1.4.1.15312.2.2.1.14 NAME 'amavisBypassBanned 77 Checks' DESC 'Bypass Banned Files Check' EQUALITY booleanMatch SYNTAX 1.3.6 78 .1.4.1.1466.115.121.1.7 SINGLE-VALUE ) 79olcAttributeTypes: {14}( 1.3.6.1.4.1.15312.2.2.1.15 NAME 'amavisBypassHeader 80 Checks' DESC 'Bypass Header Check' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1 81 .1466.115.121.1.7 SINGLE-VALUE ) 82olcAttributeTypes: {15}( 1.3.6.1.4.1.15312.2.2.1.16 NAME 'amavisVirusQuarant 83 ineTo' DESC 'Virus quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR 84 caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SING 85 LE-VALUE ) 86olcAttributeTypes: {16}( 1.3.6.1.4.1.15312.2.2.1.17 NAME 'amavisBannedQuaran 87 tineTo' DESC 'Banned Files quarantine location' EQUALITY caseIgnoreIA5Match 88 SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{2 89 56} SINGLE-VALUE ) 90olcAttributeTypes: {17}( 1.3.6.1.4.1.15312.2.2.1.18 NAME 'amavisBadHeaderQua 91 rantineTo' DESC 'Bad Header quarantine location' EQUALITY caseIgnoreIA5Matc 92 h SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{ 93 256} SINGLE-VALUE ) 94olcAttributeTypes: {18}( 1.3.6.1.4.1.15312.2.2.1.19 NAME 'amavisLocal' DESC 95 'Is user considered local' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1466.11 96 5.121.1.7 SINGLE-VALUE ) 97olcAttributeTypes: {19}( 1.3.6.1.4.1.15312.2.2.1.20 NAME 'amavisMessageSizeL 98 imit' DESC 'Message size limit' EQUALITY caseIgnoreIA5Match SUBSTR caseIgno 99 reIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE 100 ) 101olcAttributeTypes: {20}( 1.3.6.1.4.1.15312.2.2.1.21 NAME 'amavisWarnVirusRec 102 ip' DESC 'Notify virus recipients' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1 103 .1466.115.121.1.7 SINGLE-VALUE ) 104olcAttributeTypes: {21}( 1.3.6.1.4.1.15312.2.2.1.22 NAME 'amavisWarnBannedRe 105 cip' DESC 'Notify banned file recipients' EQUALITY booleanMatch SYNTAX 1.3. 106 6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) 107olcAttributeTypes: {22}( 1.3.6.1.4.1.15312.2.2.1.23 NAME 'amavisWarnBadHeade 108 rRecip' DESC 'Notify bad header recipients' EQUALITY booleanMatch SYNTAX 1. 109 3.6.1.4.1.1466.115.121.1.7 SINGLE-VALUE ) 110olcAttributeTypes: {23}( 1.3.6.1.4.1.15312.2.2.1.24 NAME 'amavisVirusAdmin' 111 DESC 'Virus admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5Substrin 112 gsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 113olcAttributeTypes: {24}( 1.3.6.1.4.1.15312.2.2.1.25 NAME 'amavisNewVirusAdmi 114 n' DESC 'New virus admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5S 115 ubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 116olcAttributeTypes: {25}( 1.3.6.1.4.1.15312.2.2.1.26 NAME 'amavisSpamAdmin' D 117 ESC 'Spam admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5Substrings 118 Match SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 119olcAttributeTypes: {26}( 1.3.6.1.4.1.15312.2.2.1.27 NAME 'amavisBannedAdmin' 120 DESC 'Banned file admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5S 121 ubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 122olcAttributeTypes: {27}( 1.3.6.1.4.1.15312.2.2.1.28 NAME 'amavisBadHeaderAdm 123 in' DESC 'Bad header admin' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA 124 5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 125olcAttributeTypes: {28}( 1.3.6.1.4.1.15312.2.2.1.29 NAME 'amavisBannedRuleNa 126 mes' DESC 'Banned rule names' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnore 127 IA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 128olcAttributeTypes: {29}( 1.3.6.1.4.1.15312.2.2.1.30 NAME 'amavisSpamDsnCutof 129 fLevel' DESC 'Spam DSN Cutoff Level' EQUALITY caseIgnoreIA5Match SUBSTR cas 130 eIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE- 131 VALUE ) 132olcAttributeTypes: {30}( 1.3.6.1.4.1.15312.2.2.1.31 NAME 'amavisSpamQuaranti 133 neCutoffLevel' DESC 'Spam Quarantine Cutoff Level' EQUALITY caseIgnoreIA5Ma 134 tch SUBSTR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.2 135 6{256} SINGLE-VALUE ) 136olcAttributeTypes: {31}( 1.3.6.1.4.1.15312.2.2.1.32 NAME 'amavisSpamSubjectT 137 ag' DESC 'Spam Subject Tag' EQUALITY caseExactIA5Match SUBSTR caseExactSubs 138 tringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 139olcAttributeTypes: {32}( 1.3.6.1.4.1.15312.2.2.1.33 NAME 'amavisSpamSubjectT 140 ag2' DESC 'Spam Subject Tag2' EQUALITY caseExactIA5Match SUBSTR caseExactSu 141 bstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 142olcAttributeTypes: {33}( 1.3.6.1.4.1.15312.2.2.1.34 NAME 'amavisArchiveQuara 143 ntineTo' DESC 'Archive quarantine location' EQUALITY caseIgnoreIA5Match SUB 144 STR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} 145 SINGLE-VALUE ) 146olcAttributeTypes: {34}( 1.3.6.1.4.1.15312.2.2.1.35 NAME 'amavisAddrExtensio 147 nVirus' DESC 'Address Extension for Virus' EQUALITY caseExactIA5Match SUBST 148 R caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE 149 -VALUE ) 150olcAttributeTypes: {35}( 1.3.6.1.4.1.15312.2.2.1.36 NAME 'amavisAddrExtensio 151 nSpam' DESC 'Address Extension for Spam' EQUALITY caseExactIA5Match SUBSTR 152 caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-V 153 ALUE ) 154olcAttributeTypes: {36}( 1.3.6.1.4.1.15312.2.2.1.37 NAME 'amavisAddrExtensio 155 nBanned' DESC 'Address Extension for Banned' EQUALITY caseExactIA5Match SUB 156 STR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SING 157 LE-VALUE ) 158olcAttributeTypes: {37}( 1.3.6.1.4.1.15312.2.2.1.38 NAME 'amavisAddrExtensio 159 nBadHeader' DESC 'Address Extension for Bad Header' EQUALITY caseExactIA5Ma 160 tch SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{25 161 6} SINGLE-VALUE ) 162olcAttributeTypes: {38}( 1.3.6.1.4.1.15312.2.2.1.39 NAME 'amavisSpamTag3Leve 163 l' DESC 'Spam Tag3 Level' EQUALITY caseIgnoreIA5Match SUBSTR caseIgnoreIA5S 164 ubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 165olcAttributeTypes: {39}( 1.3.6.1.4.1.15312.2.2.1.40 NAME 'amavisSpamSubjectT 166 ag3' DESC 'Spam Subject Tag3' EQUALITY caseExactIA5Match SUBSTR caseExactSu 167 bstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SINGLE-VALUE ) 168olcAttributeTypes: {40}( 1.3.6.1.4.1.15312.2.2.1.41 NAME 'amavisUncheckedQua 169 rantineTo' DESC 'Virus quarantine location' EQUALITY caseIgnoreIA5Match SUB 170 STR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} 171 SINGLE-VALUE ) 172olcAttributeTypes: {41}( 1.3.6.1.4.1.15312.2.2.1.42 NAME 'amavisCleanQuarant 173 ineTo' DESC 'Clean quarantine location' EQUALITY caseIgnoreIA5Match SUBSTR 174 caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} SING 175 LE-VALUE ) 176olcAttributeTypes: {42}( 1.3.6.1.4.1.15312.2.2.1.43 NAME 'amavisUncheckedLov 177 er' DESC 'Unchecked Files Lover' EQUALITY booleanMatch SYNTAX 1.3.6.1.4.1.1 178 466.115.121.1.7 SINGLE-VALUE ) 179olcAttributeTypes: {43}( 1.3.6.1.4.1.15312.2.2.1.44 NAME 'amavisForwardMetho 180 d' DESC 'Forward / next hop destination' EQUALITY caseIgnoreIA5Match SUBSTR 181 caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} ) 182olcAttributeTypes: {44}( 1.3.6.1.4.1.15312.2.2.1.45 NAME 'amavisSaUserConf' 183 DESC 'SpamAssassin user preferences configuration filename' EQUALITY caseEx 184 actIA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121 185 .1.26{256} SINGLE-VALUE ) 186olcAttributeTypes: {45}( 1.3.6.1.4.1.15312.2.2.1.46 NAME 'amavisSaUserName' 187 DESC 'SpamAssassin username (for Bayes and AWL lookups)' EQUALITY caseExact 188 IA5Match SUBSTR caseExactSubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1. 189 26{256} SINGLE-VALUE ) 190olcAttributeTypes: {46}( 1.3.6.1.4.1.15312.2.2.1.47 NAME 'amavisDisclaimerOp 191 tions' DESC 'Altermime disclaimer map data' EQUALITY caseIgnoreIA5Match SUB 192 STR caseIgnoreIA5SubstringsMatch SYNTAX 1.3.6.1.4.1.1466.115.121.1.26{256} 193 SINGLE-VALUE ) 194olcObjectClasses: {0}( 1.3.6.1.4.1.15312.2.2.2.1 NAME 'amavisAccount' DESC ' 195 Amavisd Account' SUP top AUXILIARY MAY ( amavisVirusLover $ amavisBypassVir 196 usChecks $ amavisSpamLover $ amavisBypassSpamChecks $ amavisBannedFilesLove 197 r $ amavisBypassBannedChecks $ amavisBadHeaderLover $ amavisBypassHeaderChe 198 cks $ amavisSpamTagLevel $ amavisSpamTag2Level $ amavisSpamKillLevel $ amav 199 isWhitelistSender $ amavisBlacklistSender $ amavisSpamQuarantineTo $ amavis 200 VirusQuarantineTo $ amavisBannedQuarantineTo $ amavisBadHeaderQuarantineTo 201 $ amavisArchiveQuarantineTo $ amavisSpamModifiesSubj $ amavisLocal $ amavis 202 MessageSizeLimit $ amavisWarnVirusRecip $ amavisWarnBannedRecip $ amavisWar 203 nBadHeaderRecip $ amavisVirusAdmin $ amavisNewVirusAdmin $ amavisSpamAdmin 204 $ amavisBannedAdmin $ amavisBadHeaderAdmin $ amavisBannedRuleNames $ amavis 205 SpamDsnCutoffLevel $ amavisSpamQuarantineCutoffLevel $ amavisSpamSubjectTag 206 $ amavisSpamSubjectTag2 $ amavisAddrExtensionVirus $ amavisAddrExtensionSp 207 am $ amavisAddrExtensionBanned $ amavisAddrExtensionBadHeader $ amavisSpamT 208 ag3Level $ amavisSpamSubjectTag3 $ amavisUncheckedQuarantineTo $ amavisClea 209 nQuarantineTo $ amavisUncheckedLover $ amavisForwardMethod $ amavisSaUserCo 210 nf $ amavisSaUserName $ amavisDisclaimerOptions $ cn $ description ) ) 211#-------------------------------------------------------------------------- 212# 213# GNU Free Documentation License 214# Version 1.2, November 2002 215# 216# 217# Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. 218# 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 219# Everyone is permitted to copy and distribute verbatim copies 220# of this license document, but changing it is not allowed. 221# 222# 223# 0. PREAMBLE 224# 225# The purpose of this License is to make a manual, textbook, or other 226# functional and useful document "free" in the sense of freedom: to 227# assure everyone the effective freedom to copy and redistribute it, 228# with or without modifying it, either commercially or noncommercially. 229# Secondarily, this License preserves for the author and publisher a way 230# to get credit for their work, while not being considered responsible 231# for modifications made by others. 232# 233# This License is a kind of "copyleft", which means that derivative 234# works of the document must themselves be free in the same sense. It 235# complements the GNU General Public License, which is a copyleft 236# license designed for free software. 237# 238# We have designed this License in order to use it for manuals for free 239# software, because free software needs free documentation: a free 240# program should come with manuals providing the same freedoms that the 241# software does. But this License is not limited to software manuals; 242# it can be used for any textual work, regardless of subject matter or 243# whether it is published as a printed book. We recommend this License 244# principally for works whose purpose is instruction or reference. 245# 246# 247# 1. APPLICABILITY AND DEFINITIONS 248# 249# This License applies to any manual or other work, in any medium, that 250# contains a notice placed by the copyright holder saying it can be 251# distributed under the terms of this License. Such a notice grants a 252# world-wide, royalty-free license, unlimited in duration, to use that 253# work under the conditions stated herein. The "Document", below, 254# refers to any such manual or work. Any member of the public is a 255# licensee, and is addressed as "you". You accept the license if you 256# copy, modify or distribute the work in a way requiring permission 257# under copyright law. 258# 259# A "Modified Version" of the Document means any work containing the 260# Document or a portion of it, either copied verbatim, or with 261# modifications and/or translated into another language. 262# 263# A "Secondary Section" is a named appendix or a front-matter section of 264# the Document that deals exclusively with the relationship of the 265# publishers or authors of the Document to the Document's overall subject 266# (or to related matters) and contains nothing that could fall directly 267# within that overall subject. (Thus, if the Document is in part a 268# textbook of mathematics, a Secondary Section may not explain any 269# mathematics.) The relationship could be a matter of historical 270# connection with the subject or with related matters, or of legal, 271# commercial, philosophical, ethical or political position regarding 272# them. 273# 274# The "Invariant Sections" are certain Secondary Sections whose titles 275# are designated, as being those of Invariant Sections, in the notice 276# that says that the Document is released under this License. If a 277# section does not fit the above definition of Secondary then it is not 278# allowed to be designated as Invariant. The Document may contain zero 279# Invariant Sections. If the Document does not identify any Invariant 280# Sections then there are none. 281# 282# The "Cover Texts" are certain short passages of text that are listed, 283# as Front-Cover Texts or Back-Cover Texts, in the notice that says that 284# the Document is released under this License. A Front-Cover Text may 285# be at most 5 words, and a Back-Cover Text may be at most 25 words. 286# 287# A "Transparent" copy of the Document means a machine-readable copy, 288# represented in a format whose specification is available to the 289# general public, that is suitable for revising the document 290# straightforwardly with generic text editors or (for images composed of 291# pixels) generic paint programs or (for drawings) some widely available 292# drawing editor, and that is suitable for input to text formatters or 293# for automatic translation to a variety of formats suitable for input 294# to text formatters. A copy made in an otherwise Transparent file 295# format whose markup, or absence of markup, has been arranged to thwart 296# or discourage subsequent modification by readers is not Transparent. 297# An image format is not Transparent if used for any substantial amount 298# of text. A copy that is not "Transparent" is called "Opaque". 299# 300# Examples of suitable formats for Transparent copies include plain 301# ASCII without markup, Texinfo input format, LaTeX input format, SGML 302# or XML using a publicly available DTD, and standard-conforming simple 303# HTML, PostScript or PDF designed for human modification. Examples of 304# transparent image formats include PNG, XCF and JPG. Opaque formats 305# include proprietary formats that can be read and edited only by 306# proprietary word processors, SGML or XML for which the DTD and/or 307# processing tools are not generally available, and the 308# machine-generated HTML, PostScript or PDF produced by some word 309# processors for output purposes only. 310# 311# The "Title Page" means, for a printed book, the title page itself, 312# plus such following pages as are needed to hold, legibly, the material 313# this License requires to appear in the title page. For works in 314# formats which do not have any title page as such, "Title Page" means 315# the text near the most prominent appearance of the work's title, 316# preceding the beginning of the body of the text. 317# 318# A section "Entitled XYZ" means a named subunit of the Document whose 319# title either is precisely XYZ or contains XYZ in parentheses following 320# text that translates XYZ in another language. (Here XYZ stands for a 321# specific section name mentioned below, such as "Acknowledgements", 322# "Dedications", "Endorsements", or "History".) To "Preserve the Title" 323# of such a section when you modify the Document means that it remains a 324# section "Entitled XYZ" according to this definition. 325# 326# The Document may include Warranty Disclaimers next to the notice which 327# states that this License applies to the Document. These Warranty 328# Disclaimers are considered to be included by reference in this 329# License, but only as regards disclaiming warranties: any other 330# implication that these Warranty Disclaimers may have is void and has 331# no effect on the meaning of this License. 332# 333# 334# 2. VERBATIM COPYING 335# 336# You may copy and distribute the Document in any medium, either 337# commercially or noncommercially, provided that this License, the 338# copyright notices, and the license notice saying this License applies 339# to the Document are reproduced in all copies, and that you add no other 340# conditions whatsoever to those of this License. You may not use 341# technical measures to obstruct or control the reading or further 342# copying of the copies you make or distribute. However, you may accept 343# compensation in exchange for copies. If you distribute a large enough 344# number of copies you must also follow the conditions in section 3. 345# 346# You may also lend copies, under the same conditions stated above, and 347# you may publicly display copies. 348# 349# 350# 3. COPYING IN QUANTITY 351# 352# If you publish printed copies (or copies in media that commonly have 353# printed covers) of the Document, numbering more than 100, and the 354# Document's license notice requires Cover Texts, you must enclose the 355# copies in covers that carry, clearly and legibly, all these Cover 356# Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on 357# the back cover. Both covers must also clearly and legibly identify 358# you as the publisher of these copies. The front cover must present 359# the full title with all words of the title equally prominent and 360# visible. You may add other material on the covers in addition. 361# Copying with changes limited to the covers, as long as they preserve 362# the title of the Document and satisfy these conditions, can be treated 363# as verbatim copying in other respects. 364# 365# If the required texts for either cover are too voluminous to fit 366# legibly, you should put the first ones listed (as many as fit 367# reasonably) on the actual cover, and continue the rest onto adjacent 368# pages. 369# 370# If you publish or distribute Opaque copies of the Document numbering 371# more than 100, you must either include a machine-readable Transparent 372# copy along with each Opaque copy, or state in or with each Opaque copy 373# a computer-network location from which the general network-using 374# public has access to download using public-standard network protocols 375# a complete Transparent copy of the Document, free of added material. 376# If you use the latter option, you must take reasonably prudent steps, 377# when you begin distribution of Opaque copies in quantity, to ensure 378# that this Transparent copy will remain thus accessible at the stated 379# location until at least one year after the last time you distribute an 380# Opaque copy (directly or through your agents or retailers) of that 381# edition to the public. 382# 383# It is requested, but not required, that you contact the authors of the 384# Document well before redistributing any large number of copies, to give 385# them a chance to provide you with an updated version of the Document. 386# 387# 388# 4. MODIFICATIONS 389# 390# You may copy and distribute a Modified Version of the Document under 391# the conditions of sections 2 and 3 above, provided that you release 392# the Modified Version under precisely this License, with the Modified 393# Version filling the role of the Document, thus licensing distribution 394# and modification of the Modified Version to whoever possesses a copy 395# of it. In addition, you must do these things in the Modified Version: 396# 397# A. Use in the Title Page (and on the covers, if any) a title distinct 398# from that of the Document, and from those of previous versions 399# (which should, if there were any, be listed in the History section 400# of the Document). You may use the same title as a previous version 401# if the original publisher of that version gives permission. 402# B. List on the Title Page, as authors, one or more persons or entities 403# responsible for authorship of the modifications in the Modified 404# Version, together with at least five of the principal authors of the 405# Document (all of its principal authors, if it has fewer than five), 406# unless they release you from this requirement. 407# C. State on the Title page the name of the publisher of the 408# Modified Version, as the publisher. 409# D. Preserve all the copyright notices of the Document. 410# E. Add an appropriate copyright notice for your modifications 411# adjacent to the other copyright notices. 412# F. Include, immediately after the copyright notices, a license notice 413# giving the public permission to use the Modified Version under the 414# terms of this License, in the form shown in the Addendum below. 415# G. Preserve in that license notice the full lists of Invariant Sections 416# and required Cover Texts given in the Document's license notice. 417# H. Include an unaltered copy of this License. 418# I. Preserve the section Entitled "History", Preserve its Title, and add 419# to it an item stating at least the title, year, new authors, and 420# publisher of the Modified Version as given on the Title Page. If 421# there is no section Entitled "History" in the Document, create one 422# stating the title, year, authors, and publisher of the Document as 423# given on its Title Page, then add an item describing the Modified 424# Version as stated in the previous sentence. 425# J. Preserve the network location, if any, given in the Document for 426# public access to a Transparent copy of the Document, and likewise 427# the network locations given in the Document for previous versions 428# it was based on. These may be placed in the "History" section. 429# You may omit a network location for a work that was published at 430# least four years before the Document itself, or if the original 431# publisher of the version it refers to gives permission. 432# K. For any section Entitled "Acknowledgements" or "Dedications", 433# Preserve the Title of the section, and preserve in the section all 434# the substance and tone of each of the contributor acknowledgements 435# and/or dedications given therein. 436# L. Preserve all the Invariant Sections of the Document, 437# unaltered in their text and in their titles. Section numbers 438# or the equivalent are not considered part of the section titles. 439# M. Delete any section Entitled "Endorsements". Such a section 440# may not be included in the Modified Version. 441# N. Do not retitle any existing section to be Entitled "Endorsements" 442# or to conflict in title with any Invariant Section. 443# O. Preserve any Warranty Disclaimers. 444# 445# If the Modified Version includes new front-matter sections or 446# appendices that qualify as Secondary Sections and contain no material 447# copied from the Document, you may at your option designate some or all 448# of these sections as invariant. To do this, add their titles to the 449# list of Invariant Sections in the Modified Version's license notice. 450# These titles must be distinct from any other section titles. 451# 452# You may add a section Entitled "Endorsements", provided it contains 453# nothing but endorsements of your Modified Version by various 454# parties--for example, statements of peer review or that the text has 455# been approved by an organization as the authoritative definition of a 456# standard. 457# 458# You may add a passage of up to five words as a Front-Cover Text, and a 459# passage of up to 25 words as a Back-Cover Text, to the end of the list 460# of Cover Texts in the Modified Version. Only one passage of 461# Front-Cover Text and one of Back-Cover Text may be added by (or 462# through arrangements made by) any one entity. If the Document already 463# includes a cover text for the same cover, previously added by you or 464# by arrangement made by the same entity you are acting on behalf of, 465# you may not add another; but you may replace the old one, on explicit 466# permission from the previous publisher that added the old one. 467# 468# The author(s) and publisher(s) of the Document do not by this License 469# give permission to use their names for publicity for or to assert or 470# imply endorsement of any Modified Version. 471# 472# 473# 5. COMBINING DOCUMENTS 474# 475# You may combine the Document with other documents released under this 476# License, under the terms defined in section 4 above for modified 477# versions, provided that you include in the combination all of the 478# Invariant Sections of all of the original documents, unmodified, and 479# list them all as Invariant Sections of your combined work in its 480# license notice, and that you preserve all their Warranty Disclaimers. 481# 482# The combined work need only contain one copy of this License, and 483# multiple identical Invariant Sections may be replaced with a single 484# copy. If there are multiple Invariant Sections with the same name but 485# different contents, make the title of each such section unique by 486# adding at the end of it, in parentheses, the name of the original 487# author or publisher of that section if known, or else a unique number. 488# Make the same adjustment to the section titles in the list of 489# Invariant Sections in the license notice of the combined work. 490# 491# In the combination, you must combine any sections Entitled "History" 492# in the various original documents, forming one section Entitled 493# "History"; likewise combine any sections Entitled "Acknowledgements", 494# and any sections Entitled "Dedications". You must delete all sections 495# Entitled "Endorsements". 496# 497# 498# 6. COLLECTIONS OF DOCUMENTS 499# 500# You may make a collection consisting of the Document and other documents 501# released under this License, and replace the individual copies of this 502# License in the various documents with a single copy that is included in 503# the collection, provided that you follow the rules of this License for 504# verbatim copying of each of the documents in all other respects. 505# 506# You may extract a single document from such a collection, and distribute 507# it individually under this License, provided you insert a copy of this 508# License into the extracted document, and follow this License in all 509# other respects regarding verbatim copying of that document. 510# 511# 512# 7. AGGREGATION WITH INDEPENDENT WORKS 513# 514# A compilation of the Document or its derivatives with other separate 515# and independent documents or works, in or on a volume of a storage or 516# distribution medium, is called an "aggregate" if the copyright 517# resulting from the compilation is not used to limit the legal rights 518# of the compilation's users beyond what the individual works permit. 519# When the Document is included in an aggregate, this License does not 520# apply to the other works in the aggregate which are not themselves 521# derivative works of the Document. 522# 523# If the Cover Text requirement of section 3 is applicable to these 524# copies of the Document, then if the Document is less than one half of 525# the entire aggregate, the Document's Cover Texts may be placed on 526# covers that bracket the Document within the aggregate, or the 527# electronic equivalent of covers if the Document is in electronic form. 528# Otherwise they must appear on printed covers that bracket the whole 529# aggregate. 530# 531# 532# 8. TRANSLATION 533# 534# Translation is considered a kind of modification, so you may 535# distribute translations of the Document under the terms of section 4. 536# Replacing Invariant Sections with translations requires special 537# permission from their copyright holders, but you may include 538# translations of some or all Invariant Sections in addition to the 539# original versions of these Invariant Sections. You may include a 540# translation of this License, and all the license notices in the 541# Document, and any Warranty Disclaimers, provided that you also include 542# the original English version of this License and the original versions 543# of those notices and disclaimers. In case of a disagreement between 544# the translation and the original version of this License or a notice 545# or disclaimer, the original version will prevail. 546# 547# If a section in the Document is Entitled "Acknowledgements", 548# "Dedications", or "History", the requirement (section 4) to Preserve 549# its Title (section 1) will typically require changing the actual 550# title. 551# 552# 553# 9. TERMINATION 554# 555# You may not copy, modify, sublicense, or distribute the Document except 556# as expressly provided for under this License. Any other attempt to 557# copy, modify, sublicense or distribute the Document is void, and will 558# automatically terminate your rights under this License. However, 559# parties who have received copies, or rights, from you under this 560# License will not have their licenses terminated so long as such 561# parties remain in full compliance. 562# 563# 564# 10. FUTURE REVISIONS OF THIS LICENSE 565# 566# The Free Software Foundation may publish new, revised versions 567# of the GNU Free Documentation License from time to time. Such new 568# versions will be similar in spirit to the present version, but may 569# differ in detail to address new problems or concerns. See 570# http://www.gnu.org/copyleft/. 571# 572# Each version of the License is given a distinguishing version number. 573# If the Document specifies that a particular numbered version of this 574# License "or any later version" applies to it, you have the option of 575# following the terms and conditions either of that specified version or 576# of any later version that has been published (not as a draft) by the 577# Free Software Foundation. If the Document does not specify a version 578# number of this License, you may choose any version ever published (not 579# as a draft) by the Free Software Foundation. 580