<?xml version='1.0' encoding='UTF-8'?>
<?xml-stylesheet type="text/xsl" href="imap-list-extended.xsl"?>
<?xml-model href="imap-list-extended.rng" schematypens="http://relaxng.org/ns/structure/1.0" ?>
<registry xmlns="http://www.iana.org/assignments" id="imap-list-extended">
  <title>Internet Message Access Protocol (IMAP) LIST EXTENDED Registry</title>
  <category>Internet Message Access Protocol (IMAP) Capabilities</category>
  <created>2006-10-19</created>
  <updated>2024-06-05</updated>

  <registry id="imap-list-extended-1">
    <title>LIST-EXTENDED options</title>
    <xref type="rfc" data="rfc5258"/>
    <registration_rule>FCFS; IANA approval template in <xref type="rfc" data="rfc5258"/> section 9.3</registration_rule>
    <record>
      <name>SUBSCRIBED</name>
      <type>SELECTION</type>
      <implied_return_option>SUBSCRIBED</implied_return_option>
      <description>Causes the LIST command to list subscribed mailboxes, rather than the actual mailboxes.</description>
      <spec_ref><xref type="rfc" data="rfc5258"/>, Section 3.</spec_ref>
      <security_ref><xref type="rfc" data="rfc5258"/>, Section 8.</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>REMOTE</name>
      <type>SELECTION</type>
      <implied_return_option>(none)</implied_return_option>
      <description>Causes the LIST command to return remote mailboxes as well as local ones, as described in RFC 2193.</description>
      <spec_ref><xref type="rfc" data="rfc5258"/>, Section 3.</spec_ref>
      <security_ref><xref type="rfc" data="rfc5258"/>, Section 8.</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>SUBSCRIBED</name>
      <type>RETURN</type>
      <description>Causes the LIST command to return subscription state.</description>
      <spec_ref><xref type="rfc" data="rfc5258"/>, Section 3.</spec_ref>
      <security_ref><xref type="rfc" data="rfc5258"/>, Section 8.</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>RECURSIVEMATCH</name>
      <type>SELECTION</type>
      <implied_return_option>(none)</implied_return_option>
      <description>Requests that CHILDINFO extended data item (childinfo-extended-item) is to be returned.</description>
      <spec_ref><xref type="rfc" data="rfc5258"/>, Section 3.</spec_ref>
      <security_ref><xref type="rfc" data="rfc5258"/>, Section 8.</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>CHILDREN</name>
      <type>RETURN</type>
      <description>Requests mailbox child information.</description>
      <spec_ref><xref type="rfc" data="rfc5258"/>, Section 3 and Section 4.</spec_ref>
      <security_ref><xref type="rfc" data="rfc5258"/>, Section 8.</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>UTF8</name>
      <type>SELECTION</type>
      <implied_return_option>UTF8</implied_return_option>
      <description>Causes the LIST response to include mailboxes that mandate the UTF8 SELECT/EXAMINE parameter.</description>
      <spec_ref><xref type="rfc" data="rfc5738"/>, Section 3.4.1</spec_ref>
      <security_ref><xref type="rfc" data="rfc5738"/>, Section 11</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>see Authors' Addresses at the end of <xref type="rfc" data="rfc5738"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>UTF8ONLY</name>
      <type>SELECTION</type>
      <implied_return_option>UTF8</implied_return_option>
      <description>Causes the LIST response to include mailboxes that mandate the UTF8 SELECT/EXAMINE parameter and exclude mailboxes that do not support the UTF8 SELECT/EXAMINE parameter.</description>
      <spec_ref><xref type="rfc" data="rfc5738"/>, Section 3.4.1</spec_ref>
      <security_ref><xref type="rfc" data="rfc5738"/>, Section 11</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>see Authors' Addresses at the end of <xref type="rfc" data="rfc5738"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>UTF8</name>
      <type>RETURN</type>
      <implied_return_option>none</implied_return_option>
      <description>Causes the LIST response to include \NoUTF8 and \UTF8Only mailbox attributes.</description>
      <spec_ref><xref type="rfc" data="rfc5738"/>, Section 3.4.2</spec_ref>
      <security_ref><xref type="rfc" data="rfc5738"/>, Section 11</security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>see Authors' Addresses at the end of <xref type="rfc" data="rfc5738"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>STATUS</name>
      <type>RETURN</type>
      <description>Causes the LIST command to return STATUS responses in addition to LIST responses.</description>
      <spec_ref>
        <xref type="rfc" data="rfc5819"/>
      </spec_ref>
      <security_ref>
        <xref type="rfc" data="rfc5819"/>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>SPECIAL-USE</name>
      <type>SELECTION</type>
      <implied_return_option>SPECIAL-USE</implied_return_option>
      <description>Limit the list to special-use mailboxes only</description>
      <spec_ref>
        <xref type="rfc" data="rfc6154"/>
      </spec_ref>
      <security_ref>
        <xref type="text">none</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>Authors' Addresses at the end of <xref type="rfc" data="rfc6154"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record>
      <name>SPECIAL-USE</name>
      <type>RETURN</type>
      <description>Request special-use mailbox information</description>
      <spec_ref>
        <xref type="rfc" data="rfc6154"/>
      </spec_ref>
      <security_ref>
        <xref type="text">none</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>Authors' Addresses at the end of <xref type="rfc" data="rfc6154"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record date="2018-06-12">
      <name>MYRIGHTS</name>
      <type>RETURN</type>
      <description>Causes the LIST command to return
        MYRIGHTS responses in addition to LIST responses.</description>
      <spec_ref>
        <xref type="rfc" data="rfc8440">RFC8440, Section 3</xref>
      </spec_ref>
      <security_ref>
        <xref type="rfc" data="rfc8440">RFC8440, Section 6</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Kenneth_Murchison"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record date="2024-04-09">
      <name>METADATA</name>
      <type>RETURN</type>
      <description>Causes the LIST command to return
        METADATA responses in addition to LIST responses.</description>
      <spec_ref>
        <xref type="rfc" data="rfc9590">RFC9590, Section 3</xref>
      </spec_ref>
      <security_ref>
        <xref type="rfc" data="rfc9590">RFC9590, Section 6</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>See Authors' Addresses at the end of <xref type="rfc" data="rfc9590"/></contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
  </registry>

  <registry id="imap-list-extended-2">
    <title>LIST-EXTENDED response</title>
    <xref type="rfc" data="rfc5258"/>
    <registration_rule>IANA approval template in <xref type="rfc" data="rfc5258"/> section 9.3</registration_rule>
    <record>
      <tag>CHILDINFO</tag>
      <description>The CHILDINFO extended data item describes the selection criteria that has caused it to be returned and indicates that the mailbox has one or more child mailboxes that match the selection criteria.</description>
      <return_option>RECURSIVEMATCH selection option</return_option>
      <spec_ref>
        <xref type="rfc" data="rfc5258">RFC5258, Section 3.5</xref>
	  </spec_ref>
      <security_ref>
        <xref type="rfc" data="rfc5258">RFC5258, Section 8</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
    <record updated="2021-02-22">
      <tag>OLDNAME</tag>
      <description>The OLDNAME extended data item describes the old mailbox name for the mailbox identified by the LIST response.</description>
      <return_option>none</return_option>
      <spec_ref>
        <xref type="rfc" data="rfc5465">RFC5465, Section 5.4</xref>
		<xref type="rfc" data="rfc9051"/>
	  </spec_ref>
      <security_ref>
        <xref type="text">none</xref>
      </security_ref>
      <intended_usage>COMMON</intended_usage>
      <contact>
        <xref type="person" data="Alexey_Melnikov"/>
      </contact>
      <owner>
        <xref type="person" data="IESG"/>
      </owner>
    </record>
  </registry>

  <people>
    <person id="Alexey_Melnikov">
      <name>Alexey Melnikov</name>
      <uri>mailto:Alexey.Melnikov&amp;isode.com</uri>
    </person>
    <person id="Kenneth_Murchison">
      <name>Kenneth Murchison</name>
      <uri>mailto:murch&amp;fastmailteam.com</uri>
      <updated>2018-08-15</updated>
    </person>
    <person id="IESG">
      <name>IESG</name>
      <uri>mailto:iesg&amp;ietf.org</uri>
    </person>
  </people>
</registry>
