€•ˆU      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ1/translations/zh_CN/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/zh_TW/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/it_IT/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ja_JP/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ko_KR/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/sp_SP/firmware-guide/acpi/dsd/graph”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒK/var/lib/git/docbuild/linux/Documentation/firmware-guide/acpi/dsd/graph.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒGraphs”h]”hŒGraphs”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒ_DSD”h]”hŒ_DSD”…””}”(hhÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÉhžhhŸh³h KubhŒ	paragraph”“”)”}”(hXÁ  _DSD (Device Specific Data) [dsd-guide] is a predefined ACPI device
configuration object that can be used to convey information on
hardware features which are not specifically covered by the ACPI
specification [acpi]. There are two _DSD extensions that are relevant
for graphs: property [dsd-guide] and hierarchical data extensions. The
property extension provides generic key-value pairs whereas the
hierarchical data extension supports nodes with references to other
nodes, forming a tree. The nodes in the tree may contain properties as
defined by the property extension. The two extensions together provide
a tree-like structure with zero or more properties (key-value pairs)
in each node of the tree.”h]”hXÁ  _DSD (Device Specific Data) [dsd-guide] is a predefined ACPI device
configuration object that can be used to convey information on
hardware features which are not specifically covered by the ACPI
specification [acpi]. There are two _DSD extensions that are relevant
for graphs: property [dsd-guide] and hierarchical data extensions. The
property extension provides generic key-value pairs whereas the
hierarchical data extension supports nodes with references to other
nodes, forming a tree. The nodes in the tree may contain properties as
defined by the property extension. The two extensions together provide
a tree-like structure with zero or more properties (key-value pairs)
in each node of the tree.”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K
hhÉhžhubhÛ)”}”(hŒ~The data structure may be accessed at runtime by using the device_*
and fwnode_* functions defined in include/linux/fwnode.h .”h]”hŒ~The data structure may be accessed at runtime by using the device_*
and fwnode_* functions defined in include/linux/fwnode.h .”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubhÛ)”}”(hŒÍFwnode represents a generic firmware node object. It is independent on
the firmware type. In ACPI, fwnodes are _DSD hierarchical data
extensions objects. A device's _DSD object is represented by an
fwnode.”h]”hŒÏFwnode represents a generic firmware node object. It is independent on
the firmware type. In ACPI, fwnodes are _DSD hierarchical data
extensions objects. A deviceâ€™s _DSD object is represented by an
fwnode.”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubhÛ)”}”(hŒ¸The data structure may be referenced to elsewhere in the ACPI tables
by using a hard reference to the device itself and an index to the
hierarchical data extension array on each depth.”h]”hŒ¸The data structure may be referenced to elsewhere in the ACPI tables
by using a hard reference to the device itself and an index to the
hierarchical data extension array on each depth.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhÉhžhubeh}”(h]”Œdsd”ah ]”h"]”Œ_dsd”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒPorts and endpoints”h]”hŒPorts and endpoints”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h K$ubhÛ)”}”(hX  The port and endpoint concepts are very similar to those in Devicetree
[devicetree, graph-bindings]. A port represents an interface in a device, and
an endpoint represents a connection to that interface. Also see [data-node-ref]
for generic data node references.”h]”hX  The port and endpoint concepts are very similar to those in Devicetree
[devicetree, graph-bindings]. A port represents an interface in a device, and
an endpoint represents a connection to that interface. Also see [data-node-ref]
for generic data node references.”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K&hj  hžhubhÛ)”}”(hX|  All port nodes are located under the device's "_DSD" node in the hierarchical
data extension tree. The data extension related to each port node must begin
with "port" and must be followed by the "@" character and the number of the
port as its key. The target object it refers to should be called "PRTX", where
"X" is the number of the port. An example of such a package would be::”h]”hX‘  All port nodes are located under the deviceâ€™s â€œ_DSDâ€ node in the hierarchical
data extension tree. The data extension related to each port node must begin
with â€œportâ€ and must be followed by the â€œ@â€ character and the number of the
port as its key. The target object it refers to should be called â€œPRTXâ€, where
â€œXâ€ is the number of the port. An example of such a package would be:”…””}”(hj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K+hj  hžhubhŒliteral_block”“”)”}”(hŒPackage() { "port@4", "PRT4" }”h]”hŒPackage() { "port@4", "PRT4" }”…””}”hjK  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jI  hŸh³h K1hj  hžhubhÛ)”}”(hXz  Further on, endpoints are located under the port nodes. The hierarchical
data extension key of the endpoint nodes must begin with
"endpoint" and must be followed by the "@" character and the number of the
endpoint. The object it refers to should be called "EPXY", where "X" is the
number of the port and "Y" is the number of the endpoint. An example of such a
package would be::”h]”hX  Further on, endpoints are located under the port nodes. The hierarchical
data extension key of the endpoint nodes must begin with
â€œendpointâ€ and must be followed by the â€œ@â€ character and the number of the
endpoint. The object it refers to should be called â€œEPXYâ€, where â€œXâ€ is the
number of the port and â€œYâ€ is the number of the endpoint. An example of such a
package would be:”…””}”(hjY  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K3hj  hžhubjJ  )”}”(hŒ"Package() { "endpoint@0", "EP40" }”h]”hŒ"Package() { "endpoint@0", "EP40" }”…””}”hjg  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jI  hŸh³h K:hj  hžhubhÛ)”}”(hXü  Each port node contains a property extension key "port", the value of which is
the number of the port. Each endpoint is similarly numbered with a property
extension key "reg", the value of which is the number of the endpoint. Port
numbers must be unique within a device and endpoint numbers must be unique
within a port. If a device object may only has a single port, then the number
of that port shall be zero. Similarly, if a port may only have a single
endpoint, the number of that endpoint shall be zero.”h]”hX  Each port node contains a property extension key â€œportâ€, the value of which is
the number of the port. Each endpoint is similarly numbered with a property
extension key â€œregâ€, the value of which is the number of the endpoint. Port
numbers must be unique within a device and endpoint numbers must be unique
within a port. If a device object may only has a single port, then the number
of that port shall be zero. Similarly, if a port may only have a single
endpoint, the number of that endpoint shall be zero.”…””}”(hju  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K<hj  hžhubhÛ)”}”(hXŠ  The endpoint reference uses property extension with "remote-endpoint" property
name followed by a reference in the same package. Such references consist of
the remote device reference, the first package entry of the port data extension
reference under the device and finally the first package entry of the endpoint
data extension reference under the port. Individual references thus appear as::”h]”hX  The endpoint reference uses property extension with â€œremote-endpointâ€ property
name followed by a reference in the same package. Such references consist of
the remote device reference, the first package entry of the port data extension
reference under the device and finally the first package entry of the endpoint
data extension reference under the port. Individual references thus appear as:”…””}”(hjƒ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KDhj  hžhubjJ  )”}”(hŒ,Package() { device, "port@X", "endpoint@Y" }”h]”hŒ,Package() { device, "port@X", "endpoint@Y" }”…””}”hj‘  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jI  hŸh³h KJhj  hžhubhÛ)”}”(hŒZIn the above example, "X" is the number of the port and "Y" is the number of
the endpoint.”h]”hŒbIn the above example, â€œXâ€ is the number of the port and â€œYâ€ is the number of
the endpoint.”…””}”(hjŸ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KLhj  hžhubhÛ)”}”(hŒ‚The references to endpoints must be always done both ways, to the
remote endpoint and back from the referred remote endpoint node.”h]”hŒ‚The references to endpoints must be always done both ways, to the
remote endpoint and back from the referred remote endpoint node.”…””}”(hj­  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KOhj  hžhubhÛ)”}”(hŒ(A simple example of this is show below::”h]”hŒ'A simple example of this is show below:”…””}”(hj»  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KRhj  hžhubjJ  )”}”(hX—  Scope (\_SB.PCI0.I2C2)
{
    Device (CAM0)
    {
        Name (_DSD, Package () {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "compatible", Package () { "nokia,smia" } },
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "port@0", "PRT0" },
            }
        })
        Name (PRT0, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "endpoint@0", "EP00" },
            }
        })
        Name (EP00, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
                Package () { "remote-endpoint", Package() { \_SB.PCI0.ISP, "port@4", "endpoint@0" } },
            }
        })
    }
}

