| 1 |
.\" Copyright © 2015 Free Software Foundation, Inc. |
| 2 |
.\" License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. |
| 3 |
.\" |
| 4 |
.\" This is free software: you are free to change and redistribute it. |
| 5 |
.\" There is NO WARRANTY, to the extent permitted by law. |
| 6 |
.Dd February 9, 2019 |
| 7 |
.Dt ifconfig 1 URM |
| 8 |
.Os "GNU Network Utilities" |
| 9 |
.Sh NAME |
| 10 |
.Nm ifconfig |
| 11 |
.Nd configure network interfaces |
| 12 |
.Sh SYNOPSIS |
| 13 |
.Nm ifconfig |
| 14 |
.Op Ar option ... |
| 15 |
.Ar name |
| 16 |
.Op Ar addr |
| 17 |
.Op Cm broadcast Ar brdaddr |
| 18 |
.Op Cm { pointopoint | dstaddr } Ar dstaddr |
| 19 |
.Op Cm netmask Ar mask |
| 20 |
.Op Cm { ether | hwaddr | lladdr } Ar macaddr |
| 21 |
.Op Cm metric Ar n |
| 22 |
.Op Cm mtu Ar n |
| 23 |
.Op Cm txqueuelen Ar n |
| 24 |
.Op Cm up | down |
| 25 |
.Op Ar flags |
| 26 |
.Sh DESCRIPTION |
| 27 |
Configure network interfaces. |
| 28 |
.Pp |
| 29 |
Mandatory or optional arguments to long options are also mandatory or optional |
| 30 |
for any corresponding short options. |
| 31 |
.Pp |
| 32 |
Known flags are: |
| 33 |
.Cm allmulti , arp , automedia , broadcast , debug , dynamic , master , |
| 34 |
.Cm multicast , pointopoint , portsel , promisc , slave , trailers , up . |
| 35 |
Prepending |
| 36 |
.Cm no |
| 37 |
to any of these flags will negate their effect. |
| 38 |
.Sh OPTIONS |
| 39 |
.Bl -tag -width Ds |
| 40 |
.It Fl a , -all |
| 41 |
Display all available interfaces. |
| 42 |
.It Fl A , -address Ar addr |
| 43 |
Set the interface address to |
| 44 |
.Ar addr . |
| 45 |
.It Fl B , -broadcast Ar addr |
| 46 |
.It Fl b , -brdaddr Ar addr |
| 47 |
Set the broadcast address to |
| 48 |
.Ar addr . |
| 49 |
.It Fl d , -dstaddr Ar addr |
| 50 |
.It Fl p , -peer Ar addr |
| 51 |
Set the destination (peer) address to |
| 52 |
.Ar addr . |
| 53 |
.It Fl -up |
| 54 |
Activate the interface (default if address is given). |
| 55 |
.It Fl -down |
| 56 |
Shut the interface down. |
| 57 |
.It Fl F , -flags Ar flag , Ns Op Ar flag ... |
| 58 |
Set the interface flags. |
| 59 |
.It Fl i , -interface Ar name |
| 60 |
Configure the network interface |
| 61 |
.Ar name . |
| 62 |
.It Fl l , -list |
| 63 |
List the available or selected interfaces. |
| 64 |
.It Fl m , -netmask Ar mask |
| 65 |
Set the netmask to |
| 66 |
.Ar mask . |
| 67 |
.It Fl -metric Ar n |
| 68 |
Set the interface metric to |
| 69 |
.Ar n . |
| 70 |
.It Fl M , -mtu Ar n |
| 71 |
Set the interface MTU to |
| 72 |
.Ar n . |
| 73 |
.It Fl -format Ar format |
| 74 |
Select the output format; set to |
| 75 |
.Cm help |
| 76 |
for information. |
| 77 |
.It Fl s , -short |
| 78 |
Short output format. |
| 79 |
.It Fl v , -verbose |
| 80 |
Output information when configuring the interface. |
| 81 |
.It Fl ? , -help |
| 82 |
Give this help list. |
| 83 |
.It Fl -usage |
| 84 |
Give a short usage message. |
| 85 |
.It Fl V , -version |
| 86 |
Print program version. |
| 87 |
.El |
| 88 |
.Pp |
| 89 |
Linux\-specific options: |
| 90 |
.Bl -tag -width Ds |
| 91 |
.It Fl T , -txqlen Ar n |
| 92 |
Set the transmit queue length to |
| 93 |
.Ar n . |
| 94 |
.El |