idevice 1.1.5.0

data/spec/diagnostics_relay_devicespec.rb

@@ -0,0 +1,125 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice::DiagnosticsRelayClient do
+  before :all do
+    @idevice = shared_idevice
+  end
+
+  before :each do
+    @drc = Idevice::DiagnosticsRelayClient.attach(idevice:@idevice)
+  end
+
+  after :each do
+    @drc.goodbye rescue nil
+  end
+
+  it "should attach" do
+    @drc.should be_a Idevice::DiagnosticsRelayClient
+  end
+
+  it "should request diagnostics" do
+    result = @drc.diagnostics("All")
+    result.should be_a Hash
+    result.should have_key "WiFi"
+    result.should have_key "GasGauge"
+    result["WiFi"].keys.sort.should == ["Active", "Status"]
+    result["GasGauge"].keys.sort.should == ["CycleCount", "DesignCapacity", "FullChargeCapacity", "Status"]
+  end
+
+  it "should request All diagnostics by default" do
+    result = @drc.diagnostics()
+    result.should be_a Hash
+    result.should have_key "WiFi"
+    result.should have_key "GasGauge"
+    result["WiFi"].keys.sort.should == ["Active", "Status"]
+    result["GasGauge"].keys.sort.should == ["CycleCount", "DesignCapacity", "FullChargeCapacity", "Status"]
+  end
+
+  it "should request WiFi diagnostics" do
+    result = @drc.diagnostics("WiFi")
+    result.should be_a Hash
+    result.keys.should == ["WiFi"]
+    result["WiFi"].keys.sort.should == ["Active", "Status"]
+  end
+
+  it "should request GasGauge diagnostics" do
+    result = @drc.diagnostics("GasGauge")
+    result.should be_a Hash
+    result.keys.should == ["GasGauge"]
+    result["GasGauge"].keys.sort.should == ["CycleCount", "DesignCapacity", "FullChargeCapacity", "Status"]
+  end
+
+  it "should raise an error for invalid diagnostic types " do
+    lambda{ @drc.diagnostics("SomeBogusType") }.should raise_error(Idevice::DiagnosticsRelayError)
+  end
+
+  it "should query mobilegestalt" do
+    result = @drc.mobilegestalt("UniqueDeviceID")
+    result.should be_a Hash
+    result.keys.should == ["MobileGestalt"]
+    result["MobileGestalt"].keys.sort.should == ["Status", "UniqueDeviceID"]
+    result["MobileGestalt"]["Status"].should == "Success"
+    result["MobileGestalt"]["UniqueDeviceID"].should =~ /^[a-f0-9]{40}$/i
+  end
+
+  it "should query ioregistry entries"
+
+  it "should query the Root ioregistry plane" do
+    result = @drc.ioregistry_plane("Root")
+    result.should be_a Hash
+    result.keys.should == ["IORegistry"]
+    result["IORegistry"].should be_a Hash
+    result["IORegistry"]["name"].should == "Root"
+    result["IORegistry"]["children"].should be_empty
+  end
+
+  it "should query the IOPower ioregistry plane" do
+    result = @drc.ioregistry_plane("IOPower")
+    result.should be_a Hash
+    result.keys.should == ["IORegistry"]
+    result["IORegistry"].should be_a Hash
+    result["IORegistry"]["name"].should == "Root"
+    result["IORegistry"]["children"].should_not be_empty
+  end
+
+  it "should say goodbye to disconnect from the service" do
+    @drc.goodbye.should be_true
+    lambda{ @drc.diagnostics }.should raise_error(Idevice::DiagnosticsRelayError)
+  end
+
+  it "should put a device to sleep" do
+    pending "don't actually put the device to sleep"
+    @drc.sleep
+  end
+
+  it "should restart a device" do
+    pending "don't actually reboot the device"
+    @drc.restart(0) #(with optional flags arg)
+  end
+
+  it "should shutdown a device" do
+    pending "don't actually shutdown the device"
+    @drc.shutdown(0) #(with optional flags arg)
+  end
+
+end

data/spec/file_relay_devicespec.rb

@@ -0,0 +1,45 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require 'spec_helper'
+
+describe Idevice::FileRelayClient do
+  before :each do
+    @frc = Idevice::FileRelayClient.attach(idevice:shared_idevice)
+  end
+
+  it "should attach" do
+    @frc.should be_a Idevice::FileRelayClient
+  end
+
+  it "should return an error when requesting invalid sources" do
+    lambda{ @frc.request_sources("this source is lies") }.should raise_error(Idevice::FileRelayError)
+  end
+
+  it "should request and receive CrashReporter logs" do
+    crashdata = @frc.request_sources("CrashReporter")
+    crashdata.should be_a String
+
+    # the returned data is actually a gzip-compressed cpio
+    shell_pipe(crashdata[0..256], "file -").should =~ /gzip compressed data, from Unix\n$/
+    shell_pipe(crashdata, "cpio -t").should =~ /^\.\/var\/mobile\/Library/
+  end
+end
+

data/spec/heartbeat_devicespec.rb

