Bug 171674 - Adding a section to the Troubleshooting section describing how to fix the File::Temp problems in perl 5.6.0.

4 files changed, 148 insertions, 0 deletions

diff --git a/docs/sgml/filetemp.patch b/docs/sgml/filetemp.patch
new file mode 100644
index 000000000..9fb70adce
--- /dev/null
+++ b/docs/sgml/filetemp.patch
@@ -0,0 +1,18 @@
+--- File/Temp.pm.orig   Thu Feb  6 16:26:00 2003
++++ File/Temp.pm        Thu Feb  6 16:26:23 2003
+@@ -205,6 +205,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+@@ -226,6 +227,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
diff --git a/docs/sgml/installation.sgml b/docs/sgml/installation.sgml
index 9f94feb7a..68a911b86 100644
--- a/docs/sgml/installation.sgml
+++ b/docs/sgml/installation.sgml
@@ -1565,6 +1565,62 @@ proc filter_deny { why } {
       as root to fix this problem.
       </para>
     </section>    
+
+    <section id="trouble-filetemp">
+      <title>Your vendor has not defined Fcntl macro O_NOINHERIT</title>
+
+      <para>This is caused by a bug in the version of
+      <productname>File::Temp</productname> that is distributed with perl
+      5.6.0. Many minor variations of this error have been reported. Examples
+      can be found in <xref linkend="trouble-filetemp-errors"/>.
+      </para>
+
+      <figure id="trouble-filetemp-errors">
+        <title>Other File::Temp error messages</title>
+
+        <programlisting>
+Your vendor has not defined Fcntl macro O_NOINHERIT, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
+
+Your vendor has not defined Fcntl macro O_EXLOCK, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
+
+Your vendor has not defined Fcntl macro O_TEMPORARY, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.
+        </programlisting>
+      </figure>
+
+      <para>Numerous people have reported that upgrading to version 5.6.1
+      or higher solved the problem for them. A less involved fix is to apply
+      the patch in <xref linkend="trouble-filetemp-patch"/>. The patch is also
+      available as a <ulink url="../sgml/filetemp.patch">patch file</ulink>.
+      </para>
+
+      <figure id="trouble-filetemp-patch">
+        <title>Patch for File::Temp in Perl 5.6.0</title>
+
+        <programlisting><![CDATA[
+--- File/Temp.pm.orig   Thu Feb  6 16:26:00 2003
++++ File/Temp.pm        Thu Feb  6 16:26:23 2003
+@@ -205,6 +205,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+@@ -226,6 +227,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+        ]]></programlisting>
+      </figure>
+    </section>
   </section>
 </chapter>
 
diff --git a/docs/xml/filetemp.patch b/docs/xml/filetemp.patch
new file mode 100644
index 000000000..9fb70adce
--- /dev/null
+++ b/docs/xml/filetemp.patch
@@ -0,0 +1,18 @@
+--- File/Temp.pm.orig   Thu Feb  6 16:26:00 2003
++++ File/Temp.pm        Thu Feb  6 16:26:23 2003
+@@ -205,6 +205,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+@@ -226,6 +227,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
diff --git a/docs/xml/installation.xml b/docs/xml/installation.xml
index 9f94feb7a..68a911b86 100644
--- a/docs/xml/installation.xml
+++ b/docs/xml/installation.xml
@@ -1565,6 +1565,62 @@ proc filter_deny { why } {
       as root to fix this problem.
       </para>
     </section>    
+
+    <section id="trouble-filetemp">
+      <title>Your vendor has not defined Fcntl macro O_NOINHERIT</title>
+
+      <para>This is caused by a bug in the version of
+      <productname>File::Temp</productname> that is distributed with perl
+      5.6.0. Many minor variations of this error have been reported. Examples
+      can be found in <xref linkend="trouble-filetemp-errors"/>.
+      </para>
+
+      <figure id="trouble-filetemp-errors">
+        <title>Other File::Temp error messages</title>
+
+        <programlisting>
+Your vendor has not defined Fcntl macro O_NOINHERIT, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 208.
+
+Your vendor has not defined Fcntl macro O_EXLOCK, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 210.
+
+Your vendor has not defined Fcntl macro O_TEMPORARY, used 
+at /usr/lib/perl5/site_perl/5.6.0/File/Temp.pm line 233.
+        </programlisting>
+      </figure>
+
+      <para>Numerous people have reported that upgrading to version 5.6.1
+      or higher solved the problem for them. A less involved fix is to apply
+      the patch in <xref linkend="trouble-filetemp-patch"/>. The patch is also
+      available as a <ulink url="../sgml/filetemp.patch">patch file</ulink>.
+      </para>
+
+      <figure id="trouble-filetemp-patch">
+        <title>Patch for File::Temp in Perl 5.6.0</title>
+
+        <programlisting><![CDATA[
+--- File/Temp.pm.orig   Thu Feb  6 16:26:00 2003
++++ File/Temp.pm        Thu Feb  6 16:26:23 2003
+@@ -205,6 +205,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+@@ -226,6 +227,7 @@
+     # eg CGI::Carp
+     local $SIG{__DIE__} = sub {};
+     local $SIG{__WARN__} = sub {};
++    local *CORE::GLOBAL::die = sub {};
+     $bit = &$func();
+     1;
+   };
+        ]]></programlisting>
+      </figure>
+    </section>
   </section>
 </chapter>