1
0
mirror of https://github.com/nmap/nmap.git synced 2025-12-27 01:49:03 +00:00

Remove trailing whitespace in lua files

Whitespace is not significant, so this should not be a problem.
https://secwiki.org/w/Nmap/Code_Standards
This commit is contained in:
dmiller
2014-01-23 21:51:58 +00:00
parent 86ac3c0a19
commit 620f9fdb34
499 changed files with 11134 additions and 11134 deletions

View File

@@ -6,7 +6,7 @@
-- Overview
-- --------
-- The library consists of the following classes:
--
--
-- o SessionData
-- - Holds session data for the SIP session
--
@@ -31,7 +31,7 @@
--
-- o Helper
-- - A class containing code used as a primary interface by scripts
--
--
--
-- @author "Patrik Karlsson <patrik@cqure.net>"
-- @copyright Same as Nmap--See http://nmap.org/book/man-legal.html
@@ -75,7 +75,7 @@ Error = {
-- The SessionData class
SessionData = {
--- Creates a new instance of sessiondata
-- @return o an instance of SessionData
new = function(self, o)
@@ -85,7 +85,7 @@ SessionData = {
o.user = "user"
return o
end,
--- Sets the session username
-- @param user string containing the username
setUsername = function(self, user) self.user = user end,
@@ -111,19 +111,19 @@ SessionData = {
--- Sets the SIP users Full Name
-- @param name string containing the full name of the user
setName = function(self, name) self.name = name end,
--- Retrieves the username
-- @return user string containing the sessions username
getUsername = function(self) return self.user end,
--- Retrieves the session password
-- @return pass string containing the session password
getPassword = function(self) return self.pass end,
--- Retrieves the SIP domain
-- @return domain string containing the SIP domain
getDomain = function(self) return self.domain end,
--- Retrieves the client IP and port
-- @return host string containing the client IP
-- @return port number containing the client port
@@ -158,13 +158,13 @@ Session = {
o.expires = (options and options.expires) or 300
o.conn = Connection:new(host,port)
o.cseq = (options and options.cseq) or 1234
local timeout = ( ( options and options.timeout ) and
local timeout = ( ( options and options.timeout ) and
options.timeout * 1000 ) or 5000
o.conn.socket:set_timeout( timeout )
o.sessdata = sessdata or SessionData:new()
return o
end,
--- Connect the session
-- @return true on success, false on failure
-- @return err string containing error message
@@ -181,12 +181,12 @@ Session = {
self.sessdata:setServer(rhost, rport)
return true
end,
--- Closes the session
-- TODO: We should probably send some "closing" packets here
-- @return true on success, false on failure
close = function(self) return self.conn:close() end,
--- Sends and SIP invite
-- @param uri
invite = function(self, uri)
@@ -194,10 +194,10 @@ Session = {
local lhost, _ = self.sessdata:getClient()
local tm = os.time()
local uri = (uri and uri:match("^sip:.*@.*")) or
local uri = (uri and uri:match("^sip:.*@.*")) or
("sip:%s@%s"):format(uri, self.sessdata:getDomain())
request:setUri(uri)
request:setSessionData(self.sessdata)
@@ -212,13 +212,13 @@ Session = {
request:setContent(stdnse.strjoin("\r\n", data))
request:setContentType("application/sdp")
local status, response = self:exch(request)
if ( not(status) ) then return false, response end
local errcode = response:getErrorCode()
if ( Error.PROXY_AUTH_REQUIRED == errcode or
if ( Error.PROXY_AUTH_REQUIRED == errcode or
Error.UNAUTHORIZED == errcode ) then
-- Send an ACK to the server
@@ -232,19 +232,19 @@ Session = {
status, data = self:authenticate(request, response)
if ( not(status) ) then return false, "SIP Authentication failed" end
response = Response:new(data)
-- read a bunch of 180 Ringing and 100 Trying requests, until we get a 200 OK
while ( response:getErrorCode() ~= Error.OK ) do
status, data = self.conn:recv()
if ( not(status) ) then return status, "ERROR: Failed to receive response" end
response = Response:new(data)
end
end
return true
end,
--- Prepares and sends the challenge response authentication to the server
-- @param request instance of the request object requiring authentication
-- @param authdata string containing authentication data
@@ -252,7 +252,7 @@ Session = {
-- @return err string containing an error message if status is false
authenticate = function(self, request, response)
local rhost, _ = self.sessdata:getServer()
local auth_header, auth_data = response:getAuthData()
local auth_header, auth_data = response:getAuthData()
local auth = SipAuth:new(auth_data)
auth:setUsername(self.sessdata:getUsername())
auth:setPassword(self.sessdata:getPassword())
@@ -276,7 +276,7 @@ Session = {
end
return status, data
end,
--- Sends a SIP Request and receives the Response
-- @param request instance of Request
-- @return status true on success, false on failure
@@ -284,31 +284,31 @@ Session = {
-- err containing error message if status is false
exch = function(self, request)
request:setCseq(self.cseq)
local status, err = self.conn:send( tostring(request) )
if ( not(status) ) then return status, "ERROR: Failed to send request" end
local status, data = self.conn:recv()
if ( not(status) ) then return status, "ERROR: Failed to receive response" end
return true, Response:new(data)
end,
--- Sends a register request to the server
-- @return status true on success, false on failure
-- @return msg string containing the error message (if status is false)
register = function(self)
local request = Request:new(Method.REGISTER, self.protocol)
request:setUri("sip:" .. self.sessdata:getServer())
request:setSessionData(self.sessdata)
request:setExpires(self.expires)
local status, response = self:exch(request)
if (not(status)) then return false, response end
local errcode = response:getErrorCode()
if ( status and errcode == Error.OK ) then
return true, response
elseif ( Error.PROXY_AUTH_REQUIRED == errcode or Error.UNAUTHORIZED == errcode ) then
@@ -316,7 +316,7 @@ Session = {
self.cseq = self.cseq + 1
status, data = self:authenticate(request, response)
response = Response:new(data)
errcode = response:getErrorCode()
errcode = response:getErrorCode()
if ( not(status) or ( errcode and errcode ~= Error.OK ) ) then
return false, "ERROR: Failed to authenticate"
end
@@ -327,7 +327,7 @@ Session = {
end
return true
end,
--- Sends an option request to the server and handles the response
-- @return status true on success, false on failure
-- @return response if status is true, nil else.
@@ -348,7 +348,7 @@ Session = {
-- The connection class contains basic communication code
Connection = {
--- Creates a new SIP Connection
-- @param host table containing the host to connect to
-- @param port table containing the port to connect to
@@ -362,7 +362,7 @@ Connection = {
o.socket = nmap.new_socket()
return o
end,
--- Connects to the server
-- @return status containing true on success and false on failure
-- @return err containing the error message (if status is false)
@@ -377,7 +377,7 @@ Connection = {
end
return status, err
end,
--- Sends the data over the socket
-- @return status true on success, false on failure
send = function(self, data)
@@ -395,7 +395,7 @@ Connection = {
close = function(self)
return self.socket:close()
end,
--- Retrieves the client ip and port
-- @return lhost string containing the local ip
-- @return lport number containing the local port
@@ -405,13 +405,13 @@ Connection = {
-- @return rhost string containing the server ip
-- @return rport number containing the server port
getServer = function(self) return ( self.host.ip or self.host ), ( self.port.number or self.port ) end,
}
-- The response class holds the necessary methods and parameters to parse a response
Response = {
--- Creates a new Response instance
-- @param str containing the data as received over the socket
-- @return o table containing a new Response instance
@@ -422,7 +422,7 @@ Response = {
o.tbl = stdnse.strsplit("\r\n", str)
return o
end,
--- Retrieves a given header value from the response
-- @param name string containing the name of the header
-- @return value string containing the header value
@@ -430,40 +430,40 @@ Response = {
for _, line in ipairs(self.tbl) do
local header, value = line:match("^(.-): (.*)$")
if ( header and header:lower() == name:lower() ) then
return value
return value
end
end
end,
--- Returns the error code from the SIP response
-- @return err number containing the error code
getErrorCode = function(self)
return tonumber(self.tbl[1]:match("SIP/%d%.%d (%d+)"))
end,
--- Returns the error message returned by the server
-- @return errmsg string containing the error message
getErrorMessage = function(self)
return self.tbl[1]:match("^SIP/%d%.%d %d+ (.+)$")
end,
--- Returns the message method
-- @return method string containing the method
getMethod = function(self)
return self.tbl[1]:match("^(.-)%s.*SIP/2%.0$")
end,
--- Returns the authentication data from the SIP response
-- @return auth string containing the raw authentication data
getAuthData = function(self)
local auth = self:getHeader("WWW-Authenticate") or self:getHeader("Proxy-Authenticate")
if ( auth ) then
return ( self:getHeader("WWW-Authenticate") and
"WWW-Authenticate" or
return ( self:getHeader("WWW-Authenticate") and
"WWW-Authenticate" or
"Proxy-Authenticate"), auth
end
end,
--- Retrieves the current sequence number
-- @return cseq number containing the current sequence number
getCSeq = function(self)
@@ -471,12 +471,12 @@ Response = {
cseq = (cseq and cseq:match("^(%d+)"))
return (cseq and tonumber(cseq))
end,
}
-- The request class holds the necessary functions and parameters for a basic SIP request
Request = {
--- Creates a new Request instance
-- @param method string containing the request method to use
-- @param proto Used protocol, could be "UDP" or "TCP"
@@ -485,7 +485,7 @@ Request = {
local o = {}
setmetatable(o, self)
self.__index = self
o.ua = "Nmap NSE"
o.protocol = proto or "UDP"
o.expires = 0
@@ -498,11 +498,11 @@ Request = {
o.cid = Util.get_random_string(60)
return o
end,
--- Sets the sessiondata so that session information may be fetched
-- @param data instance of SessionData
setSessionData = function(self, data) self.sessdata = data end,
--- Adds a custom header to the request
-- @param name string containing the header name
-- @param value string containing the header value
@@ -510,28 +510,28 @@ Request = {
self.headers = self.headers or {}
table.insert(self.headers, ("%s: %s"):format(name, value))
end,
--- Sets the SIP uri
-- @param uri string containing the SIP uri
setUri = function(self, uri) self.uri = uri end,
--- Sets an error
-- @param code number containing the error code
-- @param msg string containing the error message
setError = function(self, code, msg) self.error = { code = code, msg = msg } end,
--- Sets the request method
-- @param method string containing a valid SIP method (@see Method constant)
setMethod = function(self, method) self.method = method end,
--- Sets the sequence number
-- @param seq number containing the sequence number to set
setCseq = function(self, seq) self.cseq = seq end,
--- Sets the allow header
-- @param allow table containing all of the allowed SIP methods
setAllow = function(self, allow) self.allow = stdnse.strjoin(", ", allow) end,
--- Sets the request content data
-- @param string containing the content data
setContent = function(self, content) self.content = content end,
@@ -543,15 +543,15 @@ Request = {
--- Sets the supported SIP methods
-- @param supported string containing the supported methods
setSupported = function(self, supported) self.supported = supported end,
--- Sets the content-length of the SIP request
-- @param len number containing the length of the actual request
setContentLength = function(self, len) self.length = len end,
--- Sets the expires header of the SIP request
-- @param expires number containing the expire value
setExpires = function(self, expires) self.expires = expires end,
--- Sets the User Agent being used to connect to the SIP server
-- @param ua string containing the User-Agent name (defaults to Nmap NSE)
setUA = function(self, ua) self.ua = ua end,
@@ -559,19 +559,19 @@ Request = {
--- Sets the caller ID information of the SIP request
-- @param cid string containing the callers id
setCallId = function(self, cid) self.cid = cid end,
--- Sets the maximum forwards allowed of this request
-- @param maxfwd number containing the maximum allowed forwards
setForwards = function(self, maxfwd) self.maxfwd = maxfwd end,
--- Sets the proxy authentication data
-- @param auth string containing properly formatted proxy authentication data
setProxyAuth = function(self, auth) self.proxyauth = auth end,
--- Sets the www authentication data
-- @param auth string containing properly formatted proxy authentication data
setWWWAuth = function(self, auth) self.wwwauth = auth end,
--- Specifies the network protocol being used
-- @param proto should be either "UDP" or "TCP"
setProtocol = function(self, proto)
@@ -579,7 +579,7 @@ Request = {
self.protocol = proto
end,
--- Converts the request to a String suitable to be sent over the socket
-- @return ret string containing the complete request for sending over the socket
__tostring = function(self)
@@ -590,15 +590,15 @@ Request = {
local sessdata = self.sessdata
local lhost, lport = sessdata:getClient()
local rhost, rport = sessdata:getServer()
local name, user, domain = sessdata:getName(), sessdata:getUsername(), sessdata:getDomain()
assert(self.method, "No method specified")
assert(self.maxfwd, "Max forward not set")
-- if no domain was specified use the remote host instead
domain = domain or rhost
if ( self.error ) then
table.insert(data, ("SIP/2.0 %s %d"):format(self.error.msg, self.error.code))
else
@@ -611,15 +611,15 @@ Request = {
table.insert(data, ("Via: SIP/2.0/%s %s:%d;rport;branch=%s"):format(self.protocol, lhost, lport, branch))
table.insert(data, ("Max-Forwards: %d"):format(self.maxfwd))
table.insert(data, ("From: \"%s\" <sip:%s@%s>;tag=%s"):format(name, user, domain, self.from_tag))
if ( self.method == Method.INVITE ) then
table.insert(data, ("To: <sip:%s@%s>"):format(user, domain))
else
table.insert(data, ("To: \"%s\" <sip:%s@%s>"):format(name, user, domain))
end
table.insert(data, ("Call-ID: %s"):format(self.cid))
if ( self.error and self.error.code == Error.OK ) then
table.insert(data, ("CSeq: %d OPTIONS"):format(self.cseq))
else
@@ -638,9 +638,9 @@ Request = {
if ( self.supported ) then
table.insert(data, ("Supported: %s"):format(self.supported))
end
if ( not(self.error) ) then
if ( self.proxyauth ) then
if ( self.proxyauth ) then
table.insert(data, ("Proxy-Authorization: %s"):format(self.proxyauth))
end
if ( self.wwwauth ) then
@@ -664,22 +664,22 @@ Request = {
table.insert(data, "")
else
self.length = (self.content and #self.content +2 or 0)
table.insert(data, ("Content-Length: %d"):format(self.length))
table.insert(data, "")
end
return stdnse.strjoin("\r\n", data)
end,
}
-- A minimal Util class with supporting functions
Util = {
--- Generates a random string of the requested length.
-- @param length (optional) The length of the string to return. Default: 8.
-- @param set (optional) The set of letters to choose from. Default: upper, lower, numbers, and underscore.
-- @return The random string.
--- Generates a random string of the requested length.
-- @param length (optional) The length of the string to return. Default: 8.
-- @param set (optional) The set of letters to choose from. Default: upper, lower, numbers, and underscore.
-- @return The random string.
get_random_string = function(length, set)
if(length == nil) then
length = 8
@@ -698,12 +698,12 @@ Util = {
return str
end
}
-- The SIP authentication class, supporting MD5 digest authentication
SipAuth = {
--- Creates a new SipAuth instance
-- @param auth string containing the auth data as received from the server
new = function(self, auth)
@@ -713,46 +713,46 @@ SipAuth = {
o.auth = auth
return o
end,
--- Sets the username used for authentication
-- @param username string containing the name of the user
setUsername = function(self, username) self.username = username end,
--- Sets the password used for authentication
-- @param password string containing the password of the user
setPassword = function(self, password) self.password = password end,
--- Sets the method used for authentication
-- @param method string containing the method (Usually REGISTER)
setMethod = function(self, method) self.method = method end,
--- Sets the uri used for authentication
-- @param uri string containing the uri (Usually sip:<ip>)
setUri = function(self, uri) self.uri = uri end,
--- Processes and parses a challenge as received from the server
parseChallenge = function(self)
if ( not(self.auth) ) then return end
self.nonce = self.auth:match("nonce=[\"]([^,]-)[\"]")
self.algorithm = self.auth:match("algorithm=[\"]*(.-)[\"]*,")
self.realm = self.auth:match("realm=[\"]([^,]-)[\"]")
assert(self.algorithm:upper() == "MD5",
assert(self.algorithm:upper() == "MD5",
("Unsupported algorithm detected in authentication challenge (%s)"):format(self.algorithm:upper()))
end,
--- Calculates the authentication response
-- @return reponse string containing the authentication response
calculateResponse = function(self)
if ( not(self.nonce) or not(self.algorithm) or not(self.realm) ) then
self:parseChallenge()
end
assert(self.username, "SipAuth: No username specified")
assert(self.password, "SipAuth: No password specified")
assert(self.method, "SipAuth: No method specified")
assert(self.uri, "SipAuth: No uri specified")
local result
if ( self.algorithm == "MD5" ) then
local HA1 = select(2, bin.unpack("H16", openssl.md5(self.username .. ":" .. self.realm .. ":" .. self.password)))
@@ -761,7 +761,7 @@ SipAuth = {
end
return select(2, bin.unpack("H16", result)):lower()
end,
--- Creates the complete authentication response
-- @return auth string containing the complete authentication digest
createResponse = function(self)
@@ -770,12 +770,12 @@ SipAuth = {
" uri=\"%s\", response=\"%s\", algorithm=%s"):format(self.username, self.realm,
self.nonce, self.uri, response, self.algorithm)
end,
}
-- The Helper class used as main script interface
Helper = {
--- Creates a new instance of the Helper class
-- @param host table containing the remote host
-- @param port table containing the remote port
@@ -789,7 +789,7 @@ Helper = {
local timeout = stdnse.get_script_args("sip.timeout")
if ( timeout ) then options.timeout = timeout end
o.sessdata = SessionData:new()
o.session = Session:new(host, port, o.sessdata, options)
o.session = Session:new(host, port, o.sessdata, options)
return o
end,
@@ -797,7 +797,7 @@ Helper = {
connect = function(self) return self.session:connect() end,
--- Disconnects and closes the helper instance
close = function(self) return self.session:close() end,
close = function(self) return self.session:close() end,
--- Sets the credentials used when performing authentication
-- @param username string containing the username to use for authentication
@@ -812,7 +812,7 @@ Helper = {
setDomain = function(self, domain) self.sessdata:setDomain(domain) end,
--- Register the UAC with the server
-- @param options table containing zero or more options
-- @param options table containing zero or more options
-- (@see Session:register for more details)
-- @return status true on success, false on failure
-- @return msg containing the error message if status is false
@@ -823,14 +823,14 @@ Helper = {
end,
options = function(self) return self.session:options() end,
--- Attempts to INVITE the user at uri to a call
-- @param uri string containing the sip uri
-- @return status true on success, false on failure
invite = function(self, uri)
return self.session:invite(uri)
end,
}
return _ENV;