1idevicesyslog(1) General Commands Manual idevicesyslog(1)
2
6 idevicesyslog - Relay syslog of a connected device.
7
9 idevicesyslog [OPTIONS]
10
13 Relay syslog of a connected device.
14
17 -u, --udid UDID
18 target specific device by UDID
19 -n, --network
21 connect to network device
22 -x, --exit
24 exit when device disconnects
25 -d, --debug
27 enable communication debugging
28 -h, --help
30 prints usage information
31 -v, --version
33 prints version information.
34 --no-colors
36 disable colored output
37
40 -m, --match STRING
41 only print messages that contain STRING
42 This option will set a filter to only printed log messages that
44 contain the given string.
45 -t, --trigger STRING
47 start logging when matching STRING
48 When specified, logging will start as soon as a log messages is
50 encountered that contains the given string. See also -T, --un‐
51 trigger. Other filters are still applied but obviously filtered
52 messages are only printed after logging has started.
53 -T, --untrigger STRING
55 stop logging when matching STRING
56 When specified logging will halt as soon as a log message is en‐
58 countered that contains the given string. See also -t, --trig‐
59 ger. Other filters are still applied but obviously filtered mes‐
60 sages are only printed before logging stops.
61 NOTE: If no --trigger is given, idevicesyslog will exit after a
63 matching log message was encountered.
64 -p, --process PROCESS
66 only print messages from matching process(es)
67 PROCESS is a string that can either be a numeric pid or a
69 process name. It also supports multiple process names or pids in
70 one string, separated by | (make sure to use quotes!).
71 -e, --exclude PROCESS
73 print all messages except matching process(es)
74 PROCESS is a string that can either be a numeric pid or a
76 process name. It also supports multiple process names or pids in
77 one string, separated by | (make sure to use quotes!).
78 -q, --quiet
80 set a filter to exclude common noisy processes
81 Since the syslog can be quite noisy, this quick command line
83 switch allows silencing a predefined set of commonly known pro‐
84 cesses. The list of processes that are silenced can be retrieved
85 with --quiet-list.
86 --quiet-list
88 prints the list of processes for --quiet and exits
89 -k, --kernel
91 only print kernel messages
92 This is actually equivalent to passing --process kernel with the
94 exception that it can be used with --quiet to silence out the
95 noisy process but still get all the kernel log messages.
96 -K, --no-kernel
98 suppress kernel messages
99 This is equivalent to passing --exclude kernel.
101
104 idevicesyslog -u 00008030-0000111ABC000DEF
105 Relay syslog of device with UDID 00008030-0000111ABC000DEF.
106 idevicesyslog -x
108 Relay syslog of device and exit when the device is unplugged.
109 idevicesyslog -m '####' -e 'identityservicesd' -K
111 Only print log messages that contain the string #### and do NOT
112 originate from identityservicesd or the kernel.
113 idevicesyslog -p MyApp -p ReportCrash
115 Only print log messages from the process named 'MyApp' and 'Re‐
116 portCrash'.
117 idevicesyslog -p 'MyApp|ReportCrash'
119 Same as previous example with different syntax.
120 idevicesyslog -e 'backboardd|CommCenter|mDNSResponder'
122 Suppress log messages from backboardd, CommCenter, and mDNSRe‐
123 sponder.
124 idevicesyslog -q -k
126 Suppress log messages from common noisy processes, but DO print
127 kernel log messages.
128 idevicesyslog -K
130 Suppress log messages from kernel, but print everything else
131 idevicesyslog -t 'backlight on' -T 'backlight off' -q
133 Start logging when the device turns on backlight and stop log‐
134 ging when it turns backlight off, and suppress noisy processes
135
138 Nikias Bassen, Martin Szulecki
139 Man page written to conform with Debian by Julien Lavergne.
141
144 https://libimobiledevice.org
145 https://github.com/libimobiledevice/libimobiledevice
147 idevicesyslog(1)