Update the question about vfs.usermount. From the PR:

The attached patch to the FAQ file adds CDROMs to the title and
        procedure, lowers the device permissions a bit, including an
        example on how to restrict the ability to a group, and adds the
        sysctl.conf step. I reorganized the text a bit to work better
        with the new information.

Submitted by:   Mike Meyer <mwm@mired.org>
PR:             docs/22297

Rewrite the section on accessing virtual terminals from X.

Prompted by:    Neil Youngman <Neil_Youngman@nai.com>
This commit is contained in:
Nik Clayton 2000-10-26 23:07:29 +00:00
parent c593fa7abc
commit 9ea241c2f4
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=8204
2 changed files with 128 additions and 60 deletions

View file

@ -15,7 +15,7 @@
</author>
</authorgroup>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.110 2000/10/12 20:36:03 jkh Exp $</pubdate>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.111 2000/10/17 16:29:23 nik Exp $</pubdate>
<abstract>
<para>This is the FAQ for FreeBSD versions 2.X, 3.X, and 4.X.
@ -6343,7 +6343,7 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<qandaentry>
<question>
<para>How do I let ordinary users mount floppies and other removable
<para>How do I let ordinary users mount floppies, CDROMs and other removable
media?</para>
</question>
@ -6352,6 +6352,14 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
how:</para>
<procedure>
<step>
<para>As <username>root</username> set the sysctl variable
<varname>vfs.usermount</varname> to
<literal>1</literal>.</para>
<screen>&prompt.root; <userinput>sysctl -w vfs.usermount=1</userinput></screen>
</step>
<step>
<para>As <username>root</username> assign the appropriate
permissions to the block device associated with the
@ -6360,24 +6368,38 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<para>For example, to allow users to mount the first floppy
drive, use:</para>
<screen>&prompt.root; <userinput>chmod 777 /dev/fd0</userinput></screen>
<screen>&prompt.root; <userinput>chmod 666 /dev/fd0</userinput></screen>
<para>To allow users in the group
<username>operator</username> to mount the cdrom drive,
use:</para>
<screen>&prompt.root; <userinput>chgrp operator /dev/cd0c</userinput>
&prompt.root; <userinput>chmod 640 /dev/cd0c</userinput></screen>
</step>
<step>
<para>As <username>root</username> set the sysctl variable
<varname>vfs.usermount</varname> to
<literal>1</literal>.</para>
<screen>&prompt.root; <userinput>sysctl -w vfs.usermount=1</userinput></screen>
</step>
<step>
<para>Finally, add the line
<literal>vfs.usermount=1</literal> to the file
<filename>/etc/sysctl.conf</filename> so that it is reset
at system boot time.</para>
</step>
</procedure>
<para>Users can now mount <filename>/dev/fd0</filename> onto a
directory that they own:</para>
<para>All users can now mount the floppy
<filename>/dev/fd0</filename> onto a directory that they
own:</para>
<screen>&prompt.user; <userinput> mkdir ~/my-mount-point</userinput>
&prompt.user; <userinput> mount -t msdos /dev/fd0 ~/my-mount-point</userinput></screen>
<para>Users in group <username>operator</username> can now
mount the cdrom <filename>/dev/cd0c</filename> onto a
directory that they own:</para>
<screen>&prompt.user; <userinput> mkdir ~/my-mount-point</userinput>
&prompt.user; <userinput> mount -t msdos /dev/cd0c ~/my-mount-point</userinput></screen>
<para>Unmounting the device is simple:</para>
<screen>&prompt.user; <userinput>umount <filename>~/my-mount-point</filename></userinput></screen>
@ -6385,8 +6407,7 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<para>Enabling <varname>vfs.usermount</varname>, however, has
negative security implications. A better way to access MSDOS
formatted media is to use the <ulink
URL="http://www.freebsd.org/cgi/ports.cgi?query=%5Emtools-&amp;stype=name">mtools</ulink>
package in the ports collection.</para>
URL="http://www.freebsd.org/cgi/ports.cgi?query=%5Emtools-&amp;stype=name">mtools</ulink> package in the ports collection.</para>
</answer>
</qandaentry>
@ -6522,7 +6543,6 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
</question>
<answer>
<para>If you are using syscons (the default console driver),
you can configure FreeBSD to support a mouse pointer on each
virtual screen. In order to avoid conflicting with X, syscons
@ -6841,17 +6861,18 @@ ttyvb "/usr/libexec/getty Pc" cons25 on secure</programlisting>
want to change the <literal>secure</literal>
to <literal>insecure</literal>.</para>
<para>
<para>
<important>
<para>If you want to run an X server you
<emphasis>MUST</emphasis> leave at least one virtual
<emphasis>must</emphasis> leave at least one virtual
terminal unused (or turned off) for it to use. That is to
say that if you want to have a login prompt pop up for all
twelve of your Alt-function keys, you're out of luck - you
can only do this for eleven of them if you also want to run
an X server on the same machine.</para>
</important></para>
</important>
</para>
<para>The easiest way to disable a console is by turning it off.
For example, if you had the full 12 terminal allocation
mentioned above and you wanted to run X, you would change
@ -6901,18 +6922,31 @@ ttyvb "/usr/libexec/getty Pc" cons25 off secure</programlisting>
<para>How do I access the virtual consoles from X?</para>
</question>
<answer>
<para>If the console is currently displaying X Window, you can
use Ctrl-Alt-F1, etc. to switch to a virtual console. Note,
however, that once you've switched away from X Window to a
virtual terminal, you may use only the Alt- function key to
switch to another virtual terminal or back to X Window. You do
not need to also press the Ctrl key. If you use the control key
to switch back to X on some older releases, you can find your
text console stuck in <quote>control-lock</quote> mode. Tap the
control key to wake it up again.</para>
<answer>
<para>Use <keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>Alt</keycap>
<keycap>F<replaceable>n</replaceable></keycap>
</keycombo> to switch back to a virtual console.
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>Alt</keycap>
<keycap>F1</keycap>
</keycombo> would return you to the first virtual console.</para>
<para>Once you are back to a text console, you can then use
<keycombo action="simul">
<keycap>Alt</keycap>
<keycap>F<replaceable>n</replaceable></keycap>
</keycombo> as normal to move between them.</para>
<para>To return to the X session, you must switch to the virtual
console running X. If you have eight virtual consoles then X will
be running on the ninth, and you would use
<keycombo action="simul">
<keycap>Alt</keycap>
<keycap>F9</keycap>
</keycombo> to return.</para>
</answer>
</qandaentry>

