nginx-site: xml/en/docs/windows.xml annotate

annotate xml/en/docs/windows.xml @ 1878:127ae107e5a9

Removed clause about shared memory and Windows versions with ASLR. Starting with nginx 1.9.0 shared memory can be used on Windows versions with address space layout randomization.

author	Maxim Dounin <mdounin@mdounin.ru>
date	Mon, 26 Dec 2016 19:38:06 +0300
parents	48615cf80e20
children	4795c2ae5066

rev	line source
580 be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 553 diff changeset	1 <!--
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 553 diff changeset	2 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 553 diff changeset	3 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 553 diff changeset	4 -->
be54c443235a Added copyright markers to documentation sources. Ruslan Ermilov <ru@nginx.com> parents: 553 diff changeset	5
50 9d544687d02c Fixed DOCTYPE declaration. Ruslan Ermilov <ru@nginx.com> parents: 0 diff changeset	6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	7
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	8 <article name="nginx for Windows"
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	9 link="/en/docs/windows.html"
589 764fbac1b8b4 Added document revision. Ruslan Ermilov <ru@nginx.com> parents: 580 diff changeset	10 lang="en"
1878 127ae107e5a9 Removed clause about shared memory and Windows versions with ASLR. Maxim Dounin <mdounin@mdounin.ru> parents: 1662 diff changeset	11 rev="4">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	12
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	13 <section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	14
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	15 <para>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	16 Version of nginx for Windows uses the native Win32 API (not the Cygwin emulation
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	17 layer).
553 6330ca27a485 Translated "events" into English. Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	18 Only the <c-func>select</c-func> connection processing method is currently used,
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	19 so high performance and scalability should not be expected.
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	20 Due to this and some other known issues version of nginx for Windows
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	21 is considered to be a <i>beta</i> version.
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	22 At this time, it provides almost the same functionality as a UNIX version
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	23 of nginx except for
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	24 XSLT filter, image filter, GeoIP module, and embedded Perl language.
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	25 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	26
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	27 <para>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	28 To install nginx/Windows, <link doc="../download.xml">download</link>
922 9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	29 the latest mainline version distribution (<mainline_version/>),
9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	30 since the mainline branch of nginx contains all known fixes.
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	31 Then unpack the distribution, go to the
922 9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	32 nginx-<mainline_version/>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	33 directory, and run <command>nginx</command>.
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	34 Here is an example for the drive C: root directory:
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	35
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	36 <programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	37 cd c:\
922 9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	38 unzip nginx-<mainline_version/>.zip
9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	39 cd nginx-<mainline_version/>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	40 start nginx
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	41 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	42
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	43 Run the <command>tasklist</command> command-line utility
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	44 to see nginx processes:
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	45
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	46 <programlisting>
922 9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	47 C:\nginx-<mainline_version/>>tasklist /fi "imagename eq nginx.exe"
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	48
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	49 Image Name PID Session Name Session# Mem Usage
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	50 =============== ======== ============== ========== ============
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	51 nginx.exe 652 Console 0 2 780 K
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	52 nginx.exe 1332 Console 0 3 112 K
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	53 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	54
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	55 One of the processes is the master process and another is the worker process.
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	56 If nginx does not start, look for the reason in
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	57 the error log file <path>logs\error.log</path>.
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	58 If the log file has not been created, the reason for this should be reported
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	59 in the Windows Event Log.
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	60 If an error page is displayed instead of the expected page, also look
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	61 for the reason in the <path>logs\error.log</path> file.
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	62 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	63
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	64 <para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	65 nginx/Windows uses the directory where it has been run as the prefix
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	66 for relative paths in the configuration.
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	67 In the example above, the prefix is
922 9ad2770d3f28 Finished renaming development to mainline. Ruslan Ermilov <ru@nginx.com> parents: 589 diff changeset	68 <path>C:\nginx-<mainline_version/>\</path>.
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	69 Paths in a configuration file must be specified in UNIX-style using
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	70 forward slashes:
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	71
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	72 <programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	73 access_log logs/site.log;
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	74 root C:/web/html;
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	75 </programlisting>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	76 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	77
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	78 <para>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	79 nginx/Windows runs as a standard console application (not a service),
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	80 and it can be managed using the following commands:
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	81
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	82 <table note="yes">
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	83
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	84 <tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	85 <td width="20%">nginx -s stop</td>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	86 <td>fast shutdown</td>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	87 </tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	88
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	89 <tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	90 <td>nginx -s quit</td>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	91 <td>graceful shutdown</td>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	92 </tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	93
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	94 <tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	95 <td>nginx -s reload</td>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	96 <td>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	97 changing configuration,
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	98 starting new worker processes with a new configuration,
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	99 graceful shutdown of old worker processes
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	100 </td>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	101 </tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	102
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	103 <tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	104 <td>nginx -s reopen</td>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	105 <td>re-opening log files</td>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	106 </tr>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	107
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	108 </table>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	109 </para>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	110
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	111 </section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	112
121 49443032011c Unified <section> syntax for "article" and "module" documents. Ruslan Ermilov <ru@nginx.com> parents: 50 diff changeset	113 <section id="known_issues"
49443032011c Unified <section> syntax for "article" and "module" documents. Ruslan Ermilov <ru@nginx.com> parents: 50 diff changeset	114 name="Known issues">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	115
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	116 <list type="bullet">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	117
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	118 <listitem>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	119 Although several workers can be started, only one of them
4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	120 actually does any work.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	121 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	122
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	123 <listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	124 A worker can handle no more than 1024 simultaneous connections.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	125 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	126
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	127 <listitem>
1662 48615cf80e20 Documented the UDP proxy functionality. Yaroslav Zhuravlev <yar@nginx.com> parents: 922 diff changeset	128 The UDP proxy functionality is not supported.
48615cf80e20 Documented the UDP proxy functionality. Yaroslav Zhuravlev <yar@nginx.com> parents: 922 diff changeset	129 </listitem>
48615cf80e20 Documented the UDP proxy functionality. Yaroslav Zhuravlev <yar@nginx.com> parents: 922 diff changeset	130
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	131 </list>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	132
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	133 </section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	134
121 49443032011c Unified <section> syntax for "article" and "module" documents. Ruslan Ermilov <ru@nginx.com> parents: 50 diff changeset	135 <section id="possible_future_enhancements"
49443032011c Unified <section> syntax for "article" and "module" documents. Ruslan Ermilov <ru@nginx.com> parents: 50 diff changeset	136 name="Possible future enhancements">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	137
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	138 <list type="bullet">
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	139
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	140 <listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	141 Running as a service.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	142 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	143
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	144 <listitem>
553 6330ca27a485 Translated "events" into English. Ruslan Ermilov <ru@nginx.com> parents: 461 diff changeset	145 Using the I/O completion ports as a connection processing method.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	146 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	147
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	148 <listitem>
265 4d047c05b7ad Revised the "nginx for Windows" article. Ruslan Ermilov <ru@nginx.com> parents: 148 diff changeset	149 Using multiple worker threads inside a single worker process.
461 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 265 diff changeset	150 </listitem>
0 61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	151
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	152 </list>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	153
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	154 </section>
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	155
61e04fc01027 Initial import of the nginx.org website. Ruslan Ermilov <ru@nginx.com> parents: diff changeset	156 </article>

Mercurial > hg > nginx-site

annotate xml/en/docs/windows.xml @ 1878:127ae107e5a9