1idevicesyslog(1)            General Commands Manual           idevicesyslog(1)
2
3
4

NAME

6       idevicesyslog - Relay syslog of a connected device.
7

SYNOPSIS

9       idevicesyslog [OPTIONS]
10
11

DESCRIPTION

13       Relay syslog of a connected device.
14
15

OPTIONS

17       -u, --udid UDID
18              target specific device by UDID
19
20       -n, --network
21              connect to network device
22
23       -x, --exit
24              exit when device disconnects
25
26       -d, --debug
27              enable communication debugging
28
29       -h, --help
30              prints usage information
31
32       -v, --version
33              prints version information.
34
35       --no-colors
36              disable colored output
37
38

FILTER OPTIONS

40       -m, --match STRING
41              only print messages that contain STRING
42
43              This  option will set a filter to only printed log messages that
44              contain the given string.
45
46       -t, --trigger STRING
47              start logging when matching STRING
48
49              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
54       -T, --untrigger STRING
55              stop logging when matching STRING
56
57              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
62              NOTE: If no --trigger is given, idevicesyslog will exit after  a
63              matching log message was encountered.
64
65       -p, --process PROCESS
66              only print messages from matching process(es)
67
68              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
72       -e, --exclude PROCESS
73              print all messages except matching process(es)
74
75              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
79       -q, --quiet
80              set a filter to exclude common noisy processes
81
82              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
87       --quiet-list
88              prints the list of processes for --quiet and exits
89
90       -k, --kernel
91              only print kernel messages
92
93              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
97       -K, --no-kernel
98              suppress kernel messages
99
100              This is equivalent to passing --exclude kernel.
101
102

EXAMPLES

104       idevicesyslog -u 00008030-0000111ABC000DEF
105              Relay syslog of device with UDID 00008030-0000111ABC000DEF.
106
107       idevicesyslog -x
108              Relay syslog of device and exit when the device is unplugged.
109
110       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
114       idevicesyslog -p MyApp -p ReportCrash
115              Only  print log messages from the process named 'MyApp' and 'Re‐
116              portCrash'.
117
118       idevicesyslog -p 'MyApp|ReportCrash'
119              Same as previous example with different syntax.
120
121       idevicesyslog -e 'backboardd|CommCenter|mDNSResponder'
122              Suppress log messages from backboardd, CommCenter,  and  mDNSRe‐
123              sponder.
124
125       idevicesyslog -q -k
126              Suppress  log messages from common noisy processes, but DO print
127              kernel log messages.
128
129       idevicesyslog -K
130              Suppress log messages from kernel, but print everything else
131
132       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
136

AUTHORS

138       Nikias Bassen, Martin Szulecki
139
140       Man page written to conform with Debian by Julien Lavergne.
141
142

ON THE WEB

144       https://libimobiledevice.org
145
146       https://github.com/libimobiledevice/libimobiledevice
147
148
149
150                                                              idevicesyslog(1)
Impressum