@@ -0,0 +1,39 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice::HeartbeatClient do
+  before :all do
+    @hb = Idevice::HeartbeatClient.attach(idevice:shared_idevice)
+  end
+
+  it "should attach" do
+    @hb.should be_a Idevice::HeartbeatClient
+  end
+
+  it "should send and receive a heartbeat" do
+    pending "Heartbeat is not working on my test device"
+    marco = @hb.receive_plist
+    marco.should be_a Hash
+    @hb.send_plist("Command" => "Polo").should be_true
+  end
+end
+

data/spec/idevice_devicespec.rb

@@ -0,0 +1,93 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice do
+  it "should list attached devices" do
+    devlist = Idevice.device_list
+    devlist.count.should > 0
+    devlist.each do |dev|
+      dev.should =~ /^[a-f0-9]{40}$/i
+    end
+  end
+end
+
+describe Idevice::Idevice do
+
+  context "with an attached device" do
+    before :all do
+      @idevice = Idevice::Idevice.attach()
+    end
+
+    it "should attach" do
+      @idevice.should be_a Idevice::Idevice
+    end
+
+    it "should have a udid" do
+      @idevice.udid.should_not be_nil
+      @idevice.udid.should =~ /^[a-f0-9]{40}$/i
+    end
+
+    it "should have a handle" do
+      @idevice.handle.should_not be_nil
+      @idevice.handle.should be_a Numeric
+    end
+
+    it "should fail to connect to the telnet port" do
+      lambda{ @idevice.connect(23).should be_false }.should raise_error
+    end
+
+    context "connecting to lockdown" do
+      it "should connect to the lockdownd port" do
+        begin
+          connection = @idevice.connect(62078)
+          connection.should be_a Idevice::IdeviceConnection
+          connection.should be_connected
+          connection.should_not be_disconnected
+        ensure
+          connection.disconnect if connection
+        end
+      end
+
+      it "should query lockdownd" do
+        begin
+          connection = @idevice.connect(62078)
+          connection.should be_a Idevice::IdeviceConnection
+          connection.should be_connected
+          connection.should_not be_disconnected
+
+          connection.send_data("\000\000\001\032<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n\t<key>Label</key>\n\t<string>idevspecs</string>\n\t<key>Request</key>\n\t<string>QueryType</string>\n</dict>\n</plist>\n")
+          blen = connection.receive_data(4)
+          blen.size.should == 4
+          len = blen.unpack("N").first
+          dat = connection.receive_data(len)
+          dat.size.should == len
+          dat.should =~ /^<\?xml /
+
+        ensure
+          connection.disconnect if connection
+        end
+      end
+    end
+  end
+
+end
+

data/spec/idevice_spec.rb

@@ -0,0 +1,29 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice do
+  it "should have a version" do
+    Idevice::VERSION.should be_a String
+    Idevice::VERSION.should =~ /^(\d+\.)+\d+$/
+  end
+end
+

data/spec/image_mounter_devicespec.rb

@@ -0,0 +1,65 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice::ImageMounterClient do
+  before :each do
+    @imgmounter = Idevice::ImageMounterClient.attach(idevice:shared_idevice)
+  end
+
+  after :each do
+    @imgmounter.hangup rescue nil
+  end
+
+  it "should attach" do
+    @imgmounter.should be_a Idevice::ImageMounterClient
+  end
+
+  it "should look up whether the Developer image is mounted" do
+    res=@imgmounter.lookup_image("Developer")
+    res["Status"].should == "Complete"
+    res.should have_key "ImagePresent"
+  end
+
+  it "should look up whether the Developer image is mounted (by default)" do
+    res=@imgmounter.lookup_image
+    res["Status"].should == "Complete"
+    res.should have_key "ImagePresent"
+  end
+
+  it "should look up whether the Debug image is mounted" do
+    res=@imgmounter.lookup_image("Debug")
+    res["Status"].should == "Complete"
+    res.should have_key "ImagePresent"
+  end
+
+  it "should look up whether an arbitrary image is mounted" do
+    @imgmounter.lookup_image("SomebogusImageName").should == {"ImagePresent"=>false, "Status"=>"Complete"}
+  end
+
+  it "should hangup" do
+    @imgmounter.hangup.should be_true
+    lambda{ @imgmounter.lookup_image }.should raise_error(Idevice::ImageMounterError)
+  end
+
+  it "should mount an image"
+end
+

data/spec/installation_proxy_devicespec.rb

@@ -0,0 +1,54 @@
+#
+# Copyright (c) 2013 Eric Monti - Bluebox Security
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative 'spec_helper'
+
+describe Idevice::InstProxyClient do
+  before :each do
+    @instproxy = Idevice::InstProxyClient.attach(idevice:shared_idevice)
+  end
+
+  it "should attach" do
+    @instproxy.should be_a Idevice::InstProxyClient
+  end
+
+  it "should browse installed apps" do
+    browsedata = @instproxy.browse()
+    browsedata.should be_a Array
+    browsedata.map{|x| x.class }.uniq.should == [Hash]
+    browsedata.map{|x| x["ApplicationType"]}.should include "System"
+  end
+
+  it "should install an application"
+
+  it "should upgrade an application"
+
+  it "should uninstall an application"
+
+  it "should lookup archives"
+
+  it "should archive an application"
+
+  it "should restore an archived application"
+
+  it "should remove an archive"
+
+end
+