Package damage

import "github.com/itchio/damage"

Overview
Index
Subdirectories

Overview

const (
    // LanguageEnglish represents the English Languageuage, as if there was a single one.
    LanguageEnglish           = 0
    LanguageFrench            = 1
    LanguageGerman            = 2
    LanguageItalian           = 3
    LanguageDutch             = 4
    LanguageSwedish           = 5
    LanguageSpanish           = 6
    LanguageDanish            = 7
    LanguagePortuguese        = 8
    LanguageNorwegian         = 9
    LanguageHebrew            = 10
    LanguageJapanese          = 11
    LanguageArabic            = 12
    LanguageFinnish           = 13
    LanguageGreek             = 14
    LanguageIcelandic         = 15
    LanguageMaltese           = 16
    LanguageTurkish           = 17
    LanguageCroatian          = 18
    LanguageTradChinese       = 19
    LanguageUrdu              = 20
    LanguageHindi             = 21
    LanguageThai              = 22
    LanguageKorean            = 23
    LanguageLithuanian        = 24
    LanguagePolish            = 25
    LanguageHungarian         = 26
    LanguageEstonian          = 27
    LanguageLatvian           = 28
    LanguageSami              = 29
    LanguageFaroese           = 30
    LanguageFarsi             = 31
    LanguageRussian           = 32
    LanguageSimpChinese       = 33
    LanguageFlemish           = 34
    LanguageIrishGaelic       = 35
    LanguageAlbanian          = 36
    LanguageRomanian          = 37
    LanguageCzech             = 38
    LanguageSlovak            = 39
    LanguageSlovenian         = 40
    LanguageYiddish           = 41
    LanguageSerbian           = 42
    LanguageMacedonian        = 43
    LanguageBulgarian         = 44
    LanguageUkrainian         = 45
    LanguageByelorussian      = 46
    LanguageUzbek             = 47
    LanguageKazakh            = 48
    LanguageAzerbaijani       = 49
    LanguageAzerbaijanAr      = 50
    LanguageArmenian          = 51
    LanguageGeorgian          = 52
    LanguageMoldavian         = 53
    LanguageKirghiz           = 54
    LanguageTajiki            = 55
    LanguageTurkmen           = 56
    LanguageMongolian         = 57
    LanguageMongolianCyr      = 58
    LanguagePashto            = 59
    LanguageKurdish           = 60
    LanguageKashmiri          = 61
    LanguageSindhi            = 62
    LanguageTibetan           = 63
    LanguageNepali            = 64
    LanguageSanskrit          = 65
    LanguageMarathi           = 66
    LanguageBengali           = 67
    LanguageAssamese          = 68
    LanguageGujarati          = 69
    LanguagePunjabi           = 70
    LanguageOriya             = 71
    LanguageMalayalam         = 72
    LanguageKannada           = 73
    LanguageTamil             = 74
    LanguageTelugu            = 75
    LanguageSinhalese         = 76
    LanguageBurmese           = 77
    LanguageKhmer             = 78
    LanguageLao               = 79
    LanguageVietnamese        = 80
    LanguageIndonesian        = 81
    LanguageTagalog           = 82
    LanguageMalayRoman        = 83
    LanguageMalayArabic       = 84
    LanguageAmharic           = 85
    LanguageTigrinya          = 86
    LanguageOromo             = 87
    LanguageSomali            = 88
    LanguageSwahili           = 89
    LanguageRuanda            = 90
    LanguageRundi             = 91
    LanguageChewa             = 92
    LanguageMalagasy          = 93
    LanguageEsperanto         = 94
    LanguageWelsh             = 128
    LanguageBasque            = 129
    LanguageCatalan           = 130
    LanguageLatin             = 131
    LanguageQuechua           = 132
    LanguageGuarani           = 133
    LanguageAymara            = 134
    LanguageTatar             = 135
    LanguageUighur            = 136
    LanguageDzongkha          = 137
    LanguageJavaneseRom       = 138
    LanguageSundaneseRom      = 139
    LanguageGalician          = 140
    LanguageAfrikaans         = 141
    LanguageBreton            = 142
    LanguageInuktitut         = 143
    LanguageScottishGaelic    = 144
    LanguageManxGaelic        = 145
    LanguageIrishGaelicScript = 146
    LanguageTongan            = 147
    LanguageGreekAncient      = 148
    LanguageGreenlandic       = 149
    LanguageAzerbaijanRoman   = 150
    LanguageNynorsk           = 151
    LanguageUnspecified       = 32767
)

LPicResourceID is the identifier for the base LPic resource - where languages are listed for an SLA.

const LPicResourceID int64 = 5000

func Unmount

func Unmount(host hdiutil.Host, dir string) error

type DiskInfo

type DiskInfo struct {
    Format            string              `plist:"Format"`
    FormatDescription string              `plist:"Format Description"`
    Partitions        Partitions          `plist:"partitions"`
    Properties        DiskProperties      `plist:"Properties"`
    SizeInformation   DiskSizeInformation `plist:"Size Information"`
}

func GetDiskInfo

func GetDiskInfo(host hdiutil.Host, dmgpath string) (*DiskInfo, error)

func (*DiskInfo) String

func (di *DiskInfo) String() string

type DiskProperties

