summaryrefslogtreecommitdiffstats
path: root/man/ideviceinstaller.1
blob: 0cd0bee0489517820f324961b74a26e01b27485c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.TH "ideviceinstaller" 1
.SH NAME
ideviceinstaller \- Manage apps on iOS devices.
.SH SYNOPSIS
.B ideviceinstaller
[OPTIONS]

.SH DESCRIPTION

Allows to enumerate, install, upgrade, and uninstall apps on iOS devices.

.SH COMMANDS
.TP
.B list
List installed apps on the device. Options:
.RS
.TP
.B \-\-user
List user apps only (apps installed by the user).
.B This is the default.
.TP
.B \-\-system
List system apps only (apps available from the system firmware).
.TP
.B \-\-all
List all types of apps.
.TP
.B \-\-xml
Print output as XML Property List.
.TP
.B \-a, \-\-attribute ATTR
Specify attribute to return. This argument can be passed multiple times. If omitted and \f[B]\-\-xml\f[] is *not* specified, the default attributes \f[B]CFBundleIdentifier\f[], \f[B]CFBundleShortVersionString\f[], and \f[B]CFBundleDisplayName\f[] will be used. The attributes can be found in the app's Info.plist, but also some extra attributes exist. Some examples:
.RS
.TP
\f[B]StaticDiskUsage\f[]   disk usage of installed app
.TP
\f[B]DynamicDiskUsage\f[]  app user data disk usage
.TP
\f[B]Path\f[]              app installation location
.TP
\f[B]SignerIdentity\f[]    code signing identity
.TP
NOTE: It is suggested to always add CFBundleIdentifier to allow unique identification of the apps.
.RE
.TP
.B \-b, \-\-bundle\-identifier BUNDLEID
Only query given bundle identifier. This argument can be passed multiple times.
.RE
.TP
.B install PATH
Install app from a package file specified by PATH. PATH can also be a .ipcc
file for carrier bundle installation or a .app directory for developer
app installation.
.RS
.TP
.B \-s, \-\-sinf PATH
Pass an external SINF file located at PATH.
.TP
.B \-m, \-\-metadata PATH
Pass an external iTunesMetadata file located at PATH.
.RE

.TP
.B uninstall BUNDLEID
Uninstall app specified by BUNDLEID.

.TP
.B upgrade PATH
Upgrade app from a package file specified by PATH.

.SH LEGACY COMMANDS
The following commands are non-functional with iOS 7 or later.
.TP
.B archive BUNDLEID
Archive app specified by BUNDLEID. Options:
.RS
.TP
.B \-\-uninstall
Uninstall the package after making an archive
.TP
.B \-\-app_only
Archive application data only
.TP
.B \-\-docs_only
Archive documents (user data) only
.TP
.B \-\-copy=PATH
Copy the app archive to directory PATH when done
.TP
.B \-\-remove
Only valid when copy=PATH is used: remove after copy
.RE

.TP
.B restore BUNDLEID
Restore archived app specified by BUNDLEID.

.TP
.B list-archives
List archived apps on the device. Options:
.RS
.TP
.B \-\-xml
Print output as XML Property List.
.RE

.TP
.B remove-archive BUNDLEID
Remove app archive specified by BUNDLEID.

.SH OPTIONS
.TP
.B \-u, \-\-udid UDID
Target specific device by UDID.
.TP
.B \-n, \-\-network
Connect to network device.
.TP
.B \-w, \-\-notify-wait
Wait for app installed/uninstalled notification before reporting success of operation.
.TP
.B \-h, \-\-help
Print usage information.
.TP
.B \-d, \-\-debug
Enable communication debugging.
.TP
.B \-v, \-\-version
Print version information.

.SH AUTHORS
Nikias Bassen

Martin Szulecki

.SH ON THE WEB
https://libimobiledevice.org

https://github.com/libimobiledevice/ideviceinstaller