[gentoo-commits] proj/netifrc:master commit in: doc/

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     5766357baea67cc679c39b558d7e745669817442
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Mon Aug 26 22:04:08 2013 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Mon Aug 26 22:04:08 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/netifrc.git;a=commit;h=5766357b

Avoid brokeness.

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

---
 doc/Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/Makefile b/doc/Makefile
index d311273..32f0fa9 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,5 +1,4 @@
 DIR=	${DOCDIR}/netifrc
-CONF= README
 SRCS=	net.example.in
 INC=	net.example
 

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     f144b97303313f913cee7e91f11648066a61c619
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Wed Aug 28 16:45:57 2013 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Wed Aug 28 16:45:57 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/netifrc.git;a=commit;h=f144b973

bonding: update example

Document per Kernel bonding.txt that some parameters are mutually
exclusive, eg miimon & arp_*.

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>
X-Gentoo-Bug: 468964

---
 doc/net.example.Linux.in | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index e838f28..ddfe5e0 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -651,7 +651,9 @@
 # You can also configure the parameters of the bond here, which must be done
 # via sysfs on 2.6 kernels or newer. The description of all the options can be
 # found in the kernel: /usr/src/linux-*/Documentation/networking/bonding.txt
-# You will probably want the 'mode' option at the least.
+# You will probably want the 'mode' option at the least. Please beware that
+# some options are mutually exclusive, eg miimon & arp_*; again, see the kernel
+# documentation for more info.
 # Some possible parameters: mode fail_over_mac arp_validate arp_interval
 # arp_ip_target downdelay updelay lacp_rate ad_select xmit_hash_policy
 # num_grat_arp num_unsol_na miimon primary primary_reselect use_carrier

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     bfaf7aac630894f0384b6e4c83c6517e915cd14b
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Sun Nov  8 14:33:40 2015 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Sun Nov  8 14:33:40 2015 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=bfaf7aac

hsr: Missed $iface in variable names.

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.Linux.in | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 6059301..f65c03d 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -162,9 +162,9 @@
 #
 # HSR: High-availability Seamless Redundancy
 #type_hsr0=hsr
-#hsr_slave1=eth0
-#hsr_slave2=eth1
-#hsr_supervision=99 # Byte value
+#hsr_slave1_hsr0=eth0
+#hsr_slave2_hsr0=eth1
+#hsr_supervision_hsr0=99 # Byte value
 
 #-----------------------------------------------------------------------------
 # WIRELESS (802.11 support)

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     08789e3964d8d577b76e91d016f0fb3e4554b392
Author:     Alon Bar-Lev <alon.barlev <AT> gmail <DOT> com>
AuthorDate: Sat Oct 15 21:12:57 2016 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Mon Oct 17 19:21:05 2016 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=08789e39

doc: bridge: add explicit iproute2 hint

Signed-off-by: Alon Bar-Lev <alon.barlev <AT> gmail.com>

 doc/net.example.Linux.in | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 72608bb..e6cc180 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -896,7 +896,8 @@
 
 #-----------------------------------------------------------------------------
 # Bridging (802.1d)
-# For bridging support emerge net-misc/bridge-utils
+# Preferred: iproute2, emerge sys-apps/iproute2
+# Legacy: brctl, emerge net-misc/bridge-utils
 
 # To add ports to bridge br0
 #bridge_br0="eth0 eth1"
@@ -931,7 +932,7 @@
 #sethello 2
 #stp on"
 
-# You can also configure the bridge or bridge members via sysfs on 2.6 kernels
+# You can configure the bridge or bridge members via sysfs on 2.6 kernels
 # or newer. See the kernel bridge documentation for a description of these
 # options.
 #bridge_stp_state_br0="0"

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     1665c1214e1f45127f69150a1c083f3dc66eb24b
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Mon Oct 24 22:12:45 2016 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Mon Oct 24 22:12:45 2016 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=1665c121

doc: resolvconf-gentoo is now openresolv.

X-Gentoo-Bug: 507346
X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=507346
Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.BSD.in   | 4 ++--
 doc/net.example.Linux.in | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/net.example.BSD.in b/doc/net.example.BSD.in
