systemextensions

package
v0.19.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Aug 11, 2026 License: MIT Imports: 13 Imported by: 0

Documentation

Rendered for darwin/amd64

Overview

Package systemextensions provides a fluent Go API over the macOS SystemExtensions framework.

Construction

New… functions create objects; each With… method sets one property and returns its receiver, so configuration calls chain. A <Type>FromID constructor adopts an Objective-C object obtained elsewhere.

Lifecycle

A wrapper releases its Objective-C object automatically once the garbage collector finds it unreachable. Call Release to relinquish the reference deterministically (for objects holding scarce resources); Release is idempotent, and afterwards the wrapper's methods are no-ops returning zero values.

Errors

Failing calls return errors carrying the Objective-C error domain and code. Match them against this package's Err… sentinel values with errors.Is, or inspect domain, code, and Apple's prose via errors.As with *errkit.Error.

Delegates

A …Delegate interface is implemented by a plain Go value and installed with the matching With… setter; the package builds the Objective-C delegate object behind the scenes. Optional protocol methods are separate one-method …Handler interfaces — implement the ones you need on the same value and the framework calls them too.

Index

Constants

This section is empty.

Variables

View Source
var ErrAuthorizationRequired = errkit.New("OSSystemExtensionErrorDomain", 13)

ErrAuthorizationRequired matches the SystemExtensions error OSSystemExtensionErrorAuthorizationRequired.

View Source
var ErrCodeSignatureInvalid = errkit.New("OSSystemExtensionErrorDomain", 8)

ErrCodeSignatureInvalid matches the SystemExtensions error OSSystemExtensionErrorCodeSignatureInvalid.

View Source
var ErrDuplicateExtensionIdentifer = errkit.New("OSSystemExtensionErrorDomain", 6)

ErrDuplicateExtensionIdentifer matches the SystemExtensions error OSSystemExtensionErrorDuplicateExtensionIdentifer.

View Source
var ErrExtensionMissingIdentifier = errkit.New("OSSystemExtensionErrorDomain", 5)

ErrExtensionMissingIdentifier matches the SystemExtensions error OSSystemExtensionErrorExtensionMissingIdentifier.

View Source
var ErrExtensionNotFound = errkit.New("OSSystemExtensionErrorDomain", 4)

ErrExtensionNotFound matches the SystemExtensions error OSSystemExtensionErrorExtensionNotFound.

View Source
var ErrForbiddenBySystemPolicy = errkit.New("OSSystemExtensionErrorDomain", 10)

ErrForbiddenBySystemPolicy matches the SystemExtensions error OSSystemExtensionErrorForbiddenBySystemPolicy.

View Source
var ErrMissingEntitlement = errkit.New("OSSystemExtensionErrorDomain", 2)

ErrMissingEntitlement matches the SystemExtensions error OSSystemExtensionErrorMissingEntitlement.

View Source
var ErrRequestCanceled = errkit.New("OSSystemExtensionErrorDomain", 11)

ErrRequestCanceled matches the SystemExtensions error OSSystemExtensionErrorRequestCanceled.

View Source
var ErrRequestSuperseded = errkit.New("OSSystemExtensionErrorDomain", 12)

ErrRequestSuperseded matches the SystemExtensions error OSSystemExtensionErrorRequestSuperseded.

View Source
var ErrUnknown = errkit.New("OSSystemExtensionErrorDomain", 1)

ErrUnknown matches the SystemExtensions error OSSystemExtensionErrorUnknown.

View Source
var ErrUnknownExtensionCategory = errkit.New("OSSystemExtensionErrorDomain", 7)

ErrUnknownExtensionCategory matches the SystemExtensions error OSSystemExtensionErrorUnknownExtensionCategory.

View Source
var ErrUnsupportedParentBundleLocation = errkit.New("OSSystemExtensionErrorDomain", 3)

ErrUnsupportedParentBundleLocation matches the SystemExtensions error OSSystemExtensionErrorUnsupportedParentBundleLocation.

View Source
var ErrValidationFailed = errkit.New("OSSystemExtensionErrorDomain", 9)

ErrValidationFailed matches the SystemExtensions error OSSystemExtensionErrorValidationFailed.

Functions

func NSSystemExtensionUsageDescriptionKey

func NSSystemExtensionUsageDescriptionKey() obj.Object

NSSystemExtensionUsageDescriptionKey returns the string constant NSSystemExtensionUsageDescriptionKey, for use as a dictionary key or argument.

func OSBundleUsageDescriptionKey

func OSBundleUsageDescriptionKey() obj.Object

OSBundleUsageDescriptionKey returns the string constant OSBundleUsageDescriptionKey, for use as a dictionary key or argument.

func OSRelatedKernelExtensionKey

func OSRelatedKernelExtensionKey() obj.Object

OSRelatedKernelExtensionKey returns the string constant OSRelatedKernelExtensionKey, for use as a dictionary key or argument.

func OSSystemExtensionErrorDomain

func OSSystemExtensionErrorDomain() obj.Object

OSSystemExtensionErrorDomain returns the string constant OSSystemExtensionErrorDomain, for use as a dictionary key or argument.

Types

type Clockid added in v0.17.0

type Clockid int32
const (
	ClockidRealtime           Clockid = 0
	ClockidMonotonic          Clockid = 6
	ClockidMonotonicRaw       Clockid = 4
	ClockidMonotonicRawApprox Clockid = 5
	ClockidUptimeRaw          Clockid = 8
	ClockidUptimeRawApprox    Clockid = 9
	ClockidProcessCputimeID   Clockid = 12
	ClockidThreadCputimeID    Clockid = 16
)