Scope (\_SB.PCI0)
{
    Device (ISP)
    {
        Name (_DSD, Package () {
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "port@4", "PRT4" },
            }
        })

        Name (PRT4, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 4 }, /* CSI-2 port number */
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "endpoint@0", "EP40" },
            }
        })

        Name (EP40, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
                Package () { "remote-endpoint", Package () { \_SB.PCI0.I2C2.CAM0, "port@0", "endpoint@0" } },
            }
        })
    }
}”h]”hX—  Scope (\_SB.PCI0.I2C2)
{
    Device (CAM0)
    {
        Name (_DSD, Package () {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "compatible", Package () { "nokia,smia" } },
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "port@0", "PRT0" },
            }
        })
        Name (PRT0, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "endpoint@0", "EP00" },
            }
        })
        Name (EP00, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
                Package () { "remote-endpoint", Package() { \_SB.PCI0.ISP, "port@4", "endpoint@0" } },
            }
        })
    }
}

Scope (\_SB.PCI0)
{
    Device (ISP)
    {
        Name (_DSD, Package () {
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "port@4", "PRT4" },
            }
        })

        Name (PRT4, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 4 }, /* CSI-2 port number */
            },
            ToUUID("dbb8e3e6-5886-4ba6-8795-1319f52a966b"),
            Package () {
                Package () { "endpoint@0", "EP40" },
            }
        })

        Name (EP40, Package() {
            ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
            Package () {
                Package () { "reg", 0 },
                Package () { "remote-endpoint", Package () { \_SB.PCI0.I2C2.CAM0, "port@0", "endpoint@0" } },
            }
        })
    }
}”…””}”hjÉ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1jI  hŸh³h KThj  hžhubhÛ)”}”(hŒdHere, the port 0 of the "CAM0" device is connected to the port 4 of
the "ISP" device and vice versa.”h]”hŒlHere, the port 0 of the â€œCAM0â€ device is connected to the port 4 of
the â€œISPâ€ device and vice versa.”…””}”(hj×  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K–hj  hžhubeh}”(h]”Œports-and-endpoints”ah ]”h"]”Œports and endpoints”ah$]”h&]”uh1h´hh¶hžhhŸh³h K$ubhµ)”}”(hhh]”(hº)”}”(hŒ
References”h]”hŒ
References”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjí  hžhhŸh³h K›ubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒƒ[acpi] Advanced Configuration and Power Interface Specification.
https://uefi.org/specifications/ACPI/6.4/, referenced 2021-11-30.
”h]”(hŒterm”“”)”}”(hŒ@[acpi] Advanced Configuration and Power Interface Specification.”h]”hŒ@[acpi] Advanced Configuration and Power Interface Specification.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  hŸh³h Kžhj  ubhŒ
definition”“”)”}”(hhh]”hÛ)”}”(hŒAhttps://uefi.org/specifications/ACPI/6.4/, referenced 2021-11-30.”h]”(hŒ	reference”“”)”}”(hŒ)https://uefi.org/specifications/ACPI/6.4/”h]”hŒ)https://uefi.org/specifications/ACPI/6.4/”…””}”(hj$  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j&  uh1j"  hj  ubhŒ, referenced 2021-11-30.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Kžhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h Kžhj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1jþ  hjí  hžhhŸh³h NubhÛ)”}”(hŒN[data-node-ref] Documentation/firmware-guide/acpi/dsd/data-node-references.rst”h]”hŒN[data-node-ref] Documentation/firmware-guide/acpi/dsd/data-node-references.rst”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K hjí  hžhubhÛ)”}”(hŒK[devicetree] Devicetree. https://www.devicetree.org, referenced 2016-10-03.”h]”(hŒ[devicetree] Devicetree. ”…””}”(hj]  hžhhŸNh Nubj#  )”}”(hŒhttps://www.devicetree.org”h]”hŒhttps://www.devicetree.org”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jg  uh1j"  hj]  ubhŒ, referenced 2016-10-03.”…””}”(hj]  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¢hjí  hžhubjÿ  )”}”(hhh]”(j  )”}”(hŒj[dsd-guide] DSD Guide.
https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc, referenced
2021-11-30.
”h]”(j
  )”}”(hŒ[dsd-guide] DSD Guide.”h]”hŒ[dsd-guide] DSD Guide.”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  hŸh³h K¦hj  ubj  )”}”(hhh]”hÛ)”}”(hŒRhttps://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc, referenced
2021-11-30.”h]”(j#  )”}”(hŒ:https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc”h]”hŒ:https://github.com/UEFI/DSD-Guide/blob/main/dsd-guide.adoc”…””}”(hjš  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jœ  uh1j"  hj–  ubhŒ, referenced
2021-11-30.”…””}”(hj–  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¥hj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h K¦hj~  ubj  )”}”(hŒk[dsd-rules] _DSD Device Properties Usage Rules.
Documentation/firmware-guide/acpi/DSD-properties-rules.rst
”h]”(j
  )”}”(hŒ/[dsd-rules] _DSD Device Properties Usage Rules.”h]”hŒ/[dsd-rules] _DSD Device Properties Usage Rules.”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  hŸh³h K©hj¿  ubj  )”}”(hhh]”hÛ)”}”(hŒ:Documentation/firmware-guide/acpi/DSD-properties-rules.rst”h]”hŒ:Documentation/firmware-guide/acpi/DSD-properties-rules.rst”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K©hjÑ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj¿  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h K©hj~  hžhubj  )”}”(hŒ¡[graph-bindings] Common bindings for device graphs (Devicetree).
https://github.com/devicetree-org/dt-schema/blob/main/schemas/graph.yaml,
referenced 2021-11-30.”h]”(j
  )”}”(hŒ@[graph-bindings] Common bindings for device graphs (Devicetree).”h]”hŒ@[graph-bindings] Common bindings for device graphs (Devicetree).”…””}”(hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  hŸh³h K¬hjî  ubj  )”}”(hhh]”hÛ)”}”(hŒ`https://github.com/devicetree-org/dt-schema/blob/main/schemas/graph.yaml,
referenced 2021-11-30.”h]”(j#  )”}”(hŒHhttps://github.com/devicetree-org/dt-schema/blob/main/schemas/graph.yaml”h]”hŒHhttps://github.com/devicetree-org/dt-schema/blob/main/schemas/graph.yaml”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j	  uh1j"  hj  ubhŒ,
referenced 2021-11-30.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K¬hj   ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjî  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h K¬hj~  hžhubeh}”(h]”h ]”h"]”h$]”h&]”uh1jþ  hjí  hžhhŸh³h Nubeh}”(h]”Œ
references”ah ]”h"]”Œ
references”ah$]”h&]”uh1h´hh¶hžhhŸh³h K›ubeh}”(h]”Œgraphs”ah ]”h"]”Œgraphs”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”je  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j?  j<  j  j  jê  jç  j7  j4  uŒ	nametypes”}”(j?  ‰j  ‰jê  ‰j7  ‰uh}”(j<  h¶j  hÉjç  j  j4  jí  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.