summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/edsc.4 3.html
blob: 1cbbba44d7c94142bd9b11cff42a7ab295e0f5b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
<table class="head">
  <tr>
    <td class="head-ltitle">EDSC(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">EDSC(4)</td>
  </tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">edsc</code> &#x2014; <span class="Nd">Ethernet
    discard network interface</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="Cd">device edsc</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">edsc</code> interface is a software discard
    mechanism which may be used for performance analysis and software testing.
    It imitates an Ethernet device, which allows for its use in conjunction with
    such drivers as <a class="Xr">if_bridge(4)</a> and
    <a class="Xr">vlan(4)</a>.</p>
<p class="Pp">As with other network interfaces, an <code class="Nm">edsc</code>
    interface must have network addresses assigned for each address family with
    which it is to be used. These addresses may be set or changed with the
    <code class="Dv">SIOCSIFADDR</code> <a class="Xr">ioctl(2)</a> or
    <a class="Xr">ifconfig(8)</a> utility.</p>
<p class="Pp">Each <code class="Nm">edsc</code> interface is created at runtime
    using interface cloning. This is most easily done with the
    <a class="Xr">ifconfig(8)</a> <code class="Cm">create</code> command or
    using the <var class="Va">cloned_interfaces</var> variable in
    <a class="Xr">rc.conf(5)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
  ALSO</a></h1>
<p class="Pp"><a class="Xr">ioctl(2)</a>, <a class="Xr">arp(4)</a>,
    <a class="Xr">if_bridge(4)</a>, <a class="Xr">inet(4)</a>,
    <a class="Xr">intro(4)</a>, <a class="Xr">vlan(4)</a>,
    <a class="Xr">rc.conf(5)</a>, <a class="Xr">arp(8)</a>,
    <a class="Xr">ifconfig(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <code class="Nm">edsc</code> device was derived from the
    <a class="Xr">disc(4)</a> device and first appeared in
    <span class="Ux">FreeBSD 6.3</span>. This manpage was adapted from
    <a class="Xr">disc(4)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
<p class="Pp">Since outgoing packets are just discarded by
    <code class="Nm">edsc</code>, ARP requests stay unreplied. Consequently, an
    IP packet cannot be sent via <code class="Nm">edsc</code> until a static
    <a class="Xr">arp(4)</a> entry is created for its next hop using
    <a class="Xr">arp(8)</a>.</p>
<p class="Pp">Initially an <code class="Nm">edsc</code> interface has a zero
    link level address. It can be changed with <a class="Xr">ifconfig(8)</a>
    <code class="Cm">lladdr</code> if needed.</p>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">March 25, 2007</td>
    <td class="foot-os">FreeBSD 15.0</td>
  </tr>
</table>