Adding Network instructions to Wiki

[aellul27]

How can I connect my device using the technique described here but on CLI?
libimobiledevice/libimobiledevice#1348

[MrMan314]

I was able to get network connectivity by following those instructions from the thread, all running from the companion VM. I used NetworkManager and had to install dnsmasq (it did not install with NetworkManager) and also installed usbmuxd-git instead of usbmuxd (although I think it might have just been because I was missing dnsmasq).

[natanrce]

I was able to get network connectivity by following those instructions from the thread, all running from the companion VM. I used NetworkManager and had to install dnsmasq (it did not install with NetworkManager) and also installed usbmuxd-git instead of usbmuxd (although I think it might have just been because I was missing dnsmasq).

@MrMan314 How did you configure the NetworkManager?

[MrMan314]

I used nmtui to and set the interface IPv4 to be Shared

App Store does not seem to work unfortunately, I believe you will have to jailbreak to install IPA files

[natanrce]

I used nmtui to and set the interface IPv4 to be Shared

App Store does not seem to work unfortunately, I believe you will have to jailbreak to install IPA files

Did you make any additional configuration on iOS? Are you able to access Safari?

I connected my eth1 interface to the internet using the NetworkManager, but it doesn't seem to have any effect on iOS. Do I need to pass any parameter during boot?

[MrMan314]

I did not do anything on iOS. Make sure that cdc_ncm is loaded rather than ipheth (it should show in nmcli), I think that this is done through setting the usbmuxd config as said in the linked issue:

@hyphenlee Thanks! I can confirm that the steps you described there works with Ubuntu 23.10:

• Install usbmuxd via apt so that all dependencies are in place,