func (Clockid) String added in v0.17.0

func (e Clockid) String() string

String returns the Clockid constant's name, or its numeric form when the value is not a known constant.

type DispatchAutoreleaseFrequency added in v0.17.0

type DispatchAutoreleaseFrequency uint64
const (
	DispatchAutoreleaseFrequencyInherit  DispatchAutoreleaseFrequency = 0
	DispatchAutoreleaseFrequencyWorkItem DispatchAutoreleaseFrequency = 1
	DispatchAutoreleaseFrequencyNever    DispatchAutoreleaseFrequency = 2
)

func (DispatchAutoreleaseFrequency) String added in v0.17.0

String returns the DispatchAutoreleaseFrequency constant's name, or its numeric form when the value is not a known constant.

type DispatchBlockFlags added in v0.17.0

type DispatchBlockFlags uint64

Bitmask — values may be combined with |.

const (
	DispatchBlockFlagsBarrier         DispatchBlockFlags = 1
	DispatchBlockFlagsDetached        DispatchBlockFlags = 2
	DispatchBlockFlagsAssignCurrent   DispatchBlockFlags = 4
	DispatchBlockFlagsNoQosClass      DispatchBlockFlags = 8
	DispatchBlockFlagsInheritQosClass DispatchBlockFlags = 16
	DispatchBlockFlagsEnforceQosClass DispatchBlockFlags = 32
)

func (DispatchBlockFlags) String added in v0.17.0

func (e DispatchBlockFlags) String() string

String returns the DispatchBlockFlags constant's name, or its numeric form when the value is not a known constant.

type EntryID added in v0.17.0

type EntryID int32
const (
	EntryIDFirstEntry EntryID = 0
	EntryIDNextEntry  EntryID = -1
	EntryIDLastEntry  EntryID = -2
)

func (EntryID) String added in v0.17.0

func (e EntryID) String() string

String returns the EntryID constant's name, or its numeric form when the value is not a known constant.

type FilesecProperty added in v0.17.0

type FilesecProperty int32
const (
	FilesecPropertyOwner        FilesecProperty = 1
	FilesecPropertyGroup        FilesecProperty = 2
	FilesecPropertyUUID         FilesecProperty = 3
	FilesecPropertyMode         FilesecProperty = 4
	FilesecPropertyACL          FilesecProperty = 5
	FilesecPropertyGrpuuid      FilesecProperty = 6
	FilesecPropertyACLRaw       FilesecProperty = 100
	FilesecPropertyACLAllocsize FilesecProperty = 101
)

func (FilesecProperty) String added in v0.17.0

func (e FilesecProperty) String() string

String returns the FilesecProperty constant's name, or its numeric form when the value is not a known constant.

type Flag added in v0.17.0

type Flag int32
const (
	FlagFlagDeferInherit      Flag = 1
	FlagFlagNoInherit         Flag = 131072
	FlagEntryInherited        Flag = 16
	FlagEntryFileInherit      Flag = 32
	FlagEntryDirectoryInherit Flag = 64
	FlagEntryLimitInherit     Flag = 128
	FlagEntryOnlyInherit      Flag = 256
)

func (Flag) String added in v0.17.0

func (e Flag) String() string

String returns the Flag constant's name, or its numeric form when the value is not a known constant.

type Idtype added in v0.17.0

type Idtype int32
const (
	IdtypeAll  Idtype = 0
	IdtypePid  Idtype = 1
	IdtypePgid Idtype = 2
)

func (Idtype) String added in v0.17.0

func (e Idtype) String() string

String returns the Idtype constant's name, or its numeric form when the value is not a known constant.

type IpcInfoObjectType added in v0.17.0

