2019-05-08 12:47:52 +02:00
|
|
|
#!/usr/bin/env python
|
2010-03-26 23:23:25 +00:00
|
|
|
|
|
|
|
|
"""
|
2026-01-01 19:12:07 +01:00
|
|
|
Copyright (c) 2006-2026 sqlmap developers (https://sqlmap.org)
|
2017-10-11 14:50:46 +02:00
|
|
|
See the file 'LICENSE' for copying permission
|
2010-03-26 23:23:25 +00:00
|
|
|
"""
|
|
|
|
|
|
2010-03-31 10:50:47 +00:00
|
|
|
import os
|
|
|
|
|
|
2010-03-26 23:23:25 +00:00
|
|
|
from lib.core.data import conf
|
|
|
|
|
from lib.core.data import logger
|
2012-12-06 14:14:19 +01:00
|
|
|
from lib.core.exception import SqlmapFilePathException
|
|
|
|
|
from lib.core.exception import SqlmapUndefinedMethod
|
2010-03-26 23:23:25 +00:00
|
|
|
|
2019-05-29 16:42:04 +02:00
|
|
|
class Connector(object):
|
2010-03-26 23:23:25 +00:00
|
|
|
"""
|
|
|
|
|
This class defines generic dbms protocol functionalities for plugins.
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
def __init__(self):
|
|
|
|
|
self.connector = None
|
|
|
|
|
self.cursor = None
|
2018-11-04 14:36:38 +01:00
|
|
|
self.hostname = None
|
2010-03-26 23:23:25 +00:00
|
|
|
|
|
|
|
|
def initConnection(self):
|
2017-07-03 14:17:11 +02:00
|
|
|
self.user = conf.dbmsUser or ""
|
|
|
|
|
self.password = conf.dbmsPass or ""
|
2010-03-26 23:23:25 +00:00
|
|
|
self.hostname = conf.hostname
|
|
|
|
|
self.port = conf.port
|
|
|
|
|
self.db = conf.dbmsDb
|
|
|
|
|
|
2013-04-15 14:31:27 +02:00
|
|
|
def printConnected(self):
|
2019-05-07 15:59:26 +02:00
|
|
|
if self.hostname and self.port:
|
2019-05-07 16:37:32 +02:00
|
|
|
infoMsg = "connection to %s server '%s:%d' established" % (conf.dbms, self.hostname, self.port)
|
2019-05-07 15:59:26 +02:00
|
|
|
logger.info(infoMsg)
|
2010-11-03 10:08:27 +00:00
|
|
|
|
2010-03-30 13:52:47 +00:00
|
|
|
def closed(self):
|
2019-05-07 15:59:26 +02:00
|
|
|
if self.hostname and self.port:
|
2019-05-07 16:37:32 +02:00
|
|
|
infoMsg = "connection to %s server '%s:%d' closed" % (conf.dbms, self.hostname, self.port)
|
2018-11-04 14:36:38 +01:00
|
|
|
logger.info(infoMsg)
|
2010-03-26 23:23:25 +00:00
|
|
|
|
2010-03-31 10:50:47 +00:00
|
|
|
self.connector = None
|
|
|
|
|
self.cursor = None
|
|
|
|
|
|
2013-01-18 11:21:23 +01:00
|
|
|
def initCursor(self):
|
2010-03-31 10:50:47 +00:00
|
|
|
self.cursor = self.connector.cursor()
|
|
|
|
|
|
|
|
|
|
def close(self):
|
2012-01-20 00:11:19 +00:00
|
|
|
try:
|
2013-04-15 10:33:25 +02:00
|
|
|
if self.cursor:
|
|
|
|
|
self.cursor.close()
|
|
|
|
|
if self.connector:
|
|
|
|
|
self.connector.close()
|
2019-01-22 01:20:27 +01:00
|
|
|
except Exception as ex:
|
|
|
|
|
logger.debug(ex)
|
2012-01-20 00:11:19 +00:00
|
|
|
finally:
|
|
|
|
|
self.closed()
|
2010-03-31 10:50:47 +00:00
|
|
|
|
|
|
|
|
def checkFileDb(self):
|
|
|
|
|
if not os.path.exists(self.db):
|
|
|
|
|
errMsg = "the provided database file '%s' does not exist" % self.db
|
2013-01-03 23:20:55 +01:00
|
|
|
raise SqlmapFilePathException(errMsg)
|
2010-03-31 10:50:47 +00:00
|
|
|
|
2010-03-26 23:23:25 +00:00
|
|
|
def connect(self):
|
2011-04-30 13:20:05 +00:00
|
|
|
errMsg = "'connect' method must be defined "
|
2021-03-11 11:11:29 +01:00
|
|
|
errMsg += "inside the specific DBMS plugin"
|
2013-01-03 23:20:55 +01:00
|
|
|
raise SqlmapUndefinedMethod(errMsg)
|
2010-03-26 23:23:25 +00:00
|
|
|
|
|
|
|
|
def fetchall(self):
|
2011-04-30 13:20:05 +00:00
|
|
|
errMsg = "'fetchall' method must be defined "
|
2021-03-11 11:11:29 +01:00
|
|
|
errMsg += "inside the specific DBMS plugin"
|
2013-01-03 23:20:55 +01:00
|
|
|
raise SqlmapUndefinedMethod(errMsg)
|
2010-03-26 23:23:25 +00:00
|
|
|
|
|
|
|
|
def execute(self, query):
|
2011-04-30 13:20:05 +00:00
|
|
|
errMsg = "'execute' method must be defined "
|
2021-03-11 11:11:29 +01:00
|
|
|
errMsg += "inside the specific DBMS plugin"
|
2013-01-03 23:20:55 +01:00
|
|
|
raise SqlmapUndefinedMethod(errMsg)
|
2010-03-26 23:23:25 +00:00
|
|
|
|
|
|
|
|
def select(self, query):
|
2011-04-30 13:20:05 +00:00
|
|
|
errMsg = "'select' method must be defined "
|
2021-03-11 11:11:29 +01:00
|
|
|
errMsg += "inside the specific DBMS plugin"
|
2013-01-03 23:20:55 +01:00
|
|
|
raise SqlmapUndefinedMethod(errMsg)
|