System Log - Revision history

IAdam1n: This should not be in the filesystem category as it has nothing to do with it.

2015-08-26T17:44:05Z

This should not be in the filesystem category as it has nothing to do with it.

Britta: adding "detailed instructions for non-developers" from jbqa faq so information is consolidated

2014-11-10T23:30:52Z

adding "detailed instructions for non-developers" from jbqa faq so information is consolidated

Britta: more detail

2014-11-10T23:18:38Z

more detail

Britta: more intro; organizing

2014-11-10T14:16:44Z

more intro; organizing

Britta: sbsettings is old

2014-11-10T14:10:24Z

sbsettings is old

Britta: slightly better description

2014-11-10T14:06:46Z

slightly better description

Britta: moving longer script to bottom

2014-11-10T11:11:03Z

moving longer script to bottom

Xvolks at 12:36, 9 November 2014

2014-11-09T12:36:42Z

Britta: mentioning name of package in cydia

2014-11-01T09:13:35Z

mentioning name of package in cydia

Britta: formatting

2014-10-24T21:24:28Z

formatting

← Older revision		Revision as of 17:44, 26 August 2015
Line 134:		Line 134:
	* [http://code.google.com/p/iphone-elite/wiki/IphoneSyslogd Old iPhoneSyslogd page on the iPhone-elite wiki] ([http://code.google.com/p/iphone-elite/source/list?path=/wiki/IphoneSyslogd.wiki&start=398 Full History])		* [http://code.google.com/p/iphone-elite/wiki/IphoneSyslogd Old iPhoneSyslogd page on the iPhone-elite wiki] ([http://code.google.com/p/iphone-elite/source/list?path=/wiki/IphoneSyslogd.wiki&start=398 Full History])

−	[[Category:Filesystem]]
	[[Category:Daemons]]		[[Category:Daemons]]

@@ Line 1: / Line 1: @@
 iOS devices have a '''system log''' ('''syslog''') like other UNIX-derived operating systems do. See [http://en.wikipedia.org/wiki/Syslog Syslog on Wikipedia] for background. This can be helpful as a debugging tool for developers.
-If you're a developer who needs simple instructions to give to a user about how to send a syslog to you, you can give them [http://www.jailbreakqa.com/questions/32462/frequently-asked-questions#81925 "A developer asked for my device's syslog. How do I send it?" in the JailbreakQA FAQ].
+If you're a developer who needs simple instructions to give to a user about how to send a syslog to you, you can give them a link to the [[#Detailed instructions for non-developers|Detailed instructions for non-developers]] below.
 == Reading syslog ==
@@ Line 107: / Line 107: @@
 </pre>
 [[Category:Filesystem]]

@@ Line 28: / Line 28: @@
 (The "tail" command is in the package "Core Utilities" (coreutils) in the Cydia/Telesphoreo repository.) If you keep your device full of data, be careful you don't fill the disk. Unix systems tend to break when they can't write to the syslog. Keep an eye on it or employ some log rotation.
  rm /var/log/syslog;
  mknod /var/log/syslog c 3 2
@@ Line 37: / Line 39: @@
  touch /var/log/syslog
-This will delete (<tt>rm</tt>) the file and and make a blank regular file. (<tt>touch</tt>)
+This will delete (<tt>rm</tt>) the file and and make a blank regular file (<tt>touch</tt>).
 On iOS 6 and below, it may be useful to install the SBSettings [http://apt.thebigboss.org/onepackage.php?bundleid=sbsettingssyslogd syslog toggle] for enabling/disabling the syslog in this way, available at BigBoss' Cydia repository. Ensure "syslogd to /var/log/syslog" is installed - the toggle package hasn't marked it as a dependency.

@@ Line 1: / Line 1: @@
-iOS devices have a '''system log''' ('''syslog''') like other UNIX-derived operating systems do. See [http://en.wikipedia.org/wiki/Syslog Syslog on Wikipedia] for background.
+iOS devices have a '''system log''' ('''syslog''') like other UNIX-derived operating systems do. See [http://en.wikipedia.org/wiki/Syslog Syslog on Wikipedia] for background. This can be helpful as a debugging tool for developers.
 If you're a developer who needs simple instructions to give to a user about how to send a syslog to you, you can give them [http://www.jailbreakqa.com/questions/32462/frequently-asked-questions#81925 "A developer asked for my device's syslog. How do I send it?" in the JailbreakQA FAQ].
@@ Line 16: / Line 16: @@
 Evan Swick's [https://github.com/eswick/ondeviceconsole ondeviceconsole] tool can be used in place of the method mentioned above. It functions similar to Ryan Petrich's [https://github.com/rpetrich/deviceconsole deviceconsole] tool, but runs directly on the device, without the need of a computer. It connects directly to the syslog socket, and displays log entries in real-time, with syntax highlighting. A precompiled version is available in the BigBoss repository.
 === On-device with saving to a file ===
@@ Line 47: / Line 40: @@
 On iOS 6 and below, it may be useful to install the SBSettings [http://apt.thebigboss.org/onepackage.php?bundleid=sbsettingssyslogd syslog toggle] for enabling/disabling the syslog in this way, available at BigBoss' Cydia repository. Ensure "syslogd to /var/log/syslog" is installed - the toggle package hasn't marked it as a dependency.
 === On OS X or Windows through cinject ===

← Older revision		Revision as of 14:10, 10 November 2014
Line 46:		Line 46:
	This will delete (<tt>rm</tt>) the file and and make a blank regular file. (<tt>touch</tt>)		This will delete (<tt>rm</tt>) the file and and make a blank regular file. (<tt>touch</tt>)

		+	On iOS 6 and below, it may be useful to install the SBSettings [http://apt.thebigboss.org/onepackage.php?bundleid=sbsettingssyslogd syslog toggle] for enabling/disabling the syslog in this way, available at BigBoss' Cydia repository. Ensure "syslogd to /var/log/syslog" is installed - the toggle package hasn't marked it as a dependency.
−	==== SBSettings Toggle ====
−	An SBSettings [http://apt.thebigboss.org/onepackage.php?bundleid=sbsettingssyslogd toggle] for enabling/disabling the syslog in this way is available at BigBoss' Cydia repository. Ensure "syslogd to /var/log/syslog" is installed - the toggle package hasn't marked it as a dependency.

	=== On OS X or Windows through cinject ===		=== On OS X or Windows through cinject ===

@@ Line 24: / Line 24: @@
 Apple's [http://support.apple.com/kb/dl1466 iPhone Configuration Utility] can display the syslog on Windows.
-=== bgm's trick for enabling system log ===
+=== On-device with saving to a file ===
-This method will constantly write syslog output to a file. This is not recommended as it is slower, and can become fairly large. Install "syslogd to /var/log/syslog" from [[saurik]]'s repo and reboot your device.
+To constantly write syslog output to a file on the device (which can be slower, and the file can become fairly larg e, but can be convenient): install '''syslogd to /var/log/syslog''' from [[saurik]]'s repo and reboot your device.
 If you don't want to reboot, you can restart the syslogd instead:
@@ Line 58: / Line 58: @@
 # That should display the running syslog from your device.
-=== On-device with file saving ===
+=== On-device with saving to a file via a Python script ===
 I made this little naive python script for my own usage.
 It saves the syslog in <code>/var/log/syslog</code> file.

@@ Line 4: / Line 4: @@
 == Reading syslog ==
 === On-device with socat ===
@@ Line 105: / Line 57: @@
 # Assuming you're using OS X and have downloads configured to use the default Downloads folder, run this command (copy and paste it and then hit the return key): <tt>cd ~/Downloads/cinject-0.5.4</tt> and then run <tt>./cinject -w</tt>
 # That should display the running syslog from your device.
 == Reference ==

← Older revision		Revision as of 12:36, 9 November 2014
Line 4:		Line 4:

	== Reading syslog ==		== Reading syslog ==
		+	=== On-device with file saving ===
		+	I made this little naive python script for my own usage.
		+	It saves the syslog in <code>/var/log/syslog</code> file.
		+	You need to install python with <code>apt-get install python</code> to use it.
		+	Name it syslog or whatever and start it with
		+	<code>
		+	./syslog &
		+	</code>
		+
		+	<pre>
		+	#!/usr/bin/python
		+
		+	# Created by Xvolks 11/09/2014
		+
		+	import sys
		+	import socket
		+
		+	server_address = '/var/run/lockdown/syslog.sock'
		+
		+	# Create a UDS socket
		+	sock = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
		+
		+	try:
		+	sock.connect(server_address)
		+	except socket.error, msg:
		+	print >>sys.stderr, msg
		+	sys.exit(1)
		+
		+	try:
		+
		+	# Send data
		+	data = sock.recv(64)
		+	print data
		+	sock.sendall('watch\n')
		+	f = open('/var/log/syslog', 'a')
		+	while 1:
		+	data = sock.recv(256)
		+	if (data):
		+	f.write("".join(data.split('\x00')))
		+	else:
		+	sleep(1)
		+
		+	finally:
		+	f.close()
		+	print >>sys.stderr, 'closing socket'
		+	sock.close()
		+	</pre>
		+
		+
	=== On-device with socat ===		=== On-device with socat ===

@@ Line 8: / Line 8: @@
 <!-- TODO: Add a description of what socat is
 -->
-As [[iOS]] is [[wikipedia:Unix|Unix]] based, it comes as no surprise that its syslog can be read using the same tools desktop Unix and [[wikipedia:Linux|Linux]] power users use; provided the tools are compiled for ARM. The most common tool is <code>socat(1)</code><sup>[{{man|socat|1}}]</sup>. If you don't have it yet, just run an <code>apt-get</code> on the package <code>socat</code>. In order to use it, just connect to the syslog socket with the following command:
+As [[iOS]] is [[wikipedia:Unix|Unix]] based, it comes as no surprise that its syslog can be read using the same tools desktop Unix and [[wikipedia:Linux|Linux]] power users use; provided the tools are compiled for ARM. The most common tool is <code>socat(1)</code><sup>[{{man|socat|1}}]</sup>. If you don't have it yet, run an <code>apt-get</code> on the package <code>socat</code> (or install the package <code>SOcket CAT</code> via Cydia). In order to use it, connect to the syslog socket with the following command:
  socat - UNIX-CONNECT:/var/run/lockdown/syslog.sock
 This gives an interactive shell with the syslog daemon (no need to enable file output). If you execute the <code>watch</code> command, a backlog of messages will be printed and new messages will be printed as they arrive.