mcinstall

Documentation

Index

• func Erase(device ios.DeviceEntry) error
• func GetAllSetupSkipOptions() []string
• func InstallProfileSilent(device ios.DeviceEntry, p12file []byte, p12password string, ...) error
• func Prepare(device ios.DeviceEntry, skip []string, certBytes []byte, orgname string, ...) error
• func RemoveProxy(device ios.DeviceEntry) error
• func SetHttpProxy(device ios.DeviceEntry, host string, port string, user string, pass string, ...) error
• type Connection
  • func New(device ios.DeviceEntry) (*Connection, error)
  • func (mcInstallConn *Connection) AddProfile(profilePlist []byte) error
  • func (mcInstallConn *Connection) AddProfileSupervised(profileFileBytes []byte, p12fileBytes []byte, password string) error
  • func (mcInstallConn *Connection) Close() error
  • func (mcInstallConn *Connection) Escalate(p12bytes []byte, p12Password string) error
  • func (mcInstallConn *Connection) EscalateUnsupervised() error
  • func (mcInstallConn *Connection) EscalateWithCertAndKey(supervisedPrivateKey interface{}, supervisionCert *x509.Certificate) error
  • func (mcInstallConn *Connection) HandleList() ([]ProfileInfo, error)
  • func (mcInstallConn *Connection) RemoveProfile(identifier string) error
• type ProfileInfo
• type ProfileManifest
• type ProfileMetadata

Functions

func Erase

func Erase(device ios.DeviceEntry) error

Erase tells a device to remove all apps and settings. You need to activate it afterwards. Be careful with this if you do not have a backup!

func GetAllSetupSkipOptions

func GetAllSetupSkipOptions() []string

GetAllSetupSkipOptions returns a list of all possible values you can skip during device preparation

func InstallProfileSilent

func InstallProfileSilent(device ios.DeviceEntry, p12file []byte, p12password string, profileBytes []byte) error

InstallProfileSilent install a configuration profile silently.

func Prepare

func Prepare(device ios.DeviceEntry, skip []string, certBytes []byte, orgname string, locale string, lang string) error

Prepare prepares an activated device and supervises it if desired. skip is the list of setup options to skip, use GetAllSetupSkipOptions() to get a list of all available options. certBytes is the DER encoded supervision certificate. If it is nil then the device won't be supervised. ios.CreateDERFormattedSupervisionCert() provides an example how to generate these certificates. Orgname can be any string, it will show up as the supervision name on the device. Locale and lang can be set. If they are empty strings, then the default will be en_US and en.

func RemoveProxy

func RemoveProxy(device ios.DeviceEntry) error

RemoveProxy unsets the global HTTP proxy config again by deleting the global config profile installed by go-ios using the identifier I hardcoded 'Go-iOS.CD15976B-E205-4213-9B8E-FDAA5FAB1C22'

func SetHttpProxy

func SetHttpProxy(device ios.DeviceEntry, host string, port string, user string, pass string, p12file []byte, p12password string) error

SetHttpProxy generates the config profile "Go-iOS.CD15976B-E205-4213-9B8E-FDAA5FAB1C22" that will set a global http proxy on supervised devices.

Types

type Connection

type Connection struct {
	// contains filtered or unexported fields
}

func New

func New(device ios.DeviceEntry) (*Connection, error)

func (*Connection) AddProfile

func (mcInstallConn *Connection) AddProfile(profilePlist []byte) error

func (*Connection) AddProfileSupervised

func (mcInstallConn *Connection) AddProfileSupervised(profileFileBytes []byte, p12fileBytes []byte, password string) error

func (*Connection) Close

func (mcInstallConn *Connection) Close() error

Close closes the underlying DeviceConnection

func (*Connection) Escalate

func (mcInstallConn *Connection) Escalate(p12bytes []byte, p12Password string) error

func (*Connection) EscalateUnsupervised

func (mcInstallConn *Connection) EscalateUnsupervised() error

func (*Connection) EscalateWithCertAndKey

func (mcInstallConn *Connection) EscalateWithCertAndKey(supervisedPrivateKey interface{}, supervisionCert *x509.Certificate) error

func (*Connection) HandleList

func (mcInstallConn *Connection) HandleList() ([]ProfileInfo, error)

func (*Connection) RemoveProfile

func (mcInstallConn *Connection) RemoveProfile(identifier string) error

type ProfileInfo

type ProfileInfo struct {
	Identifier string
	Manifest   ProfileManifest
	Metadata   ProfileMetadata
	Status     string
}

type ProfileManifest

type ProfileManifest struct {
	Description string
	IsActive    bool
}

type ProfileMetadata

type ProfileMetadata struct {
	PayloadDescription       string
	PayloadDisplayName       string
	PayloadRemovalDisallowed bool
	PayloadUUID              string
	PayloadVersion           uint64
}