type IpcInfoObjectType uint32
const (
	IpcInfoObjectTypeNone               IpcInfoObjectType = 0
	IpcInfoObjectTypeThreadControl      IpcInfoObjectType = 1
	IpcInfoObjectTypeTaskControl        IpcInfoObjectType = 2
	IpcInfoObjectTypeHost               IpcInfoObjectType = 3
	IpcInfoObjectTypeHostPriv           IpcInfoObjectType = 4
	IpcInfoObjectTypeProcessor          IpcInfoObjectType = 5
	IpcInfoObjectTypeProcessorSet       IpcInfoObjectType = 6
	IpcInfoObjectTypeProcessorSetName   IpcInfoObjectType = 7
	IpcInfoObjectTypeTimer              IpcInfoObjectType = 8
	IpcInfoObjectTypePortSubstOnce      IpcInfoObjectType = 9
	IpcInfoObjectTypeMig                IpcInfoObjectType = 10
	IpcInfoObjectTypeMemoryObject       IpcInfoObjectType = 11
	IpcInfoObjectTypeXmmPager           IpcInfoObjectType = 12
	IpcInfoObjectTypeXmmKernel          IpcInfoObjectType = 13
	IpcInfoObjectTypeXmmReply           IpcInfoObjectType = 14
	IpcInfoObjectTypeUndReply           IpcInfoObjectType = 15
	IpcInfoObjectTypeHostNotify         IpcInfoObjectType = 16
	IpcInfoObjectTypeHostSecurity       IpcInfoObjectType = 17
	IpcInfoObjectTypeLedger             IpcInfoObjectType = 18
	IpcInfoObjectTypeMainDevice         IpcInfoObjectType = 19
	IpcInfoObjectTypeTaskName           IpcInfoObjectType = 20
	IpcInfoObjectTypeSubsystem          IpcInfoObjectType = 21
	IpcInfoObjectTypeIODoneQueue        IpcInfoObjectType = 22
	IpcInfoObjectTypeSemaphore          IpcInfoObjectType = 23
	IpcInfoObjectTypeLockSet            IpcInfoObjectType = 24
	IpcInfoObjectTypeClock              IpcInfoObjectType = 25
	IpcInfoObjectTypeClockCtrl          IpcInfoObjectType = 26
	IpcInfoObjectTypeIokitIdent         IpcInfoObjectType = 27
	IpcInfoObjectTypeNamedEntry         IpcInfoObjectType = 28
	IpcInfoObjectTypeIokitConnect       IpcInfoObjectType = 29
	IpcInfoObjectTypeIokitObject        IpcInfoObjectType = 30
	IpcInfoObjectTypeUpl                IpcInfoObjectType = 31
	IpcInfoObjectTypeMemObjControl      IpcInfoObjectType = 32
	IpcInfoObjectTypeAuSessionport      IpcInfoObjectType = 33
	IpcInfoObjectTypeFileport           IpcInfoObjectType = 34
	IpcInfoObjectTypeLabelh             IpcInfoObjectType = 35
	IpcInfoObjectTypeTaskResume         IpcInfoObjectType = 36
	IpcInfoObjectTypeVoucher            IpcInfoObjectType = 37
	IpcInfoObjectTypeVoucherAttrControl IpcInfoObjectType = 38
	IpcInfoObjectTypeWorkInterval       IpcInfoObjectType = 39
	IpcInfoObjectTypeUxHandler          IpcInfoObjectType = 40
	IpcInfoObjectTypeUextObject         IpcInfoObjectType = 41
	IpcInfoObjectTypeArcadeReg          IpcInfoObjectType = 42
	IpcInfoObjectTypeEventlink          IpcInfoObjectType = 43
	IpcInfoObjectTypeTaskInspect        IpcInfoObjectType = 44
	IpcInfoObjectTypeTaskRead           IpcInfoObjectType = 45
	IpcInfoObjectTypeThreadInspect      IpcInfoObjectType = 46
	IpcInfoObjectTypeThreadRead         IpcInfoObjectType = 47
	IpcInfoObjectTypeSuidCred           IpcInfoObjectType = 48
	IpcInfoObjectTypeHypervisor         IpcInfoObjectType = 49
	IpcInfoObjectTypeTaskIDToken        IpcInfoObjectType = 50
	IpcInfoObjectTypeTaskFatal          IpcInfoObjectType = 51
	IpcInfoObjectTypeKcdata             IpcInfoObjectType = 52
	IpcInfoObjectTypeExclavesResource   IpcInfoObjectType = 53
	IpcInfoObjectTypeThreadResume       IpcInfoObjectType = 54
	IpcInfoObjectTypeUnknown            IpcInfoObjectType = 4294967295
)

func (IpcInfoObjectType) String added in v0.17.0

func (e IpcInfoObjectType) String() string

String returns the IpcInfoObjectType constant's name, or its numeric form when the value is not a known constant.

type LaunchDataType added in v0.17.0

type LaunchDataType int32
const (
	LaunchDataTypeDictionary LaunchDataType = 1
	LaunchDataTypeArray      LaunchDataType = 2
	LaunchDataTypeFd         LaunchDataType = 3
	LaunchDataTypeInteger    LaunchDataType = 4
	LaunchDataTypeReal       LaunchDataType = 5
	LaunchDataTypeBool       LaunchDataType = 6
	LaunchDataTypeString     LaunchDataType = 7
	LaunchDataTypeOpaque     LaunchDataType = 8
	LaunchDataTypeErrno      LaunchDataType = 9
	LaunchDataTypeMachport   LaunchDataType = 10
)

func (LaunchDataType) String added in v0.17.0

func (e LaunchDataType) String() string

String returns the LaunchDataType constant's name, or its numeric form when the value is not a known constant.

type MDLabelDomain

type MDLabelDomain int32

These constants are used to specify a domain to MDLabelCreate().

const (
	KMDLabelUserDomain  MDLabelDomain = 0
	KMDLabelLocalDomain MDLabelDomain = 1
)

func (MDLabelDomain) String

func (e MDLabelDomain) String() string

String returns the MDLabelDomain constant's name, or its numeric form when the value is not a known constant.

type MDQueryOptionFlags

type MDQueryOptionFlags int32
const (
	KMDQuerySynchronous        MDQueryOptionFlags = 1
	KMDQueryWantsUpdates       MDQueryOptionFlags = 4
	KMDQueryAllowFSTranslation MDQueryOptionFlags = 8
)

func (MDQueryOptionFlags) String

func (e MDQueryOptionFlags) String() string

String returns the MDQueryOptionFlags constant's name, or its numeric form when the value is not a known constant.

type MDQuerySortOptionFlags

type MDQuerySortOptionFlags int32
const (
	KMDQueryReverseSortOrderFlag MDQuerySortOptionFlags = 1
)

func (MDQuerySortOptionFlags) String

func (e MDQuerySortOptionFlags) String() string

String returns the MDQuerySortOptionFlags constant's name, or its numeric form when the value is not a known constant.

type MachVMRangeFlags added in v0.17.0

type MachVMRangeFlags uint64

Bitmask — values may be combined with |.

const (
	MachVMRangeFlagsNone MachVMRangeFlags = 0
)

func (MachVMRangeFlags) String added in v0.17.0

func (e MachVMRangeFlags) String() string

String returns the MachVMRangeFlags constant's name, or its numeric form when the value is not a known constant.

