idevice 1.1.5.0

data/spec/lockdown_devicespec.rb

@@ -0,0 +1,106 @@
+#
+# 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::LockdownClient do
+  it "should attach without arguments" do
+    client = Idevice::LockdownClient.attach
+    client.should be_a Idevice::LockdownClient
+    client.device_udid.should == client.get_value(nil, "UniqueDeviceID")
+  end
+
+  it "should attach with an instantiated idevice" do
+    client = Idevice::LockdownClient.attach(idevice: Idevice::Idevice.attach)
+    client.should be_a Idevice::LockdownClient
+    client.device_udid.should == client.get_value(nil, "UniqueDeviceID")
+  end
+
+  context "an attached client" do
+    before :each do
+      @lockdown = Idevice::LockdownClient.attach(idevice: shared_idevice)
+    end
+
+    after :each do
+      @lockdown.goodbye
+    end
+
+    it "should attach" do
+      @lockdown.should be_a Idevice::LockdownClient
+    end
+
+    it "should list sync data classes" do
+      result = @lockdown.sync_data_classes
+      result.should be_a Array
+      result.count.should > 1
+    end
+
+    it "should query type" do
+      @lockdown.query_type.should == "com.apple.mobile.lockdown"
+    end
+
+    it "should have a device_udid" do
+      result = @lockdown.device_udid
+      result.should be_a String
+      result.should =~ /^[a-f0-9]{40}$/i
+      result.should == @lockdown.get_value(nil, "UniqueDeviceID")
+    end
+
+    it "should have a device_name" do
+      result = @lockdown.device_name
+      result.should be_a String
+      result.should == @lockdown.get_value(nil, "DeviceName")
+    end
+
+    it "should get a value for nil:UniqueDeviceID" do
+      result = @lockdown.get_value(nil, "UniqueDeviceID")
+      result.should be_a String
+      result.should =~ /^[a-f0-9]{40}$/i
+      result.should == @lockdown.device_udid
+    end
+
+    it "should not get a value for nil:BogusKey" do
+      result = @lockdown.get_value(nil, "BogusKey")
+      result.should be_nil
+    end
+
+    it "should get an empty hash for BogusDomain" do
+      result = @lockdown.get_value("BogusDomain", nil)
+      result.should == {}
+    end
+
+    it "should not get a value for BogusDomain:UniqueDeviceID" do
+      result = @lockdown.get_value("BogusDomain", "UniqueDeviceID")
+      result.should be_nil
+    end
+
+    it "should start an 'afc' lockdown service" do
+      ldsvc = @lockdown.start_service("com.apple.afc")
+      ldsvc.should_not be_nil
+      ldsvc[:port].should > 1024
+      [0,1].include?(ldsvc[:ssl_enabled]).should be_true
+    end
+
+    it "should raise an error starting a nonexistent lockdown service" do
+      lambda{ @lockdown.start_service("nonexistent.service.garbage") }.should raise_error Idevice::IdeviceLibError
+    end
+
+  end
+end

data/spec/misagent_devicespec.rb

@@ -0,0 +1,43 @@
+#
+# 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::MisAgentClient do
+  before :each do
+    @mis = Idevice::MisAgentClient.attach(idevice:shared_idevice)
+  end
+
+  it "should attach" do
+    @mis.should be_a Idevice::MisAgentClient
+  end
+
+  it "should list installed profiles" do
+    profiles = @mis.profiles
+    profiles.should be_a Array
+    profiles.each do |profile|
+      profile.should be_a StringIO
+    end
+  end
+
+  it "should install a profile"
+
+  it "should remove an installed profile"
+end

data/spec/mobilebackup2_devicespec.rb

@@ -0,0 +1,58 @@
+#
+# 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::MobileBackup2Client do
+  before :each do
+    @mb2 = Idevice::MobileBackup2Client.attach(idevice:shared_idevice)
+  end
+
+  after :each do
+  end
+
+  it "should attach" do
+    @mb2.should be_a Idevice::MobileBackup2Client
+  end
+
+  it "should exchange versions" do
+    versions = [1.0, 1.1, 1.2, 1.3, 2.0, 2.1, 2.2, 2.3]
+    versions.should include(@mb2.version_exchange(versions))
+  end
+
+  it "should raise an exception attempting to negotiate an invalid version" do
+    lambda{ @mb2.version_exchange([999.99]) }.should raise_error Idevice::MobileBackup2Error
+  end
+
+  it "should send a message"
+
+  it "should receive a message"
+
+  it "should send a raw message"
+
+  it "should receive a raw message"
+
+  it "should send a request"
+
+  it "should send a status response"
+
+end
+
+

data/spec/mobilebackup_devicespec.rb

@@ -0,0 +1,41 @@
+#
+# 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'
+
+if ENV["TEST_MOBILEBACKUP1"]
+
+  describe Idevice::MobileBackupClient do
+    before :each do
+      @mb = Idevice::MobileBackupClient.attach(idevice:shared_idevice)
+    end
+
+    after :each do
+    end
+
+    it "should attach" do
+      @mb.should be_a Idevice::MobileBackupClient
+    end
+
+    it "needs functional tests" do
+      pending "writing more specs for MobileBackupClient"
+    end
+  end
+end

data/spec/mobilesync_devicespec.rb

