summaryrefslogtreecommitdiff
path: root/sbin
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@cvs.openbsd.org>2017-05-12 15:11:03 +0000
committerIngo Schwarze <schwarze@cvs.openbsd.org>2017-05-12 15:11:03 +0000
commit9e14237085de5043c034d19c7c7ea470ca3d7e32 (patch)
tree8c638f11c1027c08e6c8a466c77a39882854e2a5 /sbin
parent4817542a48e4d50ff998258dc99a0a708132670f (diff)
Make the markup of negative parameters consistently use .Cm;
those are command modifiers, not flags. Inconsistency noticed and patch sent in by Anton dot Lindqvist at gmail dot com.
Diffstat (limited to 'sbin')
-rw-r--r--sbin/ifconfig/ifconfig.882
1 files changed, 41 insertions, 41 deletions
diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8
index 3392425d83e..3dc3d341a86 100644
--- a/sbin/ifconfig/ifconfig.8
+++ b/sbin/ifconfig/ifconfig.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ifconfig.8,v 1.281 2017/04/05 08:45:33 jmc Exp $
+.\" $OpenBSD: ifconfig.8,v 1.282 2017/05/12 15:11:02 schwarze Exp $
.\" $NetBSD: ifconfig.8,v 1.11 1996/01/04 21:27:29 pk Exp $
.\" $FreeBSD: ifconfig.8,v 1.16 1998/02/01 07:03:29 steve Exp $
.\"
@@ -31,7 +31,7 @@
.\"
.\" @(#)ifconfig.8 8.4 (Berkeley) 6/1/94
.\"
-.Dd $Mdocdate: April 5 2017 $
+.Dd $Mdocdate: May 12 2017 $
.Dt IFCONFIG 8
.Os
.Sh NAME
@@ -138,7 +138,7 @@ may be set with
Establish an additional network address for this interface.
This is sometimes useful when changing network numbers, and
one wishes to accept packets addressed to the old interface.
-.It Fl alias
+.It Cm -alias
A synonym for
.Cm delete .
Use of this option is discouraged in favour of
@@ -149,7 +149,7 @@ in mapping
between network level addresses and link level addresses (default).
This is currently implemented for mapping between
DARPA Internet addresses and Ethernet addresses.
-.It Fl arp
+.It Cm -arp
Disable the use of ARP.
.It Cm broadcast Ar addr
(inet only)
@@ -186,7 +186,7 @@ At least the following devices can be created on demand:
.It Cm debug
Enable driver-dependent debugging code; usually, this turns on
extra console error logging.
-.It Fl debug
+.It Cm -debug
Disable driver-dependent debugging code.
.It Cm delete
Remove the default inet address associated with the interface,
@@ -284,11 +284,11 @@ The device supports Wake on LAN (WoL).
.It Sy hardmtu
The maximum MTU supported.
.El
-.It Fl inet
+.It Cm -inet
Remove all configured
.Xr inet 4
addresses on the given interface.
-.It Fl inet6
+.It Cm -inet6
Disable
.Xr inet6 4
on the given interface and remove all configured
@@ -311,7 +311,7 @@ they are in general used to select special modes of operation.
An example
of this is to select the connector type for some Ethernet cards.
Refer to the man page for the specific driver for more information.
-.It Fl link[0-2]
+.It Cm -link[0-2]
Disable special processing at the link level with the specified interface.
.It Cm lladdr Ar etheraddr Ns | Ns Cm random
Change the link layer address (MAC address) of the interface.
@@ -358,7 +358,7 @@ or use the following command
for a listing of choices:
.Pp
.Dl $ ifconfig interface media
-.It Fl mediaopt Ar opts
+.It Cm -mediaopt Ar opts
Disable the specified media options on the interface.
.It Cm metric Ar nhops
Set the routing metric of the interface to
@@ -380,13 +380,13 @@ this directive is used to select between 802.11a
and 802.11n
.Pq Dq 11n
modes.
-.It Fl mode
+.It Cm -mode
Select the mode automatically.
This is the default for IEEE 802.11 wireless interfaces.
.It Cm mpls
Enable Multiprotocol Label Switching (MPLS) on the interface,
allowing it to send and receive MPLS traffic.
-.It Fl mpls
+.It Cm -mpls
Disable MPLS on the interface.
.It Cm mtu Ar value
Set the MTU for this device to the given
@@ -467,7 +467,7 @@ When enabled, reception of a WoL frame will cause the network card to
power up the system from standby or suspend mode.
WoL frames are sent using
.Xr arp 8 .
-.It Fl wol
+.It Cm -wol
Disable WoL.
WoL is disabled at boot by the driver, if possible.
.El
@@ -793,7 +793,7 @@ traffic can be protected using
.Xr ipsec 4
and it may be desired in networks that do not allow or have problems
with IPv4 multicast traffic.
-.It Fl carppeer
+.It Cm -carppeer
Send the advertisements to the default carp multicast
group.
.It Cm pass Ar passphrase
@@ -851,7 +851,7 @@ The following options are available for a wireless interface:
.Bl -tag -width Ds
.It Cm bssid Ar bssid
Set the desired BSSID.
-.It Fl bssid
+.It Cm -bssid
Unset the desired BSSID.
The interface will automatically select a BSSID in this mode, which is
the default.
@@ -861,7 +861,7 @@ Set the channel (radio frequency) to
.Pp
With no channel specified,
show the list of channels supported by the device.
-.It Fl chan
+.It Cm -chan
Unset the desired channel.
It doesn't affect the channel to be created for IBSS or Host AP mode.
.It Cm nwflag Ar flag
@@ -893,7 +893,7 @@ stations and can be easily discovered with tools like
.Xr tcpdump 8
and
.Xr hostapd 8 .
-.It Fl nwflag Ar flag
+.It Cm -nwflag Ar flag
Remove specified flag.
.It Cm nwid Ar id
Configure network ID.
@@ -904,7 +904,7 @@ or a series of hexadecimal digits up to 64 digits.
The empty string allows the interface to connect to any available
access points.
Note that network ID is synonymous with Extended Service Set ID (ESSID).
-.It Fl nwid
+.It Cm -nwid
Set the network ID to the empty string to allow the interface to connect
to any available access point.
.It Cm nwkey Ar key
@@ -937,7 +937,7 @@ or 10 hexadecimal digits)
or 104 bits for 128-bit encryption
(13-character ASCII string
or 26 hexadecimal digits).
-.It Fl nwkey
+.It Cm -nwkey
Disable WEP encryption.
.It Cm nwkey Cm persist
Enable WEP encryption using the persistent key stored in the network card.
@@ -950,7 +950,7 @@ enable WEP encryption using that
.It Cm powersave Op Ar duration
Enable 802.11 power saving mode.
Optionally set the receiver sleep duration (in milliseconds).
-.It Fl powersave
+.It Cm -powersave
Disable 802.11 power saving mode.
.It Cm scan
Show the results of an access point scan.
@@ -961,7 +961,7 @@ WPA is a Wi-Fi Alliance protocol based on the IEEE 802.11i standard.
It was designed to enhance the security of wireless networks.
Notice that not all drivers support WPA.
Check the driver's manual page to know if this option is supported.
-.It Fl wpa
+.It Cm -wpa
Disable Wi-Fi Protected Access.
.It Cm wpaakms Ar akm,akm,...
Set the comma-separated list of allowed authentication and key management
@@ -1041,7 +1041,7 @@ option must be set prior to specifying the
option, since
.Nm
will hash the nwid along with the passphrase to create the key.
-.It Fl wpakey
+.It Cm -wpakey
Delete the pre-shared WPA key and disable WPA.
.It Cm wpaprotos Ar proto,proto,...
Set the comma-separated list of allowed WPA protocol versions.
@@ -1084,7 +1084,7 @@ interface:
.Bl -tag -width Ds
.It Cm anycast
Set the IPv6 anycast address bit.
-.It Fl anycast
+.It Cm -anycast
Clear the IPv6 anycast address bit.
.It Cm autoconf
Enable stateless autoconfiguration (SLAAC),
@@ -1092,7 +1092,7 @@ automatically configuring IPv6 addresses.
In this mode,
router advertisements are accepted
and periodic router solicitations are sent.
-.It Fl autoconf
+.It Cm -autoconf
Disable autoconfiguration.
.It Cm autoconfprivacy
Enable privacy extensions for stateless IPv6 address autoconfiguration
@@ -1120,7 +1120,7 @@ Temporary addresses become invalid after one week, at which time they
will be removed from the interface.
Address lifetime extension through router advertisements is ignored
for temporary addresses.
-.It Fl autoconfprivacy
+.It Cm -autoconfprivacy
Disable IPv6 autoconf privacy extensions on the interface.
Currently configured addresses will not be removed until they become
invalid.
@@ -1132,7 +1132,7 @@ automatically.
Set preferred lifetime for the address.
.It Cm tentative
Set the IPv6 tentative address bit.
-.It Fl tentative
+.It Cm -tentative
Clear the IPv6 tentative address bit.
.It Cm vltime Ar n
Set valid lifetime for the address.
@@ -1160,7 +1160,7 @@ If
.Ar number
is omitted, it is increased by 1.
Demote count can be set up to 255.
-.It Fl carpdemote Op Ar number
+.It Cm -carpdemote Op Ar number
Decrease
.Xr carp 4
demote count for given interface group by
@@ -1255,7 +1255,7 @@ will be received by the second
.Ar interface ,
and vice versa.
This makes it possible to interconnect two routing domains locally.
-.It Fl patch
+.It Cm -patch
If configured, disconnect the interface pair.
.El
.Sh PFLOW
@@ -1283,14 +1283,14 @@ is the IP address and
.Ar port
is the port number of the flow collector.
Pflow data will be sent to this address/port.
-.It Fl flowdst
+.It Cm -flowdst
Unset the receiver address and stop sending pflow data.
.It Cm flowsrc Ar addr Ns Oo : Ns Ar port Oc
Set the source IP address for pflow packets.
.Ar addr
is the IP address used as sender of the UDP packets and may be used to
identify the source of the data on the pflow collector.
-.It Fl flowsrc
+.It Cm -flowsrc
Unset the source address.
.It Cm pflowproto Ar n
Set the protocol version.
@@ -1318,7 +1318,7 @@ acknowledged that the associated state has been inserted.
See
.Xr pfsync 4
for more information.
-.It Fl defer
+.It Cm -defer
Do not defer the first packet in a state.
This is the default.
.It Cm maxupd Ar n
@@ -1328,7 +1328,7 @@ This is an 8-bit number; the default value is 128.
.It Cm syncdev Ar iface
Use the specified interface
to send and receive pfsync state synchronisation messages.
-.It Fl syncdev
+.It Cm -syncdev
Stop sending pfsync state synchronisation messages over the network.
.It Cm syncpeer Ar peer_address
Make the pfsync link point-to-point rather than using
@@ -1339,7 +1339,7 @@ With this option,
.Xr pfsync 4
traffic can be protected using
.Xr ipsec 4 .
-.It Fl syncpeer
+.It Cm -syncpeer
Broadcast the packets using multicast.
.El
.Sh PPPOE
@@ -1375,14 +1375,14 @@ interface:
.Bl -tag -width Ds
.It Cm pppoeac Ar access-concentrator
Set the name of the access-concentrator.
-.It Fl pppoeac
+.It Cm -pppoeac
Clear a previously set access-concentrator name.
.It Cm pppoedev Ar parent-interface
Set the name of the interface through which
packets will be transmitted and received.
.It Cm pppoesvc Ar service
Set the service name of the interface.
-.It Fl pppoesvc
+.It Cm -pppoesvc
Clear a previously set service name.
.El
.Sh SPPP (PPP LINK CONTROL PROTOCOL)
@@ -1437,7 +1437,7 @@ flag is only meaningful with the CHAP protocol to not re-challenge
once the initial CHAP handshake has been successful.
This is used to work around broken peer implementations that can't
grok being re-challenged once the connection is up.
-.It Fl peerflag Ar flag
+.It Cm -peerflag Ar flag
Remove a specified PPP flag for the remote authenticator.
.It Cm peerkey Ar key
Set the authenticator key or password for the PPP authentication protocol.
@@ -1513,7 +1513,7 @@ interface:
Add
.Ar child-iface
as a trunk port.
-.It Fl trunkport Ar child-iface
+.It Cm -trunkport Ar child-iface
Remove the trunk port
.Ar child-iface .
.It Cm trunkproto Ar proto
@@ -1560,7 +1560,7 @@ down.
The minimal usable
.Ar count
is 2 since the round-trip time of keepalive packets needs to be accounted for.
-.It Fl keepalive
+.It Cm -keepalive
Disable the
.Xr gre 4
keepalive mechanism.
@@ -1619,7 +1619,7 @@ interface:
.Bl -tag -width Ds
.It Cm apn Ar apn
Set the Access Point Name (APN) required by the network provider.
-.It Fl apn
+.It Cm -apn
Clear the current APN.
.It Cm chgpin Ar oldpin Ar newpin
Permanently change the PIN of the SIM card from the current value
@@ -1637,7 +1637,7 @@ the following aliases can be used:
.Ar 3G ,
and
.Ar 2G .
-.It Fl class
+.It Cm -class
Clear any cell class preferences.
.It Cm down
Marking the interface as "down" will terminate any existing data connection
@@ -1654,7 +1654,7 @@ using the PUK
to validate the request.
.It Cm roaming
Enable data roaming.
-.It Fl roaming
+.It Cm -roaming
Disable data roaming.
.It Cm up
As soon as the interface is marked as "up", the
@@ -1702,7 +1702,7 @@ are not set at the same time, the vlan tag will be inferred from
the interface name, for instance
.Cm vlan5
will be assigned 802.1Q tag 5.
-.It Fl vlandev
+.It Cm -vlandev
Disassociate from the parent interface.
This breaks the link between the vlan interface and its parent,
clears its vlan tag, flags, and link address, and shuts the interface down.