fwutils

README

fwutils

A collection of utilities for working with iOS firmwares. WIP.

Documentation

Overview

device is a library for getting information about apple's iOS devices

ipsw is for doing things with IPSWs

Index

• func NewiTunesVersionMaster() *iTunesVersionMaster
• func ReadFile(reader *zip.Reader, file string) (result []byte, err error)
• type BuildInformation
• type BuildNumber
• type Device
  • func (d *Device) DeviceInfo(identifier string) (err error)
  • func (d *Device) DeviceInfoGivenURL(firmwareURL string) (err error)
• type DeviceIdentifier
• type IPSW
  • func NewIPSW(url string) *IPSW
  • func (ip *IPSW) GetRestorePlist() (parsed Restore, err error)
  • func (ip *IPSW) PopulateInfo() (err error)
  • func (ip *IPSW) PopulateInfoGivenBuild(build *IndividualBuild)
• type IPSWProperties
• type IndividualBuild
• type IndividualDevice
• type Restore
• type VersionWrapper

Functions

func NewiTunesVersionMaster

func NewiTunesVersionMaster() *iTunesVersionMaster

creates a new iTunesVersionMaster struct, parsed and ready to use

func ReadFile

func ReadFile(reader *zip.Reader, file string) (result []byte, err error)

Types

type BuildInformation

type BuildInformation struct {
	Restore              *IndividualBuild
	Update               *IndividualBuild
	SameAs               BuildNumber
	OfferRestoreAsUpdate bool
}

type BuildNumber

type BuildNumber string

type Device

type Device struct {
	Identifier  string
	BDID        int
	BoardConfig string
	CPID        int
	Platform    string
	SCEP        int
	DeviceClass string
}

func (*Device) DeviceInfo

func (d *Device) DeviceInfo(identifier string) (err error)

Populates device given an identifier. Does so by finding a software URL for the identifier

func (*Device) DeviceInfoGivenURL

func (d *Device) DeviceInfoGivenURL(firmwareURL string) (err error)

Populates device given the URL for the device

type DeviceIdentifier

type DeviceIdentifier string

type IPSW

type IPSW struct {
	DownloadURL string
	Properties  *IPSWProperties
}

func NewIPSW

func NewIPSW(url string) *IPSW

creates a new IPSW given an URL

func (*IPSW) GetRestorePlist

func (ip *IPSW) GetRestorePlist() (parsed Restore, err error)

Get the restore Plist from the IPSW

func (*IPSW) PopulateInfo

func (ip *IPSW) PopulateInfo() (err error)

PopulateInfo gets the information about the IPSW from the path

func (*IPSW) PopulateInfoGivenBuild

func (ip *IPSW) PopulateInfoGivenBuild(build *IndividualBuild)

type IPSWProperties

type IPSWProperties struct {
	Identifier             string
	Version                string
	BuildID                string
	Filename               string
	Size                   int64
	MD5sum                 string
	SHA1sum                string
	UploadDate             string
	ReleaseDate            string
	AppleTVSoftwareVersion string
}

type IndividualBuild

type IndividualBuild struct {
	BuildVersion     BuildNumber
	DocumentationURL string
	FirmwareURL      string
	FirmwareSHA1     string
	ProductVersion   string
}

type IndividualDevice

type IndividualDevice struct {
	Identifier  string
	BDID        int
	BoardConfig string
	CPID        int
	Platform    string
	SCEP        int
}

type Restore

type Restore struct {
	DeviceClass         string
	Devices             []*IndividualDevice `plist:"DeviceMap"`
	ProductBuildVersion string
	ProductType         string
	ProductVersion      string
}

type VersionWrapper

type VersionWrapper struct {
	MobileDeviceSoftwareVersions map[DeviceIdentifier]map[BuildNumber]*BuildInformation
}