From nobody@FreeBSD.org  Tue Feb  1 06:35:29 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 718BE16A4CE
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  1 Feb 2005 06:35:29 +0000 (GMT)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 34D3143D1D
	for <freebsd-gnats-submit@FreeBSD.org>; Tue,  1 Feb 2005 06:35:29 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j116ZSeD000591
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 1 Feb 2005 06:35:28 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j116ZSSP000590;
	Tue, 1 Feb 2005 06:35:28 GMT
	(envelope-from nobody)
Message-Id: <200502010635.j116ZSSP000590@www.freebsd.org>
Date: Tue, 1 Feb 2005 06:35:28 GMT
From: David Adam <zanchey@ucc.gu.uwa.edu.au>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [PATCH] FAQ: Mounting as users: Cleanup and move to 5.X
X-Send-Pr-Version: www-2.3

>Number:         76942
>Category:       docs
>Synopsis:       [PATCH] FAQ: Mounting as users: Cleanup and move to 5.X
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    jcamou
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 01 06:40:04 GMT 2005
>Closed-Date:    Thu Mar 10 09:11:13 GMT 2005
>Last-Modified:  Thu Mar 10 09:11:13 GMT 2005
>Originator:     David Adam
>Release:        FreeBSD 5-STABLE
>Organization:
University Computer Club, UWA
>Environment:
Linux mermaid 2.4.24-grsec-uccextras #1 Sat Feb 21 01:16:29 WST 2004 i586 unknown

>Description:
As mentioned in http://lists.freebsd.org/pipermail/freebsd-doc/2005-January/007012.html, the FAQ does not deal with allowing ordinary users to mount disks on FreeBSD versions > 4.
>How-To-Repeat:
Examine the FAQ entry currently numbered 9.22, with an id of user-floppymount.
>Fix:
Patch pasted below, also available at http://zanchey.ucc.asn.au/freebsd/faq.book.sgml.patch

--- faq.book.sgml.orig  2005-02-01 13:10:22.000000000 +0800
+++ faq.book.sgml       2005-02-01 14:10:37.000000000 +0800
@@ -6174,17 +6174,21 @@

       <qandaentry>
         <question id="user-floppymount">
-          <para>How do I let ordinary users mount floppies, CDROMs and
+          <para>How do I let ordinary users mount floppies, CD-ROMs and
             other removable media?</para>
         </question>

         <answer>
           <para>Ordinary users can be permitted to mount devices. Here is
             how:</para>
+
+         <note>On &os; 4.X and below, you should replace the device <filename>
+           /dev/acd0</filename> with <filename>/dev/cd0c</filename> in the examples
+           below.</note>

           <procedure>
             <step>
-              <para>As <username>root</username> set the sysctl variable
+              <para>As <username>root</username>, set the sysctl variable
                 <varname>vfs.usermount</varname> to
                 <literal>1</literal>.</para>

@@ -6202,13 +6206,36 @@
               <screen>&prompt.root; <userinput>chmod 666 /dev/fd0</userinput></screen>

               <para>To allow users in the group
-                <groupname>operator</groupname> to mount the CDROM drive,
+                <groupname>operator</groupname> to mount the CD-ROM drive,
                 use:</para>

-              <screen>&prompt.root; <userinput>chgrp operator /dev/cd0c</userinput>
-&prompt.root; <userinput>chmod 640 /dev/cd0c</userinput></screen>
+              <screen>&prompt.root; <userinput>chgrp operator /dev/acd0</userinput>
+&prompt.root; <userinput>chmod 640 /dev/acd0</userinput></screen>
+
             </step>

+           <step>
+             <para>You will need to alter your &man.devfs.conf.5; to make these
+               changes permanent across reboots.</para>
+
+             <note>This step does not apply to &os; 4.X and below.</note>
+
+             <para>As <username>root</username>, add the relevant lines to
+               <filename>/etc/devfs.conf</filename>. For example, to allow users
+               to mount the first floppy drive, add:</para>
+
+             <programlisting># Allow all users to mount the floppy disk.
+own     /dev/fd0        root:operator
+perm    /dev/fd0        0666</programlisting>
+
+             <para>To allow users in the group <groupname>operator</groupname
+              to mount the CD-ROM drive, add:</para>
+
+            <programlisting># Allow members of the group operator to mount CD-ROMs.
+own     /dev/acd0       root:operator
+perm    /dev/acd0       0660
+           </step>
+
             <step>
               <para>Finally, add the line
                 <literal><varname>vfs.usermount</varname>=1</literal>
