summaryrefslogtreecommitdiff
path: root/tun/wintun/namespaceapi/namespaceapi_windows.go
diff options
context:
space:
mode:
Diffstat (limited to 'tun/wintun/namespaceapi/namespaceapi_windows.go')
-rw-r--r--tun/wintun/namespaceapi/namespaceapi_windows.go83
1 files changed, 83 insertions, 0 deletions
diff --git a/tun/wintun/namespaceapi/namespaceapi_windows.go b/tun/wintun/namespaceapi/namespaceapi_windows.go
new file mode 100644
index 0000000..a7637ae
--- /dev/null
+++ b/tun/wintun/namespaceapi/namespaceapi_windows.go
@@ -0,0 +1,83 @@
+/* SPDX-License-Identifier: MIT
+ *
+ * Copyright (C) 2019 WireGuard LLC. All Rights Reserved.
+ */
+
+package namespaceapi
+
+import "golang.org/x/sys/windows"
+
+//sys createBoundaryDescriptor(name *uint16, flags uint32) (handle windows.Handle, err error) = kernel32.CreateBoundaryDescriptorW
+//sys deleteBoundaryDescriptor(boundaryDescriptor windows.Handle) = kernel32.DeleteBoundaryDescriptor
+//sys addSIDToBoundaryDescriptor(boundaryDescriptor windows.Handle, requiredSid *windows.SID) (err error) = kernel32.AddSIDToBoundaryDescriptor
+//sys createPrivateNamespace(privateNamespaceAttributes *windows.SecurityAttributes, boundaryDescriptor windows.Handle, aliasPrefix *uint16) (handle windows.Handle, err error) = kernel32.CreatePrivateNamespaceW
+//sys openPrivateNamespace(boundaryDescriptor windows.Handle, aliasPrefix *uint16) (handle windows.Handle, err error) = kernel32.OpenPrivateNamespaceW
+//sys closePrivateNamespace(handle windows.Handle, flags uint32) (err error) = kernel32.ClosePrivateNamespace
+
+// BoundaryDescriptor represents a boundary that defines how the objects in the namespace are to be isolated.
+type BoundaryDescriptor windows.Handle
+
+// CreateBoundaryDescriptor creates a boundary descriptor.
+func CreateBoundaryDescriptor(name string) (BoundaryDescriptor, error) {
+ name16, err := windows.UTF16PtrFromString(name)
+ if err != nil {
+ return 0, err
+ }
+ handle, err := createBoundaryDescriptor(name16, 0)
+ if err != nil {
+ return 0, err
+ }
+ return BoundaryDescriptor(handle), nil
+}
+
+// Delete deletes the specified boundary descriptor.
+func (bd BoundaryDescriptor) Delete() {
+ deleteBoundaryDescriptor(windows.Handle(bd))
+}
+
+// AddSid adds a security identifier (SID) to the specified boundary descriptor.
+func (bd BoundaryDescriptor) AddSid(requiredSid *windows.SID) error {
+ return addSIDToBoundaryDescriptor(windows.Handle(bd), requiredSid)
+}
+
+// PrivateNamespace represents a private namespace. Duh?!
+type PrivateNamespace windows.Handle
+
+// CreatePrivateNamespace creates a private namespace.
+func CreatePrivateNamespace(privateNamespaceAttributes *windows.SecurityAttributes, boundaryDescriptor BoundaryDescriptor, aliasPrefix string) (PrivateNamespace, error) {
+ aliasPrefix16, err := windows.UTF16PtrFromString(aliasPrefix)
+ if err != nil {
+ return 0, err
+ }
+ handle, err := createPrivateNamespace(privateNamespaceAttributes, windows.Handle(boundaryDescriptor), aliasPrefix16)
+ if err != nil {
+ return 0, err
+ }
+ return PrivateNamespace(handle), nil
+}
+
+// OpenPrivateNamespace opens a private namespace.
+func OpenPrivateNamespace(boundaryDescriptor BoundaryDescriptor, aliasPrefix string) (PrivateNamespace, error) {
+ aliasPrefix16, err := windows.UTF16PtrFromString(aliasPrefix)
+ if err != nil {
+ return 0, err
+ }
+ handle, err := openPrivateNamespace(windows.Handle(boundaryDescriptor), aliasPrefix16)
+ if err != nil {
+ return 0, err
+ }
+ return PrivateNamespace(handle), nil
+}
+
+// ClosePrivateNamespaceFlags describes flags that are used by PrivateNamespace's Close() method.
+type ClosePrivateNamespaceFlags uint32
+
+const (
+ // PrivateNamespaceFlagDestroy makes the close to destroy the namespace.
+ PrivateNamespaceFlagDestroy = ClosePrivateNamespaceFlags(0x1)
+)
+
+// Close closes an open namespace handle.
+func (pns PrivateNamespace) Close(flags ClosePrivateNamespaceFlags) error {
+ return closePrivateNamespace(windows.Handle(pns), uint32(flags))
+}