type MachVMRangeFlavor added in v0.17.0

type MachVMRangeFlavor uint32
const (
	MachVMRangeFlavorInvalid MachVMRangeFlavor = 0
	MachVMRangeFlavorV1      MachVMRangeFlavor = 1
)

func (MachVMRangeFlavor) String added in v0.17.0

func (e MachVMRangeFlavor) String() string

String returns the MachVMRangeFlavor constant's name, or its numeric form when the value is not a known constant.

type MachVMRangeTag added in v0.17.0

type MachVMRangeTag uint16
const (
	MachVMRangeTagDefault MachVMRangeTag = 0
	MachVMRangeTagData    MachVMRangeTag = 1
	MachVMRangeTagFixed   MachVMRangeTag = 2
)

func (MachVMRangeTag) String added in v0.17.0

func (e MachVMRangeTag) String() string

String returns the MachVMRangeTag constant's name, or its numeric form when the value is not a known constant.

type MpoFlags added in v0.17.0

type MpoFlags uint32

Bitmask — values may be combined with |.

const (
	MpoFlagsPort                        MpoFlags = 0
	MpoFlagsServicePort                 MpoFlags = 1024
	MpoFlagsConnectionPort              MpoFlags = 2048
	MpoFlagsReplyPort                   MpoFlags = 4096
	MpoFlagsWeakReplyPort               MpoFlags = 16384
	MpoFlagsNotificationPort            MpoFlags = 17408
	MpoFlagsExceptionPort               MpoFlags = 32768
	MpoFlagsConnectionPortWithPortArray MpoFlags = 65536
)

func (MpoFlags) String added in v0.17.0

func (e MpoFlags) String() string

String returns the MpoFlags constant's name, or its numeric form when the value is not a known constant.

type OSClockid added in v0.17.0

type OSClockid uint32
const (
	OSClockidTime OSClockid = 32
)

func (OSClockid) String added in v0.17.0

func (e OSClockid) String() string

String returns the OSClockid constant's name, or its numeric form when the value is not a known constant.

type Perm added in v0.17.0

type Perm int32
const (
	PermReadData           Perm = 2
	PermListDirectory      Perm = 2
	PermWriteData          Perm = 4
	PermAddFile            Perm = 4
	PermExecute            Perm = 8
	PermSearch             Perm = 8
	PermDelete             Perm = 16
	PermAppendData         Perm = 32
	PermAddSubdirectory    Perm = 32
	PermDeleteChild        Perm = 64
	PermReadAttributes     Perm = 128
	PermWriteAttributes    Perm = 256
	PermReadExtattributes  Perm = 512
	PermWriteExtattributes Perm = 1024
	PermReadSecurity       Perm = 2048
	PermWriteSecurity      Perm = 4096
	PermChangeOwner        Perm = 8192
	PermSynchronize        Perm = 1048576
)

func (Perm) String added in v0.17.0

func (e Perm) String() string

String returns the Perm constant's name, or its numeric form when the value is not a known constant.

type PtrauthKey added in v0.17.0

type PtrauthKey int32
const (
	Ptrauth_key_none                     PtrauthKey = -1
	Ptrauth_key_asia                     PtrauthKey = 0
	Ptrauth_key_asib                     PtrauthKey = 1
	Ptrauth_key_asda                     PtrauthKey = 2
	Ptrauth_key_asdb                     PtrauthKey = 3
	Ptrauth_key_process_independent_code PtrauthKey = 0
	Ptrauth_key_process_dependent_code   PtrauthKey = 1
	Ptrauth_key_process_independent_data PtrauthKey = 2
	Ptrauth_key_process_dependent_data   PtrauthKey = 3
	Ptrauth_key_return_address           PtrauthKey = 1
	Ptrauth_key_frame_pointer            PtrauthKey = 3
	Ptrauth_key_function_pointer         PtrauthKey = 0
	Ptrauth_key_block_function           PtrauthKey = 0
	Ptrauth_key_cxx_vtable_pointer       PtrauthKey = 2
	Ptrauth_key_method_list_pointer      PtrauthKey = 2
	Ptrauth_key_objc_isa_pointer         PtrauthKey = 2
	Ptrauth_key_objc_super_pointer       PtrauthKey = 2
	Ptrauth_key_objc_sel_pointer         PtrauthKey = 3
	Ptrauth_key_objc_class_ro_pointer    PtrauthKey = 2
	Ptrauth_key_block_descriptor_pointer PtrauthKey = 2
	Ptrauth_key_init_fini_pointer        PtrauthKey = 0
)

func (PtrauthKey) String added in v0.17.0

func (e PtrauthKey) String() string

String returns the PtrauthKey constant's name, or its numeric form when the value is not a known constant.

type QosClass added in v0.17.0

type QosClass uint32
const (
	QosClassUserInteractive QosClass = 33
	QosClassUserInitiated   QosClass = 25
	QosClassDefault         QosClass = 21
	QosClassUtility         QosClass = 17
	QosClassBackground      QosClass = 9
	QosClassUnspecified     QosClass = 0
)

func (QosClass) String added in v0.17.0

func (e QosClass) String() string

String returns the QosClass constant's name, or its numeric form when the value is not a known constant.

type SystemExtensionErrorCode added in v0.17.0

type SystemExtensionErrorCode int64

Error codes for system extensions.

