From owner-freebsd-doc@freebsd.org Wed May 27 01:07:10 2020 Return-Path: Delivered-To: freebsd-doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 592E62F9CA6 for ; Wed, 27 May 2020 01:07:10 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.nyi.freebsd.org (mailman.nyi.freebsd.org [IPv6:2610:1c1:1:606c::50:13]) by mx1.freebsd.org (Postfix) with ESMTP id 49Wt321gdNz4J1n for ; Wed, 27 May 2020 01:07:10 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.nyi.freebsd.org (Postfix) id 37A0B2F9CA5; Wed, 27 May 2020 01:07:10 +0000 (UTC) Delivered-To: doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 376592F9A5A for ; Wed, 27 May 2020 01:07:10 +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 "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 49Wt320mXCz4HqX for ; Wed, 27 May 2020 01:07:10 +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 1175FC723 for ; Wed, 27 May 2020 01:07:10 +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 04R179mc091605 for ; Wed, 27 May 2020 01:07:09 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 04R179tF091572 for doc@FreeBSD.org; Wed, 27 May 2020 01:07:09 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 246760] ZFS usermount sysrc command invalid Date: Wed, 27 May 2020 01:07:08 +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: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: mikeplemmons@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 bug_severity priority component assigned_to reporter 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 MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 May 2020 01:07:10 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D246760 Bug ID: 246760 Summary: ZFS usermount sysrc command invalid Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Documentation Assignee: doc@FreeBSD.org Reporter: mikeplemmons@gmail.com On https://www.freebsd.org/doc/handbook/zfs-zfs.html under heading 19.4.7.2. Sending Encrypted Backups over SSH the text says the following. "To mount the pool, the unprivileged user must own the directory, and regul= ar users must be allowed to mount file systems. On the receiving system: # sysctl vfs.usermount=3D1 vfs.usermount: 0 -> 1 # sysrc -f /etc/sysctl.conf vfs.usermount=3D1 # zfs create recvpool/backup # zfs allow -u someuser create,mount,receive recvpool/backup # chown someuser /recvpool/backup" When I type the following as using sudo on my 12.1-RELEASE-p2 system I get = an error. [mike@nas ~]$ sudo sysrc -f /etc/sysctl.conf vfs.usermount=3D1 sysrc: vfs.usermount: name contains characters not allowed in shell When I change to the root user I get the same error. [mike@nas ~]$ sudo -i root@nas:~ # sysrc -f /etc/sysctl.conf vfs.usermount=3D1 sysrc: vfs.usermount: name contains characters not allowed in shell It seems like the valid characters variable in /usr/share/bsdconfig/sysrc.s= ubr=20 is incorrect. VALID_VARNAME_CHARS=3D"0-9ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvw= xyz_" Should it include a period? Also, I believe the documentation should clarify when a user needs to run as root versus when to run as a non-root user. At least it seems like every command should be run as root but it is not clear. I had to manually edit the /etc/sysctl.conf file. --=20 You are receiving this mail because: You are the assignee for the bug.=