blob: be794258a69631528f028c09e33239643946cf15 [file] [log] [blame]
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Accepts inbound HTTP/2 streams on a connection."><meta name="keywords" content="rust, rustlang, rust-lang, Connection"><title>Connection in h2::server - Rust</title><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Regular.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../FiraSans-Medium.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Regular.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceSerif4-Bold.ttf.woff2"><link rel="preload" as="font" type="font/woff2" crossorigin href="../../SourceCodePro-Semibold.ttf.woff2"><link rel="stylesheet" href="../../normalize.css"><link rel="stylesheet" href="../../rustdoc.css" id="mainThemeStyle"><link rel="stylesheet" href="../../ayu.css" disabled><link rel="stylesheet" href="../../dark.css" disabled><link rel="stylesheet" href="../../light.css" id="themeStyle"><script id="default-settings" ></script><script src="../../storage.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../main.js"></script><noscript><link rel="stylesheet" href="../../noscript.css"></noscript><link rel="alternate icon" type="image/png" href="../../favicon-16x16.png"><link rel="alternate icon" type="image/png" href="../../favicon-32x32.png"><link rel="icon" type="image/svg+xml" href="../../favicon.svg"></head><body class="rustdoc struct"><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><nav class="mobile-topbar"><button class="sidebar-menu-toggle">&#9776;</button><a class="sidebar-logo" href="../../h2/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2></h2></nav><nav class="sidebar"><a class="sidebar-logo" href="../../h2/index.html"><div class="logo-container"><img class="rust-logo" src="../../rust-logo.svg" alt="logo"></div></a><h2 class="location"><a href="#">Connection</a></h2><div class="sidebar-elems"><section><h3><a href="#implementations">Methods</a></h3><ul class="block"><li><a href="#method.abrupt_shutdown">abrupt_shutdown</a></li><li><a href="#method.accept">accept</a></li><li><a href="#method.enable_connect_protocol">enable_connect_protocol</a></li><li><a href="#method.graceful_shutdown">graceful_shutdown</a></li><li><a href="#method.max_concurrent_recv_streams">max_concurrent_recv_streams</a></li><li><a href="#method.max_concurrent_send_streams">max_concurrent_send_streams</a></li><li><a href="#method.ping_pong">ping_pong</a></li><li><a href="#method.poll_closed">poll_closed</a></li><li><a href="#method.set_initial_window_size">set_initial_window_size</a></li><li><a href="#method.set_target_window_size">set_target_window_size</a></li></ul><h3><a href="#trait-implementations">Trait Implementations</a></h3><ul class="block"><li><a href="#impl-Debug-for-Connection%3CT%2C%20B%3E">Debug</a></li></ul><h3><a href="#synthetic-implementations">Auto Trait Implementations</a></h3><ul class="block"><li><a href="#impl-RefUnwindSafe-for-Connection%3CT%2C%20B%3E">!RefUnwindSafe</a></li><li><a href="#impl-Send-for-Connection%3CT%2C%20B%3E">Send</a></li><li><a href="#impl-Sync-for-Connection%3CT%2C%20B%3E">Sync</a></li><li><a href="#impl-Unpin-for-Connection%3CT%2C%20B%3E">Unpin</a></li><li><a href="#impl-UnwindSafe-for-Connection%3CT%2C%20B%3E">!UnwindSafe</a></li></ul><h3><a href="#blanket-implementations">Blanket Implementations</a></h3><ul class="block"><li><a href="#impl-Any-for-Connection%3CT%2C%20B%3E">Any</a></li><li><a href="#impl-Borrow%3CT%3E-for-Connection%3CT%2C%20B%3E">Borrow&lt;T&gt;</a></li><li><a href="#impl-BorrowMut%3CT%3E-for-Connection%3CT%2C%20B%3E">BorrowMut&lt;T&gt;</a></li><li><a href="#impl-From%3CT%3E-for-Connection%3CT%2C%20B%3E">From&lt;T&gt;</a></li><li><a href="#impl-Instrument-for-Connection%3CT%2C%20B%3E">Instrument</a></li><li><a href="#impl-Into%3CU%3E-for-Connection%3CT%2C%20B%3E">Into&lt;U&gt;</a></li><li><a href="#impl-TryFrom%3CU%3E-for-Connection%3CT%2C%20B%3E">TryFrom&lt;U&gt;</a></li><li><a href="#impl-TryInto%3CU%3E-for-Connection%3CT%2C%20B%3E">TryInto&lt;U&gt;</a></li><li><a href="#impl-WithSubscriber-for-Connection%3CT%2C%20B%3E">WithSubscriber</a></li></ul></section><h2><a href="index.html">In h2::server</a></h2></div></nav><main><div class="width-limiter"><nav class="sub"><form class="search-form"><div class="search-container"><span></span><input class="search-input" name="search" autocomplete="off" spellcheck="false" placeholder="Click or press ‘S’ to search, ‘?’ for more options…" type="search"><div id="help-button" title="help" tabindex="-1"><a href="../../help.html">?</a></div><div id="settings-menu" tabindex="-1"><a href="../../settings.html" title="settings"><img width="22" height="22" alt="Change settings" src="../../wheel.svg"></a></div></div></form></nav><section id="main-content" class="content"><div class="main-heading"><h1 class="fqn">Struct <a href="../index.html">h2</a>::<wbr><a href="index.html">server</a>::<wbr><a class="struct" href="#">Connection</a><button id="copy-path" onclick="copy_path(this)" title="Copy item path to clipboard"><img src="../../clipboard.svg" width="19" height="18" alt="Copy item path"></button></h1><span class="out-of-band"><a class="srclink" href="../../src/h2/server.rs.html#196-198">source</a> · <a id="toggle-all-docs" href="javascript:void(0)" title="collapse all docs">[<span class="inner">&#x2212;</span>]</a></span></div><div class="item-decl"><pre class="rust struct"><code>pub struct Connection&lt;T, B:&nbsp;<a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>&gt; { /* private fields */ }</code></pre></div><details class="rustdoc-toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Accepts inbound HTTP/2 streams on a connection.</p>
<p>A <code>Connection</code> is backed by an I/O resource (usually a TCP socket) and
implements the HTTP/2 server logic for that connection. It is responsible
for receiving inbound streams initiated by the client as well as driving the
internal state forward.</p>
<p><code>Connection</code> values are created by calling <a href="struct.Connection.html#method.handshake"><code>handshake</code></a>. Once a
<code>Connection</code> value is obtained, the caller must call <a href="struct.Connection.html#method.poll"><code>poll</code></a> or
<a href="struct.Connection.html#method.poll_close"><code>poll_close</code></a> in order to drive the internal connection state forward.</p>
<p>See <a href="index.html">module level</a> documentation for more details</p>
<h2 id="examples"><a href="#examples">Examples</a></h2>
<div class="example-wrap"><pre class="rust rust-example-rendered"><code><span class="kw">let </span><span class="kw-2">mut </span>server = server::handshake(my_io).<span class="kw">await</span>.unwrap();
<span class="kw">while let </span><span class="prelude-val">Some</span>(request) = server.accept().<span class="kw">await </span>{
tokio::spawn(<span class="kw">async move </span>{
<span class="kw">let </span>(request, respond) = request.unwrap();
<span class="comment">// Process the request and send the response back to the client
// using `respond`.
</span>});
}</code></pre></div>
</div></details><h2 id="implementations" class="small-section-header">Implementations<a href="#implementations" class="anchor"></a></h2><div id="implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#368-590">source</a><a href="#impl-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: <a class="trait" href="../../tokio/io/async_read/trait.AsyncRead.html" title="trait tokio::io::async_read::AsyncRead">AsyncRead</a> + <a class="trait" href="../../tokio/io/async_write/trait.AsyncWrite.html" title="trait tokio::io::async_write::AsyncWrite">AsyncWrite</a> + Unpin,<br>&nbsp;&nbsp;&nbsp;&nbsp;B: <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.accept" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#407-411">source</a><h4 class="code-header">pub async fn <a href="#method.accept" class="fnname">accept</a>(<br>&nbsp;&nbsp;&nbsp;&nbsp;&amp;mut self<br>) -&gt; Option&lt;Result&lt;(<a class="struct" href="../../http/request/struct.Request.html" title="struct http::request::Request">Request</a>&lt;<a class="struct" href="../struct.RecvStream.html" title="struct h2::RecvStream">RecvStream</a>&gt;, <a class="struct" href="struct.SendResponse.html" title="struct h2::server::SendResponse">SendResponse</a>&lt;B&gt;), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;&gt;</h4></section></summary><div class="docblock"><p>Accept the next incoming request on this connection.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.set_target_window_size" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#457-460">source</a><h4 class="code-header">pub fn <a href="#method.set_target_window_size" class="fnname">set_target_window_size</a>(&amp;mut self, size: u32)</h4></section></summary><div class="docblock"><p>Sets the target window size for the whole connection.</p>
<p>If <code>size</code> is greater than the current value, then a <code>WINDOW_UPDATE</code>
frame will be immediately sent to the remote, increasing the connection
level window by <code>size - current_value</code>.</p>
<p>If <code>size</code> is less than the current value, nothing will happen
immediately. However, as window capacity is released by
<a href="../struct.FlowControl.html"><code>FlowControl</code></a> instances, no <code>WINDOW_UPDATE</code> frames will be sent
out until the number of “in flight” bytes drops below <code>size</code>.</p>
<p>The default value is 65,535.</p>
<p>See <a href="../struct.FlowControl.html"><code>FlowControl</code></a> documentation for more details.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.set_initial_window_size" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#475-479">source</a><h4 class="code-header">pub fn <a href="#method.set_initial_window_size" class="fnname">set_initial_window_size</a>(&amp;mut self, size: u32) -&gt; Result&lt;(), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;</h4></section></summary><div class="docblock"><p>Set a new <code>INITIAL_WINDOW_SIZE</code> setting (in octets) for stream-level
flow control for received data.</p>
<p>The <code>SETTINGS</code> will be sent to the remote, and only applied once the
remote acknowledges the change.</p>
<p>This can be used to increase or decrease the window size for existing
streams.</p>
<h5 id="errors"><a href="#errors">Errors</a></h5>
<p>Returns an error if a previous call is still pending acknowledgement
from the remote endpoint.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.enable_connect_protocol" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#489-492">source</a><h4 class="code-header">pub fn <a href="#method.enable_connect_protocol" class="fnname">enable_connect_protocol</a>(&amp;mut self) -&gt; Result&lt;(), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;</h4></section></summary><div class="docblock"><p>Enables the <a href="https://datatracker.ietf.org/doc/html/rfc8441#section-4">extended CONNECT protocol</a>.</p>
<h5 id="errors-1"><a href="#errors-1">Errors</a></h5>
<p>Returns an error if a previous call is still pending acknowledgement
from the remote endpoint.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.poll_closed" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#507-509">source</a><h4 class="code-header">pub fn <a href="#method.poll_closed" class="fnname">poll_closed</a>(&amp;mut self, cx: &amp;mut Context&lt;'_&gt;) -&gt; Poll&lt;Result&lt;(), <a class="struct" href="../struct.Error.html" title="struct h2::Error">Error</a>&gt;&gt;</h4></section></summary><div class="docblock"><p>Returns <code>Ready</code> when the underlying connection has closed.</p>
<p>If any new inbound streams are received during a call to <code>poll_closed</code>,
they will be queued and returned on the next call to <a href="struct.Connection.html#method.poll_accept"><code>poll_accept</code></a>.</p>
<p>This function will advance the internal connection state, driving
progress on all the other handles (e.g. <a href="../struct.RecvStream.html"><code>RecvStream</code></a> and <a href="../struct.SendStream.html"><code>SendStream</code></a>).</p>
<p>See <a href="index.html#managing-the-connection">here</a> for more details.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.abrupt_shutdown" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#529-531">source</a><h4 class="code-header">pub fn <a href="#method.abrupt_shutdown" class="fnname">abrupt_shutdown</a>(&amp;mut self, reason: <a class="struct" href="../struct.Reason.html" title="struct h2::Reason">Reason</a>)</h4></section></summary><div class="docblock"><p>Sets the connection to a GOAWAY state.</p>
<p>Does not terminate the connection. Must continue being polled to close
connection.</p>
<p>After flushing the GOAWAY frame, the connection is closed. Any
outstanding streams do not prevent the connection from closing. This
should usually be reserved for shutting down when something bad
external to <code>h2</code> has happened, and open streams cannot be properly
handled.</p>
<p>For graceful shutdowns, see <a href="struct.Connection.html#method.graceful_shutdown"><code>graceful_shutdown</code></a>.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.graceful_shutdown" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#543-545">source</a><h4 class="code-header">pub fn <a href="#method.graceful_shutdown" class="fnname">graceful_shutdown</a>(&amp;mut self)</h4></section></summary><div class="docblock"><p>Starts a <a href="http://httpwg.org/specs/rfc7540.html#GOAWAY">graceful shutdown</a> process.</p>
<p>Must continue being polled to close connection.</p>
<p>It’s possible to receive more requests after calling this method, since
they might have been in-flight from the client already. After about
1 RTT, no new requests should be accepted. Once all active streams
have completed, the connection is closed.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.ping_pong" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#552-554">source</a><h4 class="code-header">pub fn <a href="#method.ping_pong" class="fnname">ping_pong</a>(&amp;mut self) -&gt; Option&lt;<a class="struct" href="../struct.PingPong.html" title="struct h2::PingPong">PingPong</a>&gt;</h4></section></summary><div class="docblock"><p>Takes a <code>PingPong</code> instance from the connection.</p>
<h5 id="note"><a href="#note">Note</a></h5>
<p>This may only be called once. Calling multiple times will return <code>None</code>.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.max_concurrent_send_streams" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#565-567">source</a><h4 class="code-header">pub fn <a href="#method.max_concurrent_send_streams" class="fnname">max_concurrent_send_streams</a>(&amp;self) -&gt; usize</h4></section></summary><div class="docblock"><p>Returns the maximum number of concurrent streams that may be initiated
by the server on this connection.</p>
<p>This limit is configured by the client peer by sending the
<a href="https://tools.ietf.org/html/rfc7540#section-5.1.2"><code>SETTINGS_MAX_CONCURRENT_STREAMS</code> parameter</a> in a <code>SETTINGS</code> frame.
This method returns the currently acknowledged value received from the
remote.</p>
</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.max_concurrent_recv_streams" class="method has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#580-582">source</a><h4 class="code-header">pub fn <a href="#method.max_concurrent_recv_streams" class="fnname">max_concurrent_recv_streams</a>(&amp;self) -&gt; usize</h4></section></summary><div class="docblock"><p>Returns the maximum number of concurrent streams that may be initiated
by the client on this connection.</p>
<p>This returns the value of the <a href="https://tools.ietf.org/html/rfc7540#section-5.1.2"><code>SETTINGS_MAX_CONCURRENT_STREAMS</code>
parameter</a> sent in a <code>SETTINGS</code> frame that has been
acknowledged by the remote peer. The value to be sent is configured by
the <a href="../struct.Builder.html#method.max_concurrent_streams"><code>Builder::max_concurrent_streams</code></a> method before handshaking
with the remote peer.</p>
</div></details></div></details></div><h2 id="trait-implementations" class="small-section-header">Trait Implementations<a href="#trait-implementations" class="anchor"></a></h2><div id="trait-implementations-list"><details class="rustdoc-toggle implementors-toggle" open><summary><section id="impl-Debug-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#605-615">source</a><a href="#impl-Debug-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; Debug for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Debug,<br>&nbsp;&nbsp;&nbsp;&nbsp;B: Debug + <a class="trait" href="../../bytes/buf/buf_impl/trait.Buf.html" title="trait bytes::buf::buf_impl::Buf">Buf</a>,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.fmt" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/h2/server.rs.html#610-614">source</a><a href="#method.fmt" class="anchor"></a><h4 class="code-header">fn <a class="fnname">fmt</a>(&amp;self, fmt: &amp;mut Formatter&lt;'_&gt;) -&gt; Result</h4></section></summary><div class='docblock'>Formats the value using the given formatter. <a>Read more</a></div></details></div></details></div><h2 id="synthetic-implementations" class="small-section-header">Auto Trait Implementations<a href="#synthetic-implementations" class="anchor"></a></h2><div id="synthetic-implementations-list"><section id="impl-RefUnwindSafe-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-RefUnwindSafe-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; !RefUnwindSafe for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;</h3></section><section id="impl-Send-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Send-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; Send for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: Send,<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Send,</span></h3></section><section id="impl-Sync-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Sync-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; Sync for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;B: Send + Sync,<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Sync,</span></h3></section><section id="impl-Unpin-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Unpin-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; Unpin for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: Unpin,</span></h3></section><section id="impl-UnwindSafe-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-UnwindSafe-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, B&gt; !UnwindSafe for <a class="struct" href="struct.Connection.html" title="struct h2::server::Connection">Connection</a>&lt;T, B&gt;</h3></section></div><h2 id="blanket-implementations" class="small-section-header">Blanket Implementations<a href="#blanket-implementations" class="anchor"></a></h2><div id="blanket-implementations-list"><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Any-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Any-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Any for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: 'static + ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.type_id" class="method trait-impl has-srclink"><a href="#method.type_id" class="anchor"></a><h4 class="code-header">fn <a class="fnname">type_id</a>(&amp;self) -&gt; TypeId</h4></section></summary><div class='docblock'>Gets the <code>TypeId</code> of <code>self</code>. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Borrow%3CT%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Borrow%3CT%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; Borrow&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow</a>(&amp;self) -&gt; &amp;T</h4></section></summary><div class='docblock'>Immutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-BorrowMut%3CT%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-BorrowMut%3CT%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; BorrowMut&lt;T&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;T: ?Sized,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.borrow_mut" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/91522" title="Tracking issue for const_borrow">unstable</a></span><a href="#method.borrow_mut" class="anchor"></a><h4 class="code-header">fn <a class="fnname">borrow_mut</a>(&amp;mut self) -&gt; &amp;mut T</h4></section></summary><div class='docblock'>Mutably borrows from an owned value. <a>Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-From%3CT%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-From%3CT%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; From&lt;T&gt; for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">from</a>(t: T) -&gt; T</h4></section></summary><div class="docblock"><p>Returns the argument unchanged.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Instrument-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#276">source</a><a href="#impl-Instrument-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="../../tracing/instrument/trait.Instrument.html" title="trait tracing::instrument::Instrument">Instrument</a> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.instrument" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#82">source</a><a href="#method.instrument" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.instrument" class="fnname">instrument</a>(self, span: <a class="struct" href="../../tracing/span/struct.Span.html" title="struct tracing::span::Span">Span</a>) -&gt; <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Instruments this type with the provided <a href="../../tracing/span/struct.Span.html" title="Span"><code>Span</code></a>, returning an
<code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.instrument">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.in_current_span" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#121">source</a><a href="#method.in_current_span" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span" class="fnname">in_current_span</a>(self) -&gt; <a class="struct" href="../../tracing/instrument/struct.Instrumented.html" title="struct tracing::instrument::Instrumented">Instrumented</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Instruments this type with the <a href="../../tracing/span/struct.Span.html#method.current">current</a> <a href="../../tracing/span/struct.Span.html"><code>Span</code></a>, returning an
<code>Instrumented</code> wrapper. <a href="../../tracing/instrument/trait.Instrument.html#method.in_current_span">Read more</a></div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-Into%3CU%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-Into%3CU%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; Into&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: From&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">into</a>(self) -&gt; U</h4></section></summary><div class="docblock"><p>Calls <code>U::from(self)</code>.</p>
<p>That is, this conversion is whatever the implementation of
<code>[From]&lt;T&gt; for U</code> chooses to do.</p>
</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryFrom%3CU%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-TryFrom%3CU%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryFrom&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: Into&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error-1" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error-1" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = Infallible</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_from" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_from" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_from</a>(value: U) -&gt; Result&lt;T, &lt;T as TryFrom&lt;U&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-TryInto%3CU%3E-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a href="#impl-TryInto%3CU%3E-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T, U&gt; TryInto&lt;U&gt; for T<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;U: TryFrom&lt;T&gt;,</span></h3></section></summary><div class="impl-items"><details class="rustdoc-toggle" open><summary><section id="associatedtype.Error" class="associatedtype trait-impl has-srclink"><a href="#associatedtype.Error" class="anchor"></a><h4 class="code-header">type <a class="associatedtype">Error</a> = &lt;U as TryFrom&lt;T&gt;&gt;::Error</h4></section></summary><div class='docblock'>The type returned in the event of a conversion error.</div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.try_into" class="method trait-impl has-srclink"><span class="since rightside" title="const unstable">const: <a href="https://github.com/rust-lang/rust/issues/88674" title="Tracking issue for const_convert">unstable</a></span><a href="#method.try_into" class="anchor"></a><h4 class="code-header">fn <a class="fnname">try_into</a>(self) -&gt; Result&lt;U, &lt;U as TryFrom&lt;T&gt;&gt;::Error&gt;</h4></section></summary><div class='docblock'>Performs the conversion.</div></details></div></details><details class="rustdoc-toggle implementors-toggle"><summary><section id="impl-WithSubscriber-for-Connection%3CT%2C%20B%3E" class="impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#334">source</a><a href="#impl-WithSubscriber-for-Connection%3CT%2C%20B%3E" class="anchor"></a><h3 class="code-header">impl&lt;T&gt; <a class="trait" href="../../tracing/instrument/trait.WithSubscriber.html" title="trait tracing::instrument::WithSubscriber">WithSubscriber</a> for T</h3></section></summary><div class="impl-items"><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#169-171">source</a><a href="#method.with_subscriber" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber" class="fnname">with_subscriber</a>&lt;S&gt;(self, subscriber: S) -&gt; <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a>&lt;Self&gt;<span class="where fmt-newline">where<br>&nbsp;&nbsp;&nbsp;&nbsp;S: Into&lt;<a class="struct" href="../../tracing_core/dispatcher/struct.Dispatch.html" title="struct tracing_core::dispatcher::Dispatch">Dispatch</a>&gt;,</span></h4></section></summary><div class='docblock'>Attaches the provided <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_subscriber">Read more</a></div></details><details class="rustdoc-toggle method-toggle" open><summary><section id="method.with_current_subscriber" class="method trait-impl has-srclink"><a class="srclink rightside" href="../../src/tracing/instrument.rs.html#221">source</a><a href="#method.with_current_subscriber" class="anchor"></a><h4 class="code-header">fn <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber" class="fnname">with_current_subscriber</a>(self) -&gt; <a class="struct" href="../../tracing/instrument/struct.WithDispatch.html" title="struct tracing::instrument::WithDispatch">WithDispatch</a>&lt;Self&gt;</h4></section></summary><div class='docblock'>Attaches the current <a href="../../tracing/dispatcher/index.html#setting-the-default-subscriber">default</a> <a href="../../tracing_core/subscriber/trait.Subscriber.html"><code>Subscriber</code></a> to this type, returning a
<a href="../../tracing/instrument/struct.WithDispatch.html" title="WithDispatch"><code>WithDispatch</code></a> wrapper. <a href="../../tracing/instrument/trait.WithSubscriber.html#method.with_current_subscriber">Read more</a></div></details></div></details></div></section></div></main><div id="rustdoc-vars" data-root-path="../../" data-current-crate="h2" data-themes="ayu,dark,light" data-resource-suffix="" data-rustdoc-version="1.66.0-nightly (5c8bff74b 2022-10-21)" ></div></body></html>