From 31ea0382c01af87eb5ae5cdaffa7e461097838d3 Mon Sep 17 00:00:00 2001
From: Anil Madhavapeddy <avsm@php.net>
Date: Sun, 23 Nov 2003 17:47:00 +0000
Subject: [PATCH] update with some FAQs for openbsd (apache chroot and the gd
 package)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@144791 c90b9560-bf6c-de11-be94-00142212c4b1
---
 chapters/install.openbsd.xml | 36 ++++++++++++++++++++++++++++--------
 1 file changed, 28 insertions(+), 8 deletions(-)

diff --git a/chapters/install.openbsd.xml b/chapters/install.openbsd.xml
index 49f7122b68..edf6e1d2af 100644
--- a/chapters/install.openbsd.xml
+++ b/chapters/install.openbsd.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <sect1 id="install.openbsd">
  <title>Unix/OpenBSD installs</title>
  <para>
@@ -21,13 +21,6 @@
     or <filename>php4-imap-4.3.3.tgz</filename>.  You need to use the <command>phpxs</command>
     command to activate and deactivate these modules in your &php.ini;.
    </simpara>
-   <simpara>
-    Due to an error in the OpenBSD 3.4 packages, the <filename>php4-gd-4.3.3-no_x11</filename>
-    package was not generated.  You can still use the <filename>php4-gd-4.3.3</filename>
-    package, but it requires <filename>xbase34.tgz</filename> to be installed.  The -stable
-    branch of the ports tree has corrected this error, and a replacement package is being
-    generated.
-   </simpara>
    <example id="install.openbsd.ports.example">
     <title>OpenBSD Package Install Example</title>
     <programlisting>
@@ -66,6 +59,33 @@
    the imap module, set the FLAVOR to <command>no_imap</command>.
   </simpara>
  </sect2>
+ <sect2 id="install.openbsd.faq">
+  <title>Common Problems</title>
+  <itemizedlist>
+   <listitem>
+    <simpara>The default install of Apache runs inside a
+    <ulink url="&url.openbsd.chroot;">chroot(2) jail</ulink>, which will restrict PHP scripts to
+    accessing files under <filename>/var/www</filename>.  You will therefore need to create a
+    <filename>/var/www/tmp</filename> directory for PHP session files to be stored, or use an
+    alternative session backend.  In addition, database sockets need to be placed inside the
+    jail or listen on the <filename>localhost</filename> interface.  If you use network functions,
+    some files from <filename>/etc</filename> such as <filename>/etc/resolv.conf</filename> and
+    <filename>/etc/services</filename> will need to be moved into <filename>/var/www/etc</filename>.
+    The OpenBSD PEAR package automatically installs into the correct chroot directories, so 
+    no special modification is needed there.  More information on the OpenBSD Apache is available
+    in the <ulink url="&url.openbsd.apachefaq;">OpenBSD FAQ</ulink>.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+    The OpenBSD 3.4 package for the <ulink url="&url.gd;">gd</ulink> extension requires
+    XFree86 to be installed.  If you do not wish to use some of the font features that
+    require X11, install the <filename>php4-gd-4.3.3-no_x11.tgz</filename> package instead.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </sect2>
+   
  <sect2 id="install.openbsd.older">
   <title>Older Releases</title>
   <simpara>