From nobody Fri Oct 11 22:11:27 2024 X-Original-To: dev-commits-src-branches@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 4XQLSJ1knYz5ZV9p; Fri, 11 Oct 2024 22:11:28 +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 4XQLSH6pSZz4V6h; Fri, 11 Oct 2024 22:11:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1728684688; 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=YfS/fiQVHQdy6WnNxQ3nauZykpSt0YMKa3uGpNA3Hko=; b=JYRMZv4yNHOETafzxFLvnWgQp5F0TkA8Z+9pBxfsRIpEb7WyxTPl9JWTdhwIF6nfiBRXGX 27rMkjRn039NhuGbE9Yl7HrbNvIp9v2AP9soxO4qOB36GfNGJaAORu3WKDmp8MDvUrthJs mV7IKDn9y0fRW2CRfE7pA6/k3fqHzCbFkZLruU54WEwpFiYGA46/Ta5Vmm25HeEOchQEca vPNtFHZ4cXsuKICLBz6XwIyHwe10nagm+OgjYeZk8aVMC3rl+wY//x5J/VTTtghTvrQJB8 y9vj5Y7UDK+i2qC/sfyIDT5zFmeW5gkToPPeEvlbqTHmgAZ+4zwL3cGDDlqjBA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1728684688; 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=YfS/fiQVHQdy6WnNxQ3nauZykpSt0YMKa3uGpNA3Hko=; b=nC/1Jl7tlX2Is5LPN0qwb4+WgoHqTk96V9Vu+rGnXP9RuUKnjIdzmUH2n1QZq0m6aVf2qI 6jOZeYaAUB9FmYuK7jlgGV6zzasW7u/JlGXRTzHtMyovb8m2JipLPFVMfJiDwTpu4SNahE n51ONHPMSSM4SSvhVNln4qoVnNgaeGHpETji3Kvln/Si01lLspXDBhafswD/ckm/Hbiifn Zv9WbZ3wyuFO+ZWDHs/j8zfjm2npAnfiqisb0fs0TVfAbGsgvs77Be+7zQcCue93koCnUX MS1axNACIkHGfwKoAcFQzsX8Kvrw47gYZZLbr6GqrdG9dO7cm8sce78+EOe3FA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1728684688; a=rsa-sha256; cv=none; b=fS7OyNJ9n2BHBfrWqi6VS6jhbiE7aCShbUqNsYFeOyocSdmTOgE6zgYsZjHODXan7TEhpq 5DhaorrUCH4k4rCgQD61n1vPIvmzeTkHzm30cndQshg/GgAq68t9kp0m+NJvPankRWkB/a MTu/Q16n75QCgYSyqAwrW82gmQrp9j+57JhXokg5KbmvkFJpI/O8fPZjs8XqjW/ddM2Hn2 CFp5LNLmEJA3wjrmSY0GSJjsXsi3EJuJCXRXZuGG4KODVsW+sl3n0CixLpI0KEI5+CpL8i SixIsxRXfksqD9C/k7sFI0NPG7zY2Y+hd1AaULlK1E1rV3tV49kqD73dqQ2OBA== 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 4XQLSH56yCz105C; Fri, 11 Oct 2024 22:11:27 +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 49BMBRYr029007; Fri, 11 Oct 2024 22:11:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 49BMBRH8029004; Fri, 11 Oct 2024 22:11:27 GMT (envelope-from git) Date: Fri, 11 Oct 2024 22:11:27 GMT Message-Id: <202410112211.49BMBRH8029004@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Warner Losh Subject: git: 83a8160fe6f3 - stable/14 - jail.conf.5: cleanup introduction List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@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/stable/14 X-Git-Reftype: branch X-Git-Commit: 83a8160fe6f3d23b9b7cd8a97f92ee4a32f1aa9d Auto-Submitted: auto-generated The branch stable/14 has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=83a8160fe6f3d23b9b7cd8a97f92ee4a32f1aa9d commit 83a8160fe6f3d23b9b7cd8a97f92ee4a32f1aa9d Author: Ingo Schwarze AuthorDate: 2024-09-14 01:12:18 +0000 Commit: Warner Losh CommitDate: 2024-10-11 22:10:22 +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 (cherry picked from commit e36af20691d8922ecf416170a56d06aca62a0ccd) --- 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 dda2c0366dd1..1bce1535455a 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,