@@ -0,0 +1,62 @@
+#
+# 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::MobileSyncClient do
+  before :each do
+    @sync = Idevice::MobileSyncClient.attach(idevice:shared_idevice)
+  end
+
+  after :each do
+  end
+
+  it "should attach" do
+    @sync.should be_a Idevice::MobileSyncClient
+  end
+
+  it "should send a plist"
+
+  it "should receive a plist"
+
+  it "should start synchronizing a data class with the device"
+
+  it "should cancel"
+
+  it "should finish"
+
+  it "should get all records from a device"
+
+  it "should get changes from a device"
+
+  it "should clear all records on a device"
+
+  it "should receive changes from a device"
+
+  it "should acknowledge changes from a device"
+
+  it "should signal it is ready to send changes from the computer"
+
+  it "should send changes"
+
+  it "should remap identifiers"
+
+
+end

data/spec/notification_proxy_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_relative 'spec_helper'
+
+describe Idevice::NotificationProxyClient do
+  before :each do
+    @sync = Idevice::NPClient.attach(idevice:shared_idevice)
+  end
+
+  after :each do
+  end
+
+  it "should attach" do
+    @sync.should be_a Idevice::NotificationProxyClient
+  end
+
+  it "should post a notification"
+
+  it "should observe a notification"
+
+  it "should observe notifications (in the plural)"
+
+  it "should set a notification callback"
+
+  it "should receive notifications via a callback"
+
+end

data/spec/plist_spec.rb

@@ -0,0 +1,176 @@
+#
+# 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 Plist do
+  it "should parse a xml plist to a hash" do
+    hash = Plist.parse_xml(sample_file("plist.xml").read)
+    hash.should be_a Hash
+    hash.should == {"Label" => "idevspecs", "Request" => "QueryType"}
+  end
+
+  it "should parse a binary plist to a hash" do
+    hash = Plist.parse_binary(sample_file("plist.bin").read)
+    hash.should be_a Hash
+    hash.should == {"Label" => "idevspecs", "Request" => "QueryType"}
+  end
+
+  it "should parse a xml plist to plist pointer" do
+    ptr = Plist.xml_to_pointer(sample_file("plist.xml").read)
+    ptr.should be_a FFI::Pointer
+  end
+
+  it "should parse a binary plist to plist pointer" do
+    ptr = Plist.binary_to_pointer(sample_file("plist.bin").read)
+    ptr.should be_a FFI::Pointer
+  end
+
+  it "should convert a plist pointer from and to a hash" do
+    ptr = Idevice::Plist_t.new_dict
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    hash = ptr.to_ruby
+    hash.should == {}
+  end
+
+  it "should create a plist pointer from and to an array" do
+    ptr = Idevice::Plist_t.new_array
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    ary = ptr.to_ruby
+    ary.should == []
+  end
+
+  it "should convert a plist pointer from and to a string" do
+    ptr = Idevice::Plist_t.new_string("foobadoo")
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    str = ptr.to_ruby
+    str.should == "foobadoo"
+  end
+
+  it "should convert a plist pointer from and to a string using from_ruby" do
+    ptr = Idevice::Plist_t.from_ruby("foobadoo")
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    str = ptr.to_ruby
+    str.should == "foobadoo"
+  end
+
+  it "should convert a plist pointer from and to bool" do
+    ptr = Idevice::Plist_t.new_bool(false)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    bool = ptr.to_ruby
+    bool.should == false
+
+    ptr = Idevice::Plist_t.new_bool(true)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    bool = ptr.to_ruby
+    bool.should == true
+  end
+
+  it "should convert a plist pointer from and to bool using from_ruby" do
+    ptr = Idevice::Plist_t.from_ruby(false)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    bool = ptr.to_ruby
+    bool.should == false
+
+    ptr = Idevice::Plist_t.from_ruby(true)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    bool = ptr.to_ruby
+    bool.should == true
+  end
+
+
+  it "should convert a plist pointer from and to an unsigned int" do
+    ptr = Idevice::Plist_t.new_uint(0xdeadbeef)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 0xdeadbeef
+  end
+
+  it "should convert a negative number to an unsigned 64-bit int" do
+    ptr = Idevice::Plist_t.from_ruby(-2)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 0xfffffffffffffffe
+  end
+
+  it "should convert a plist pointer from and to an unsigned int using from_ruby" do
+    ptr = Idevice::Plist_t.from_ruby(0xdeadbeef)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 0xdeadbeef
+  end
+
+  it "should convert a plist pointer from and to a real number" do
+    ptr = Idevice::Plist_t.new_real(1234.567)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 1234.567
+  end
+
+  it "should convert a plist pointer from and to a real number from an integer" do
+    ptr = Idevice::Plist_t.new_real(1234)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 1234.0
+  end
+
+
+  it "should convert a plist pointer from and to a real number using from_ruby" do
+    ptr = Idevice::Plist_t.from_ruby(1234.567)
+    ptr.should be_a FFI::Pointer
+    ptr.should_not be_null
+    val = ptr.to_ruby
+    val.should == 1234.567
+  end
+
+  it "should convert a plist pointer from and to raw data" do
+    ptr = Idevice::Plist_t.new_data("some data here")
+    ptr.should be_a FFI::Pointer
+    val = ptr.to_ruby
+    val.should be_a StringIO
+    val.string.should == "some data here"
+  end
+
+  it "should convert a plist pointer from and to raw data using from_ruby" do
+    ptr = Idevice::Plist_t.from_ruby(StringIO.new("some data here"))
+    ptr.should be_a FFI::Pointer
+    val = ptr.to_ruby
+    val.should be_a StringIO
+    val.string.should == "some data here"
+  end
+
+  it "should convert a plist date pointer from and to a ruby"
+
+  it "should convert a plist date pointer from and to a ruby using from_ruby"
+
+end