mirror of
https://github.com/nmap/nmap.git
synced 2025-12-29 02:49:01 +00:00
Normalize NSEDoc documentation of scripts.
I made every script follow a standard form: it starts with the id, followed by the description. The description is contained in [[ ]] delimiters. The description is in the global description variable, not in a LuaDoc comment. Other LuaDoc information such as @args and @usage follows the description in a comment. The first paragraph of each description is a a short summary of what the script does. More detailed information, if any, is given in following paragraphs. I also improved some wording and formatting in a few cases.
This commit is contained in:
@@ -1,10 +1,14 @@
|
||||
--- Connects to a MySQL server and prints information such as the protocol and
|
||||
--- version numbers, thread id, status, capabilities and the password salt
|
||||
--
|
||||
-- If service detection is performed and the server appears to be blocking
|
||||
-- our host or is blocked from too many connections, then we don't bother
|
||||
-- running this script (see the portrule)
|
||||
--
|
||||
id = "MySQL Server Information"
|
||||
description = [[
|
||||
Connects to a MySQL server and prints information such as the protocol and
|
||||
version numbers, thread ID, status, capabilities, and the password salt.
|
||||
\n\n
|
||||
If service detection is performed and the server appears to be blocking
|
||||
our host or is blocked from too many connections, then we don't bother
|
||||
running this script (see the portrule).
|
||||
]]
|
||||
|
||||
---
|
||||
--@output
|
||||
-- 3306/tcp open mysql \n
|
||||
-- | MySQL Server Information: Protocol: 10 \n
|
||||
@@ -16,10 +20,6 @@
|
||||
|
||||
-- Many thanks to jah (jah@zadkiel.plus.com) for testing and enhancements
|
||||
|
||||
id = "MySQL Server Information"
|
||||
|
||||
description = "Connects to a MySQL server and prints information"
|
||||
|
||||
author = "Kris Katterjohn <katterjohn@gmail.com>"
|
||||
|
||||
license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
|
||||
|
||||
Reference in New Issue
Block a user