xref: /dflybsd-src/share/man/man4/rgephy.4 (revision e7d8119802cadd0d12b4d4c91e6d7b43e9483782)
1*e7d81198SSascha Wildner.\"
2*e7d81198SSascha Wildner.\" Copyright (c) 2011 Marius Strobl <marius@FreeBSD.org>
3*e7d81198SSascha Wildner.\" All rights reserved.
4*e7d81198SSascha Wildner.\"
5*e7d81198SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
6*e7d81198SSascha Wildner.\" modification, are permitted provided that the following conditions
7*e7d81198SSascha Wildner.\" are met:
8*e7d81198SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
9*e7d81198SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
10*e7d81198SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
11*e7d81198SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in the
12*e7d81198SSascha Wildner.\"    documentation and/or other materials provided with the distribution.
13*e7d81198SSascha Wildner.\"
14*e7d81198SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15*e7d81198SSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16*e7d81198SSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17*e7d81198SSascha Wildner.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18*e7d81198SSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19*e7d81198SSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20*e7d81198SSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21*e7d81198SSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22*e7d81198SSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23*e7d81198SSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24*e7d81198SSascha Wildner.\" SUCH DAMAGE.
25*e7d81198SSascha Wildner.\"
26*e7d81198SSascha Wildner.\" $FreeBSD: head/share/man/man4/rgephy.4 217872 2011-01-26 06:07:24Z dougb $
27*e7d81198SSascha Wildner.\"
28*e7d81198SSascha Wildner.Dd November 18, 2014
29*e7d81198SSascha Wildner.Dt RGEPHY 4
30*e7d81198SSascha Wildner.Os
31*e7d81198SSascha Wildner.Sh NAME
32*e7d81198SSascha Wildner.Nm rgephy
33*e7d81198SSascha Wildner.Nd RealTek RTL8168/8169/8110/8211 series 10/100/1000 Gigabit Ethernet PHY driver
34*e7d81198SSascha Wildner.Sh SYNOPSIS
35*e7d81198SSascha WildnerTo compile all available PHY drivers into the kernel,
36*e7d81198SSascha Wildnerplace the following line in your kernel configuration file:
37*e7d81198SSascha Wildner.Bd -ragged -offset indent
38*e7d81198SSascha Wildner.Cd "device miibus"
39*e7d81198SSascha Wildner.Ed
40*e7d81198SSascha Wildner.\".Pp
41*e7d81198SSascha Wildner.\"Alternatively, to selectively compile this driver into the kernel,
42*e7d81198SSascha Wildner.\"place the following lines in your kernel configuration file instead:
43*e7d81198SSascha Wildner.\".Bd -ragged -offset indent
44*e7d81198SSascha Wildner.\".Cd "device mii"
45*e7d81198SSascha Wildner.\".Cd "device rgephy"
46*e7d81198SSascha Wildner.\".Ed
47*e7d81198SSascha Wildner.Sh DESCRIPTION
48*e7d81198SSascha WildnerThe
49*e7d81198SSascha Wildner.Nm
50*e7d81198SSascha Wildnerdriver supports the RealTek RTL8168, RTL8169, RTL8110 and RTL8211 series
51*e7d81198SSascha Wildnerintegrated 10/100/1000 Gigabit Ethernet PHYs.
52*e7d81198SSascha Wildner.Pp
53*e7d81198SSascha WildnerIn order to get a list of media types and options supported by a specific
54*e7d81198SSascha Wildnerinstance of the
55*e7d81198SSascha Wildner.Nm
56*e7d81198SSascha Wildnerdriver, run
57*e7d81198SSascha Wildner.Li ifconfig -m
58*e7d81198SSascha Wildneron the instance of its parent MAC driver.
59*e7d81198SSascha Wildner.\".Pp
60*e7d81198SSascha Wildner.\"Additionally,
61*e7d81198SSascha Wildner.\"the
62*e7d81198SSascha Wildner.\".Nm
63*e7d81198SSascha Wildner.\"driver supports the following special media option:
64*e7d81198SSascha Wildner.\".Bl -tag -width ".Cm flag0"
65*e7d81198SSascha Wildner.\".It Cm flag0
66*e7d81198SSascha Wildner.\"When manually setting media type and options via
67*e7d81198SSascha Wildner.\".Xr ifconfig 8 ,
68*e7d81198SSascha Wildner.\"the
69*e7d81198SSascha Wildner.\".Nm
70*e7d81198SSascha Wildner.\"driver by default also triggers an autonegotiation advertising the selected
71*e7d81198SSascha Wildner.\"media.
72*e7d81198SSascha Wildner.\"This is done in order to work around hardware issues in certain scenarios.
73*e7d81198SSascha Wildner.\"It is believed that this behavior does not cause harm in general but in fact
74*e7d81198SSascha Wildner.\"can have an adverse effect in edge cases.
75*e7d81198SSascha Wildner.\"In order to manually set the media type and options without also triggering
76*e7d81198SSascha Wildner.\"an autonegotiation,
77*e7d81198SSascha Wildner.\"the
78*e7d81198SSascha Wildner.\".Nm
79*e7d81198SSascha Wildner.\"driver allows to turn this behavior off via the
80*e7d81198SSascha Wildner.\".Cm flag0
81*e7d81198SSascha Wildner.\"media option.
82*e7d81198SSascha Wildner.\".El
83*e7d81198SSascha Wildner.\".Pp
84*e7d81198SSascha Wildner.\"Note that this special media option will not show up in the output of
85*e7d81198SSascha Wildner.\".Xr ifconfig 8 ,
86*e7d81198SSascha Wildner.\"even when set.
87*e7d81198SSascha Wildner.\".Sh EXAMPLES
88*e7d81198SSascha Wildner.\"Manually set 100BASE-TX full-duplex without also triggering an
89*e7d81198SSascha Wildner.\"autonegotiation:
90*e7d81198SSascha Wildner.\".Pp
91*e7d81198SSascha Wildner.\".Dl "ifconfig re0 media 100baseTX mediaopt full-duplex,flag0"
92*e7d81198SSascha Wildner.Sh SEE ALSO
93*e7d81198SSascha Wildner.Xr ifmedia 4 ,
94*e7d81198SSascha Wildner.Xr intro 4 ,
95*e7d81198SSascha Wildner.Xr miibus 4 ,
96*e7d81198SSascha Wildner.Xr ifconfig 8
97