Clarify in Section 7.2 that only a UPnP service type token can be used and the user agent must strip the preceeding string 'upnp:' from that UPnP service type token before initiating a network search.
authorRich Tibbett <richt@opera.com>
Fri, 08 Feb 2013 15:49:52 +0100
changeset 3918621c3c1faf5
parent 390 6211d232766d
child 392 38bf34c08d76
Clarify in Section 7.2 that only a UPnP service type token can be used and the user agent must strip the preceeding string 'upnp:' from that UPnP service type token before initiating a network search.
discovery-api/Overview.html
discovery-api/Overview.src.html
     1.1 --- a/discovery-api/Overview.html	Fri Feb 08 15:23:08 2013 +0100
     1.2 +++ b/discovery-api/Overview.html	Fri Feb 08 15:49:52 2013 +0100
     1.3 @@ -1802,7 +1802,12 @@
     1.4               class="internalDFN">user agent</a> must also send an ST header with this <abbr title=
     1.5               "Hypertext Transfer Protocol">HTTP</abbr> request equal to the String value of <code>ssdp:all</code> or
     1.6               <code>upnp:rootdevice</code> or a single <a href="#dfn-valid-service-type"
     1.7 -             class="internalDFN">valid service type</a> token. The user-agent <em class="rfc2119"
     1.8 +             class="internalDFN">valid service type</a> token beginning with the String value <code>upnp:</code>. If a
     1.9 +             single <a href="#dfn-valid-service-type"
    1.10 +             class="internalDFN">valid service type</a> token beginning with the String value <code>upnp:</code> is to
    1.11 +             be used, the user agent <em class="rfc2119"
    1.12 +             title="must">must</em> strip the leading String <code>upnp:</code> before using this value in this
    1.13 +             <abbr title="Hypertext Transfer Protocol">HTTP</abbr> request. The user-agent <em class="rfc2119"
    1.14               title="must">must</em> also send an MX header equal to a <dfn id=
    1.15               "dfn-maximum-upnp-advertisement-response-wait-time">maximum UPnP advertisement response wait time</dfn>
    1.16               value between <code>1</code> and <code>5</code> seconds with this <abbr title=
     2.1 --- a/discovery-api/Overview.src.html	Fri Feb 08 15:23:08 2013 +0100
     2.2 +++ b/discovery-api/Overview.src.html	Fri Feb 08 15:49:52 2013 +0100
     2.3 @@ -1243,8 +1243,11 @@
     2.4            the reserved multicast address and port of <code>239.255.255.250:1900</code> and a MAN header equal to
     2.5            <code>ssdp:discover</code>. The <a>user agent</a> must also send an ST header with this HTTP request equal to
     2.6            the String value of <code>ssdp:all</code> or <code>upnp:rootdevice</code> or a single <a>valid service
     2.7 -          type</a> token. The user-agent MUST also send an MX header equal to a <dfn>maximum UPnP advertisement
     2.8 -          response wait time</dfn> value between <code>1</code> and <code>5</code> seconds with this HTTP request.
     2.9 +          type</a> token beginning with the String value <code>upnp:</code>. If a single <a>valid service type</a>
    2.10 +          token beginning with the String value <code>upnp:</code> is to be used, the user agent MUST strip the leading
    2.11 +          String <code>upnp:</code> before using this value in this HTTP request. The user-agent MUST also send an MX
    2.12 +          header equal to a <dfn>maximum UPnP advertisement response wait time</dfn> value between <code>1</code> and
    2.13 +          <code>5</code> seconds with this HTTP request.
    2.14          </p>
    2.15          <p>
    2.16            The user agent MUST listen for any incoming responses to any <a>search request for UPnP root devices</a>.