safe mode note

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@147556 c90b9560-bf6c-de11-be94-00142212c4b1

reference/exec/functions/exec.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
   <refentry id="function.exec">
    <refnamediv>
@@ -56,6 +56,15 @@
       hang until the execution of the program ends.
      </para>
     </note>
+    <note>
+     <simpara>
+      When <link linkend="features.safe-mode">safe mode</link> is enabled, you
+      can only execute executables within the <link
+       linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. For
+      practical reasons it's currently not allowed to have
+      <literal>..</literal> components in the path to the executable.
+     </simpara>
+    </note>
     <para>
      See also <function>system</function>,
      <function>passthru</function>, <function>popen</function>,

reference/exec/functions/passthru.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
   <refentry id="function.passthru">
    <refnamediv>
@@ -47,6 +47,15 @@
       hang until the execution of the program ends.
      </para>
     </note>
+    <note>
+     <simpara>
+      When <link linkend="features.safe-mode">safe mode</link> is enabled, you
+      can only execute executables within the <link
+       linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. For
+      practical reasons it's currently not allowed to have
+      <literal>..</literal> components in the path to the executable.
+     </simpara>
+    </note>
     <para>
      See also <function>exec</function>, <function>system</function>,
      <function>popen</function>, <function>escapeshellcmd</function>,

reference/exec/functions/system.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.24 -->
   <refentry id="function.system">
    <refnamediv>
@@ -75,6 +75,15 @@ echo '
       </programlisting>
      </example>
     </para>
+    <note>
+     <simpara>
+      When <link linkend="features.safe-mode">safe mode</link> is enabled, you
+      can only execute executables within the <link
+       linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. For
+      practical reasons it's currently not allowed to have
+      <literal>..</literal> components in the path to the executable.
+     </simpara>
+    </note>
     <para>
      See also <function>exec</function>,
      <function>passthru</function>, <function>popen</function>,

reference/filesystem/functions/chgrp.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.chgrp">
    <refnamediv>
@@ -22,6 +22,7 @@
     <para>
      &return.success;
     </para>
+    &note.no-remote;
     &note.sm.uidcheck;
     <para>
      See also <function>chown</function> and

reference/filesystem/functions/chmod.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.chmod">
    <refnamediv>
@@ -79,9 +79,15 @@ chmod("/somedir/somefile", 0750);
       access.
      </para>
     </note>
-    
     &note.no-remote;
-
+    <note>
+     <simpara>
+      When <link linkend="features.safe-mode">safe mode</link> is enabled, PHP
+      checks whether the files or directories you are about to operate on have
+      the same UID (owner) as the script that is being executed. In addition,
+      you cannot set the SUID, SGID and sticky bits
+     </simpara>
+    </note>
     <para>
      See also <function>chown</function> and
      <function>chgrp</function>.

reference/filesystem/functions/popen.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.2 -->
   <refentry id="function.popen">
    <refnamediv>
@@ -67,6 +67,15 @@ pclose($handle);
       </programlisting>
      </informalexample>
     </para>
+    <note>
+     <simpara>
+      When <link linkend="features.safe-mode">safe mode</link> is enabled, you
+      can only execute executables within the <link
+       linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link>. For
+      practical reasons it's currently not allowed to have
+      <literal>..</literal> components in the path to the executable.
+     </simpara>
+    </note>
     <para>
      See also <function>pclose</function>, <function>fopen</function>,
      and <function>proc_open</function>.