From nobody Fri Feb 23 14:25:25 2024 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4ThC3B0jVvz59qY1 for ; Fri, 23 Feb 2024 14:25:26 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4ThC3B0CPlz47DG; Fri, 23 Feb 2024 14:25:26 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708698326; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=REFDhPcZd4JgsKr5AvQv6ky3ueAktFgRG/0RqLUbRi4=; b=JejY12xzoX3ebeGCO90mHfyyMkAuyqlZdaUO1ItqqPoBxJJnjQeYIPizY7raGuzAgHG3YP BUgRvwcgiJeenCgf6g9aXwomHGdEq2sCxu1q3fk+7VF3F5eNaEPUOnFep4t80GN8WRiWtD pVoZOc1hDCnJVH1g3U4kKyZUYKPO7TDV16KDfKI5SqlOIzKiCsAltHZA/QN/RTo6UUHw06 vfumbvxxMfQpevhmR8D6Wjuny8GTmCwmndlPpvdYRv9Xi07EYuNv1rs5B+BJ6hOh0xvZuR 1SbEFZ0ZumiLqWON/bJjQf1tmf4b3N6RluL2DQBF084IioWk5DzGW92wry+ntw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1708698326; a=rsa-sha256; cv=none; b=WsqR8r2iSw7tg98aSrsenoEq1pbI7aqPoZFEQ5BkTPWolLu2MbgKJivwDfWx+6t4mOYyK3 T3udBV/f85UkNfdHyOgfyRzGa/pT9pwzsb7mPVbibxkoxrzdygA0XQgj05Ql8A0dz7oUT/ DTU4DYjlhQBqna7zLUbQku73hBhjBlcPHhD2piW+IQU5kbIwBivLP6/ZZT7wryOQJAxAxp RDincuRPC00J9v/rJCc0NMQRXnWKIchCinU2pbl74QwlYd2OWAnNqe0BMFN9G1vmZ1kxbQ pBptWFhxj07cuTZMSBNnCYHwRHFLLALgr/B9N0cEascbSBpEFXnYj2I5mtYe4w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708698326; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=REFDhPcZd4JgsKr5AvQv6ky3ueAktFgRG/0RqLUbRi4=; b=JhlVWchbD8ZcMj5iBSgu5/F6NNj3PBwZqKMSNXMDkcIeZxSqBmh/5hlugo3kXuEZd+gBbT feF805wnTB48CBTJazxi50a4Wz6YMotx4MOuuryeQ8SyxYSMzO9pk5kDHKhQcIKp7k/hc3 uoEv/yKCgNdABK8JlKSdqMkOTUpyf0lxkPsbh5+el7g8qBKzkspY0hYRpS1IiNIEnX0KxM 5jbf5tDcrnhqXrZWwcU1VzC5cKqaXaRs78TNOqkgfyx8HDFZAPB8zyVqsbdztFAHR9w1JC +zT9gywSqL40cFkoq8mDcLC1SEpw/FGx4XO82Pdo3vogsp7PWlib7gGPMYTlmA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4ThC396CN3zK9h; Fri, 23 Feb 2024 14:25:25 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 41NEPPdm056972; Fri, 23 Feb 2024 14:25:25 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 41NEPPbv056969; Fri, 23 Feb 2024 14:25:25 GMT (envelope-from git) Date: Fri, 23 Feb 2024 14:25:25 GMT Message-Id: <202402231425.41NEPPbv056969@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Joseph Mingrone Subject: git: c7ccb4f4e8 - main - Handbook/Advanced Networking: Add note about VLAN creation List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jrm X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c7ccb4f4e882d073f066b0ff10c61d1fa924972c Auto-Submitted: auto-generated The branch main has been updated by jrm: URL: https://cgit.FreeBSD.org/doc/commit/?id=c7ccb4f4e882d073f066b0ff10c61d1fa924972c commit c7ccb4f4e882d073f066b0ff10c61d1fa924972c Author: Chris Moerz AuthorDate: 2024-02-23 14:00:06 +0000 Commit: Joseph Mingrone CommitDate: 2024-02-23 14:25:09 +0000 Handbook/Advanced Networking: Add note about VLAN creation When adding a new VLAN, the parent interface must be up. Add notes to remind readers of this. PR: 270942 Reviewed by: jrm, leres Differential Revision: https://reviews.freebsd.org/D43993 --- .../books/handbook/advanced-networking/_index.adoc | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc index 1a6e239cf7..a1f861079b 100644 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -2406,6 +2406,17 @@ To configure VLANs at run time, with a NIC of `em0` and a VLAN tag of `5` the co See how the interface name includes the NIC driver name and the VLAN tag, separated by a period? This is a best practice to make maintaining the VLAN configuration easy when many VLANs are present on a machine. ==== +[NOTE] +==== +When defining VLANs, ensure that the parent network interface is also configured and enabled. +The minimum configuration for the above example would be: + +[source,shell] +.... +# ifconfig em0 up +.... +==== + To configure VLANs at boot time, [.filename]#/etc/rc.conf# must be updated. To duplicate the configuration above, the following will need to be added: @@ -2417,6 +2428,17 @@ ifconfig_em0_5="inet 192.168.20.20/24" Additional VLANs may be added, by simply adding the tag to the `vlans_em0` field and adding an additional line configuring the network on that VLAN tag's interface. +[NOTE] +==== +When defining VLANs in [.filename]#/etc/rc.conf#, make sure that the parent network interface is configured and enabled as well. +The minimum configuration for the above example would be: + +[.programlisting] +.... +ifconfig_em0="up" +.... +==== + It is useful to assign a symbolic name to an interface so that when the associated hardware is changed, only a few configuration variables need to be updated. For example, security cameras need to be run over VLAN 1 on `em0`. Later, if the `em0` card is replaced with a card that uses the man:ixgb[4] driver, all references to `em0.1` will not have to change to `ixgb0.1`.