€•ñS      Œ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”Œ+/translations/zh_CN/infiniband/core_locking”Œ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”Œ+/translations/zh_TW/infiniband/core_locking”Œ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”Œ+/translations/it_IT/infiniband/core_locking”Œ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”Œ+/translations/ja_JP/infiniband/core_locking”Œ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”Œ+/translations/ko_KR/infiniband/core_locking”Œ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”Œ+/translations/sp_SP/infiniband/core_locking”Œ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Œsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒInfiniBand Midlayer Locking”h]”hŒInfiniBand Midlayer Locking”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒE/var/lib/git/docbuild/linux/Documentation/infiniband/core_locking.rst”h KubhŒblock_quote”“”)”}”(hŒéThis guide is an attempt to make explicit the locking assumptions
made by the InfiniBand midlayer.  It describes the requirements on
both low-level drivers that sit below the midlayer and upper level
protocols that use the midlayer.
”h]”hŒ	paragraph”“”)”}”(hŒèThis guide is an attempt to make explicit the locking assumptions
made by the InfiniBand midlayer.  It describes the requirements on
both low-level drivers that sit below the midlayer and upper level
protocols that use the midlayer.”h]”hŒèThis guide is an attempt to make explicit the locking assumptions
made by the InfiniBand midlayer.  It describes the requirements on
both low-level drivers that sit below the midlayer and upper level
protocols that use the midlayer.”…””}”(hh¿hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khh¹ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒSleeping and interrupt context”h]”hŒSleeping and interrupt context”…””}”(hhÖhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hhÓhžhhŸh¶h Kubh¸)”}”(hXø  With the following exceptions, a low-level driver implementation of
all of the methods in struct ib_device may sleep.  The exceptions
are any methods from the list:

  - create_ah
  - modify_ah
  - query_ah
  - destroy_ah
  - post_send
  - post_recv
  - poll_cq
  - req_notify_cq

which may not sleep and must be callable from any context.

The corresponding functions exported to upper level protocol
consumers:

  - rdma_create_ah
  - rdma_modify_ah
  - rdma_query_ah
  - rdma_destroy_ah
  - ib_post_send
  - ib_post_recv
  - ib_req_notify_cq

are therefore safe to call from any context.

In addition, the function

  - ib_dispatch_event

used by low-level drivers to dispatch asynchronous events through
the midlayer is also safe to call from any context.
”h]”(h¾)”}”(hŒ¤With the following exceptions, a low-level driver implementation of
all of the methods in struct ib_device may sleep.  The exceptions
are any methods from the list:”h]”hŒ¤With the following exceptions, a low-level driver implementation of
all of the methods in struct ib_device may sleep.  The exceptions
are any methods from the list:”…””}”(hhèhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khhäubh¸)”}”(hŒb- create_ah
- modify_ah
- query_ah
- destroy_ah
- post_send
- post_recv
- poll_cq
- req_notify_cq
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ	create_ah”h]”h¾)”}”(hj  h]”hŒ	create_ah”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒ	modify_ah”h]”h¾)”}”(hj  h]”hŒ	modify_ah”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒquery_ah”h]”h¾)”}”(hj1  h]”hŒquery_ah”…””}”(hj3  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj/  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒ
destroy_ah”h]”h¾)”}”(hjH  h]”hŒ
destroy_ah”…””}”(hjJ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h KhjF  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒ	post_send”h]”h¾)”}”(hj_  h]”hŒ	post_send”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj]  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒ	post_recv”h]”h¾)”}”(hjv  h]”hŒ	post_recv”…””}”(hjx  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khjt  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒpoll_cq”h]”h¾)”}”(hj  h]”hŒpoll_cq”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj‹  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubj   )”}”(hŒreq_notify_cq
”h]”h¾)”}”(hŒreq_notify_cq”h]”hŒreq_notify_cq”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khj¢  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhhüubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1húhŸh¶h Khhöubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khhäubh¾)”}”(hŒ:which may not sleep and must be callable from any context.”h]”hŒ:which may not sleep and must be callable from any context.”…””}”(hjÈ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khhäubh¾)”}”(hŒGThe corresponding functions exported to upper level protocol
consumers:”h]”hŒGThe corresponding functions exported to upper level protocol
consumers:”…””}”(hjÖ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khhäubh¸)”}”(hŒu- rdma_create_ah
- rdma_modify_ah
- rdma_query_ah
- rdma_destroy_ah
- ib_post_send
- ib_post_recv
- ib_req_notify_cq
”h]”hû)”}”(hhh]”(j   )”}”(hŒrdma_create_ah”h]”h¾)”}”(hjí  h]”hŒrdma_create_ah”…””}”(hjï  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Khjë  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒrdma_modify_ah”h]”h¾)”}”(hj  h]”hŒrdma_modify_ah”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒrdma_query_ah”h]”h¾)”}”(hj  h]”hŒrdma_query_ah”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K!hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒrdma_destroy_ah”h]”h¾)”}”(hj2  h]”hŒrdma_destroy_ah”…””}”(hj4  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K"hj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒib_post_send”h]”h¾)”}”(hjI  h]”hŒib_post_send”…””}”(hjK  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K#hjG  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒib_post_recv”h]”h¾)”}”(hj`  h]”hŒib_post_recv”…””}”(hjb  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K$hj^  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubj   )”}”(hŒib_req_notify_cq
”h]”h¾)”}”(hŒib_req_notify_cq”h]”hŒib_req_notify_cq”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K%hju  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhjè  ubeh}”(h]”h ]”h"]”h$]”h&]”jÀ  jÁ  uh1húhŸh¶h Khjä  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khhäubh¾)”}”(hŒ,are therefore safe to call from any context.”h]”hŒ,are therefore safe to call from any context.”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K'hhäubh¾)”}”(hŒIn addition, the function”h]”hŒIn addition, the function”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K)hhäubh¸)”}”(hŒ- ib_dispatch_event
”h]”hû)”}”(hhh]”j   )”}”(hŒib_dispatch_event
”h]”h¾)”}”(hŒib_dispatch_event”h]”hŒib_dispatch_event”…””}”(hjÀ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K+hj¼  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hÿhj¹  ubah}”(h]”h ]”h"]”h$]”h&]”jÀ  jÁ  uh1húhŸh¶h K+hjµ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K+hhäubh¾)”}”(hŒuused by low-level drivers to dispatch asynchronous events through
the midlayer is also safe to call from any context.”h]”hŒuused by low-level drivers to dispatch asynchronous events through
the midlayer is also safe to call from any context.”…””}”(hjà  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K-hhäubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÓhžhubh¢)”}”(hhh]”(h§)”}”(hŒ
Reentrancy”h]”hŒ
Reentrancy”…””}”(hj÷  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjô  hžhhŸh¶h K1ubh¸)”}”(hXß  All of the methods in struct ib_device exported by a low-level
driver must be fully reentrant.  The low-level driver is required to
perform all synchronization necessary to maintain consistency, even
if multiple function calls using the same object are run
simultaneously.

The IB midlayer does not perform any serialization of function calls.

Because low-level drivers are reentrant, upper level protocol
consumers are not required to perform any serialization.  However,
some serialization may be required to get sensible results.  For
example, a consumer may safely call ib_poll_cq() on multiple CPUs
simultaneously.  However, the ordering of the work completion
information between different calls of ib_poll_cq() is not defined.
”h]”(h¾)”}”(hX  All of the methods in struct ib_device exported by a low-level
driver must be fully reentrant.  The low-level driver is required to
perform all synchronization necessary to maintain consistency, even
if multiple function calls using the same object are run
simultaneously.”h]”hX  All of the methods in struct ib_device exported by a low-level
driver must be fully reentrant.  The low-level driver is required to
perform all synchronization necessary to maintain consistency, even
if multiple function calls using the same object are run
simultaneously.”…””}”(hj	  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K3hj  ubh¾)”}”(hŒEThe IB midlayer does not perform any serialization of function calls.”h]”hŒEThe IB midlayer does not perform any serialization of function calls.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K9hj  ubh¾)”}”(hX…  Because low-level drivers are reentrant, upper level protocol
consumers are not required to perform any serialization.  However,
some serialization may be required to get sensible results.  For
example, a consumer may safely call ib_poll_cq() on multiple CPUs
simultaneously.  However, the ordering of the work completion
information between different calls of ib_poll_cq() is not defined.”h]”hX…  Because low-level drivers are reentrant, upper level protocol
consumers are not required to perform any serialization.  However,
some serialization may be required to get sensible results.  For
example, a consumer may safely call ib_poll_cq() on multiple CPUs
simultaneously.  However, the ordering of the work completion
information between different calls of ib_poll_cq() is not defined.”…””}”(hj%  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K;hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K3hjô  hžhubeh}”(h]”Œ
reentrancy”ah ]”h"]”Œ
reentrancy”ah$]”h&]”uh1h¡hhÓhžhhŸh¶h K1ubh¢)”}”(hhh]”(h§)”}”(hŒ	Callbacks”h]”hŒ	Callbacks”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjA  hžhhŸh¶h KCubh¸)”}”(hX  A low-level driver must not perform a callback directly from the
same callchain as an ib_device method call.  For example, it is not
allowed for a low-level driver to call a consumer's completion event
handler directly from its post_send method.  Instead, the low-level
driver should defer this callback by, for example, scheduling a
tasklet to perform the callback.

The low-level driver is responsible for ensuring that multiple
completion event handlers for the same CQ are not called
simultaneously.  The driver must guarantee that only one CQ event
handler for a given CQ is running at a time.  In other words, the
following situation is not allowed::

        CPU1                                    CPU2

  low-level driver ->
    consumer CQ event callback:
      /* ... */
      ib_req_notify_cq(cq, ...);
                                        low-level driver ->
      /* ... */                           consumer CQ event callback:
                                            /* ... */
      return from CQ event handler

The context in which completion event and asynchronous event
callbacks run is not defined.  Depending on the low-level driver, it
may be process context, softirq context, or interrupt context.
Upper level protocol consumers may not sleep in a callback.
”h]”(h¾)”}”(hXn  A low-level driver must not perform a callback directly from the
same callchain as an ib_device method call.  For example, it is not
allowed for a low-level driver to call a consumer's completion event
handler directly from its post_send method.  Instead, the low-level
driver should defer this callback by, for example, scheduling a
tasklet to perform the callback.”h]”hXp  A low-level driver must not perform a callback directly from the
same callchain as an ib_device method call.  For example, it is not
allowed for a low-level driver to call a consumerâ€™s completion event
handler directly from its post_send method.  Instead, the low-level
driver should defer this callback by, for example, scheduling a
tasklet to perform the callback.”…””}”(hjV  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h KEhjR  ubh¾)”}”(hX   The low-level driver is responsible for ensuring that multiple
completion event handlers for the same CQ are not called
simultaneously.  The driver must guarantee that only one CQ event
handler for a given CQ is running at a time.  In other words, the
following situation is not allowed::”h]”hX  The low-level driver is responsible for ensuring that multiple
completion event handlers for the same CQ are not called
simultaneously.  The driver must guarantee that only one CQ event
handler for a given CQ is running at a time.  In other words, the
following situation is not allowed:”…””}”(hjd  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h KLhjR  ubhŒliteral_block”“”)”}”(hXe        CPU1                                    CPU2

low-level driver ->
  consumer CQ event callback:
    /* ... */
    ib_req_notify_cq(cq, ...);
                                      low-level driver ->
    /* ... */                           consumer CQ event callback:
                                          /* ... */
    return from CQ event handler”h]”hXe        CPU1                                    CPU2