const (
	SystemExtensionErrorUnknown                         SystemExtensionErrorCode = 1
	SystemExtensionErrorMissingEntitlement              SystemExtensionErrorCode = 2
	SystemExtensionErrorUnsupportedParentBundleLocation SystemExtensionErrorCode = 3
	SystemExtensionErrorExtensionNotFound               SystemExtensionErrorCode = 4
	SystemExtensionErrorExtensionMissingIdentifier      SystemExtensionErrorCode = 5
	SystemExtensionErrorDuplicateExtensionIdentifer     SystemExtensionErrorCode = 6
	SystemExtensionErrorUnknownExtensionCategory        SystemExtensionErrorCode = 7
	SystemExtensionErrorCodeSignatureInvalid            SystemExtensionErrorCode = 8
	SystemExtensionErrorValidationFailed                SystemExtensionErrorCode = 9
	SystemExtensionErrorForbiddenBySystemPolicy         SystemExtensionErrorCode = 10
	SystemExtensionErrorRequestCanceled                 SystemExtensionErrorCode = 11
	SystemExtensionErrorRequestSuperseded               SystemExtensionErrorCode = 12
	SystemExtensionErrorAuthorizationRequired           SystemExtensionErrorCode = 13
)

func (SystemExtensionErrorCode) String added in v0.17.0

func (e SystemExtensionErrorCode) String() string

String returns the SystemExtensionErrorCode constant's name, or its numeric form when the value is not a known constant.

type SystemExtensionInfo added in v0.17.0

type SystemExtensionInfo struct {
	objref.Handle
}

SystemExtensionInfo is an idiomatic wrapper over the Objective-C class OSSystemExtensionInfo.

func NewSystemExtensionInfo added in v0.17.0

func NewSystemExtensionInfo() *SystemExtensionInfo

NewSystemExtensionInfo creates a new SystemExtensionInfo.

func SystemExtensionInfoFromID added in v0.17.0

func SystemExtensionInfoFromID(id objc.ID) *SystemExtensionInfo

SystemExtensionInfoFromID adopts an existing Objective-C object as a SystemExtensionInfo (nil for 0), retaining it and registering a release finalizer.

func (*SystemExtensionInfo) BundleIdentifier added in v0.17.0

func (sei *SystemExtensionInfo) BundleIdentifier() string

BundleIdentifier returns the bundle identifier of the extension (CFBundleIdentifier)

func (*SystemExtensionInfo) BundleShortVersion added in v0.17.0

func (sei *SystemExtensionInfo) BundleShortVersion() string

BundleShortVersion returns the bundle short version string of the extension (CFBundleShortVersionString)

func (*SystemExtensionInfo) BundleVersion added in v0.17.0

func (sei *SystemExtensionInfo) BundleVersion() string

BundleVersion returns the bundle version of the extension (CFBundleVersion)

func (*SystemExtensionInfo) Description added in v0.17.0

func (sei *SystemExtensionInfo) Description() string

Description returns the object's -description text.

func (*SystemExtensionInfo) IsEqual added in v0.17.0

func (sei *SystemExtensionInfo) IsEqual(other obj.Object) bool

IsEqual reports Objective-C equality (isEqual:) with another object.

func (*SystemExtensionInfo) IsKind added in v0.17.0

func (sei *SystemExtensionInfo) IsKind(className string) bool

IsKind reports whether the object is an instance of the named class or a subclass.

func (*SystemExtensionInfo) String added in v0.17.0

func (sei *SystemExtensionInfo) String() string

String returns the object's -description text, so a wrapper prints usefully under fmt.

type SystemExtensionManager added in v0.17.0

type SystemExtensionManager struct {
	objref.Handle
}

SystemExtensionManager is an idiomatic wrapper over the Objective-C class OSSystemExtensionManager.

A type that facilitates activation and deactivation of system extensions.

func NewSystemExtensionManager added in v0.17.0

func NewSystemExtensionManager() *SystemExtensionManager

NewSystemExtensionManager creates a new SystemExtensionManager.

func SharedManager added in v0.17.0

func SharedManager() *SystemExtensionManager

SharedManager returns the shared manager.

func SystemExtensionManagerFromID added in v0.17.0

func SystemExtensionManagerFromID(id objc.ID) *SystemExtensionManager

SystemExtensionManagerFromID adopts an existing Objective-C object as a SystemExtensionManager (nil for 0), retaining it and registering a release finalizer.

func (*SystemExtensionManager) Description added in v0.17.0

func (sem *SystemExtensionManager) Description() string

Description returns the object's -description text.

func (*SystemExtensionManager) IsEqual added in v0.17.0

func (sem *SystemExtensionManager) IsEqual(other obj.Object) bool

IsEqual reports Objective-C equality (isEqual:) with another object.

func (*SystemExtensionManager) IsKind added in v0.17.0

func (sem *SystemExtensionManager) IsKind(className string) bool

IsKind reports whether the object is an instance of the named class or a subclass.

func (*SystemExtensionManager) String added in v0.17.0

func (sem *SystemExtensionManager) String() string

String returns the object's -description text, so a wrapper prints usefully under fmt.

func (*SystemExtensionManager) SubmitRequest added in v0.17.0

func (sem *SystemExtensionManager) SubmitRequest(request *SystemExtensionRequest)

SubmitRequest submits a system extension request to the manager.

type SystemExtensionProperties added in v0.17.0

type SystemExtensionProperties struct {
	objref.Handle
}

SystemExtensionProperties is an idiomatic wrapper over the Objective-C class OSSystemExtensionProperties.

Properties that identify a specific version of a system extension.

func NewSystemExtensionProperties added in v0.17.0

func NewSystemExtensionProperties() *SystemExtensionProperties

NewSystemExtensionProperties creates a new SystemExtensionProperties.

