etc/config.xsd

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- $Id: config.xsd,v 1.5 2006-01-16 12:24:14 mike Exp $ -->
   3 <!--
   4         This Schema prescribes the format of YP2 configuration files.
   5         Invoke it like this:
   6                 xmllint -noout -schema config.xsd config1.xml
   7         But use double-dashes for the option names instead of single.
   8         (I couldn't include them literally, as, believe it or not,
   9         it's an error to include a double dash in an XML comment.
  10 -->
  11 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
  12            elementFormDefault="qualified"
  13            targetNamespace="http://indexdata.dk/yp2/config/1"
  14            xmlns:config="http://indexdata.dk/yp2/config/1">
  15
  16   <xs:element name="yp2">
  17     <xs:complexType>
  18       <xs:sequence>
  19         <xs:element ref="config:start"/>
  20         <xs:element ref="config:filters"/>
  21         <xs:element ref="config:routes"/>
  22       </xs:sequence>
  23     </xs:complexType>
  24   </xs:element>
  25
  26
  27   <xs:element name="start">
  28     <xs:complexType>
  29       <!-- ### We need to specify here that the element is empty -->
  30       <xs:attribute name="route" use="required" type="xs:NCName"/>
  31     </xs:complexType>
  32   </xs:element>
  33
  34
  35   <xs:element name="filters">
  36     <xs:complexType>
  37       <xs:sequence>
  38         <xs:element maxOccurs="unbounded" ref="config:filter"/>
  39       </xs:sequence>
  40     </xs:complexType>
  41   </xs:element>
  42
  43   <xs:element name="filter">
  44     <xs:complexType>
  45       <xs:choice>
  46         <!-- In general, the content depends on the "type" attribute.
  47              Perhaps the various filter-types' configuration
  48              structures should each be described by their own little
  49              subschemas? -->
  50
  51         <!-- type="frontend_net" -->
  52         <xs:sequence>
  53           <xs:element minOccurs="0" ref="config:threads"/>
  54           <xs:element ref="config:port"/>
  55         </xs:sequence>
  56
  57         <!-- type="z3950_client" -->
  58         <xs:element ref="config:timeout"/>
  59
  60         <!-- type="log" -->
  61         <xs:element ref="config:message"/>
  62
  63         <!-- type="virt_db" or type="multi" -->
  64         <xs:element minOccurs="0" maxOccurs="unbounded" ref="config:virtual"/>
  65
  66         <!-- type="auth_simple" or type="backend_test" -->
  67         <!-- No elements included -->
  68
  69         <!-- type="session_shared" -->
  70         <!-- No example configuration to deduce from yet -->
  71
  72         <!-- type="template" -->
  73         <!-- No example configuration to deduce from yet -->
  74
  75       </xs:choice>
  76       <xs:attribute name="id" type="xs:NCName"/>
  77       <xs:attribute name="refid" type="xs:NCName"/>
  78       <xs:attribute name="type">
  79         <xs:simpleType>
  80           <xs:restriction base="xs:NCName">
  81             <xs:enumeration value="frontend_net"/>
  82             <xs:enumeration value="z3950_client"/>
  83             <xs:enumeration value="log"/>
  84             <xs:enumeration value="virt_db"/>
  85             <xs:enumeration value="auth_simple"/>
  86             <xs:enumeration value="backend_test"/>
  87             <xs:enumeration value="multi"/>
  88             <xs:enumeration value="session_shared"/>
  89             <xs:enumeration value="template"/>
  90           </xs:restriction>
  91         </xs:simpleType>
  92       </xs:attribute>
  93     </xs:complexType>
  94   </xs:element>
  95
  96   <xs:element name="threads" type="xs:integer"/>
  97   <xs:element name="port" type="xs:string"/>
  98   <xs:element name="timeout" type="xs:integer"/>
  99   <xs:element name="message" type="xs:NCName"/>
 100
 101   <!-- ### This is used differently depending on whether it occurs
 102        within a "virt_db" or "multi" filter: for the former, it
 103        contains one database and one target; for the latter, it
 104        contains an optional vhost and one or more targets.  This
 105        schema should be tweaked to enforce this. -->
 106   <xs:element name="virtual">
 107     <xs:complexType>
 108       <xs:sequence>
 109         <xs:element minOccurs="0" ref="config:database"/>
 110         <xs:element minOccurs="0" ref="config:vhost"/>
 111         <xs:element maxOccurs="unbounded" ref="config:target"/>
 112       </xs:sequence>
 113       <xs:attribute name="route" type="xs:NCName"/>
 114     </xs:complexType>
 115   </xs:element>
 116
 117   <xs:element name="database" type="xs:NCName"/>
 118   <xs:element name="vhost" type="xs:NCName"/>
 119   <xs:element name="target" type="xs:anyURI"/>
 120
 121
 122   <xs:element name="routes">
 123     <xs:complexType>
 124       <xs:sequence>
 125         <xs:element maxOccurs="unbounded" ref="config:route"/>
 126       </xs:sequence>
 127     </xs:complexType>
 128   </xs:element>
 129
 130   <xs:element name="route">
 131     <xs:complexType>
 132       <xs:sequence>
 133         <xs:element maxOccurs="unbounded" ref="config:filter"/>
 134       </xs:sequence>
 135       <xs:attribute name="id" use="required" type="xs:NCName"/>
 136     </xs:complexType>
 137   </xs:element>
 138 </xs:schema>