Changeset 38186 in vbox for trunk/doc/manual

Timestamp:

Jul 26, 2011 1:47:54 PM (14 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

73144

Message:

GuestCtrl: Changelog, docs for process policy.

Location:

trunk/doc/manual

Files:

• en_US/user_VBoxManage.xml (modified) (5 diffs)
• user_ChangeLogImpl.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_VBoxManage.xml

@@ -1102 +1102 @@
     <itemizedlist>
        <listitem>
-           <para><computeroutput>--snapshot &lt;uuid&gt;|&lt;name&gt;</computeroutput>: 
+           <para><computeroutput>--snapshot &lt;uuid&gt;|&lt;name&gt;</computeroutput>:
             Select a specific snapshot where the clone operation should refer
             to. Default is referring to the current state.</para>
        </listitem>
        <listitem>
-           <para><computeroutput>--mode machine|machineandchildren|all</computeroutput>: 
+           <para><computeroutput>--mode machine|machineandchildren|all</computeroutput>:
            Selects the cloning mode of the operation. If
            <computeroutput>machine</computeroutput> is selected (the default),
@@ -1118 +1118 @@
        </listitem>
        <listitem>
-           <para><computeroutput>--options link|keepallmacs|keepnatmacs|keepdisknames</computeroutput>: 
+           <para><computeroutput>--options link|keepallmacs|keepnatmacs|keepdisknames</computeroutput>:
            Allows additional fine tuning of the clone operation. The first
            option defines that a linked clone should be created, which is
@@ -1138 +1138 @@
        </listitem>
        <listitem>
-           <para><computeroutput>--basefolder &lt;basefolder&gt;</computeroutput>: 
+           <para><computeroutput>--basefolder &lt;basefolder&gt;</computeroutput>:
            Select the folder where the new virtual machine configuration should
            be saved in.</para>
        </listitem>
        <listitem>
-           <para><computeroutput>--uuid &lt;uuid&gt;</computeroutput>: 
+           <para><computeroutput>--uuid &lt;uuid&gt;</computeroutput>:
            Select the UUID the new VM should have. This id has to be unique in
            the VirtualBox instance this clone should be registered. Default is
@@ -1149 +1149 @@
        </listitem>
        <listitem>
-           <para><computeroutput>--register</computeroutput>: 
+           <para><computeroutput>--register</computeroutput>:
            Automatically register the new clone in this VirtualBox
            installation. If you manually want register the new VM later, see
@@ -2687 +2687 @@
           the double backslashes in the second example are only required on
           Unix hosts.</para>
+
+          <para>Starting at VirtualBox 4.1.2 guest process execution by default is limited
+          to serve up to 5 guest processes at a time. If a new guest process gets started
+          which would exceed this limit, the oldest not running guest process will be discarded
+          in order to be able to run that new process. Also, retrieving output from this
+          old guest process will not be possible anymore then. If all 5 guest processes
+          are still active and running, starting a new guest process will result in an
+          appropriate error message.</para>
+
+          <para>To raise or lower the guest process execution limit, either the guest
+          property <computerouptut>/VirtualBox/GuestAdd/VBoxService/--control-procs-max-kept</computerouptut>
+          or VBoxService' command line by specifying <computeroutput>--control-procs-max-kept</computeroutput>
+          needs to be modified. A restart of the guest OS is required afterwards. To serve unlimited
+          guest processes, a value of <computeroutput>0</computeroutput> needs to be set (not recommended).</para>
         </listitem>
 

trunk/doc/manual/user_ChangeLogImpl.xml

@@ -12 +12 @@
         <para>Guest control execution: implemented copying single files from
           guest to the host (directories and filters not supported yet)</para>
+      </listitem>
+
+      <listitem>
+        <para>Guest control execution: limited to serve up to 5 guest processes at a time
+          by default</para>
       </listitem>