index d3bd15b..1df32e0 100644
--- a/doc/net.example.BSD.in
+++ b/doc/net.example.BSD.in
@@ -367,8 +367,8 @@
 # will be listed in /etc/resolv.conf even if there were any there to start
 # with.
 # If this is an issue for you then maybe you should look into a resolv.conf
-# manager like resolvconf-gentoo to manage this file for you. All packages
-# that baselayout supports use resolvconf-gentoo if installed.
+# manager like net-dns/openresolv to manage this file for you. All packages
+# that baselayout supports use net-dns/openresolv if installed.
 
 #-----------------------------------------------------------------------------
 # Cable in/out detection

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index e6cc180..c895a17 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -1096,8 +1096,8 @@
 # will be listed in /etc/resolv.conf even if there were any there to start
 # with.
 # If this is an issue for you then maybe you should look into a resolv.conf
-# manager like resolvconf-gentoo to manage this file for you. All packages
-# that baselayout supports use resolvconf-gentoo if installed.
+# manager like net-dns/openresolv to manage this file for you. All packages
+# that baselayout supports use net-dns/openresolv if installed.
 
 #-----------------------------------------------------------------------------
 # Cable in/out detection

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     60714158b4536d1e5694ec8a45e2cfac56202027
Author:     Sergey Popov <admin <AT> pinkbyte <DOT> ru>
AuthorDate: Tue Jan 24 13:46:18 2017 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Tue Jan 24 13:46:18 2017 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=60714158

Add examples for using iproute2 link command

 doc/net.example.Linux.in | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index c895a17..cf8439d 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -966,6 +966,12 @@
 # For IPIP tunnels
 #iptunnel_vpn0="mode ipip remote 207.170.82.2 ttl 255"
 
+# For GRETAP tunnels (works only with sys-apps/iproute2)
+#iplink_vpn0="type gretap remote 207.170.82.3 ttl 255"
+
+# For VXLAN tunnels (works only with sys-apps/iproute2)
+#iplink_vpn0="type vxlan id 1 group 207.170.82.4 local 207.170.82.100 dstport 4789 dev eth0"
+
 # To configure the interface
 #config_vpn0="192.168.0.2 pointopoint 192.168.1.2"	# ifconfig style
 #config_vpn0="192.168.0.2 peer 192.168.1.1"		# iproute2 style

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     1ff764f73dbab2d5df934c1073e9f6e99f7ddf5d
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Thu Jul 12 06:24:12 2018 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Thu Jul 12 06:24:48 2018 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=1ff764f7

doc: usage example for wireguard

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.Linux.in | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 6a57e43..c0cfd38 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -1214,6 +1214,15 @@
 # interfaces, you can do this here.
 #firewalld_zone_eth0="myzone"
 
+#-----------------------------------------------------------------------------
+# Wireguard support
+#
+# Wireguard can be configured either by passing a config file
+#wireguard_wg0="/path/to/file.conf"
+#
+# Wireguard can also be configured by passing explicit settings
+#wireguard_wg0="private-key /path/to/whatever listen-port 1234 peer ABCDEF= endpoint 1.2.3.4:2468"
+
 ##############################################################################
 # ADVANCED CONFIGURATION
 #

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     869d41ee7501ab6a2832c6e8cf232eb4b5060d93
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Sun May 31 05:23:37 2020 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Sun May 31 05:23:37 2020 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=869d41ee

doc: Document bridge_forward_delay/bridge_hello_time

Closes: https://bugs.gentoo.org/721148
Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.Linux.in | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 8896acf..c211ca7 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -943,6 +943,7 @@
 # Bridging (802.1d)
 # Preferred: iproute2, emerge sys-apps/iproute2
 # Legacy: brctl, emerge net-misc/bridge-utils
+# # See https://wiki.gentoo.org/wiki/Network_bridge#OpenRC for further notes
 
 # To add ports to bridge br0
 #bridge_br0="eth0 eth1"
@@ -984,6 +985,15 @@
 #bridge_forward_delay_br0="10"
 #brport_hairpin_mode_eth0="1"
 
