NetCopying

Sometimes you won't have a USB stick handy to copy a UQM mod's source over to uqm-crossbuilder, or to get your newly build UQM .exe off. Perhaps you're using a VM and can't easily mount a USB stick. Fortunately, you can still copy your UQM executable over the network, to another computer or to the machine hosting your VM. The following assumes you are using a home network which uses DHCP to automatically assign an IP address to your computers. Chances are that if you have a modern wireless router or broadband modem of any kind this will all Just Work.

Setting up VirtualBox for net copying

1. Start up the VirtualBox VM manager.
2. Go to the settings for your uqm-crossbuilder vm:

3. Under the Network section, change Connection Method to 'Bridged adapter':

Finding out what uqm-crossbuilder's IP address is

On some networks you will be able to use the uqm-crossbuiler machine's host name, currently 'uqm-crossbuilder' by default, to connect to it. This will not always work, however, so you may need to use the machine's plain IP address. You can find this out by running sudo ifconfig on the uqm-crossbuilder machine, which should print out something like the following:

eth0      Link encap:Ethernet  HWaddr 08:00:27:09:05:4c  
          inet addr:192.168.1.36  Bcast:192.168.1.255  Mask:255.255.255.0
          inet6 addr: fe80::a00:27ff:fe09:54c/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:1114 errors:0 dropped:0 overruns:0 frame:0
          TX packets:142 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:125328 (122.3 KiB)  TX bytes:15380 (15.0 KiB)
	
lo        Link encap:Local Loopback  
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:16436  Metric:1
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:0 
          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)

You want the "inet addr" of the network interface 'eth0'. In this case our IP address is 192.168.1.36.

Using SFTP

Windows

1. Download and install WinSCP: http://winscp.net/eng/index.php
2. When you start WinSCP, you will be presented with a screen like the following:

3. You now must fill out a few boxes. You will need the following options set:

    File protocol: SFTP
    User: user
    Password: live
    Host: [uqm-crossbuilder hostname or IP]
   

4. If all goes well you should now have a window that looks like this. You can now navigate the filesystems and drag'n'drop any files you need:

Linux

Commandline way

1. Make sure you have the SFTP client installed on the machine you want to transfer the Windows executable to. Most distros include it out of the box. If yours doesn't, please consult its documentation on SSH/SFTP and get a SFTP client set up.

2. On the machine you want to transfer to, bring up a command prompt and connect to uqm-crossbuilder. You should use a command something like this:

    $ sftp user@[uqm-crossbuilder hostname or IP]
   

3. You will now be prompted for a password. This is 'live' unless you changed it.

4. You can now use FTP commands to get the file you want. Type 'help' for more information.

GUI way

KDE, GNOME, and Xfce all provide sftp functionality in their file managers. For example, in KDE's Konqueror, you need to go to a URL that looks like this:

sftp://user@[uqm-crossbuilder hostname or IP]/