From nobody Sat Sep 21 13:04:13 2024 X-Original-To: dev-commits-src-main@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 4X9qG61RJJz5WMY4; Sat, 21 Sep 2024 13:04:14 +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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4X9qG60v5cz44mr; Sat, 21 Sep 2024 13:04:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1726923854; 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=PbzZUiJGjNqBNd4DG6fg/DyKx3qIGh02Xgl86lNagCI=; b=ZtpE/wiCO0JRCM9tX3uqFrI/fw8atIMZOkJ67jdEpQw6+o1hwk/jiZvDTr2fxi/hWgl/7U dCqLa8d5mbXFZbeIlWuM0RSOgzLiBWboTAVIpiDbUC1lljF0rx3g2CeZ4n/L9hX7rTgDN6 AToenigX3796ZlChNTF3GoFYEiFr+9vMC6+H9RweDBYNwlOTSo+1pxTdV9l/o+9exPoCrh 905M8QZhcA6uC5dVGrkKrkP5vn7O2Yqk539SA9+y9rKs8Dv/p6hbBvvDUuAcEqxLfDaK6V s5q/ftTSus8VLhBcUbuvj645Rm4fbNeeBmGLJnib/sUx7jQLsg+q3c5z53EnSw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1726923854; a=rsa-sha256; cv=none; b=tYRLX1PnUfpc5+oSkkyZcFVUM0p4E3aaDQgkaGuQBJAjfPjhB917VeCGxK1lVbZLEgUtEf jvOsKoKvekNN/WO38r8ryPk5y6+dLa+jKmPYH6keajQFzzwKxETyX2B2c/fzr0vOXtBEVl 8JHwHNmsFzA1SAB5OwaCKdR8rasPGjDJOmjc+Z2Wgpk5piFS8LCp4ApX/IpxKGS0EToW9g JLCD5RwbaD2L378IDMRLnvTd5PWjDI+0iCwTrdWPSHQ+uxML1e09O5tqW0oi6NCp4Eyotr H6sh47WRngzbk6TScYQFEG+go1OTg6HEQ4mzzvL97f5Dxbe/gQezRdw1eDj0BQ== 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=1726923854; 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=PbzZUiJGjNqBNd4DG6fg/DyKx3qIGh02Xgl86lNagCI=; b=eLduUxBigZcsRXcuQBNzwahlDir9JRRqSj0cJONlMFeri4orjn4pzahsnyqHXtF2A1dMbQ 5/SZnvOe0++EHxn70swY5sqp2aVbYJPSgQEzEJFKT+Sxcs5ZcHQHoe+547rGMS6UoBtZIo nXRqfNfiB4oKWQ5feLxYA5X9MBSm2kWakOZWhMLaO/29IrroKH73i4A3/suW3GjB9Tl6cd rhyY9mgEyBtDk4srwDR6bhybUGHWPkmEvrzi9jbEdqFdco34Jh6ZRKxeQvYPWNm4RU6e08 z/lnxe09NNKjFZtg9fUjVc2kRtjVQ+/bBAJmryicbz1O9KHHVIiLZrXOX5ml2g== 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 4X9qG60Mq5zZmv; Sat, 21 Sep 2024 13:04:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 48LD4D25010248; Sat, 21 Sep 2024 13:04:13 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 48LD4Dht010245; Sat, 21 Sep 2024 13:04:13 GMT (envelope-from git) Date: Sat, 21 Sep 2024 13:04:13 GMT Message-Id: <202409211304.48LD4Dht010245@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: e36af20691d8 - main - jail.conf.5: cleanup introduction List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e36af20691d8922ecf416170a56d06aca62a0ccd Auto-Submitted: auto-generated The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=e36af20691d8922ecf416170a56d06aca62a0ccd commit e36af20691d8922ecf416170a56d06aca62a0ccd Author: Ingo Schwarze AuthorDate: 2024-09-14 01:12:18 +0000 Commit: Warner Losh CommitDate: 2024-09-21 13:03:21 +0000 jail.conf.5: cleanup introduction Suggested by ingo on mandoc-tech@ MFC after: 3 days Reviewed by: imp Pull Request: https://github.com/freebsd/freebsd-src/pull/1422 --- usr.sbin/jail/jail.conf.5 | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/usr.sbin/jail/jail.conf.5 b/usr.sbin/jail/jail.conf.5 index f2c1861cc304..627c38b0f8b6 100644 --- a/usr.sbin/jail/jail.conf.5 +++ b/usr.sbin/jail/jail.conf.5 @@ -30,29 +30,29 @@ .Os .Sh NAME .Nm jail.conf -.Nd configuration file for -.Xr jail 8 +.Nd configuration file for system jails .Sh DESCRIPTION -A +The +.Nm +file consists of one or more jail definitions statements for use by the .Xr jail 8 -configuration file consists of one or more jail definitions statements, -and parameter or variable statements within those jail definitions. -A jail definition statement looks something like a C compound statement. -A parameter statement looks like a C assignment, -including a terminating semicolon. +management program. +A jail definition statement consists of a single word, the name of the jail, +an opening curly brace, a list of at least two parameter assignments, +and a closing curly brace. +A parameter assignment consists of a single word, the parameter name, +an equals sign, a value enclosed in double quotes, and a terminating semicolon. .Pp -The general syntax of a jail definition is: -.Bd -literal -offset indent -jailname { - parameter = "value"; - parameter = "value"; - ... -} +The syntax of a jail definition is as follows: +.Bd -unfilled +. Ar jailname Cm \&{ +.Bd -unfilled -offset indent -compact +.Ar parameter Cm = Qq Ar value ; +\&... +.Ed +.Cm \&} .Ed .Pp -Each jail is required to have a -.Va name -at the front of its definition. This is used by .Xr jail 8 to specify a jail on the command line and report the jail status,