+# It is important to include bridge_forward_delay_br0=0 and
+# bridge_hello_time_br0=1000 in the /etc/conf.d/net file in order to bring the
+# bridge interface up quickly. Other values will cause network packets to be
+# dropped for the first 30 seconds after the bridge has become active. This, in
+# turn, could prevent DHCP from working as intended.
+#bridge_forward_delay_br0=0
+#bridge_hello_time_br0=1000
+
+
 #-----------------------------------------------------------------------------
 # RFC 2684 Bridge Support
 # For RFC 2684 bridge support emerge net-misc/br2684ctl

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     51a7c4fae619a05b8f179f5f03b3e8a556df7205
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Tue Jun  2 21:35:31 2020 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Tue Jun  2 21:35:31 2020 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=51a7c4fa

doc/net.example.Linux: document !wireless better

Users that used layer2 wireless configuration external to netifrc and
had previously configured netifrc with:
`modules="!iwconfig !wpa_supplicant"`
were surprised by the introduction of the iw & iwd modules, because the
modules tries to auto-configure the wireless interfaces.

Document that `modules="!wireless"` is a better configuration knob for
this situation.

Bug: https://bugs.gentoo.org/717226
Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.Linux.in | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 53d9e84..4fc603b 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -43,8 +43,20 @@
 # You can also specify which modules not to use - for example you may be
 # using a supplicant or linux-wlan-ng to control wireless configuration but
 # you still want to configure network settings per SSID associated with.
-#modules="!iwconfig !wpa_supplicant"
-# IMPORTANT: If you need the above, please disable modules in that order
+#
+# A common case here may be using hostapd or other external configuration of
+# the wireless hardware at layer 2, but leaving netifrc to configure the layer
+# 3 networking
+#
+# Best practice for this situation is to disable ALL netifrc wireless modules:
+#modules="!wireless"
+#
+# This supersedes older cases where each module was disabled seperately:
+# If new modules are introduced that provide wireless support, they may be used
+# automatically otherwise, causing situations like
+# https://bugs.gentoo.org/717226
+# Do not use a line like this anymore:
+#modules="!iwconfig !wpa_supplicant !iw !iwd"
 
 
 ##############################################################################
@@ -435,9 +447,8 @@
 # won't have associated then)
 
 # If you're using anything else to configure wireless on your interface AND
-# you have installed wpa_supplicant, you need to disable wpa_supplicant
-#modules="!iwconfig !wpa_supplicant"
-#or
+# you have installed wpa_supplicant, you need to disable wpa_supplicant.
+# Please see the note about hostapd in the MODULES section.
 #modules="!wireless"
 
 ##############################################################################

[gentoo-commits] proj/netifrc:master commit in: doc/

[Lars Wendler]

commit:     ebc70a9cead6790b0ef337dc0c3c1ea77d9164dd
Author:     Lars Wendler <polynomial-c <AT> gentoo <DOT> org>
AuthorDate: Mon Jan 18 14:30:07 2021 +0000
Commit:     Lars Wendler <polynomial-c <AT> gentoo <DOT> org>
CommitDate: Mon Jan 18 14:30:07 2021 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=ebc70a9c

doc/net.example.Linux.in: Document wpa_supplicant's dbus dependency

Signed-off-by: Lars Wendler <polynomial-c <AT> gentoo.org>

 doc/net.example.Linux.in | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index bafde42..2dc05c1 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -451,6 +451,10 @@
 # pre/post user functions below (although it's not available in preup as you
 # won't have associated then)
 
+# If wpa_supplicant has been compiled with dbus support, it is necessary to
+# make the corresponding interface depend on the dbus daemon:
+#rc_net_wlan0_need="dbus"
+
 # If you're using anything else to configure wireless on your interface AND
 # you have installed wpa_supplicant, you need to disable wpa_supplicant.
 # Please see the note about hostapd in the MODULES section.

[gentoo-commits] proj/netifrc:master commit in: doc/

[Lars Wendler]

commit:     407f763feb33955ddd4a2ef3219960270a8e43bf
Author:     Patrick McLean <chutzpah <AT> gentoo <DOT> org>
AuthorDate: Wed Nov 25 03:24:21 2020 +0000
Commit:     Lars Wendler <polynomial-c <AT> gentoo <DOT> org>
CommitDate: Thu Mar 11 16:53:33 2021 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=407f763f

