From nobody Tue Feb 27 00:02:59 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 4TkHkC4m1Yz5ByJP for ; Tue, 27 Feb 2024 00:02:59 +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 4TkHkC4Kqhz4d4s; Tue, 27 Feb 2024 00:02:59 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708992179; 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=NRI+uWbC35ExLJswltkcPeSt5To23EiRGyzZck/9o4A=; b=n19BsPsEvFz50Td/FRe3kL1NXGL0t0Jx+j27JRO9az4dxNB19pxOEH52Bo3xiZdb3f8PMA 1U8cHpIzKHL+zApYmnUmFpfuB888xGbR/5t0r4NkndPXvGtfe3zYnsPZPoqYTnyaIijwjf 2Jfa9CyGkleiIZu7jZkqUsj3yrHmx/pVzeDpjn33ycgJdqiDI6XgOuHZXb4O89bVqSr3mg /tHsWqvchxbrQ6eBEFun59ZGL1gTcvEJJavtPanN6zGyIOugPxuxNotMpzotFrVOvfGP3I rEr3g2ys70+cZbX34PbUMxM8560MpBXmyFa+Sc9powM654hYz0j+VOW839pRnA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1708992179; a=rsa-sha256; cv=none; b=EH3dExSKZEkeEjWn1G+gQ7ZQaBb5tw2o6Gu/tCPSBI/1Tokgxq0pe79m/21For+JUf5ncQ JGsfJHEDY6qqUI1u5N5FhJaTVM8AWDEODHccy9gcjoW6EzdAzyIqw1gXnM/RFVdndKg7Tt M6PARmv8/isrjReBQngHgP85MxgXftAUjwOZ2enqi605RCln9GupGHbEPqhscm8hbW9Hkz zO/GXcP560lpaBDCBTZLYtii4y2k9Ecv3hloChXsEG3F1UM8YkD8X2WzicsNOtDHhGD1Bg 7nMwAyXeimQ7Uwbccf+XSqs0GwqlNvNlal0MKsZZ/++Z+XVXnB651ZNIIVNcFg== 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=1708992179; 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=NRI+uWbC35ExLJswltkcPeSt5To23EiRGyzZck/9o4A=; b=qFeVxvg0VmvnItlBwfVxRH/NVtdWLyAXu54+Lfo2Gis2UoAwT9NkRvP/PQ82/0bT2EynZ+ qYLKtT+IL2RP/tNG6xUYbHSmoAD0J+VW6EOXY/fxGDRIDe4+7uUyJX2DgLDC7bcm9Pi9mU jLjAY/AKQNVrB3sg/xll4P28/x853LkKMbvhYo2O5CWTTjfJjM61onrXsl8VzBJV25wYVM /bU3nU+n2AXnrAaZaItv+up5QYUceiytALYlaf7be8FaCKQgjwWtKbN9pdjQLBifv0KISp +gLPJ+3a2bNIuOdnrE1n2Oq+F+X+E/actfyj5mJubjvBRh4h8Kz00Z0hnvKEQg== 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 4TkHkC3NdzzqFR; Tue, 27 Feb 2024 00:02:59 +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 41R02x4v098140; Tue, 27 Feb 2024 00:02:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 41R02xSP098137; Tue, 27 Feb 2024 00:02:59 GMT (envelope-from git) Date: Tue, 27 Feb 2024 00:02:59 GMT Message-Id: <202402270002.41R02xSP098137@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: df4729f3c0 - main - handbook/jails: Add clarification about jail configuration 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: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: df4729f3c0e9dcc0660c1ae81baeb40b1cb46566 Auto-Submitted: auto-generated The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=df4729f3c0e9dcc0660c1ae81baeb40b1cb46566 commit df4729f3c0e9dcc0660c1ae81baeb40b1cb46566 Author: Oliver Epper AuthorDate: 2024-02-07 16:38:11 +0000 Commit: Danilo G. Baio CommitDate: 2024-02-26 23:55:24 +0000 handbook/jails: Add clarification about jail configuration Reviewed by: Pau Amma (earlier version), dbaio Pull Request: https://github.com/freebsd/freebsd-doc/pull/336 --- documentation/content/en/books/handbook/jails/_index.adoc | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/documentation/content/en/books/handbook/jails/_index.adoc b/documentation/content/en/books/handbook/jails/_index.adoc index 7d928583b2..e6905fc162 100644 --- a/documentation/content/en/books/handbook/jails/_index.adoc +++ b/documentation/content/en/books/handbook/jails/_index.adoc @@ -250,11 +250,15 @@ There are two ways to configure jails. The first one is to add an entry for each jail to the file [.filename]#/etc/jail.conf#. The other option is to create a file for each jail in the directory [.filename]#/etc/jail.conf.d/#. -There is no right or wrong option. -Each administrator must choose the one that best suits their needs. - In case a host system has few jails, an entry for each jail can be added in the file [.filename]#/etc/jail.conf#. -If the host system has many jails, it is good idea to have one configuration file for each jail in the [.filename]#/etc/jail.conf.d/# directory. +If the host system has many jails, it is a good idea to have one configuration file for each jail in the [.filename]#/etc/jail.conf.d/# directory. + +The files in [.filename]#/etc/jail.conf.d/# must have `.conf` as their extension and have to be included in [.filename]#/etc/jail.conf#: + +[.programmlisting] +.... +.include "/etc/jail.conf.d/*.conf"; +.... A typical jail entry would look like this: