xref: /illumos-gate/usr/src/man/man9f/mac_tx_update.9f (revision 55a13001fbd9772352bc050632ef966a249dc73b)
1.\"
2.\" This file and its contents are supplied under the terms of the
3.\" Common Development and Distribution License ("CDDL"), version 1.0.
4.\" You may only use this file in accordance with the terms of version
5.\" 1.0 of the CDDL.
6.\"
7.\" A full copy of the text of the CDDL should have accompanied this
8.\" source.  A copy of the CDDL is also available via the Internet at
9.\" http://www.illumos.org/license/CDDL.
10.\"
11.\"
12.\" Copyright 2016 Joyent, Inc.
13.\"
14.Dd June 02, 2016
15.Dt MAC_TX_UPDATE 9F
16.Os
17.Sh NAME
18.Nm mac_tx_update
19.Nd indicate that a device can transmit again
20.Sh SYNOPSIS
21.In sys/mac_provider.h
22.Ft void
23.Fo mac_tx_update
24.Fa "mac_handle_t mh"
25.Fc
26.Sh INTERFACE LEVEL
27illumos DDI specific
28.Sh PARAMETERS
29.Bl -tag -width Fa
30.It Fa mh
31The MAC handle obtained from a call to
32.Xr mac_register 9F .
33.El
34.Sh DESCRIPTION
35The
36.Fn mac_tx_update
37function is used by device drivers to indicate that the device
38represented by the handle
39.Fa mh
40can transmit data again. It should only be called after the device
41driver has returned data from its
42.Xr mc_tx 9E
43endpoint. For more information on when this should be called, see both
44.Xr mc_tx 9E
45and the
46.Sx Transmitting Data and Back Pressure
47section of
48.Xr mac 9E .
49.Pp
50Device drivers should not hold any of their own locks when calling into
51this function. See the
52.Sx MAC Callbacks
53section of
54.Xr mac 9E
55for more information.
56.Sh CONTEXT
57The
58.Fn mac_tx_update
59function may be called from
60.Sy user ,
61.Sy kernel ,
62or
63.Sy interrupt
64context.
65.Sh SEE ALSO
66.Xr mac 9E ,
67.Xr mac_tx 9E ,
68.Xr mac_register 9F
69