PenTest/nmap
1
0
Fork 0
mirror of https://github.com/nmap/nmap.git synced 2025-12-26 09:29:01 +00:00
Code Issues Projects Releases Wiki Activity

Replace 'master' with 'controller thread' in NSE script docs/comments

Browse Source
This commit is contained in:
dmiller
2020-06-18 17:14:48 +00:00
parent 233d3a3691
commit 030a58a26e
4 changed files with 13 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

14
docs/scripting.xml
View File

@@ -3402,11 +3402,11 @@ end
<para>
For example, consider the earlier <xref
linkend="nse-worker-example"/>. Until all
the workers finish, the master thread must sleep. Note that we cannot
the workers finish, the controller thread must sleep. Note that we cannot
<literal>poll</literal> for results like in a traditional operating
system thread because NSE does not preempt Lua threads. Instead,
we use a condition variable that the master thread
<emphasis>waits</emphasis> on until awakened by a worker. The master
we use a condition variable that the controller thread
<emphasis>waits</emphasis> on until awakened by a worker. The controller
will continually wait until all workers have terminated.
</para>
@@ -3474,11 +3474,11 @@ end
<para>
When using condition variables, it is important to check the predicate
before and after waiting. A predicate is a test on whether to continue
doing work within a worker or master thread. For worker
doing work within a worker or controller thread. For worker
threads, this will at the very least include a test to see if the
master thread is still alive. You do not want to continue doing work
controller is still alive. You do not want to continue doing work
when there's no thread to use your results. A typical test before waiting
may be: Check whether the master is still running; if not, then quit.
may be: Check whether the controller is still running; if not, then quit.
Check if is work to be done; if not, then wait.
</para>
@@ -3490,7 +3490,7 @@ end
The usual, but not only, reason that this may happen
is the termination of one of the threads using the condition variable. This
is an important guarantee NSE makes that allows you to avoid deadlock
where a worker or master waits for a thread to wake them up that ended
where a worker or controller waits for a thread to wake them up that ended
without signaling the condition variable.
</para>
</sect2>