Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
idevicesyslog(1)	    General Commands Manual	      idevicesyslog(1)

NAME
       idevicesyslog - Relay syslog of a connected device.

SYNOPSIS
       idevicesyslog [OPTIONS]

DESCRIPTION
       Relay syslog of a connected device.

OPTIONS
       -u, --udid UDID
	      target specific device by	UDID

       -n, --network
	      connect to network device

       -x, --exit
	      exit when	device disconnects

       -d, --debug
	      enable communication debugging

       -h, --help
	      prints usage information

       -v, --version
	      Prints version information.

       --no-colors
	      disable colored output

       -o, --output FILE
	      Write  to	FILE instead of	stdout.	This will disable writing col-
	      ored output, but can be re-enabled with --colors.	 If  FILE  al-
	      ready exists, it will be overwritten without warning.

       --colors
	      Force writing colored output, e.g. when using --output.

FILTER OPTIONS
       -m, --match STRING
	      only print messages that contain STRING

	      This  option will	set a filter to	only printed log messages that
	      contain the given	string.

       -t, --trigger STRING
	      start logging when matching STRING

	      When specified, logging will start as soon as a log messages  is
	      encountered  that	 contains the given string. See	also -T, --un-
	      trigger. Other filters are still applied but obviously  filtered
	      messages are only	printed	after logging has started.

       -T, --untrigger STRING
	      stop logging when	matching STRING

	      When specified logging will halt as soon as a log	message	is en-
	      countered	 that  contains	the given string. See also -t, --trig-
	      ger. Other filters are still applied but obviously filtered mes-
	      sages are	only printed before logging stops.

	      NOTE: If no --trigger is given, idevicesyslog will exit after  a
	      matching log message was encountered.

       -p, --process PROCESS
	      only print messages from matching	process(es)

	      PROCESS  is  a  string  that  can	 either	 be a numeric pid or a
	      process name. It also supports multiple process names or pids in
	      one string, separated by | (make sure to use quotes!).

       -e, --exclude PROCESS
	      print all	messages except	matching process(es)

	      PROCESS is a string that can  either  be	a  numeric  pid	 or  a
	      process name. It also supports multiple process names or pids in
	      one string, separated by | (make sure to use quotes!).

       -q, --quiet
	      set a filter to exclude common noisy processes

	      Since  the  syslog  can  be quite	noisy, this quick command line
	      switch allows silencing  a  predefined  set  of  commonly	 known
	      processes.  The  list  of	processes that are silenced can	be re-
	      trieved with --quiet-list.

       --quiet-list
	      prints the list of processes for --quiet and exits

       -k, --kernel
	      only print kernel	messages

	      This is actually equivalent to passing --process kernel with the
	      exception	that it	can be used with --quiet to  silence  out  the
	      noisy process but	still get all the kernel log messages.

       -K, --no-kernel
	      suppress kernel messages

	      This is equivalent to passing --exclude kernel.

EXAMPLES
       idevicesyslog -u	00008030-0000111ABC000DEF
	      Relay syslog of device with UDID 00008030-0000111ABC000DEF.

       idevicesyslog -x
	      Relay syslog of device and exit when the device is unplugged.

       idevicesyslog -m	'####' -e 'identityservicesd' -K
	      Only  print log messages that contain the	string #### and	do NOT
	      originate	from identityservicesd or the kernel.

       idevicesyslog -p	MyApp -p ReportCrash
	      Only print log messages from the process named 'MyApp' and  'Re-
	      portCrash'.

       idevicesyslog -p	'MyApp|ReportCrash'
	      Same as previous example with different syntax.

       idevicesyslog -e	'backboardd|CommCenter|mDNSResponder'
	      Suppress	log  messages from backboardd, CommCenter, and mDNSRe-
	      sponder.

       idevicesyslog -q	-k
	      Suppress log messages from common	noisy processes, but DO	 print
	      kernel log messages.

       idevicesyslog -K
	      Suppress log messages from kernel, but print everything else

       idevicesyslog -t	'backlight on' -T 'backlight off' -q
	      Start  logging  when the device turns on backlight and stop log-
	      ging when	it turns backlight off,	and suppress noisy processes

AUTHORS
       Nikias Bassen, Martin Szulecki

       Man page	written	to conform with	Debian by Julien Lavergne.

ON THE WEB
       https://libimobiledevice.org

       https://github.com/libimobiledevice/libimobiledevice

							      idevicesyslog(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=idevicesyslog&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help