func SystemExtensionPropertiesFromID added in v0.17.0

func SystemExtensionPropertiesFromID(id objc.ID) *SystemExtensionProperties

SystemExtensionPropertiesFromID adopts an existing Objective-C object as a SystemExtensionProperties (nil for 0), retaining it and registering a release finalizer.

func (*SystemExtensionProperties) BundleIdentifier added in v0.17.0

func (sep *SystemExtensionProperties) BundleIdentifier() string

BundleIdentifier returns the bundle identifier of the extension (CFBundleIdentifier)

func (*SystemExtensionProperties) BundleShortVersion added in v0.17.0

func (sep *SystemExtensionProperties) BundleShortVersion() string

BundleShortVersion returns the bundle short version string of the extension (CFBundleShortVersionString)

func (*SystemExtensionProperties) BundleVersion added in v0.17.0

func (sep *SystemExtensionProperties) BundleVersion() string

BundleVersion returns the bundle version of the extension (CFBundleVersion)

func (*SystemExtensionProperties) Description added in v0.17.0

func (sep *SystemExtensionProperties) Description() string

Description returns the object's -description text.

func (*SystemExtensionProperties) IsAwaitingUserApproval added in v0.17.0

func (sep *SystemExtensionProperties) IsAwaitingUserApproval() bool

IsAwaitingUserApproval reports whether an extension is waiting for user approval

func (*SystemExtensionProperties) IsEnabled added in v0.17.0

func (sep *SystemExtensionProperties) IsEnabled() bool

IsEnabled reports whether returns the enabled state of the extension

func (*SystemExtensionProperties) IsEqual added in v0.17.0

func (sep *SystemExtensionProperties) IsEqual(other obj.Object) bool

IsEqual reports Objective-C equality (isEqual:) with another object.

func (*SystemExtensionProperties) IsKind added in v0.17.0

func (sep *SystemExtensionProperties) IsKind(className string) bool

IsKind reports whether the object is an instance of the named class or a subclass.

func (*SystemExtensionProperties) IsUninstalling added in v0.17.0

func (sep *SystemExtensionProperties) IsUninstalling() bool

IsUninstalling reports whether returns if an extension is being uninstalled

func (*SystemExtensionProperties) String added in v0.17.0

func (sep *SystemExtensionProperties) String() string

String returns the object's -description text, so a wrapper prints usefully under fmt.

func (*SystemExtensionProperties) URL added in v0.17.0

func (sep *SystemExtensionProperties) URL() string

URL returns the file URL locating an indicating the extension bundle these properties were retreived from.

type SystemExtensionReplacementAction added in v0.17.0

type SystemExtensionReplacementAction int64

Actions for describing how the extension manager should resolve a version conflict.

const (
	// Returned by the delegate when it determines that replacing an existing System Extension should not proceed.
	SystemExtensionReplacementActionCancel SystemExtensionReplacementAction = 0
	// Returned by the delegate when it determines that replacing an existing System Extension is desired.
	SystemExtensionReplacementActionReplace SystemExtensionReplacementAction = 1
)

func (SystemExtensionReplacementAction) String added in v0.17.0

String returns the SystemExtensionReplacementAction constant's name, or its numeric form when the value is not a known constant.

type SystemExtensionRequest added in v0.17.0

type SystemExtensionRequest struct {
	objref.Handle
}

SystemExtensionRequest is an idiomatic wrapper over the Objective-C class OSSystemExtensionRequest.

A request to activate or deactivate a system extension.

func ActivationRequestForExtensionQueue added in v0.17.0

func ActivationRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest

ActivationRequestForExtensionQueue creates a request to activate a System Extension.

func DeactivationRequestForExtensionQueue added in v0.17.0

func DeactivationRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest

DeactivationRequestForExtensionQueue creates a request to deactivate a System Extension.

func NewSystemExtensionRequest added in v0.17.0

func NewSystemExtensionRequest() *SystemExtensionRequest

NewSystemExtensionRequest creates a new SystemExtensionRequest.

func PropertiesRequestForExtensionQueue added in v0.17.0

func PropertiesRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest

PropertiesRequestForExtensionQueue creates a request to get information about System Extensions. This method creates a new request to retrieve the properties of any System Extensions matching the given identifier.

func SystemExtensionRequestFromID added in v0.17.0

func SystemExtensionRequestFromID(id objc.ID) *SystemExtensionRequest

SystemExtensionRequestFromID adopts an existing Objective-C object as a SystemExtensionRequest (nil for 0), retaining it and registering a release finalizer.

func (*SystemExtensionRequest) Description added in v0.17.0

func (ser *SystemExtensionRequest) Description() string

Description returns the object's -description text.

func (*SystemExtensionRequest) Identifier added in v0.17.0

func (ser *SystemExtensionRequest) Identifier() string

Identifier returns the bundle identifier of the target extension

func (*SystemExtensionRequest) IsEqual added in v0.17.0

func (ser *SystemExtensionRequest) IsEqual(other obj.Object) bool

IsEqual reports Objective-C equality (isEqual:) with another object.

func (*SystemExtensionRequest) IsKind added in v0.17.0

func (ser *SystemExtensionRequest) IsKind(className string) bool

IsKind reports whether the object is an instance of the named class or a subclass.

func (*SystemExtensionRequest) String added in v0.17.0

func (ser *SystemExtensionRequest) String() string

String returns the object's -description text, so a wrapper prints usefully under fmt.

func (*SystemExtensionRequest) WithDelegate added in v0.17.0

WithDelegate sets a delegate to receive updates about the progress of a request.

