# ##############################################################
# 
# File:         PassiveAnomal.rnc - TBD
# Version:      $Id$
# Purpose:      TBD
# Reference:    http://books.xmlschemata.org/relaxng/page2.html
#                         
# ##############################################################


# ##############################################################
# Namespace definitions
# ##############################################################
namespace nmwg = "http://ggf.org/ns/nmwg/base/2.0/"
namespace passiveanomal = "http://ggf.org/ns/nmwg/tools/passiveanomal/2.0/"
namespace nmtm = "http://ggf.org/ns/nmwg/time/2.0/"
namespace nmwgr = "http://ggf.org/ns/nmwg/result/2.0/"


# ##############################################################
# Include additional functionality from other files
# ##############################################################
include "nmtopo.rnc"
include "nmtopo_ver3.rnc"
include "result.rnc"
include "nmbase.rnc" {
        Metadata |= PassiveAnomalMetadata
        Data |= PassiveAnomalData        
} 


# ##############################################################
# Metadata is the 'data' that describes physical measurements. 
# Metadata can be something such as a physical address, or 
# a geographical location; any form of static, re-usable 
# designation.  It is important to note that the subject
# namespace and parameters namespace MUST match (or the parameters
# can be a generic NMWG) or bad things will occur.
#
# Example: 
# 
# <nmwg:metadata id="REQUIRED_ID" 
#                metadataIdRef="OPTIONAL_REFERENCE_ID"
#                xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
# 
#   <!-- TBD OPTIONAL SUBJECT -->
# 
#   <!-- TBD OPTIONAL PARAMETERS -->
#
#   <!-- TBD OPTIONAL EVENTTYPE -->
# 
#   <!-- TBD OPTIONAL KEY -->
#  
#   <!-- ANY OPTIONAL (MULTIPLE) ELEMENT IN ANY NAMESPACE --> 
#
# </nmwg:metadata>
# 
# ##############################################################
        
PassiveAnomalMetadata = 
        element nmwg:metadata {
                Identifier &
                MetadataIdentifierRef? &
                PassiveAnomalMetadataContent
        }
          
PassiveAnomalMetadataBlock = 
        PassiveAnomalSubject? &
        (
                PassiveAnomalParameters |
                Parameters
        )?        
        
PassiveAnomalMetadataContent = 
        (
                PassiveAnomalMetadataBlock |
                FilterMetadataBlock                
        ) &        
        EventType? &
        Key?        


# ##############################################################
# TBD   
#
# Example: 
# 
# <passiveanomal:subject id="REQUIRED_ID" 
#               metadataIdRef="OPTIONAL_REFERENCE_ID"
#               xmlns:passiveanomal="http://ggf.org/ns/nmwg/tools/passiveanomal/2.0/">
# 
#   <nmwgtopo:endPointPair xmlns:nmwgtopo="http://ggf.org/ns/nmwg/topology/2.0/">
# 
#     <nmwgtopo:src type="REQUIRED_TYPE" value="REQUIRED_VALUE" 
#                   port="OPTIONAL_PORT"/>
# 
#     <nmwgtopo:dst type="REQUIRED_TYPE" value="REQUIRED_VALUE" 
#                   port="OPTIONAL_PORT"/>
#  
#   </nmwgtopo:endPointPair>
#
#           <!-- OR -->
#
#   <nmwgtopo:interface xmlns:nmwgtopo="http://ggf.org/ns/nmwg/topology/2.0/">
# 
#     <nmwgtopo:ipAddress type='REQUIRED_TYPE'> TEXT </nmwgtopo:ipAddress>
# 
#     <nmwgtopo:hostName> TEXT </nmwgtopo:hostName>
# 
#     <nmwgtopo:ifName> TEXT </nmwgtopo:ifName>
# 
#     <nmwgtopo:ifDescription> TEXT </nmwgtopo:ifDescription>
# 
#     <nmwgtopo:ifAddress type='REQUIRED_TYPE'> TEXT </nmwgtopo:ifAddress>
# 
#     <nmwgtopo:ifHostName> TEXT </nmwgtopo:ifHostName>
# 
#     <nmwgtopo:ifIndex> TEXT </nmwgtopo:ifIndex>
# 
#     <nmwgtopo:type> TEXT </nmwgtopo:type>
# 
#     <nmwgtopo:direction> TEXT </nmwgtopo:direction>
# 
#     <nmwgtopo:authRealm> TEXT </nmwgtopo:authRealm>
# 
#     <nmwgtopo:classOfService> TEXT </nmwgtopo:classOfService>
# 
#     <nmwgtopo:capacity> TEXT </nmwgtopo:capacity>
#  
#   </nmwgtopo:interface>
#  
# </passiveanomal:subject>
#
# ##############################################################

PassiveAnomalSubject =
        element passiveanomal:subject {
                Identifier &
                MetadataIdentifierRef? &  
                (  
                        (                   
                                EndpointPair |
                                L4EndpointPair
                        ) |
                        (
                                Interface |
                                BaseInterface |
                                L2Interface |
                                L3Interface
                        )
                )?
        }


# ##############################################################
# TBD
#
# Example: 
# 
# <passiveanomal:parameters id="REQUIRED_ID" 
#                   xmlns:passiveanomal="http://ggf.org/ns/nmwg/tools/passiveanomal/2.0/">
# 
#   <nmwg:parameter name="REQUIRED_ENUM_NAME" value="OPTIONAL_VALUE"
#                   xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
# 
#     <!-- ANY TEXT, (IF YOU DID NOT USE THE VALUE ATTRIBUTE) -->
# 
#   </nmwg:parameter>
#  
#   <!-- MORE PARAMETERS -->
#   
# </passiveanomal:parameters>
# 
# ##############################################################