type DiskProperties struct {
    // true if has a software license agreement
    SoftwareLicenseAgreement bool `plist:"Software License Agreement" json:",omitempty"`
    // true if is compressed
    Checksummed bool `plist:"Checksummed" json:",omitempty"`
    // true if includes checksums
    Compressed bool `plist:"Compressed" json:",omitempty"`
    Encrypted  bool `plist:"Encrypted" json:",omitempty"`
}

type DiskSizeInformation

type DiskSizeInformation struct {
    CompressedBytes    int64 `plist:"Compressed Bytes"`
    TotalBytes         int64 `plist:"Total Bytes"`
    TotalNonEmptyBytes int64 `plist:"Total Non-Empty Bytes"`
}

type LPic

LPic is the decoded version of UDIF's language information for SLAs.

type LPic struct {
    Missing         bool
    DefaultLanguage Language
    Entries         []LPicEntry
}

func (*LPic) ByLanguage

func (lp *LPic) ByLanguage(lang Language) (LPicEntry, bool)

ByLanguage returns the information for a specific language, or (, false) if it can't be found.

type LPicEntry

An LPicEntry contains information for one of the languages an SLA is available in.

type LPicEntry struct {
    Language Language
    // RelativeResourceID is the ID of the STR#/TEXT/styl resource
    // for the SLA in this language, relative to LPicResourceID
    RelativeResourceID int64
    // MultibyteLanguage is true if Language is multibyte
    // See /System/Library/Frameworks/CoreServices.framework/Frameworks/CarbonCore.framework/Headers/Script.h for language IDs.
    MultibyteLanguage bool
}

type Language

Language is an Apple UDIF Languageuage code

type Language int

func (Language) String

func (l Language) String() string

type MountResult

type MountResult struct {
    SystemEntities []SystemEntity `plist:"system-entities"`
}

func Mount

func Mount(host hdiutil.Host, dmgpath string, dir string) (*MountResult, error)

Mount a dmg file into a directory

type Partition

type Partition struct {
    Hint        string                 `plist:"partition-hint" json:",omitempty"`
    Name        string                 `plist:"partition-name"`
    Length      int64                  `plist:"partition-length"`
    Synthesized bool                   `plist:"synthesized" json:",omitempty"`
    Filesystems map[string]interface{} `plist:"partition-filesystems" json:",omitempty"`
}

type Partitions

type Partitions struct {
    Partitions []Partition `plist:"partitions"`
}

type SLA

An SLA is a Service License Agreement, which can be embedded into a disk image.

type SLA struct {
    Language Language
    Text     string
}

func GetDefaultSLA

func GetDefaultSLA(rez *UDIFResources) (*SLA, error)

GetDefaultSLA returns the Service License Agreement for the default language.

func GetSLA

func GetSLA(rez *UDIFResources, lang Language) (*SLA, error)

GetSLA returns the Service License Agreement for a specific language.

type SystemEntity

type SystemEntity struct {
    MountPoint           string `plist:"mount-point"`
    PotentiallyMountable bool   `plist:"potentially-mountable"`
    UnmappedContentHint  string `plist:"unmapped-content-hint"`
    VolumeKind           string `plist:"volume-kind"`
    ContentHint          string `plist:"content-hint"`
    DevEntry             string `plist:"dev-entry"`
}

type UDIFResource

type UDIFResource struct {
    Data       []byte `plist:"Data"`
    ID         string `plist:"ID"`
    Name       string `plist:"Name"`
    Attributes string `plist:"Attributes"`
}

func (UDIFResource) StringData

func (res UDIFResource) StringData() string

StringData returns Data as an ASCII (7-bit) string. Multibyte encodings are not supported.

type UDIFResourceGroup

type UDIFResourceGroup []UDIFResource

func (UDIFResourceGroup) ByID

func (grp UDIFResourceGroup) ByID(id int64) (UDIFResource, bool)

func (UDIFResourceGroup) ByIDString

func (grp UDIFResourceGroup) ByIDString(idString string) (UDIFResource, bool)

type UDIFResources

UDIFResources contains a subset of the resources contained in a UDIF (Apple Universal Disk Image Format).

type UDIFResources struct {
    // LPic is an acronym I don't know, but it contains
    // default language information and a language list for the SLA (Software License Agreement)
    LPic    UDIFResourceGroup `plist:"LPic"`
    StrHash UDIFResourceGroup `plist:"STR#"`
    Text    UDIFResourceGroup `plist:"TEXT"`
    Tmpl    UDIFResourceGroup `plist:"TMPL"`
    Plst    UDIFResourceGroup `plist:"plst"`
    Styl    UDIFResourceGroup `plist:"styl"`
    // contains filtered or unexported fields
}

func GetUDIFResources

func GetUDIFResources(host hdiutil.Host, dmgpath string) (*UDIFResources, error)

func (UDIFResources) ParsedLPic

func (rez UDIFResources) ParsedLPic() (*LPic, error)

ParsedLPic returns a parsed version of the LPic resource from an UDIF. It'll mostly error out if the resource is invalid (unlikely) or if our parser is wrong (more likely).

Subdirectories

Name	Synopsis

cmd
cmd/damage
hdiutil

github.com/itchio/damage

damage

Prerequisites