low-level driver ->
  consumer CQ event callback:
    /* ... */
    ib_req_notify_cq(cq, ...);
                                      low-level driver ->
    /* ... */                           consumer CQ event callback:
                                          /* ... */
    return from CQ event handler”…””}”hjt  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jr  hŸh¶h KRhjR  ubh¾)”}”(hŒüThe context in which completion event and asynchronous event
callbacks run is not defined.  Depending on the low-level driver, it
may be process context, softirq context, or interrupt context.
Upper level protocol consumers may not sleep in a callback.”h]”hŒüThe context in which completion event and asynchronous event
callbacks run is not defined.  Depending on the low-level driver, it
may be process context, softirq context, or interrupt context.
Upper level protocol consumers may not sleep in a callback.”…””}”(hj„  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h K]hjR  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KEhjA  hžhubeh}”(h]”Œ	callbacks”ah ]”h"]”Œ	callbacks”ah$]”h&]”uh1h¡hhÓhžhhŸh¶h KCubh¢)”}”(hhh]”(h§)”}”(hŒHot-plug”h]”hŒHot-plug”…””}”(hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj   hžhhŸh¶h Kcubh¸)”}”(hX#  A low-level driver announces that a device is ready for use by
consumers when it calls ib_register_device(), all initialization
must be complete before this call.  The device must remain usable
until the driver's call to ib_unregister_device() has returned.