PassiveAnomalParameters =
        element passiveanomal:parameters {
                Identifier &        
                (
                        PassiveAnomalParameter |
                        PassiveAnomalParameterST |
                        PassiveAnomalParameterET                        
                )+
        }
        
PassiveAnomalParameter = 
        element nmwg:parameter { 
                attribute name { "flow_h_filter" | "flow_s_type" | "flow_s_thre" | 
                                 "flow_p_filter" | "characteristics" | "granularity" } &
                (
                        attribute value { text } |                        
                        text
                )
        }
        
PassiveAnomalParameterST = 
        element nmwg:parameter { 
                attribute name { "start_time" } &
                StartTime
        }        
        
PassiveAnomalParameterET = 
        element nmwg:parameter { 
                attribute name { "end_time" } &
                EndTime
        }        


# ##############################################################
# The data block is complex, and has the potential to contain
# many things.  The data block can be used to return a metadata
# block from a request, commonTime or datum elements, keys, 
# or something that we have perhaps not defined as of yet.  
#
# Example: 
# 
# <nmwg:data id="REQUIRED_ID" 
#            metadataIdRef="OPTIONAL_REFERENCE_ID" 
#            xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
# 
#   <!-- OPTIONAL (MULTIPLE) METADATA -->
# 
#           <!-- OR -->
#
#   <!-- TBD OPTIONAL (MULTIPLE) COMMON TIME ELEMENTS AND 
#        OPTIONAL (MULTIPLE) DATUM ELEMENTS-->
# 
#           <!-- OR -->
#  
#   <!-- TBD OPTIONAL (MULTIPLE) DATUM ELEMENTS -->
# 
#           <!-- OR -->
#  
#   <!-- OPTIONAL (MULTIPLE) KEY ELEMENTS -->
# 
#           <!-- OR -->
# 
#   <!-- ANY OPTIONAL (MULTIPLE) ELEMENT IN ANY NAMESPACE -->
#   
# </nmwg:data>
# 
# ##############################################################
   
PassiveAnomalData =
        element nmwg:data {
                Identifier &
                MetadataIdentifierRef? &
                (
                        (
                                Metadata* |
                                PassiveAnomalMetadata*
                        ) |
                        (
                                PassiveAnomalCommonTime+ & 
                                (
                                        PassiveAnomalDatum* |
                                        ResultDatum*
                                )
                        ) |
                        (
                                PassiveAnomalDatum* |
                                ResultDatum*
                        ) |
                        Key*
                )
        }


# ##############################################################
# CommonTime is used a a shortcut able to 'factor out' a frequently
# occurring time range that a bunch of datum (or other) elements
# might share, thus reducing complexity of XML representation.  
# CommonTime is similar to the other NMWG time stamps (from 
# nmtime.rnc) in its potential time representations.
#
# Example: 
# 
# <nmwg:commonTime type="REQUIRED_TYPE" value="OPTIONAL_VALUE"
#                  duration="OPTIONAL_DURATION" 
#                  inclusive="OPTIONAL_INCLUSIVE_FLAG"
#                  xmlns:nmwg="http://ggf.org/ns/nmwg/base/2.0/">
# 
#   <!-- TBD OPTIONAL START TIME ELEMENT (USE END TIME OR DURATION) -->
#  
#   <!-- TBD OPTIONAL END TIME ELEMENT (ONLY WITH START TIME) -->
#  
#   <!-- TBD OPTIONAL TIME VALUE ELEMENT (USE IF NO VALUE ATTRIBUTE) -->
#  
#   <!-- TBD OPTIONAL (MULTIPLE) DATUM ELEMENTS -->
# 
#   <!-- ANY OPTIONAL (MULTIPLE) ELEMENT IN ANY NAMESPACE -->
# </nmwg:commonTime>
# 
# ##############################################################

PassiveAnomalCommonTime = 
        element nmwg:commonTime {
                Type &
                (
                        TimeStamp |
                        (
                                StartTime & 
                                (
                                        EndTime | 
                                        Duration 
                                )
                        )
                ) &
                (
                        PassiveAnomalDatum* |
                        ResultDatum*
                )
        } 


# ##############################################################
# TBD
#
# Example: 
# 
# <passiveanomal:datum event_type="OPTIONAL_EVENT_TYPE"
#              event_specification="OPTIONAL_EVENT_SPECIFICATION"
#              event_number="OPTIONAL_EVENT_NUMBER"
#              timeType="OPTIONAL_TIME_TYPE"
#              timeValue="OPTIONAL_TIME_VALUE"
#              xmlns:nmwg="http://ggf.org/ns/nmwg/tools/passiveanomal/2.0/">
# 
#   <!-- TIME ELEMENT (IF ATTRIBUTES NOT USED) -->
#  
# </passiveanomal:datum>
# 
# ##############################################################

PassiveAnomalDatum =
        element passiveanomal:datum {
                attribute event_type { xsd:string }? &  
                attribute event_specification { xsd:string }? &              
                attribute event_number { xsd:string }? &
                (
                        (
                                attribute timeType { xsd:string } & 
                                attribute timeValue { xsd:string }
                        ) |
                        Time
                )?                   
        }