Documentation
¶
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 ¶
- Variables
- func NSSystemExtensionUsageDescriptionKey() obj.Object
- func OSBundleUsageDescriptionKey() obj.Object
- func OSRelatedKernelExtensionKey() obj.Object
- func OSSystemExtensionErrorDomain() obj.Object
- type Clockid
- type DispatchAutoreleaseFrequency
- type DispatchBlockFlags
- type EntryID
- type FilesecProperty
- type Flag
- type Idtype
- type IpcInfoObjectType
- type LaunchDataType
- type MDLabelDomain
- type MDQueryOptionFlags
- type MDQuerySortOptionFlags
- type MachVMRangeFlags
- type MachVMRangeFlavor
- type MachVMRangeTag
- type MpoFlags
- type OSClockid
- type Perm
- type PtrauthKey
- type QosClass
- type SystemExtensionErrorCode
- type SystemExtensionInfo
- func (sei *SystemExtensionInfo) BundleIdentifier() string
- func (sei *SystemExtensionInfo) BundleShortVersion() string
- func (sei *SystemExtensionInfo) BundleVersion() string
- func (sei *SystemExtensionInfo) Description() string
- func (sei *SystemExtensionInfo) IsEqual(other obj.Object) bool
- func (sei *SystemExtensionInfo) IsKind(className string) bool
- func (sei *SystemExtensionInfo) String() string
- type SystemExtensionManager
- func (sem *SystemExtensionManager) Description() string
- func (sem *SystemExtensionManager) IsEqual(other obj.Object) bool
- func (sem *SystemExtensionManager) IsKind(className string) bool
- func (sem *SystemExtensionManager) String() string
- func (sem *SystemExtensionManager) SubmitRequest(request *SystemExtensionRequest)
- type SystemExtensionProperties
- func (sep *SystemExtensionProperties) BundleIdentifier() string
- func (sep *SystemExtensionProperties) BundleShortVersion() string
- func (sep *SystemExtensionProperties) BundleVersion() string
- func (sep *SystemExtensionProperties) Description() string
- func (sep *SystemExtensionProperties) IsAwaitingUserApproval() bool
- func (sep *SystemExtensionProperties) IsEnabled() bool
- func (sep *SystemExtensionProperties) IsEqual(other obj.Object) bool
- func (sep *SystemExtensionProperties) IsKind(className string) bool
- func (sep *SystemExtensionProperties) IsUninstalling() bool
- func (sep *SystemExtensionProperties) String() string
- func (sep *SystemExtensionProperties) URL() string
- type SystemExtensionReplacementAction
- type SystemExtensionRequest
- func ActivationRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest
- func DeactivationRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest
- func NewSystemExtensionRequest() *SystemExtensionRequest
- func PropertiesRequestForExtensionQueue(identifier string, queue dispatch.Queue) *SystemExtensionRequest
- func SystemExtensionRequestFromID(id objc.ID) *SystemExtensionRequest
- func (ser *SystemExtensionRequest) Description() string
- func (ser *SystemExtensionRequest) Identifier() string
- func (ser *SystemExtensionRequest) IsEqual(other obj.Object) bool
- func (ser *SystemExtensionRequest) IsKind(className string) bool
- func (ser *SystemExtensionRequest) String() string
- func (ser *SystemExtensionRequest) WithDelegate(delegate SystemExtensionRequestDelegate) *SystemExtensionRequest
- type SystemExtensionRequestDelegate
- type SystemExtensionRequestDelegateRequestFoundPropertiesHandler
- type SystemExtensionRequestResult
- type SystemExtensionsWorkspace
- type SystemExtensionsWorkspaceObserver
- type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeDisabledHandler
- type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeEnabledHandler
- type SystemExtensionsWorkspaceObserverSystemExtensionWillBecomeInactiveHandler
- type Tag
- type Type
- type VirtualMemoryGuardExceptionCode
- type XpcListenerCreateFlags
- type XpcSessionCreateFlags
Constants ¶
This section is empty.
Variables ¶
var ErrAuthorizationRequired = errkit.New("OSSystemExtensionErrorDomain", 13)
ErrAuthorizationRequired matches the SystemExtensions error OSSystemExtensionErrorAuthorizationRequired.
var ErrCodeSignatureInvalid = errkit.New("OSSystemExtensionErrorDomain", 8)
ErrCodeSignatureInvalid matches the SystemExtensions error OSSystemExtensionErrorCodeSignatureInvalid.
var ErrDuplicateExtensionIdentifer = errkit.New("OSSystemExtensionErrorDomain", 6)
ErrDuplicateExtensionIdentifer matches the SystemExtensions error OSSystemExtensionErrorDuplicateExtensionIdentifer.
var ErrExtensionMissingIdentifier = errkit.New("OSSystemExtensionErrorDomain", 5)
ErrExtensionMissingIdentifier matches the SystemExtensions error OSSystemExtensionErrorExtensionMissingIdentifier.
var ErrExtensionNotFound = errkit.New("OSSystemExtensionErrorDomain", 4)
ErrExtensionNotFound matches the SystemExtensions error OSSystemExtensionErrorExtensionNotFound.
var ErrForbiddenBySystemPolicy = errkit.New("OSSystemExtensionErrorDomain", 10)
ErrForbiddenBySystemPolicy matches the SystemExtensions error OSSystemExtensionErrorForbiddenBySystemPolicy.
var ErrMissingEntitlement = errkit.New("OSSystemExtensionErrorDomain", 2)
ErrMissingEntitlement matches the SystemExtensions error OSSystemExtensionErrorMissingEntitlement.
var ErrRequestCanceled = errkit.New("OSSystemExtensionErrorDomain", 11)
ErrRequestCanceled matches the SystemExtensions error OSSystemExtensionErrorRequestCanceled.
var ErrRequestSuperseded = errkit.New("OSSystemExtensionErrorDomain", 12)
ErrRequestSuperseded matches the SystemExtensions error OSSystemExtensionErrorRequestSuperseded.
var ErrUnknown = errkit.New("OSSystemExtensionErrorDomain", 1)
ErrUnknown matches the SystemExtensions error OSSystemExtensionErrorUnknown.
var ErrUnknownExtensionCategory = errkit.New("OSSystemExtensionErrorDomain", 7)
ErrUnknownExtensionCategory matches the SystemExtensions error OSSystemExtensionErrorUnknownExtensionCategory.
var ErrUnsupportedParentBundleLocation = errkit.New("OSSystemExtensionErrorDomain", 3)
ErrUnsupportedParentBundleLocation matches the SystemExtensions error OSSystemExtensionErrorUnsupportedParentBundleLocation.
var ErrValidationFailed = errkit.New("OSSystemExtensionErrorDomain", 9)
ErrValidationFailed matches the SystemExtensions error OSSystemExtensionErrorValidationFailed.
Functions ¶
func NSSystemExtensionUsageDescriptionKey ¶
NSSystemExtensionUsageDescriptionKey returns the string constant NSSystemExtensionUsageDescriptionKey, for use as a dictionary key or argument.
func OSBundleUsageDescriptionKey ¶
OSBundleUsageDescriptionKey returns the string constant OSBundleUsageDescriptionKey, for use as a dictionary key or argument.
func OSRelatedKernelExtensionKey ¶
OSRelatedKernelExtensionKey returns the string constant OSRelatedKernelExtensionKey, for use as a dictionary key or argument.
func OSSystemExtensionErrorDomain ¶
OSSystemExtensionErrorDomain returns the string constant OSSystemExtensionErrorDomain, for use as a dictionary key or argument.
Types ¶
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
func (e DispatchAutoreleaseFrequency) String() string
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 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 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 )
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 )
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 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
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
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
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
func (e SystemExtensionReplacementAction) String() string
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
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
func (ser *SystemExtensionRequest) WithDelegate(delegate SystemExtensionRequestDelegate) *SystemExtensionRequest
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
func (e SystemExtensionRequestResult) String() string
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
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 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
func (e VirtualMemoryGuardExceptionCode) String() string
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.
Source Files
¶
- OSSystemExtensionInfo_generated.go
- OSSystemExtensionManager_generated.go
- OSSystemExtensionProperties_generated.go
- OSSystemExtensionRequestDelegate_delegate_generated.go
- OSSystemExtensionRequest_generated.go
- OSSystemExtensionsWorkspaceObserver_delegate_generated.go
- OSSystemExtensionsWorkspace_generated.go
- doc.go
- systemextensions_classmethods_generated.go
- systemextensions_constants_generated.go
- systemextensions_enums_generated.go
- systemextensions_errors_generated.go
- systemextensions_runtime_generated.go