Imported from /home/lorry/working-area/delta_VirtualBox/VirtualBox-4.3.10.tar.bz2.HEADVirtualBox-4.3.10master

1 files changed, 236 insertions, 0 deletions

diff --git a/src/VBox/Main/src-server/HostDnsService.h b/src/VBox/Main/src-server/HostDnsService.h
new file mode 100644
index 00000000..56da78d0
--- /dev/null
+++ b/src/VBox/Main/src-server/HostDnsService.h
@@ -0,0 +1,236 @@
+/* $Id: HostDnsService.h $ */
+/** @file
+ * Host DNS listener.
+ */
+
+/*
+ * Copyright (C) 2005-2012 Oracle Corporation
+ *
+ * This file is part of VirtualBox Open Source Edition (OSE), as
+ * available from http://www.virtualbox.org. This file is free software;
+ * you can redistribute it and/or modify it under the terms of the GNU
+ * General Public License (GPL) as published by the Free Software
+ * Foundation, in version 2 as it comes in the "COPYING" file of the
+ * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
+ * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
+ */
+
+#ifndef ___H_DNSHOSTSERVICE
+#define ___H_DNSHOSTSERVICE
+#include "VirtualBoxBase.h"
+
+#include <iprt/cdefs.h>
+#include <iprt/critsect.h>
+#include <iprt/types.h>
+
+#include <list>
+#include <vector>
+
+typedef std::list<com::Utf8Str> Utf8StrList;
+typedef Utf8StrList::iterator Utf8StrListIterator;
+
+class HostDnsMonitorProxy;
+typedef const HostDnsMonitorProxy *PCHostDnsMonitorProxy;
+
+class Lockee
+{
+  public:
+    Lockee();
+    virtual ~Lockee();
+    const RTCRITSECT* lock() const;
+
+  private:
+    RTCRITSECT mLock;
+};
+
+class ALock
+{
+  public:
+    explicit ALock(const Lockee *l);
+    ~ALock();
+
+  private:
+    const Lockee *lockee;
+};
+
+class HostDnsInformation
+{
+  public:
+    std::vector<std::string> servers;
+    std::string domain;
+    std::vector<std::string> searchList;
+};
+
+/**
+ * This class supposed to be a real DNS monitor object it should be singleton,
+ * it lifecycle starts and ends together with VBoxSVC.
+ */
+class HostDnsMonitor : public Lockee
+{
+  public:
+    static const HostDnsMonitor *getHostDnsMonitor();
+    static void shutdown();
+
+    void addMonitorProxy(PCHostDnsMonitorProxy) const;
+    void releaseMonitorProxy(PCHostDnsMonitorProxy) const;
+    const HostDnsInformation &getInfo() const;
+    /* @note: method will wait till client call
+       HostDnsService::monitorThreadInitializationDone() */
+    virtual HRESULT init();
+
+  protected:
+    explicit HostDnsMonitor(bool fThreaded = false);
+    virtual ~HostDnsMonitor();
+
+    void notifyAll() const;
+    void setInfo(const HostDnsInformation &);
+
+    /* this function used only if HostDnsMonitor::HostDnsMonitor(true) */
+    void monitorThreadInitializationDone();
+    virtual void monitorThreadShutdown() = 0;
+    virtual int monitorWorker() = 0;
+
+  private:
+    HostDnsMonitor(const HostDnsMonitor &);
+    HostDnsMonitor& operator= (const HostDnsMonitor &);
+    static int threadMonitoringRoutine(RTTHREAD, void *);
+
+  public:
+    struct Data;
+    Data *m;
+};
+
+/**
+ * This class supposed to be a proxy for events on changing Host Name Resolving configurations.
+ */
+class HostDnsMonitorProxy : public Lockee
+{
+    public:
+    HostDnsMonitorProxy();
+    ~HostDnsMonitorProxy();
+    void init(const HostDnsMonitor *aMonitor, const VirtualBox *aParent);
+    void notify() const;
+
+    HRESULT GetNameServers(ComSafeArrayOut(BSTR, aNameServers));
+    HRESULT GetDomainName(BSTR *aDomainName);
+    HRESULT GetSearchStrings(ComSafeArrayOut(BSTR, aSearchStrings));
+
+    bool operator==(PCHostDnsMonitorProxy&);
+
+    private:
+    void updateInfo();
+
+    private:
+    struct Data;
+    Data *m;
+};
+
+# ifdef RT_OS_DARWIN
+class HostDnsServiceDarwin : public HostDnsMonitor
+{
+  public:
+    HostDnsServiceDarwin();
+    ~HostDnsServiceDarwin();
+    HRESULT init();
+
+    protected:
+    virtual void monitorThreadShutdown();
+    virtual int monitorWorker();
+
+    private:
+    HRESULT updateInfo();
+    static void hostDnsServiceStoreCallback(void *store, void *arrayRef, void *info);
+    struct Data;
+    Data *m;
+};
+# endif
+# ifdef RT_OS_WINDOWS
+class HostDnsServiceWin : public HostDnsMonitor
+{
+    public:
+    HostDnsServiceWin();
+    ~HostDnsServiceWin();
+    HRESULT init();
+
+    protected:
+    virtual void monitorThreadShutdown();
+    virtual int monitorWorker();
+
+    private:
+    void strList2List(std::vector<std::string>& lst, char *strLst);
+    HRESULT updateInfo();
+
+    private:
+    struct Data;
+    Data *m;
+};
+# endif
+# if defined(RT_OS_SOLARIS) || defined(RT_OS_LINUX) || defined(RT_OS_OS2) || defined(RT_OS_FREEBSD)
+class HostDnsServiceResolvConf: public HostDnsMonitor
+{
+  public:
+    explicit HostDnsServiceResolvConf(bool fThreaded = false) : HostDnsMonitor(fThreaded), m(NULL) {}
+    virtual ~HostDnsServiceResolvConf();
+    virtual HRESULT init(const char *aResolvConfFileName);
+    const std::string& resolvConf() const;
+
+  protected:
+    HRESULT readResolvConf();
+    /* While not all hosts supports Hosts DNS change notifiaction
+     * default implementation offers return VERR_IGNORE.
+     */
+    virtual void monitorThreadShutdown() {}
+    virtual int monitorWorker() {return VERR_IGNORED;}
+
+  protected:
+    struct Data;
+    Data *m;
+};
+#  if defined(RT_OS_SOLARIS)
+/**
+ * XXX: https://blogs.oracle.com/praks/entry/file_events_notification
+ */
+class HostDnsServiceSolaris : public HostDnsServiceResolvConf
+{
+  public:
+    HostDnsServiceSolaris(){}
+    ~HostDnsServiceSolaris(){}
+    HRESULT init(){ return HostDnsServiceResolvConf::init("/etc/resolv.conf");}
+};
+
+#  elif defined(RT_OS_LINUX)
+class HostDnsServiceLinux : public HostDnsServiceResolvConf
+{
+  public:
+    HostDnsServiceLinux():HostDnsServiceResolvConf(true){}
+    virtual ~HostDnsServiceLinux();
+    virtual HRESULT init(){ return HostDnsServiceResolvConf::init("/etc/resolv.conf");}
+
+  protected:
+    virtual void monitorThreadShutdown();
+    virtual int monitorWorker();
+};
+
+#  elif defined(RT_OS_FREEBSD)
+class HostDnsServiceFreebsd: public HostDnsServiceResolvConf
+{
+    public:
+    HostDnsServiceFreebsd(){}
+    ~HostDnsServiceFreebsd(){}
+    HRESULT init(){ return HostDnsServiceResolvConf::init("/etc/resolv.conf");}
+};
+
+#  elif defined(RT_OS_OS2)
+class HostDnsServiceOs2 : public HostDnsServiceResolvConf
+{
+  public:
+    HostDnsServiceOs2(){}
+    ~HostDnsServiceOs2(){}
+    /* XXX: \\MPTN\\ETC should be taken from environment variable ETC  */
+    HRESULT init(){ return init("\\MPTN\\ETC\\RESOLV2");}
+};
+
+#  endif
+# endif
+
+#endif /* !___H_DNSHOSTSERVICE */