.. SPDX-License-Identifier: GPL-2.0

==========
TTY Buffer
==========

.. contents:: :local:

Here, we document functions for taking care of tty buffer and their flipping.
Drivers are supposed to fill the buffer by one of those functions below and
then flip the buffer, so that the data are passed to :doc:`line discipline
<tty_ldisc>` for further processing.

Flip Buffer Management
======================

.. kernel-doc:: drivers/tty/tty_buffer.c
   :identifiers: tty_prepare_flip_string tty_insert_flip_string_fixed_flag
           tty_insert_flip_string_flags __tty_insert_flip_char
           tty_flip_buffer_push tty_ldisc_receive_buf

----

Other Functions
===============

.. kernel-doc:: drivers/tty/tty_buffer.c
   :identifiers: tty_buffer_space_avail tty_buffer_set_limit

----

Buffer Locking
==============

These are used only in special circumstances. Avoid them.

.. kernel-doc:: drivers/tty/tty_buffer.c
   :identifiers: tty_buffer_lock_exclusive tty_buffer_unlock_exclusive

----

Internal Functions
==================

.. kernel-doc:: drivers/tty/tty_buffer.c
   :internal:
it this file 'description' to name the repository.</td><td class='sub right'>Russell King</td></tr></table>
<table class='tabs'><tr><td>
<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/'>summary</a><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/refs/?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>refs</a><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/log/include/net'>log</a><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/tree/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>tree</a><a class='active' href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>commit</a><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/diff/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>diff</a></td><td class='form'><form class='right' method='get' action='/cgit/git.armlinux.org.uk/linux-net-next.git/log/include/net'>
<input type='hidden' name='id' value='bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>root</a>/<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/include?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>include</a>/<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>net</a></div><div class='content'><div class='cgit-panel'><b>diff options</b><form method='get'><input type='hidden' name='id' value='bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'/><table><tr><td colspan='2'/></tr><tr><td class='label'>context:</td><td class='ctrl'><select name='context' onchange='this.form.submit();'><option value='1'>1</option><option value='2'>2</option><option value='3' selected='selected'>3</option><option value='4'>4</option><option value='5'>5</option><option value='6'>6</option><option value='7'>7</option><option value='8'>8</option><option value='9'>9</option><option value='10'>10</option><option value='15'>15</option><option value='20'>20</option><option value='25'>25</option><option value='30'>30</option><option value='35'>35</option><option value='40'>40</option></select></td></tr><tr><td class='label'>space:</td><td class='ctrl'><select name='ignorews' onchange='this.form.submit();'><option value='0' selected='selected'>include</option><option value='1'>ignore</option></select></td></tr><tr><td class='label'>mode:</td><td class='ctrl'><select name='dt' onchange='this.form.submit();'><option value='0' selected='selected'>unified</option><option value='1'>ssdiff</option><option value='2'>stat only</option></select></td></tr><tr><td/><td class='ctrl'><noscript><input type='submit' value='reload'/></noscript></td></tr></table></form></div><table summary='commit info' class='commit-info'>
<tr><th>author</th><td>Julian Wiedmann &lt;jwi@linux.ibm.com&gt;</td><td class='right'>2020-02-17 13:27:58 +0100</td></tr>
<tr><th>committer</th><td>David S. Miller &lt;davem@davemloft.net&gt;</td><td class='right'>2020-02-17 14:30:54 -0800</td></tr>
<tr><th>commit</th><td colspan='2' class='sha1'><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2</a> (<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/patch/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>patch</a>)</td></tr>
<tr><th>tree</th><td colspan='2' class='sha1'><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/tree/?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>ea4e9fd226dcaec59d14d0b17b6998982bdb69c3</a> /<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/tree/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>include/net</a></td></tr>
<tr><th>parent</th><td colspan='2' class='sha1'><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/commit/include/net?id=3e07df430c2b4ffe003085a0b3e6b0b041187632'>3e07df430c2b4ffe003085a0b3e6b0b041187632</a> (<a href='/cgit/git.armlinux.org.uk/linux-net-next.git/diff/include/net?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2&amp;id2=3e07df430c2b4ffe003085a0b3e6b0b041187632'>diff</a>)</td></tr></table>
<div class='commit-subject'>net: vlan: suppress "failed to kill vid" warnings</div><div class='commit-msg'>When a real dev unregisters, vlan_device_event() also unregisters all
of its vlan interfaces. For each VID this ends up in __vlan_vid_del(),
which attempts to remove the VID from the real dev's VLAN filter.

But the unregistering real dev might no longer be able to issue the
required IOs, and return an error. Subsequently we raise a noisy warning
msg that is not appropriate for this situation: the real dev is being
torn down anyway, there shouldn't be any worry about cleanly releasing
all of its HW-internal resources.

So to avoid scaring innocent users, suppress this warning when the
failed deletion happens on an unregistering device.
While at it also convert the raw pr_warn() to a more fitting
netdev_warn().

Signed-off-by: Julian Wiedmann &lt;jwi@linux.ibm.com&gt;
Signed-off-by: David S. Miller &lt;davem@davemloft.net&gt;
</div><div class='diffstat-header'><a href='/cgit/git.armlinux.org.uk/linux-net-next.git/diff/?id=bd706ff8ea2b6e2d3f21f0863b2fc42f860f8ba2'>Diffstat</a> (limited to 'include/net')</div><table summary='diffstat' class='diffstat'>