From 91d76eb4e449dec0cb23d56886817d9910963559 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Sat, 28 Mar 2009 01:28:01 +0100 Subject: Readme.txt renamed to README --- README | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..5cb74f9 --- /dev/null +++ b/README @@ -0,0 +1,33 @@ +Build +===== + + make + + +Use +=== + + sudo ./usbmuxd & + ./iproxy 2222 22 & + ssh -p 2222 root@localhost + +Muwahahaha. Hopefully you get the normal SSH login prompt. + + +SSH +=== + +If your iphone is rooted, but isn't running SSH, you will need to +mount it with 'ifuse --afc2' (to access the root directory of the +device). + +And then edit: + + /Library/LaunchDaemons/com.openssh.sshd.plist + +to _remove_ the lines: + + Diabled + + +Reboot the device and then sshd should be running. -- cgit v1.1-32-gdbae From 968dc229afd75e670a92b24eb48222aa347d756b Mon Sep 17 00:00:00 2001 From: Paul Sladen Date: Sun, 29 Mar 2009 19:13:36 +0200 Subject: [PATCH] renamed: usbmuxd.h -> usbmuxd-proto.h renamed: libusbmuxd.h -> usbmuxd.h Use 'install' in Makefile build libusbmuxd.so (use with '#include ' and -lusbmuxd add *.so to .gitignore Really this time. Signed-off-by: Nikias Bassen --- README | 1 - 1 file changed, 1 deletion(-) (limited to 'README') diff --git a/README b/README index 5cb74f9..b36c0c0 100644 --- a/README +++ b/README @@ -3,7 +3,6 @@ Build make - Use === -- cgit v1.1-32-gdbae From 096bb6ed89596b10efbdf6f732106ff5295449fd Mon Sep 17 00:00:00 2001 From: Paul Sladen Date: Sun, 29 Mar 2009 19:46:08 +0200 Subject: [PATCH] Expand README Signed-off-by: Nikias Bassen --- README | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 51 insertions(+), 12 deletions(-) (limited to 'README') diff --git a/README b/README index b36c0c0..42ca40a 100644 --- a/README +++ b/README @@ -1,26 +1,65 @@ -Build -===== +Background +========== + +'usbmuxd' stands for "USB multiplexing daemon". To the user/developer +what it actually does is to proxy requests over a USB cable on directly +to a listening TCP port on the iPhone. + +Multiple connections to different TCP ports can happen in parallel. +An example (and useful) tool called 'iproxy' is included that allows +you to forward localhost ports to the device---allows SSH over USB on +jailbroken devices, or allowing access the lockdown daemon (and then +to all of the file access, sync, notification and backup services +running on the device). + +This higher-level layers are handled by libiphone. The version of +libiphone compatible with the 'usbmuxd' infrastructure is called +'libiphone-usbmuxd'. 'ifuse' is then able to sit on top of this. + + +Building +======== make + sudo make install + -Use -=== +Running (with magic) +==================== - sudo ./usbmuxd & + (Unplug + replug your iPhone) ./iproxy 2222 22 & ssh -p 2222 root@localhost -Muwahahaha. Hopefully you get the normal SSH login prompt. +Hopefully you get the normal SSH login prompt. You may still lots of +debugging output for the moment. If this is getting in the way of +your ssh login, then run the 'ssh' command from a different xterminal +or virtual console. + + +Running (without magic) +======================= + +If 'udev' is _not_ automatically running on your machine and picking +up the new .rules file, you will need to start usbmuxd by hand first. +Check it's running and that there is only one copy with 'ps aux | grep +usbmuxd'. + + sudo usbmuxd & + ./iproxy 2222 22 & + ssh -p 2222 root@localhost -SSH -=== +Tip: Starting SSH if disabled +============================= -If your iphone is rooted, but isn't running SSH, you will need to -mount it with 'ifuse --afc2' (to access the root directory of the -device). +If your iphone is rooted, but SSH isn't started and you _cannot_ (for +instance, cracked/broken screen) get to the Services control panel on +the device, then you can start the SSH service over the USB by +mounting the (jailbroken) filesystem. -And then edit: +You will need to mount it usbing 'ifuse --afc2' (to access the root +directory of the device), and then edit: /Library/LaunchDaemons/com.openssh.sshd.plist -- cgit v1.1-32-gdbae From f64eb1f01fe21819e6e9c43aa97830460b32a1f9 Mon Sep 17 00:00:00 2001 From: Nikias Bassen Date: Tue, 5 May 2009 15:04:52 +0200 Subject: README updated --- README | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README') diff --git a/README b/README index 42ca40a..ff28e19 100644 --- a/README +++ b/README @@ -20,6 +20,8 @@ libiphone compatible with the 'usbmuxd' infrastructure is called Building ======== + ./autogen.sh + ./configure --sysconfdir=/etc make sudo make install -- cgit v1.1-32-gdbae