A low-level driver must call ib_register_device() and
ib_unregister_device() from process context.  It must not hold any
semaphores that could cause deadlock if a consumer calls back into
the driver across these calls.

An upper level protocol consumer may begin using an IB device as
soon as the add method of its struct ib_client is called for that
device.  A consumer must finish all cleanup and free all resources
relating to a device before returning from the remove method.

A consumer is permitted to sleep in its add and remove methods.”h]”(h¾)”}”(hX  A low-level driver announces that a device is ready for use by
consumers when it calls ib_register_device(), all initialization
must be complete before this call.  The device must remain usable
until the driver's call to ib_unregister_device() has returned.”h]”hX  A low-level driver announces that a device is ready for use by
consumers when it calls ib_register_device(), all initialization
must be complete before this call.  The device must remain usable
until the driverâ€™s call to ib_unregister_device() has returned.”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Kehj±  ubh¾)”}”(hŒÚA low-level driver must call ib_register_device() and
ib_unregister_device() from process context.  It must not hold any
semaphores that could cause deadlock if a consumer calls back into
the driver across these calls.”h]”hŒÚA low-level driver must call ib_register_device() and
ib_unregister_device() from process context.  It must not hold any
semaphores that could cause deadlock if a consumer calls back into
the driver across these calls.”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Kjhj±  ubh¾)”}”(hX  An upper level protocol consumer may begin using an IB device as
soon as the add method of its struct ib_client is called for that
device.  A consumer must finish all cleanup and free all resources
relating to a device before returning from the remove method.”h]”hX  An upper level protocol consumer may begin using an IB device as
soon as the add method of its struct ib_client is called for that
device.  A consumer must finish all cleanup and free all resources
relating to a device before returning from the remove method.”…””}”(hjÑ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Kohj±  ubh¾)”}”(hŒ?A consumer is permitted to sleep in its add and remove methods.”h]”hŒ?A consumer is permitted to sleep in its add and remove methods.”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h½hŸh¶h Kthj±  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kehj   hžhubeh}”(h]”Œhot-plug”ah ]”h"]”Œhot-plug”ah$]”h&]”uh1h¡hhÓhžhhŸh¶h Kcubeh}”(h]”Œsleeping-and-interrupt-context”ah ]”h"]”Œsleeping and interrupt context”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubeh}”(h]”Œinfiniband-midlayer-locking”ah ]”h"]”Œinfiniband midlayer locking”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(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”j.  Œ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;  j  jš  jø  jõ  uŒ	nametypes”}”(j  ‰j   ‰j>  ‰j  ‰jø  ‰uh}”(j  h£jý  hÓj;  jô  jš  jA  jõ  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.