setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<chapter xml:id="win32service.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml:id="win32service.requirements">
  &reftitle.required;
  <para>
   The versions of Windows supported are the same as the Visual C++ redistributable package used to build PHP.
  </para>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 <section xml:id="win32service.installation">
  &reftitle.install;
  <para>
   &pecl.info;
   <link xlink:href="&url.pecl.package;win32service">&url.pecl.package;win32service</link>
  </para>
 </section>
 <!-- }}} -->

 <section xml:id="win32service.security">
  <title xmlns="http://docbook.org/ns/docbook">Security consideration</title>
  <para>
   This extension needs administrator privileges for some actions such as
   <link linkend="function.win32-create-service">create</link>,
   <link linkend="function.win32-delete-service">delete</link>,
   <link linkend="function.win32-start-service">start</link>,
   <link linkend="function.win32-stop-service">stop</link>,
   <link linkend="function.win32-pause-service">pause</link> and
   <link linkend="function.win32-continue-service">continue</link>.
   This requirement can cause an elevation of privileges if the service
   control is available from the web interface or remote control.
  </para>
  <para>
   The ACL on the service can be set after adding it into SCM to delegate the
   current administration tasks to a non administrator account or service account.
  </para>
  <para>
   As of Win32Service 1.1.0, service rights can be managed with PHP. The actual ACLs can be read with
   <function>win32_read_all_rights_access_service</function>, an access or deny right can be added with
   <function>win32_add_right_access_service</function>, or an access right can be removed with
   <function>win32_remove_right_access_service</function>.
  </para>
  <para>
   It is recommended to update to Win32Service 1.1.0.
   For further instructions to manage rights without the extension (or a version prior to 1.1.0), see the
   <link xlink:href="&url.win32service.kb914392;">Microsoft Knowledge Base</link>.
  </para>
 </section>

</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->