@@ -6225,21 +6252,21 @@
 &prompt.user; <userinput>mount -t msdos /dev/fd0 ~/my-mount-point</userinput></screen>

           <para>Users in group <groupname>operator</groupname> can now
-            mount the CDROM <devicename>/dev/cd0c</devicename> onto a
+            mount the CD-ROM <devicename>/dev/acd0</devicename> onto a
             directory that they own:</para>

           <screen>&prompt.user; <userinput>mkdir ~/my-mount-point</userinput>
-&prompt.user; <userinput>mount -t cd9660 /dev/cd0c ~/my-mount-point</userinput></screen>
+&prompt.user; <userinput>mount -t cd9660 /dev/acd0 ~/my-mount-point</userinput></screen>

           <para>Unmounting the device is simple:</para>

           <screen>&prompt.user; <userinput>umount ~/my-mount-point</userinput></screen>

-          <para>Enabling <varname>vfs.usermount</varname>, however,
+          <note>Enabling <varname>vfs.usermount</varname>,
             has negative security implications.  A better way to
             access &ms-dos; formatted media is to use the
             <filename role="package">emulators/mtools</filename>
-            package in the ports collection.</para>
+            package in the ports collection.</note>
         </answer>
       </qandaentry>

>Release-Note:
>Audit-Trail:

Adding to audit trail from misfiled PR 77285:

Date: Tue, 8 Feb 2005 17:25:52 -0700
From: "Jesus R. Camou" <jcamou@COX.net>

 Actually, CDROM is how the docproj applies the term.  Do
 you want to resubmit a corrected patch?
 
 -- 
 Jesus R. Camou <jcamou@COX.net>
 jcamou@es.FreeBSD.org

From: David Adam <zanchey@ucc.gu.uwa.edu.au>
To: freebsd-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/76942: [PATCH] FAQ: Mounting as users: Cleanup and move to
 5.X
