docs/59879: [PATCH] handbook/multimedia: clarify 5.x behaviour wrt to devfs

[Lukas Ertl]

>Number:         59879
>Category:       docs
>Synopsis:       [PATCH] handbook/multimedia: clarify 5.x behaviour wrt to devfs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 01 14:30:18 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Lukas Ertl
>Release:        FreeBSD 5.2-BETA i386
>Organization:
Vienna University Computer Center
>Environment:
System: FreeBSD korben 5.2-BETA FreeBSD 5.2-BETA #68: Sun Nov 30 23:02:39 CET 2003 le at korben:/usr/obj/usr/src/sys/KORBEN i386


	
>Description:

The multimedia/video playback chapter of the handbook is a little bit
inconsistent about symbolic links when using devfs(5).

Also add a note about "option USER_LDT" being only available on -stable.

>How-To-Repeat:
	
>Fix:

	

--- handbook.diff begins here ---
Index: en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
===================================================================
RCS file: /usr/local/bsdcvs/doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml,v
retrieving revision 1.68
diff -u -r1.68 chapter.sgml
--- en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml	24 Nov 2003 03:57:43 -0000	1.68
+++ en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml	1 Dec 2003 22:18:56 -0000
@@ -783,8 +783,16 @@
     <para>On FreeBSD 5.X, which uses &man.devfs.5; there
         is a slightly different set of recommended links:</para>
 
-      <screen>&prompt.root; <userinput>ln -sf /dev/acd0c /dev/dvd</userinput>
-&prompt.root; <userinput>ln -sf /dev/acd0c /dev/rdvd</userinput></screen>
+      <screen>&prompt.root; <userinput>ln -sf /dev/acd0 /dev/dvd</userinput>
+&prompt.root; <userinput>ln -sf /dev/acd0 /dev/rdvd</userinput></screen>
+
+    <para>Please note that due to the nature of &man.devfs.5;,
+      manually created links like these will not persist if you reboot
+      your system.  In order to create the symbolic links automatically
+      whenever you boot your system, add the following lines to
+      <filename>/etc/devfs.conf</filename>:</para>
+      <programlisting>link acd0 dvd
+link acd0 rdvd</programlisting>
 
     <para>Additionally, DVD decryption, which requires invoking
       special DVD-ROM functions, requires write permission on the DVD
@@ -805,6 +813,11 @@
 
       <programlisting>option CPU_ENABLE_SSE
 option USER_LDT</programlisting>
+
+    <note>
+      <para><literal>option USER_LDT</literal> is not available on
+        &os; 5.X.</para>
+    </note>
 
     <para>To enhance the shared memory X11 interface, it is
       recommended that the values of some &man.sysctl.8; variables
--- handbook.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: