Add WakeupController and NFLogListener

These classes work together to parse and dispatch NFLOG messages in
response to inbound packets annotated by the WiFi driver.

Test: as follows
    - built
    - flashed
    - booted
    - netd_unit_test passes

Change-Id: Id26d62858bf4bc4186ae66850f08077adf6fc2ac
diff --git a/server/WakeupController.h b/server/WakeupController.h
new file mode 100644
index 0000000..e147f3e
--- /dev/null
+++ b/server/WakeupController.h
@@ -0,0 +1,69 @@
+/*
+ * Copyright (C) 2017 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef WAKEUP_CONTROLLER_H
+#define WAKEUP_CONTROLLER_H
+
+#include <functional>
+
+#include <netdutils/Status.h>
+
+#include "IptablesRestoreController.h"
+#include "NFLogListener.h"
+
+namespace android {
+namespace net {
+
+class WakeupController {
+  public:
+    using ReportFn = std::function<void(const std::string&, uid_t, gid_t, uint64_t)>;
+
+    // iptables chain where wakeup packets are matched
+    static const char LOCAL_MANGLE_INPUT[];
+
+    WakeupController(ReportFn report, IptablesRestoreInterface* iptables)
+        : mReport(report), mIptables(iptables) {}
+
+    ~WakeupController();
+
+    // Subscribe this controller to a NFLOG events arriving at |listener|.
+    netdutils::Status init(NFLogListenerInterface* listener);
+
+    // Install iptables rules to match packets arriving on |ifName|
+    // which match |mark|/|mask|. Metadata from matching packets will
+    // be delivered along with the arbitrary string |prefix| to
+    // INetdEventListener::onWakeupEvent.
+    netdutils::Status addInterface(const std::string& ifName, const std::string& prefix,
+                                   uint32_t mark, uint32_t mask);
+
+    // Remove iptables rules previously installed by addInterface().
+    // |ifName|, |prefix|, |mark| and |mask| must match precisely.
+    netdutils::Status delInterface(const std::string& ifName, const std::string& prefix,
+                                   uint32_t mark, uint32_t mask);
+
+  private:
+    netdutils::Status execIptables(const std::string& action, const std::string& ifName,
+                                   const std::string& prefix, uint32_t mark, uint32_t mask);
+
+    ReportFn const mReport;
+    IptablesRestoreInterface* const mIptables;
+    NFLogListenerInterface* mListener;
+};
+
+}  // namespace net
+}  // namespace android
+
+#endif /* WAKEUP_CONTROLLER_H */