#--------------------------------------------------------------------------
# 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 )
#dn: cn=schema
#changetype: modify
#add: attributetypes
attributetype ( 1.3.6.1.4.1.15312.2.2.1.47
NAME 'amavisDisclaimerOptions'
DESC 'Altermime disclaimer map data'
EQUALITY caseIgnoreIA5Match
SUBSTR caseIgnoreIA5SubstringsMatch
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 $ amavisDisclaimerOptions $
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.