net.example: Add example for network namespace support

Signed-off-by: Lars Wendler <polynomial-c <AT> gentoo.org>

 doc/net.example.Linux.in | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 2dc05c1..427b2da 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -1333,6 +1333,15 @@
 # Wireguard can also be configured by passing explicit settings
 #wireguard_wg0="private-key /path/to/whatever listen-port 1234 peer ABCDEF= endpoint 1.2.3.4:2468"
 
+# Network namespace support 
+# If an interface is configured with a network namespace, it will be moved
+# in to that namespace before being started. This does not have any functionality
+# to move interfaces out of network namespaces. The next time the interfaces is
+# started, it will simply start the interface inside the namespace.
+#
+# Note that not all functionality has been updated to work with network namespace
+#netns_eth0="mynetns"
+
 ##############################################################################
 # ADVANCED CONFIGURATION
 #

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     bcfa92b5e7c4c1f7455dac1e49f7cfab633544bf
Author:     Maciej S. Szmigiero <mail <AT> maciej <DOT> szmigiero <DOT> name>
AuthorDate: Sat Mar 27 22:29:02 2021 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Sat Mar 27 22:29:02 2021 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=bcfa92b5

doc/net.example.Linux: fix typo in "ethtool_coalesce_eth0" description

Signed-off-by: Maciej S. Szmigiero <mail <AT> maciej.szmigiero.name>

 doc/net.example.Linux.in | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 427b2da..3bd2ee1 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -1275,7 +1275,7 @@
 #ethtool_pause_eth0="autoneg off
 #rx on tx on"
 
-# Enasble adaptive RX and TX coalescing
+# Enable adaptive RX and TX coalescing
 #ethtool_coalesce_eth0="adaptive-rx on adaptive-tx on"
 
 # Change ring buffer settings

[gentoo-commits] proj/netifrc:master commit in: doc/

[Robin H. Johnson]

commit:     a6c76fb426877a1dc516a81c2278aa94da2a9604
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Wed Apr 19 17:11:12 2023 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Wed Apr 19 17:14:04 2023 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=a6c76fb4

doc/net.example.Linux.in: add hsr examples

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 doc/net.example.Linux.in | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index e59ce52..42b8071 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -193,6 +193,8 @@
 #hsr_slave1_hsr0=eth0
 #hsr_slave2_hsr0=eth1
 #hsr_supervision_hsr0=99 # Byte value
+#hsr_version_hsr0=1 # 0=2010 spec, 1=2012 spec
+#hsr_proto_hsr0=1 # 0=HSR standard, 1=Parallel Redundancy Protocol (PRP)
 
 #-----------------------------------------------------------------------------
 # WIRELESS (802.11 support)

[gentoo-commits] proj/netifrc:master commit in: doc/

[Patrick McLean]

commit:     d01b0a6b187d8909ad11b328c557ecdc29431d04
Author:     Andrey Volkov <volkov.am <AT> ekb-info <DOT> ru>
AuthorDate: Tue Sep 28 14:21:58 2021 +0000
Commit:     Patrick McLean <chutzpah <AT> gentoo <DOT> org>
CommitDate: Fri May 24 05:51:59 2024 +0000
URL:        https://gitweb.gentoo.org/proj/netifrc.git/commit/?id=d01b0a6b

Append wireguard docs at net.example with arbitrary interface name example

Signed-off-by: Andrey Volkov <volkov <AT> ekb-info.ru>

 doc/net.example.Linux.in | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/net.example.Linux.in b/doc/net.example.Linux.in
index 84e4b1c..143dc9d 100644
--- a/doc/net.example.Linux.in
+++ b/doc/net.example.Linux.in
@@ -1350,6 +1350,10 @@
 #
 # Wireguard can also be configured by passing explicit settings
 #wireguard_wg0="private-key /path/to/whatever listen-port 1234 peer ABCDEF= endpoint 1.2.3.4:2468"
+#
+# You must specify wireguard interface type to use arbitrary interface names
+#wireguard_site1="/path/to/site1.conf"
+#type_site1="wireguard"
 
 # Network namespace support 
 # If an interface is configured with a network namespace, it will be moved