View file

@ -15,7 +15,7 @@
</author>
</authorgroup>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.110 2000/10/12 20:36:03 jkh Exp $</pubdate>
<pubdate>$FreeBSD: doc/en_US.ISO_8859-1/books/faq/book.sgml,v 1.111 2000/10/17 16:29:23 nik Exp $</pubdate>
<abstract>
<para>This is the FAQ for FreeBSD versions 2.X, 3.X, and 4.X.
@ -6343,7 +6343,7 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<qandaentry>
<question>
<para>How do I let ordinary users mount floppies and other removable
<para>How do I let ordinary users mount floppies, CDROMs and other removable
media?</para>
</question>
@ -6352,6 +6352,14 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
how:</para>
<procedure>
<step>
<para>As <username>root</username> set the sysctl variable
<varname>vfs.usermount</varname> to
<literal>1</literal>.</para>
<screen>&prompt.root; <userinput>sysctl -w vfs.usermount=1</userinput></screen>
</step>
<step>
<para>As <username>root</username> assign the appropriate
permissions to the block device associated with the
@ -6360,24 +6368,38 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<para>For example, to allow users to mount the first floppy
drive, use:</para>
<screen>&prompt.root; <userinput>chmod 777 /dev/fd0</userinput></screen>
<screen>&prompt.root; <userinput>chmod 666 /dev/fd0</userinput></screen>
<para>To allow users in the group
<username>operator</username> to mount the cdrom drive,
use:</para>
<screen>&prompt.root; <userinput>chgrp operator /dev/cd0c</userinput>
&prompt.root; <userinput>chmod 640 /dev/cd0c</userinput></screen>
</step>
<step>
<para>As <username>root</username> set the sysctl variable
<varname>vfs.usermount</varname> to
<literal>1</literal>.</para>
<screen>&prompt.root; <userinput>sysctl -w vfs.usermount=1</userinput></screen>
</step>
<step>
<para>Finally, add the line
<literal>vfs.usermount=1</literal> to the file
<filename>/etc/sysctl.conf</filename> so that it is reset
at system boot time.</para>
</step>
</procedure>
<para>Users can now mount <filename>/dev/fd0</filename> onto a
directory that they own:</para>
<para>All users can now mount the floppy
<filename>/dev/fd0</filename> onto a directory that they
own:</para>
<screen>&prompt.user; <userinput> mkdir ~/my-mount-point</userinput>
&prompt.user; <userinput> mount -t msdos /dev/fd0 ~/my-mount-point</userinput></screen>
<para>Users in group <username>operator</username> can now
mount the cdrom <filename>/dev/cd0c</filename> onto a
directory that they own:</para>
<screen>&prompt.user; <userinput> mkdir ~/my-mount-point</userinput>
&prompt.user; <userinput> mount -t msdos /dev/cd0c ~/my-mount-point</userinput></screen>
<para>Unmounting the device is simple:</para>
<screen>&prompt.user; <userinput>umount <filename>~/my-mount-point</filename></userinput></screen>
@ -6385,8 +6407,7 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
<para>Enabling <varname>vfs.usermount</varname>, however, has
negative security implications. A better way to access MSDOS
formatted media is to use the <ulink
URL="http://www.freebsd.org/cgi/ports.cgi?query=%5Emtools-&amp;stype=name">mtools</ulink>
package in the ports collection.</para>
URL="http://www.freebsd.org/cgi/ports.cgi?query=%5Emtools-&amp;stype=name">mtools</ulink> package in the ports collection.</para>
</answer>
</qandaentry>
@ -6522,7 +6543,6 @@ define(`confDELIVERY_MODE',`deferred')dnl</programlisting>
</question>
<answer>
<para>If you are using syscons (the default console driver),
you can configure FreeBSD to support a mouse pointer on each
virtual screen. In order to avoid conflicting with X, syscons
@ -6841,17 +6861,18 @@ ttyvb "/usr/libexec/getty Pc" cons25 on secure</programlisting>
want to change the <literal>secure</literal>
to <literal>insecure</literal>.</para>
<para>
<para>
<important>
<para>If you want to run an X server you
<emphasis>MUST</emphasis> leave at least one virtual
<emphasis>must</emphasis> leave at least one virtual
terminal unused (or turned off) for it to use. That is to
say that if you want to have a login prompt pop up for all
twelve of your Alt-function keys, you're out of luck - you
can only do this for eleven of them if you also want to run
an X server on the same machine.</para>
</important></para>
</important>
</para>
<para>The easiest way to disable a console is by turning it off.
For example, if you had the full 12 terminal allocation
mentioned above and you wanted to run X, you would change
@ -6901,18 +6922,31 @@ ttyvb "/usr/libexec/getty Pc" cons25 off secure</programlisting>
<para>How do I access the virtual consoles from X?</para>
</question>
<answer>
<para>If the console is currently displaying X Window, you can
use Ctrl-Alt-F1, etc. to switch to a virtual console. Note,
however, that once you've switched away from X Window to a
virtual terminal, you may use only the Alt- function key to
switch to another virtual terminal or back to X Window. You do
not need to also press the Ctrl key. If you use the control key
to switch back to X on some older releases, you can find your
text console stuck in <quote>control-lock</quote> mode. Tap the
control key to wake it up again.</para>
<answer>
<para>Use <keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>Alt</keycap>
<keycap>F<replaceable>n</replaceable></keycap>
</keycombo> to switch back to a virtual console.
<keycombo action="simul">
<keycap>Ctrl</keycap>
<keycap>Alt</keycap>
<keycap>F1</keycap>
</keycombo> would return you to the first virtual console.</para>
<para>Once you are back to a text console, you can then use
<keycombo action="simul">
<keycap>Alt</keycap>
<keycap>F<replaceable>n</replaceable></keycap>
</keycombo> as normal to move between them.</para>
<para>To return to the X session, you must switch to the virtual
console running X. If you have eight virtual consoles then X will
be running on the ninth, and you would use
<keycombo action="simul">
<keycap>Alt</keycap>
<keycap>F9</keycap>
</keycombo> to return.</para>
</answer>
</qandaentry>