changeset 838:d1b5814e5265

Controlling nginx: use "ps -w" in examples.
author Ruslan Ermilov <ru@nginx.com>
date Mon, 11 Feb 2013 12:26:17 +0400
parents 6678b1f27514
children 1a917e32c1da
files xml/en/docs/control.xml xml/ru/docs/control.xml
diffstat 2 files changed, 28 insertions(+), 28 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/control.xml
+++ b/xml/en/docs/control.xml
@@ -8,7 +8,7 @@
 <article name="Controlling nginx"
          link="/en/docs/control.html"
          lang="en"
-         rev="2">
+         rev="3">
 
 <section>
 
@@ -81,12 +81,12 @@ After all clients are serviced, old work
 Let’s illustrate this by example.
 Imagine that nginx is run on FreeBSD 4.x and the command
 <programlisting>
-ps ax -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'
+ps axw -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'
 </programlisting>
 produces the following output:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33127 33126 nobody   0.0  1380 kqread nginx: worker process (nginx)
 33128 33126 nobody   0.0  1364 kqread nginx: worker process (nginx)
 33129 33126 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -97,8 +97,8 @@ 33129 33126 nobody   0.0  1364 kqread ng
 If HUP is sent to the master process, the output becomes:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-33129 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (n
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+33129 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (nginx)
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
@@ -110,7 +110,7 @@ One of the old worker processes with PID
 After some time it exits:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
@@ -151,11 +151,11 @@ then starts a new executable file that i
 worker processes:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1380 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -179,9 +179,9 @@ send messages to its worker processes, r
 down gracefully, and they will start to exit:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-33135 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (n
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+33135 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (nginx)
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -201,8 +201,8 @@ process continuously, until the new proc
 After some time, only the new worker processes will process requests:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -252,7 +252,7 @@ If upgrade was successful, then the old 
 the QUIT signal, and only new processes will stay:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-36264     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+36264     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
--- a/xml/ru/docs/control.xml
+++ b/xml/ru/docs/control.xml
@@ -8,7 +8,7 @@
 <article name="Управление nginx"
          link="/ru/docs/control.html"
          lang="ru"
-         rev="2">
+         rev="3">
 
 <section>
 
@@ -74,12 +74,12 @@
 <para>
 Предположим, на FreeBSD 4.x команда
 <programlisting>
-ps ax -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'
+ps axw -o pid,ppid,user,%cpu,vsz,wchan,command | egrep '(nginx|PID)'
 </programlisting>
 показывает примерно такую картину:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33127 33126 nobody   0.0  1380 kqread nginx: worker process (nginx)
 33128 33126 nobody   0.0  1364 kqread nginx: worker process (nginx)
 33129 33126 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -90,8 +90,8 @@ 33129 33126 nobody   0.0  1364 kqread ng
 Если послать сигнал HUP главному процессу, то картина может быть такой:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-33129 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (n
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+33129 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (nginx)
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
@@ -103,7 +103,7 @@ 33136 33126 nobody   0.0  1368 kqread ng
 некоторого времени он завершается:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
@@ -143,11 +143,11 @@ 33136 33126 nobody   0.0  1368 kqread ng
 очередь&mdash;свои рабочие процессы:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
 33134 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
 33135 33126 nobody   0.0  1380 kqread nginx: worker process (nginx)
 33136 33126 nobody   0.0  1368 kqread nginx: worker process (nginx)
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -170,9 +170,9 @@ 36267 36264 nobody   0.0  1364 kqread ng
 рабочим процессам сообщение о плавном выходе, и они будут постепенно выходить:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-33135 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (n
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+33135 33126 nobody   0.0  1380 kqread nginx: worker process is shutting down (nginx)
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -192,8 +192,8 @@ 36267 36264 nobody   0.0  1364 kqread ng
 По истечении времени запросы будут обрабатывать только новые рабочие процессы:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sb
-36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+33126     1 root     0.0  1164 pause  nginx: master process /usr/local/nginx/sbin/nginx
+36264 33126 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
@@ -243,7 +243,7 @@ 36267 36264 nobody   0.0  1364 kqread ng
 QUIT, и останутся только новые процессы:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
-36264     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sb
+36264     1 root     0.0  1148 pause  nginx: master process /usr/local/nginx/sbin/nginx
 36265 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36266 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)
 36267 36264 nobody   0.0  1364 kqread nginx: worker process (nginx)