type SystemExtensionRequestDelegate added in v0.17.0

type SystemExtensionRequestDelegate interface {
	// RequestActionForReplacingExtensionWithExtension called when the target extension bundle identifier is already activated. The delegate will receive this callback when an activation request encounters an existing extension with the same team and bundle identifiers but with different version identifiers. The delegate must make a decision on whether or not to replace the existing extension.
	RequestActionForReplacingExtensionWithExtension(request *SystemExtensionRequest, existing *SystemExtensionProperties, ext *SystemExtensionProperties) SystemExtensionReplacementAction
	// RequestNeedsUserApproval called when the target extension requires user approval to be activated. Activating an extension may require explicit user approval in order to proceed. For example, this can occur when the user has never previously approved this extension. If approval is necessary, this callback will be triggered and the activation request will remain pending until user approves, or until the application exits.
	RequestNeedsUserApproval(request *SystemExtensionRequest)
	// RequestDidFinishWithResult called when the target extension request has completed. Successful results can come with additional information regarding the manner in which they were completed. See the OSSystemExtensionRequestResult documentation for more information.
	RequestDidFinishWithResult(request *SystemExtensionRequest, result SystemExtensionRequestResult)
	// RequestDidFailWithError called when the target extension request failed.
	RequestDidFailWithError(request *SystemExtensionRequest, err error)
}

SystemExtensionRequestDelegate receives the callbacks of the Objective-C protocol OSSystemExtensionRequestDelegate. Pass an implementation to the matching With… setter; the wrapper builds the Objective-C delegate object for you. Every method listed here is required. The protocol's optional methods are separate one-method interfaces (SystemExtensionRequestDelegate…Handler): implement the ones you need on the same value and the framework will call them too.

type SystemExtensionRequestDelegateRequestFoundPropertiesHandler added in v0.17.0

type SystemExtensionRequestDelegateRequestFoundPropertiesHandler interface {
	RequestFoundProperties(request *SystemExtensionRequest, properties obj.Object)
}

SystemExtensionRequestDelegateRequestFoundPropertiesHandler is the optional OSSystemExtensionRequestDelegate method request:foundProperties:. Implement it on a SystemExtensionRequestDelegate value to receive that callback; a value without it is simply never sent one.

type SystemExtensionRequestResult added in v0.17.0

type SystemExtensionRequestResult int64

The result of a completed request, possibly including additional information about the extension’s state.

const (
	// The request was successfully completed.
	SystemExtensionRequestCompleted SystemExtensionRequestResult = 0
	// The request will be successfully completed after a reboot.
	SystemExtensionRequestWillCompleteAfterReboot SystemExtensionRequestResult = 1
)

func (SystemExtensionRequestResult) String added in v0.17.0

String returns the SystemExtensionRequestResult constant's name, or its numeric form when the value is not a known constant.

type SystemExtensionsWorkspace added in v0.17.0

type SystemExtensionsWorkspace struct {
	objref.Handle
}

SystemExtensionsWorkspace is an idiomatic wrapper over the Objective-C class OSSystemExtensionsWorkspace.

func NewSystemExtensionsWorkspace added in v0.17.0

func NewSystemExtensionsWorkspace() *SystemExtensionsWorkspace

NewSystemExtensionsWorkspace creates a new SystemExtensionsWorkspace.

func SharedWorkspace added in v0.17.0

func SharedWorkspace() *SystemExtensionsWorkspace

SharedWorkspace returns the shared workspace.

func SystemExtensionsWorkspaceFromID added in v0.17.0

func SystemExtensionsWorkspaceFromID(id objc.ID) *SystemExtensionsWorkspace

SystemExtensionsWorkspaceFromID adopts an existing Objective-C object as a SystemExtensionsWorkspace (nil for 0), retaining it and registering a release finalizer.

func (*SystemExtensionsWorkspace) Description added in v0.17.0

func (sew *SystemExtensionsWorkspace) Description() string

Description returns the object's -description text.

func (*SystemExtensionsWorkspace) IsEqual added in v0.17.0

func (sew *SystemExtensionsWorkspace) IsEqual(other obj.Object) bool

IsEqual reports Objective-C equality (isEqual:) with another object.

func (*SystemExtensionsWorkspace) IsKind added in v0.17.0

func (sew *SystemExtensionsWorkspace) IsKind(className string) bool

IsKind reports whether the object is an instance of the named class or a subclass.

func (*SystemExtensionsWorkspace) String added in v0.17.0

func (sew *SystemExtensionsWorkspace) String() string

String returns the object's -description text, so a wrapper prints usefully under fmt.

type SystemExtensionsWorkspaceObserver added in v0.17.0

type SystemExtensionsWorkspaceObserver interface {
}

SystemExtensionsWorkspaceObserver receives the callbacks of the Objective-C protocol OSSystemExtensionsWorkspaceObserver. Pass an implementation to the matching With… setter; the wrapper builds the Objective-C delegate object for you. Every method listed here is required. The protocol's optional methods are separate one-method interfaces (SystemExtensionsWorkspaceObserver…Handler): implement the ones you need on the same value and the framework will call them too.

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeDisabledHandler added in v0.17.0

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeDisabledHandler interface {
	SystemExtensionWillBecomeDisabled(systemExtensionInfo *SystemExtensionInfo)
}

SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeDisabledHandler is the optional OSSystemExtensionsWorkspaceObserver method systemExtensionWillBecomeDisabled:. Implement it on a SystemExtensionsWorkspaceObserver value to receive that callback; a value without it is simply never sent one.

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeEnabledHandler added in v0.17.0

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeEnabledHandler interface {
	SystemExtensionWillBecomeEnabled(systemExtensionInfo *SystemExtensionInfo)
}

SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeEnabledHandler is the optional OSSystemExtensionsWorkspaceObserver method systemExtensionWillBecomeEnabled:. Implement it on a SystemExtensionsWorkspaceObserver value to receive that callback; a value without it is simply never sent one.

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeInactiveHandler added in v0.17.0

type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeInactiveHandler interface {
	SystemExtensionWillBecomeInactive(systemExtensionInfo *SystemExtensionInfo)
}

SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeInactiveHandler is the optional OSSystemExtensionsWorkspaceObserver method systemExtensionWillBecomeInactive:. Implement it on a SystemExtensionsWorkspaceObserver value to receive that callback; a value without it is simply never sent one.

type Tag added in v0.17.0

type Tag int32
const (
	TagUndefinedTag  Tag = 0
	TagExtendedAllow Tag = 1
	TagExtendedDeny  Tag = 2
)

func (Tag) String added in v0.17.0

func (e Tag) String() string

String returns the Tag constant's name, or its numeric form when the value is not a known constant.

type Type added in v0.17.0

type Type int32
const (
	TypeExtended Type = 256
	TypeAccess   Type = 0
	TypeDefault  Type = 1
	TypeAfs      Type = 2
	TypeCoda     Type = 3
	TypeNtfs     Type = 4
	TypeNwfs     Type = 5
)

func (Type) String added in v0.17.0

func (e Type) String() string

String returns the Type constant's name, or its numeric form when the value is not a known constant.

type VirtualMemoryGuardExceptionCode added in v0.17.0

type VirtualMemoryGuardExceptionCode uint32
const (
	KGUARD_EXC_DEALLOC_GAP                   VirtualMemoryGuardExceptionCode = 1
	KGUARD_EXC_RECLAIM_COPYIO_FAILURE        VirtualMemoryGuardExceptionCode = 2
	KGUARD_EXC_RECLAIM_INDEX_FAILURE         VirtualMemoryGuardExceptionCode = 4
	KGUARD_EXC_RECLAIM_DEALLOCATE_FAILURE    VirtualMemoryGuardExceptionCode = 8
	KGUARD_EXC_RECLAIM_ACCOUNTING_FAILURE    VirtualMemoryGuardExceptionCode = 9
	KGUARD_EXC_SEC_IOPL_ON_EXEC_PAGE         VirtualMemoryGuardExceptionCode = 10
	KGUARD_EXC_SEC_EXEC_ON_IOPL_PAGE         VirtualMemoryGuardExceptionCode = 11
	KGUARD_EXC_SEC_UPL_WRITE_ON_EXEC_REGION  VirtualMemoryGuardExceptionCode = 12
	KGUARD_EXC_LARGE_ALLOCATION_TELEMETRY    VirtualMemoryGuardExceptionCode = 13
	KGUARD_EXC_SEC_ACCESS_FAULT              VirtualMemoryGuardExceptionCode = 98
	KGUARD_EXC_SEC_ASYNC_ACCESS_FAULT        VirtualMemoryGuardExceptionCode = 99
	KGUARD_EXC_SEC_COPY_DENIED               VirtualMemoryGuardExceptionCode = 100
	KGUARD_EXC_SEC_SHARING_DENIED            VirtualMemoryGuardExceptionCode = 101
	KGUARD_EXC_MTE_SYNC_FAULT                VirtualMemoryGuardExceptionCode = 200
	KGUARD_EXC_MTE_ASYNC_USER_FAULT          VirtualMemoryGuardExceptionCode = 201
	KGUARD_EXC_MTE_ASYNC_KERN_FAULT          VirtualMemoryGuardExceptionCode = 202
	KGUARD_EXC_GUARD_OBJECT_ASYNC_USER_FAULT VirtualMemoryGuardExceptionCode = 203
	KGUARD_EXC_GUARD_OBJECT_ASYNC_KERN_FAULT VirtualMemoryGuardExceptionCode = 204
)

func (VirtualMemoryGuardExceptionCode) String added in v0.17.0

String returns the VirtualMemoryGuardExceptionCode constant's name, or its numeric form when the value is not a known constant.

type XpcListenerCreateFlags added in v0.17.0

type XpcListenerCreateFlags uint64

Bitmask — values may be combined with |.

const (
	XpcListenerCreateFlagsNone            XpcListenerCreateFlags = 0
	XpcListenerCreateFlagsInactive        XpcListenerCreateFlags = 1
	XpcListenerCreateFlagsForceMach       XpcListenerCreateFlags = 2
	XpcListenerCreateFlagsForceXpcservice XpcListenerCreateFlags = 4
)

func (XpcListenerCreateFlags) String added in v0.17.0

func (e XpcListenerCreateFlags) String() string

String returns the XpcListenerCreateFlags constant's name, or its numeric form when the value is not a known constant.

type XpcSessionCreateFlags added in v0.17.0

type XpcSessionCreateFlags uint64

Bitmask — values may be combined with |.

const (
	XpcSessionCreateFlagsNone           XpcSessionCreateFlags = 0
	XpcSessionCreateFlagsInactive       XpcSessionCreateFlags = 1
	XpcSessionCreateFlagsMachPrivileged XpcSessionCreateFlags = 2
)

func (XpcSessionCreateFlags) String added in v0.17.0

func (e XpcSessionCreateFlags) String() string

String returns the XpcSessionCreateFlags constant's name, or its numeric form when the value is not a known constant.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL