avsm Sun Nov 23 12:47:00 2003 EDT
Modified files:
/phpdoc/entities global.ent
/phpdoc/en/chapters install.openbsd.xml
Log:
update with some FAQs for openbsd (apache chroot and the gd package)
Index: phpdoc/entities/global.ent
diff -u phpdoc/entities/global.ent:1.140 phpdoc/entities/global.ent:1.141
--- phpdoc/entities/global.ent:1.140 Thu Nov 20 12:06:27 2003
+++ phpdoc/entities/global.ent Sun Nov 23 12:46:59 2003
@@ -1,6 +1,6 @@
<!-- -*- SGML -*-
- $Id: global.ent,v 1.140 2003/11/20 17:06:27 joey Exp $
+ $Id: global.ent,v 1.141 2003/11/23 17:46:59 avsm Exp $
Contains global "macros" for all the XML documents.
@@ -169,6 +169,8 @@
<!ENTITY url.omnihttpd "http://www.omnicron.ca/";>
<!ENTITY url.openasp "http://www.activescripting.org/";>
<!ENTITY url.openbsd "http://www.openbsd.org/";>
+<!ENTITY url.openbsd.apachefaq "http://www.openbsd.org/faq/faq10.html#httpdchroot";>
+<!ENTITY url.openbsd.chroot "http://www.openbsd.org/cgi-bin/man.cgi?query=chroot";>
<!ENTITY url.openbsd.packages "http://www.openbsd.org/cgi-bin/man.cgi?query=packages";>
<!ENTITY url.openbsd.ports "http://www.openbsd.org/ports.html";>
<!ENTITY url.openlink "http://www.openlinksw.com/";>
Index: phpdoc/en/chapters/install.openbsd.xml
diff -u phpdoc/en/chapters/install.openbsd.xml:1.5
phpdoc/en/chapters/install.openbsd.xml:1.6
--- phpdoc/en/chapters/install.openbsd.xml:1.5 Sat Nov 15 06:37:50 2003
+++ phpdoc/en/chapters/install.openbsd.xml Sun Nov 23 12:47:00 2003
@@ -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>