• Rebuild and install the following repositories with ./autogen.sh, make and sudo make install (make sure to follow Pre-requisites sections of each repo's readme first):

  • libplist
  • libimobiledevice-glue
  • usbmuxd

• Run usbmuxd with USBMUXD_DEFAULT_DEVICE_MODE=3 by adding the following to systemd service file with sudo systemctl edit --full usbmuxd.service:

  [Service]
     Environment=USBMUXD_DEFAULT_DEVICE_MODE=3
  

• sudo systemctl restart usbmuxd.service

• Plug the iPhone.

• In network settings UI, in my case, it showed up as Apple Ethernet and it didn't connect automatically. Create a new profile with Shared to other computers checked in both IPv4 and IPv6 tabs.

Safari seems to connect, but no webpages render, likely due to the lack of graphics acceleration and the filesystem patches done to allow iOS to boot.

[natanrce]

The cdc_ncm driver is already loaded but the iOS device is still not getting internet access

[MrMan314]

Check journalctl -u NetworkManager for any logs that might have some information about the DHCP

My logs show:

Jun 22 04:14:47 archlinux dnsmasq[409]: started, version 2.91 cachesize 150
Jun 22 04:14:47 archlinux dnsmasq[409]: compile time options: IPv6 GNU-getopt DBus no-UBus i18n IDN2 DHCP DHCPv6 no-Lua TFTP conntrack ipset nftset auth DNSSEC loop-detect inotify dumpfile
Jun 22 04:14:47 archlinux dnsmasq[409]: chown of PID file /run/nm-dnsmasq-enp0s3u1c5i2.pid failed: please add capability CAP_CHOWN
Jun 22 04:14:47 archlinux dnsmasq-dhcp[409]: DHCP, IP range 10.42.0.10 -- 10.42.0.254, lease time 1h
Jun 22 04:14:47 archlinux dnsmasq[409]: reading /etc/resolv.conf
Jun 22 04:14:47 archlinux dnsmasq[409]: using nameserver 10.0.2.3#53
Jun 22 04:14:47 archlinux dnsmasq[409]: cleared cache
Jun 22 04:14:48 archlinux NetworkManager[342]: <info>  [1750565688.0005] policy: set 'Wired connection 1' (enp0s2) as default for IPv6 routing and DNS
Jun 22 04:14:49 archlinux dnsmasq-dhcp[409]: DHCPDISCOVER(enp0s3u1c5i2) ac:de:48:33:44:55
Jun 22 04:14:49 archlinux dnsmasq-dhcp[409]: DHCPOFFER(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 22 04:14:50 archlinux dnsmasq-dhcp[409]: DHCPREQUEST(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 22 04:14:50 archlinux dnsmasq-dhcp[409]: DHCPACK(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55 iPhone

[sledgeh4w]

Check journalctl -u NetworkManager for any logs that might have some information about the DHCP

My logs show:

Jun 22 04:14:47 archlinux dnsmasq[409]: started, version 2.91 cachesize 150
Jun 22 04:14:47 archlinux dnsmasq[409]: compile time options: IPv6 GNU-getopt DBus no-UBus i18n IDN2 DHCP DHCPv6 no-Lua TFTP conntrack ipset nftset auth DNSSEC loop-detect inotify dumpfile
Jun 22 04:14:47 archlinux dnsmasq[409]: chown of PID file /run/nm-dnsmasq-enp0s3u1c5i2.pid failed: please add capability CAP_CHOWN
Jun 22 04:14:47 archlinux dnsmasq-dhcp[409]: DHCP, IP range 10.42.0.10 -- 10.42.0.254, lease time 1h
Jun 22 04:14:47 archlinux dnsmasq[409]: reading /etc/resolv.conf
Jun 22 04:14:47 archlinux dnsmasq[409]: using nameserver 10.0.2.3#53
Jun 22 04:14:47 archlinux dnsmasq[409]: cleared cache
Jun 22 04:14:48 archlinux NetworkManager[342]: <info>  [1750565688.0005] policy: set 'Wired connection 1' (enp0s2) as default for IPv6 routing and DNS
Jun 22 04:14:49 archlinux dnsmasq-dhcp[409]: DHCPDISCOVER(enp0s3u1c5i2) ac:de:48:33:44:55
Jun 22 04:14:49 archlinux dnsmasq-dhcp[409]: DHCPOFFER(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 22 04:14:50 archlinux dnsmasq-dhcp[409]: DHCPREQUEST(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 22 04:14:50 archlinux dnsmasq-dhcp[409]: DHCPACK(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55 iPhone

Does this connection require manual activation? This USB Ethernet connection always requires me to activate it manually. After I activated the connection, dnsmasq was started, but no DHCP request from the iPhone was received (I have tried to re-pair the iPhone).

Jun 23 20:56:02 archlinux NetworkManager[330]: <info>  [1750683362.6690] dnsmasq-manager: starting dnsmasq...
Jun 23 20:56:03 archlinux dnsmasq[459]: started, version 2.91 cachesize 150
Jun 23 20:56:03 archlinux dnsmasq[459]: compile time options: IPv6 GNU-getopt DBus no-UBus i18n IDN2 DHCP DHCPv6 no-Lua TFTP conntrack ipset nftset auth DNSSEC loop-detect inotify dumpfile
Jun 23 20:56:03 archlinux dnsmasq[459]: chown of PID file /run/nm-dnsmasq-ens4u1c5i2.pid failed: please add capability CAP_CHOWN
Jun 23 20:56:03 archlinux dnsmasq-dhcp[459]: DHCP, IP range 10.42.0.10 -- 10.42.0.254, lease time 1h
Jun 23 20:56:03 archlinux dnsmasq[459]: reading /etc/resolv.conf
Jun 23 20:56:03 archlinux dnsmasq[459]: using nameserver 10.0.2.3#53
Jun 23 20:56:03 archlinux dnsmasq[459]: cleared cache
Jun 23 20:56:04 archlinux NetworkManager[330]: <info>  [1750683364.4949] device (ens4u1c5i2): state change: ip-config -> ip-check (reason 'none', managed-type: 'full')
Jun 23 20:56:05 archlinux NetworkManager[330]: <info>  [1750683365.3852] device (ens4u1c5i2): state change: ip-check -> secondaries (reason 'none', managed-type: 'full')
Jun 23 20:56:05 archlinux NetworkManager[330]: <info>  [1750683365.3930] device (ens4u1c5i2): state change: secondaries -> activated (reason 'none', managed-type: 'full')
Jun 23 20:56:05 archlinux NetworkManager[330]: <info>  [1750683365.4184] device (ens4u1c5i2): Activation: successful, device activated.

nmcli connection show show, the Ethernet connection 1 is only set to Shared :

NAME                   UUID                                  TYPE      DEVICE     
Ethernet connection 1  2fb81d96-2354-4118-bd98-47450c472db7  ethernet  ens4u1c5i2 
Wired connection 1     ec88e0e3-393c-37da-a155-bc2cacaef406  ethernet  ens3       
lo                     18e2dca5-e07f-471b-95d4-ef1faa36066f  loopback  lo

ifconfig show:

ens3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.0.2.15  netmask 255.255.255.0  broadcast 10.0.2.255
        inet6 fe80::79cc:a84:94c1:105  prefixlen 64  scopeid 0x20<link>
        inet6 fec0::9e:c026:45e9:dd04  prefixlen 64  scopeid 0x40<site>
        ether 52:54:00:12:34:56  txqueuelen 1000  (Ethernet)
        RX packets 627  bytes 55193 (53.8 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 436  bytes 92583 (90.4 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

ens4u1c5i2: flags=4099<UP,BROADCAST,MULTICAST>  mtu 1500
        inet 10.42.0.1  netmask 255.255.255.0  broadcast 10.42.0.255
        inet6 fe80::3ea:fe15:7faa:6375  prefixlen 64  scopeid 0x20<link>
        ether ac:de:48:00:11:22  txqueuelen 1000  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 9 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

ip a show:

1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host noprefixroute 
       valid_lft forever preferred_lft forever
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
    link/ether 52:54:00:12:34:56 brd ff:ff:ff:ff:ff:ff
    altname enp0s3
    altname enx525400123456
    inet 10.0.2.15/24 brd 10.0.2.255 scope global dynamic noprefixroute ens3
       valid_lft 85800sec preferred_lft 85800sec
    inet6 fec0::9e:c026:45e9:dd04/64 scope site dynamic noprefixroute 
       valid_lft 86263sec preferred_lft 14263sec
    inet6 fe80::79cc:a84:94c1:105/64 scope link noprefixroute 
       valid_lft forever preferred_lft forever
3: ens4u1c5i2: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc fq_codel state DOWN group default qlen 1000
    link/ether ac:de:48:00:11:22 brd ff:ff:ff:ff:ff:ff
    altname enp0s4u1c5i2
    altname enxacde48001122
    inet 10.42.0.1/24 brd 10.42.0.255 scope global noprefixroute ens4u1c5i2
       valid_lft forever preferred_lft forever
    inet6 fe80::3ea:fe15:7faa:6375/64 scope link tentative noprefixroute 
       valid_lft forever preferred_lft forever

I can’t figure out what’s causing the issue. Are there any special parameters in your companion VM's startup command?

[MrMan314]

I noticed the flags for the iPhone interface displayed in ifconfig are different from what I have when the iPhone is up and running (4099 vs 4163). Doing a XOR operation shows that I have the flag IFF_RUNNING additionally set, as per the file /usr/include/net/if.h.

According to this stackoverflow answer, it means that the interface is up but not operational (IFF_UP = 0x1).

Here is the nmconnection file used for the iPhone in the companion:

[connection]
id=Wired connection 3
uuid=18638759-1314-3be4-9171-992a6cb55f36
type=ethernet
autoconnect-priority=-999
interface-name=enp0s3u1c5i2

[ethernet]

[ipv4]
method=shared

[ipv6]
addr-gen-mode=default
method=auto

[proxy]

[sledgeh4w]

I noticed the flags for the iPhone interface displayed in ifconfig are different from what I have when the iPhone is up and running (4099 vs 4163). Doing a XOR operation shows that I have the flag IFF_RUNNING additionally set, as per the file /usr/include/net/if.h.

According to this stackoverflow answer, it means that the interface is up but not operational (IFF_UP = 0x1).

You're right. I think the root cause is that the ethernet interface is not working properly. Could you share the output of ethtool ?

Settings for ens4u1c5i2:
        Supported ports: [  ]
        Supported link modes:   Not reported
        Supported pause frame use: No
        Supports auto-negotiation: No
        Supported FEC modes: Not reported
        Advertised link modes:  Not reported
        Advertised pause frame use: No
        Advertised auto-negotiation: No
        Advertised FEC modes: Not reported
        Speed: Unknown!
        Duplex: Half
        Auto-negotiation: off
        Port: Twisted Pair
        PHYAD: 0
        Transceiver: internal
        MDI-X: Unknown
        Current message level: 0x00000007 (7)
                               drv probe link
        Link detected: no

[lesszzen]

After executing the above steps, the iOS virtual machine seems to be connected to the Internet, but stops sending packets after the following error occurs

AppleT8027USBXDCI@6: AppleUSBXDCI::endpointIOTimerExpired: IO timeout (0xffffffe19db568e0) for endpoint 87, returning it001158.244470 AppleT8027USBXDCI@6: AppleUSBXDCI::endpointIOTimerExpired: IO timeout (0xffffffe19db568e0) for endpoint 87, returning it 

NetworkManager logs:

Jun 25 16:45:13 archlinux dnsmasq-dhcp[573]: DHCPDISCOVER(enp0s3u1c5i2) ac:de:48:33:44:55
Jun 25 16:45:13 archlinux dnsmasq-dhcp[573]: DHCPOFFER(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 25 16:45:13 archlinux dnsmasq-dhcp[573]: DHCPDISCOVER(enp0s3u1c5i2) ac:de:48:33:44:55
Jun 25 16:45:13 archlinux dnsmasq-dhcp[573]: DHCPOFFER(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 25 16:45:14 archlinux dnsmasq-dhcp[573]: DHCPREQUEST(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 25 16:45:14 archlinux dnsmasq-dhcp[573]: DHCPACK(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55 iPhone
Jun 25 16:47:21 archlinux NetworkManager[378]: <info>  [1750841241.1737] device (enp0s3u1c5i2): state change: activated -> unavailable (reason 'carrier-changed', managed-type: 'full')
Jun 25 16:47:21 archlinux dnsmasq[573]: exiting on receipt of SIGTERM
Jun 25 16:48:39 archlinux NetworkManager[378]: <info>  [1750841319.6822] device (enp0s3u1c5i2): state change: unavailable -> unmanaged (reason 'unmanaged-link-not-init', managed-type: 'removed')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.0065] manager: (eth0): new Ethernet device (/org/freedesktop/NetworkManager/Devices/4)
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.0191] device (eth0): interface index 4 renamed iface from 'eth0' to 'enp0s3u1c5i2'
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.0245] device (enp0s3u1c5i2): state change: unmanaged -> unavailable (reason 'managed', managed-type: 'external')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3740] device (enp0s3u1c5i2): carrier: link connected
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3742] device (enp0s3u1c5i2): state change: unavailable -> disconnected (reason 'carrier-changed', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3745] policy: auto-activating connection 'Ethernet connection 1' (3a9c7c45-6630-4c72-ad5c-9e1a752db46d)
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3748] device (enp0s3u1c5i2): Activation: starting connection 'Ethernet connection 1' (3a9c7c45-6630-4c72-ad5c-9e1a752db46d)
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3748] device (enp0s3u1c5i2): state change: disconnected -> prepare (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3749] device (enp0s3u1c5i2): state change: prepare -> config (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.3752] device (enp0s3u1c5i2): state change: config -> ip-config (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.5252] dnsmasq-manager: starting dnsmasq...
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.5270] device (enp0s3u1c5i2): state change: ip-config -> ip-check (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux dnsmasq[627]: started, version 2.91 cachesize 150
Jun 25 16:48:41 archlinux dnsmasq[627]: compile time options: IPv6 GNU-getopt DBus no-UBus i18n IDN2 DHCP DHCPv6 no-Lua TFTP conntrack ipset nftset auth DNSSEC loop-detect inotify dumpfile
Jun 25 16:48:41 archlinux dnsmasq[627]: chown of PID file /run/nm-dnsmasq-enp0s3u1c5i2.pid failed: please add capability CAP_CHOWN
Jun 25 16:48:41 archlinux dnsmasq-dhcp[627]: DHCP, IP range 10.42.0.10 -- 10.42.0.254, lease time 1h
Jun 25 16:48:41 archlinux dnsmasq[627]: reading /etc/resolv.conf
Jun 25 16:48:41 archlinux dnsmasq[627]: using nameserver 10.0.2.3#53
Jun 25 16:48:41 archlinux dnsmasq[627]: cleared cache
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.5557] device (enp0s3u1c5i2): state change: ip-check -> secondaries (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.5559] device (enp0s3u1c5i2): state change: secondaries -> activated (reason 'none', managed-type: 'full')
Jun 25 16:48:41 archlinux NetworkManager[378]: <info>  [1750841321.5561] device (enp0s3u1c5i2): Activation: successful, device activated.
Jun 25 16:48:43 archlinux NetworkManager[378]: <info>  [1750841323.0058] policy: ipv6-pd: no device to obtain a subnet to share on enp0s3u1c5i2 from
Jun 25 16:48:46 archlinux dnsmasq-dhcp[627]: DHCPREQUEST(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55
Jun 25 16:48:46 archlinux dnsmasq-dhcp[627]: DHCPACK(enp0s3u1c5i2) 10.42.0.214 ac:de:48:33:44:55 iPhone
Jun 25 16:54:32 archlinux NetworkManager[378]: <info>  [1750841672.6865] manager: NetworkManager state is now CONNECTED_SITEJun 25 16:54:33 archlinux NetworkManager[378]: <info>  [1750841673.2735] manager: NetworkManager state is now CONNECTED_GLOB

ifconfig output:

enp0s2: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.0.2.15  netmask 255.255.255.0  broadcast 10.0.2.255
        ether 52:54:00:12:34:56  txqueuelen 1000  (Ethernet)
        RX packets 45829  bytes 55454183 (52.8 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 26323  bytes 2026625 (1.9 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

enp0s3u1c5i2: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.42.0.1  netmask 255.255.255.0  broadcast 10.42.0.255
        inet6 fe80::d92e:a794:9a7:5222  prefixlen 64  scopeid 0x20<link>
        ether ac:de:48:00:11:22  txqueuelen 1000  (Ethernet)
        RX packets 10415  bytes 658265 (642.8 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 17026  bytes 21803639 (20.7 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0