From nobody Sat May 28 18:07:37 2022 X-Original-To: doc@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 219871B48D09 for ; Sat, 28 May 2022 18:07:38 +0000 (UTC) (envelope-from bugzilla-noreply@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 4L9V555jzcz4RhH for ; Sat, 28 May 2022 18:07:37 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (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 A4A3813BFC for ; Sat, 28 May 2022 18:07:37 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 24SI7bFQ039880 for ; Sat, 28 May 2022 18:07:37 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 24SI7bRC039879 for doc@FreeBSD.org; Sat, 28 May 2022 18:07:37 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 264317] handbook/jails: Mounting devfs in a jail is explained only for readers installing from source Date: Sat, 28 May 2022 18:07:37 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: patch X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: bspiegel100@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status keywords bug_severity priority component assigned_to reporter attachments.created Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1653761257; 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=l/tNA8cFV1nK9JVhvpapPPvsfurQPMmCxBJ8LplKi8I=; b=eKYG2Y/Z8qi1Mc9Luyz0mrfp/OiLHh2oPO0EzHf9/q75EgfYBzNxTzk2BjxASs/l75c/K5 DAixfjF3jV6+Uk2ZwlA5FJeU/B6fF9oGFxnFBQwPyz9RQIRgAbIAdUwCIRDn4PpUYfln3E tkeivU+5GI8aHmG0njZoW7YJBti6zsX+vwWJ8dxAcSUNTkj3Y6r/a/U1mQ7nMErzFGko99 gmVKnWUxzw/ykVxIiml6/7V+DIC3Qy4QcCZliFXNM9lcA17HPCSO+E0SRWk4jSck/dTNd6 VYBfvTdFo0TUK94nbnV7GQvCqDT2exD4vxxoFhdUqNLPsmwmKn04itzKKBzOWQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1653761257; a=rsa-sha256; cv=none; b=tk63dS9NH8PAluKDHlGMuaRGovla7oBSZ/v3KpdQCr5wZdjBDCaqYA3xNXuIL6e7psVmg2 n5BqOWKyhisz2TI3ES8ViUAZE0buFZaWkGyFfQmAkt625NuFlcBM11YX9IB4gI8cgH/eXH +zK+jHqyi3uv1cRMhXSGBuLFfI5J7A1+gZoSFqA6ldJEX2UjGaTLicLnkJlXuMhBzWb/PB IQz7of8yzeUORl6xUtHOZrXNVJ29nC7EaxXmPjDfQhrk3AOEEDG5IXC7UXQ4ZYum7CnnDL gL2OMmCOb7avzjgAZUikYboNzUY2BjXrXKyvXYk0sr6oKCUaTZl3Pj5nXa8Vkg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D264317 Bug ID: 264317 Summary: handbook/jails: Mounting devfs in a jail is explained only for readers installing from source Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Keywords: patch Severity: Affects Some People Priority: --- Component: Documentation Assignee: doc@FreeBSD.org Reporter: bspiegel100@gmail.com Created attachment 234299 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D234299&action= =3Dedit patch with email headers and commit message In the Jails chapter of the handbook, the concept of mounting devfs in a ja= il is introduced under "To build and install a Jail from source." If a reader installs from the Internet or an ISO instead of from source, they might skip that section.=20 Then, the next section, "Configuring the Host," uses the devfs_ruleset and mount.devfs arguments. Readers skipped the section about installing from so= urce haven't learned these arguments yet. This issue tripped me up the first tim= e I read the chapter. Attached is a patch with the following changes: 1. Remove the mount.devfs line from "To build and install a Jail from sourc= e." As of FreeBSD 12.3, it's gone from the cited man page example, anyway. 2. Move the explanation for that line to "Configuring the Host," building on the idea of replicating a real FreeBSD system in the jail. 3. Update the explanation to mention that a reasonable default ruleset is u= sed if devfs_ruleset is not defined. There are a few other points I didn't address. For example, "doing nasty st= uff" is a little dubious, and the jail(8) man page has some other deltas with "To build and install a Jail from source." I'd be happy do some more work here= or in a separate patch if you think these are important to fix.=20 This is my first time submitting a patch here. I'm a bit confused about the best way to do so, so I've two copies, one with email headers and commit message and one as plain diff in a .txt file. Thanks for considering! --=20 You are receiving this mail because: You are the assignee for the bug.=