Date: Wed, 2 Feb 2005 15:07:02 +0800 (WST)

   This message is in MIME format.  The first part should be readable text,
   while the remaining parts are likely unreadable without MIME-aware tools.
   Send mail to mime@docserver.cac.washington.edu for more info.
 
 --1602359821-333100574-1107328022=:9059
 Content-Type: TEXT/PLAIN; charset=US-ASCII
 
 As per discussion with Lowell Gilbert on freebsd-doc@, I have updated the
 patch to take into account IDE CD-ROM users on 4.X and minor grammar
 cleanup.
 
 It should also be noted that both the original and updated patch contain
 several minor grammar and terminological fixes (s/CDROM/CD-ROM being the
 obvious one).
 
 New patch is attached.
 
 David Adam
 zanchey@ucc.gu.uwa.edu.au
 
 --1602359821-333100574-1107328022=:9059
 Content-Type: TEXT/PLAIN; charset=US-ASCII; name="faq.book.sgml.patch"
 Content-Transfer-Encoding: BASE64
 Content-ID: <Pine.LNX.4.58.0502021507020.9059@mussel.ucc.gu.uwa.edu.au>
 Content-Description: faq.book.sgml.patch
 Content-Disposition: attachment; filename="faq.book.sgml.patch"
 
 LS0tIGZhcS5ib29rLnNnbWwub3JpZwkyMDA1LTAyLTAxIDEzOjEwOjIyLjAw
 MDAwMDAwMCArMDgwMA0KKysrIGZhcS5ib29rLnNnbWwJMjAwNS0wMi0wMiAx
 MDo0MzowOC4wMDAwMDAwMDAgKzA4MDANCkBAIC02MTc0LDE3ICs2MTc0LDIx
 IEBADQogDQogICAgICAgPHFhbmRhZW50cnk+DQogICAgICAgICA8cXVlc3Rp
 b24gaWQ9InVzZXItZmxvcHB5bW91bnQiPg0KLSAgICAgICAgICA8cGFyYT5I
 b3cgZG8gSSBsZXQgb3JkaW5hcnkgdXNlcnMgbW91bnQgZmxvcHBpZXMsIENE
 Uk9NcyBhbmQNCisgICAgICAgICAgPHBhcmE+SG93IGRvIEkgbGV0IG9yZGlu
 YXJ5IHVzZXJzIG1vdW50IGZsb3BwaWVzLCBDRC1ST01zIGFuZA0KICAgICAg
 ICAgICAgIG90aGVyIHJlbW92YWJsZSBtZWRpYT88L3BhcmE+DQogICAgICAg
 ICA8L3F1ZXN0aW9uPg0KIA0KICAgICAgICAgPGFuc3dlcj4NCiAgICAgICAg
 ICAgPHBhcmE+T3JkaW5hcnkgdXNlcnMgY2FuIGJlIHBlcm1pdHRlZCB0byBt
 b3VudCBkZXZpY2VzLiBIZXJlIGlzDQogICAgICAgICAgICAgaG93OjwvcGFy
 YT4NCisJICAgIA0KKwkgIDxub3RlPk9uICZvczsgNC5YIGFuZCBiZWxvdywg
 eW91IHNob3VsZCByZXBsYWNlIHRoZSBkZXZpY2UgPGZpbGVuYW1lPg0KKwkg
 ICAgL2Rldi9hY2QwPC9maWxlbmFtZT4gd2l0aCA8ZmlsZW5hbWU+L2Rldi9h
 Y2QwYzwvZmlsZW5hbWU+IGluIHRoZSBleGFtcGxlcw0KKwkgICAgYmVsb3cu
 PC9ub3RlPg0KIA0KICAgICAgICAgICA8cHJvY2VkdXJlPg0KICAgICAgICAg
 ICAgIDxzdGVwPg0KLSAgICAgICAgICAgICAgPHBhcmE+QXMgPHVzZXJuYW1l
 PnJvb3Q8L3VzZXJuYW1lPiBzZXQgdGhlIHN5c2N0bCB2YXJpYWJsZQ0KKyAg
 ICAgICAgICAgICAgPHBhcmE+QXMgPHVzZXJuYW1lPnJvb3Q8L3VzZXJuYW1l
 Piwgc2V0IHRoZSBzeXNjdGwgdmFyaWFibGUNCiAgICAgICAgICAgICAgICAg
 PHZhcm5hbWU+dmZzLnVzZXJtb3VudDwvdmFybmFtZT4gdG8NCiAgICAgICAg
 ICAgICAgICAgPGxpdGVyYWw+MTwvbGl0ZXJhbD4uPC9wYXJhPg0KIA0KQEAg
 LTYyMDIsMTMgKzYyMDYsMzYgQEANCiAgICAgICAgICAgICAgIDxzY3JlZW4+
 JnByb21wdC5yb290OyA8dXNlcmlucHV0PmNobW9kIDY2NiAvZGV2L2ZkMDwv
 dXNlcmlucHV0Pjwvc2NyZWVuPg0KIA0KICAgICAgICAgICAgICAgPHBhcmE+
 VG8gYWxsb3cgdXNlcnMgaW4gdGhlIGdyb3VwDQotICAgICAgICAgICAgICAg
 IDxncm91cG5hbWU+b3BlcmF0b3I8L2dyb3VwbmFtZT4gdG8gbW91bnQgdGhl
 IENEUk9NIGRyaXZlLA0KKyAgICAgICAgICAgICAgICA8Z3JvdXBuYW1lPm9w
 ZXJhdG9yPC9ncm91cG5hbWU+IHRvIG1vdW50IHRoZSBDRC1ST00gZHJpdmUs
 DQogICAgICAgICAgICAgICAgIHVzZTo8L3BhcmE+DQogDQotICAgICAgICAg
 ICAgICA8c2NyZWVuPiZwcm9tcHQucm9vdDsgPHVzZXJpbnB1dD5jaGdycCBv
 cGVyYXRvciAvZGV2L2NkMGM8L3VzZXJpbnB1dD4NCi0mcHJvbXB0LnJvb3Q7
 IDx1c2VyaW5wdXQ+Y2htb2QgNjQwIC9kZXYvY2QwYzwvdXNlcmlucHV0Pjwv
 c2NyZWVuPg0KKyAgICAgICAgICAgICAgPHNjcmVlbj4mcHJvbXB0LnJvb3Q7
 IDx1c2VyaW5wdXQ+Y2hncnAgb3BlcmF0b3IgL2Rldi9hY2QwPC91c2VyaW5w
 dXQ+DQorJnByb21wdC5yb290OyA8dXNlcmlucHV0PmNobW9kIDY0MCAvZGV2
 L2FjZDA8L3VzZXJpbnB1dD48L3NjcmVlbj4NCisNCiAgICAgICAgICAgICA8
 L3N0ZXA+DQogDQorCSAgICA8c3RlcD4NCisJICAgICAgPHBhcmE+WW91IHdp
 bGwgbmVlZCB0byBhbHRlciB5b3VyICZtYW4uZGV2ZnMuY29uZi41OyB0byBt
 YWtlIHRoZXNlDQorCSAgICAgICAgY2hhbmdlcyBwZXJtYW5lbnQgYWNyb3Nz
 IHJlYm9vdHMuPC9wYXJhPg0KKwkJDQorCSAgICAgIDxub3RlPlRoaXMgc3Rl
 cCBkb2VzIG5vdCBhcHBseSB0byAmb3M7IDQuWCBhbmQgYmVsb3cuPC9ub3Rl
 Pg0KKwkJDQorCSAgICAgIDxwYXJhPkFzIDx1c2VybmFtZT5yb290PC91c2Vy
 bmFtZT4sIGFkZCB0aGUgcmVsZXZhbnQgbGluZXMgdG8NCisJICAgICAgICA8
 ZmlsZW5hbWU+L2V0Yy9kZXZmcy5jb25mPC9maWxlbmFtZT4uIEZvciBleGFt
 cGxlLCB0byBhbGxvdyB1c2Vycw0KKwkJdG8gbW91bnQgdGhlIGZpcnN0IGZs
 b3BweSBkcml2ZSwgYWRkOjwvcGFyYT4NCisJICAgICAgDQorCSAgICAgIDxw
 cm9ncmFtbGlzdGluZz4jIEFsbG93IGFsbCB1c2VycyB0byBtb3VudCB0aGUg
 ZmxvcHB5IGRpc2suDQorb3duICAgICAvZGV2L2ZkMCAgICAgICAgcm9vdDpv
 cGVyYXRvcg0KK3Blcm0gICAgL2Rldi9mZDAgICAgICAgIDA2NjY8L3Byb2dy
 YW1saXN0aW5nPg0KKw0KKyAgICAgICAgICAgICA8cGFyYT5UbyBhbGxvdyB1
 c2VycyBpbiB0aGUgZ3JvdXAgPGdyb3VwbmFtZT5vcGVyYXRvcjwvZ3JvdXBu
 YW1lDQorCSAgICAgICB0byBtb3VudCB0aGUgQ0QtUk9NIGRyaXZlLCBhZGQ6
 PC9wYXJhPg0KKw0KKwkgICAgIDxwcm9ncmFtbGlzdGluZz4jIEFsbG93IG1l
 bWJlcnMgb2YgdGhlIGdyb3VwIG9wZXJhdG9yIHRvIG1vdW50IENELVJPTXMu
 DQorb3duICAgICAvZGV2L2FjZDAgICAgICAgcm9vdDpvcGVyYXRvcg0KK3Bl
 cm0gICAgL2Rldi9hY2QwICAgICAgIDA2NjANCisJICAgIDwvc3RlcD4NCisJ
 ICAgIA0KICAgICAgICAgICAgIDxzdGVwPg0KICAgICAgICAgICAgICAgPHBh
 cmE+RmluYWxseSwgYWRkIHRoZSBsaW5lDQogICAgICAgICAgICAgICAgIDxs
 aXRlcmFsPjx2YXJuYW1lPnZmcy51c2VybW91bnQ8L3Zhcm5hbWU+PTE8L2xp
 dGVyYWw+DQpAQCAtNjIyNSwyMSArNjI1MiwyMSBAQA0KICZwcm9tcHQudXNl
 cjsgPHVzZXJpbnB1dD5tb3VudCAtdCBtc2RvcyAvZGV2L2ZkMCB+L215LW1v
 dW50LXBvaW50PC91c2VyaW5wdXQ+PC9zY3JlZW4+DQogDQogICAgICAgICAg
 IDxwYXJhPlVzZXJzIGluIGdyb3VwIDxncm91cG5hbWU+b3BlcmF0b3I8L2dy
 b3VwbmFtZT4gY2FuIG5vdw0KLSAgICAgICAgICAgIG1vdW50IHRoZSBDRFJP
 TSA8ZGV2aWNlbmFtZT4vZGV2L2NkMGM8L2RldmljZW5hbWU+IG9udG8gYQ0K
 KyAgICAgICAgICAgIG1vdW50IHRoZSBDRC1ST00gPGRldmljZW5hbWU+L2Rl
 di9hY2QwPC9kZXZpY2VuYW1lPiBvbnRvIGENCiAgICAgICAgICAgICBkaXJl
 Y3RvcnkgdGhhdCB0aGV5IG93bjo8L3BhcmE+DQogDQogICAgICAgICAgIDxz
 Y3JlZW4+JnByb21wdC51c2VyOyA8dXNlcmlucHV0Pm1rZGlyIH4vbXktbW91
 bnQtcG9pbnQ8L3VzZXJpbnB1dD4NCi0mcHJvbXB0LnVzZXI7IDx1c2VyaW5w
 dXQ+bW91bnQgLXQgY2Q5NjYwIC9kZXYvY2QwYyB+L215LW1vdW50LXBvaW50
 PC91c2VyaW5wdXQ+PC9zY3JlZW4+DQorJnByb21wdC51c2VyOyA8dXNlcmlu
 cHV0Pm1vdW50IC10IGNkOTY2MCAvZGV2L2FjZDAgfi9teS1tb3VudC1wb2lu
 dDwvdXNlcmlucHV0Pjwvc2NyZWVuPg0KIA0KICAgICAgICAgICA8cGFyYT5V
 bm1vdW50aW5nIHRoZSBkZXZpY2UgaXMgc2ltcGxlOjwvcGFyYT4NCiANCiAg
 ICAgICAgICAgPHNjcmVlbj4mcHJvbXB0LnVzZXI7IDx1c2VyaW5wdXQ+dW1v
 dW50IH4vbXktbW91bnQtcG9pbnQ8L3VzZXJpbnB1dD48L3NjcmVlbj4NCiAN
 Ci0gICAgICAgICAgPHBhcmE+RW5hYmxpbmcgPHZhcm5hbWU+dmZzLnVzZXJt
 b3VudDwvdmFybmFtZT4sIGhvd2V2ZXIsDQorICAgICAgICAgIDxub3RlPkVu
 YWJsaW5nIDx2YXJuYW1lPnZmcy51c2VybW91bnQ8L3Zhcm5hbWU+DQogICAg
 ICAgICAgICAgaGFzIG5lZ2F0aXZlIHNlY3VyaXR5IGltcGxpY2F0aW9ucy4g
 IEEgYmV0dGVyIHdheSB0bw0KICAgICAgICAgICAgIGFjY2VzcyAmbXMtZG9z
 OyBmb3JtYXR0ZWQgbWVkaWEgaXMgdG8gdXNlIHRoZQ0KICAgICAgICAgICAg
 IDxmaWxlbmFtZSByb2xlPSJwYWNrYWdlIj5lbXVsYXRvcnMvbXRvb2xzPC9m
 aWxlbmFtZT4NCi0gICAgICAgICAgICBwYWNrYWdlIGluIHRoZSBwb3J0cyBj
 b2xsZWN0aW9uLjwvcGFyYT4NCisgICAgICAgICAgICBwYWNrYWdlIGluIHRo
 ZSBwb3J0cyBjb2xsZWN0aW9uLjwvbm90ZT4NCiAgICAgICAgIDwvYW5zd2Vy
 Pg0KICAgICAgIDwvcWFuZGFlbnRyeT4NCiANCg==
 
 --1602359821-333100574-1107328022=:9059--
 
Responsible-Changed-From-To: freebsd-doc->jcamou  
Responsible-Changed-By: jcamou 
Responsible-Changed-When: Wed Mar 9 14:10:34 GMT 2005 
Responsible-Changed-Why:  
Take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=76942 
State-Changed-From-To: open->closed  
State-Changed-By: jcamou 
State-Changed-When: Thu Mar 10 09:08:37 GMT 2005 
State-Changed-Why:  
A part of the patch committed with some minor changes. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=76942 
>Unformatted:
