84 lines
3.3 KiB
Go
84 lines
3.3 KiB
Go
|
/* 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))
|
||
|
|
}
|