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