[PHP-DOC] cvs: phpdoc /en/reference/exec/functions exec.xml passthru.xml system.xml /en/reference/filesystem/functions chgrp.xml chmod.xml popen.xml

[Nuno Lopes]

nlopess         Wed Dec 31 05:39:43 2003 EDT

  Modified files:              
    /phpdoc/en/reference/exec/functions exec.xml passthru.xml 
                                        system.xml 
    /phpdoc/en/reference/filesystem/functions   chgrp.xml chmod.xml 
                                                popen.xml 
  Log:
  safe mode note
  
Index: phpdoc/en/reference/exec/functions/exec.xml
diff -u phpdoc/en/reference/exec/functions/exec.xml:1.6 
phpdoc/en/reference/exec/functions/exec.xml:1.7
--- phpdoc/en/reference/exec/functions/exec.xml:1.6     Thu Nov 27 07:26:15 2003
+++ phpdoc/en/reference/exec/functions/exec.xml Wed Dec 31 05:39:42 2003
@@ -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>,
Index: phpdoc/en/reference/exec/functions/passthru.xml
diff -u phpdoc/en/reference/exec/functions/passthru.xml:1.2 
phpdoc/en/reference/exec/functions/passthru.xml:1.3
--- phpdoc/en/reference/exec/functions/passthru.xml:1.2 Wed Apr 17 02:37:47 2002
+++ phpdoc/en/reference/exec/functions/passthru.xml     Wed Dec 31 05:39:42 2003
@@ -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>,
Index: phpdoc/en/reference/exec/functions/system.xml
diff -u phpdoc/en/reference/exec/functions/system.xml:1.5 
phpdoc/en/reference/exec/functions/system.xml:1.6
--- phpdoc/en/reference/exec/functions/system.xml:1.5   Mon Dec 15 11:49:42 2003
+++ phpdoc/en/reference/exec/functions/system.xml       Wed Dec 31 05:39:42 2003
@@ -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 @@
       </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>,
Index: phpdoc/en/reference/filesystem/functions/chgrp.xml
diff -u phpdoc/en/reference/filesystem/functions/chgrp.xml:1.5 
phpdoc/en/reference/filesystem/functions/chgrp.xml:1.6
--- phpdoc/en/reference/filesystem/functions/chgrp.xml:1.5      Sun Dec 28 09:12:29 
2003
+++ phpdoc/en/reference/filesystem/functions/chgrp.xml  Wed Dec 31 05:39:43 2003
@@ -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
Index: phpdoc/en/reference/filesystem/functions/chmod.xml
diff -u phpdoc/en/reference/filesystem/functions/chmod.xml:1.10 
phpdoc/en/reference/filesystem/functions/chmod.xml:1.11
--- phpdoc/en/reference/filesystem/functions/chmod.xml:1.10     Sat Dec 20 23:21:46 
2003
+++ phpdoc/en/reference/filesystem/functions/chmod.xml  Wed Dec 31 05:39:43 2003
@@ -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 @@
       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>.
Index: phpdoc/en/reference/filesystem/functions/popen.xml
diff -u phpdoc/en/reference/filesystem/functions/popen.xml:1.10 
phpdoc/en/reference/filesystem/functions/popen.xml:1.11
--- phpdoc/en/reference/filesystem/functions/popen.xml:1.10     Mon Dec 15 11:49:45 
2003
+++ phpdoc/en/reference/filesystem/functions/popen.xml  Wed Dec 31 05:39:43 2003
@@ -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 @@
       </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>.