System Log

2014-07-04T08:17:20Z

Mringwal: /* bgm's trick for enabling system log */

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.

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].

== Reading syslog ==
=== On-device ===
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:
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.

=== On OS X through [[lockdownd]] ===
A binary (and its source code) to view ASL messages from Mac using the MobileDevice.framework has been made available on http://newosxbook.com/index.php?page=downloads. Ryan Petrich's [https://github.com/rpetrich/deviceconsole deviceconsole] also provides the same functionality with useful color-coding.

=== On Windows through [[lockdownd]] ===
Apple's [http://support.apple.com/kb/dl1466 iPhone Configuration Utility] can display the syslog on Windows.

=== bgm's trick for enabling system log ===
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.

If you don't want to reboot, you can restart the syslogd instead:
launchctl unload /System/Library/LaunchDaemons/com.apple.syslogd.plist
launchctl load /System/Library/LaunchDaemons/com.apple.syslogd.plist

<tt>/var/log/syslog</tt> will now be appended to automatically, and you can watch it like so:
tail -f /var/log/syslog
(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.

To disable syslog writing, run:
rm /var/log/syslog;
mknod /var/log/syslog c 3 2
This will delete (<tt>rm</tt>) the file and create a [[:/dev/null]]. (<tt>mknod *** c 3 2</tt>)

To re-enable syslog writing, run:
rm /var/log/syslog
touch /var/log/syslog

This will delete (<tt>rm</tt>) the file and and make a blank regular file. (<tt>touch</tt>)

==== 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 ===

# Plug your device into your computer.
# Download [http://blog.iphone-dev.org/post/24395681708/pre-dc cinject from this Dev Team blog post] (for OS X and Windows).
# Unzip the file.
# Open up a terminal on your computer (if you use OS X, you can use the Terminal application in the /Applications/Utilities/ folder.)
# 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 ==
* [http://code.google.com/p/iphone-elite/wiki/IphoneSyslogd Google Code]
* [http://code.google.com/p/iphone-elite/source/list?path=/wiki/IphoneSyslogd.wiki&start=398 Full History]

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

Bluetooth

2010-01-19T11:17:49Z

Mringwal: Added BTstack info

Bluetooth is a short-range, wireless technology, popular for its Personal Area Networking capability. Bluetooth hardware is provided on all iPhone platforms and the second generation iPod Touch platform. Apple has severely restricted the functions of Bluetooth to the end-user, for seemingly no reason, as the hardware supplied is capable of most if not all current bluetooth 2.0/2.1 functions.

With iPhoneOS 3.0, support for 3G internet bridging (PAN) or 'tethering' and A2DP over Bluetooth has been added, however the file sharing OBEX protocol is notably still missing.

== Access ==

Developers have been able to successfully access and interface the Bluetooth hardware to achieve basic L2CAP, RCOMM and OBEX. Besides individual closed-apps that contain a patched version of the lwBT Bluetooth Stack (e.g. roqyGPS and the upcoming iBlueNova for OBEX), the open-source BTstack project at http://btstack.googlecode.com provides general Bluetooth support for multiple applications. Examples available in Cydia: BTstack Keyboard, BTstack Mouse, WiiMote OpenGL Demo and some of ZodTTD's emulators.

The device nodes of relevance here, are
* /dev/uart.bluetooth
* /dev/cu.bluetooth
* /dev/tty.bluetooth
* /dev/btreset

== iPhone/iPods Bluetooth Hardware Summary==

* iPhone (iPhone1,1) (m68ap) - Bluetooth (r) 2.0 + EDR
* iPhone 3G (iPhone1,2) (n82ap) - Bluetooth (r) 2.0 + EDR - chip specific link [[Bluetooth iPhone2,1]]
* iPhone 3GS (iPhone2,1) (n88ap) - Bluetooth (r) 2.1 + EDR - chip specific link [[BCM4325]]

* iPod Touch (iPod1,1) (n45ap) - No Bluetooth Hardware
* iPod Touch 2G (iPod2,1) (n72ap) - Bluetooth (r) 2.1 + EDR
* iPod Touch 3G (iPod3,1) - Bluetooth (r) 2.1 + EDR - chip specific link [[BCM4329]]

The iPhone Wiki - User contributions [en]

System Log

Bluetooth