Subsections

7 File sharing

Maemo PC Connectivity provides some tools to easily share files between maemo device and host PC. That is, you can can mount the file system of maemo device on host PC over a network and interact with it as though it is mounted locally. Also, it is possible to mount a file system of host PC on maemo device. For that, you have to install maemo-pc-connectivity meta package on maemo device and host-pc-connectivity package on host PC (Linux, Windows and Mac OS). Next, it will be described how to use the file sharing tools available on Maemo PC Connectivity. To simplify, it is assumed that you already have a Usb network between maemo device and host PC.

If follows the recommended tools to mount the file system of a maemo device on host PC:

	Linux	Windows	Mac OS
SSHFS	X		X
NFS	X		X
SAMBA	X	X	X

To mount the file system of a host PC on maemo device, it is recommended the following tools:

	Linux	Windows	Mac OS
SSHFS	X		X
NFS	X	X
SAMBA	X	X	X

Note: on host PC, you should type the commands bellow at terminal on Linux and Mac OS and at Cygwin shell on Windows.

7.1 SSHFS

Note: SSHFS does not work on Windows host PC.

SSHFS (SSH File System) is a file system client based on the SSH protocol. It allows to mount locally a remote file system via SSH. With SSHFS, you can remotely access maemo device file system from host PC and vice-versa. If you want to mount maemo device file system on your host PC, you can execute the following commands:

$ mkdir ~/maemo
$ sshfs user@192.168.2.15:/ ~/maemo -o rw,nonempty
  user@192.168.2.15's password: <type user password here>

If you did not set the SSH password for ``user'' yet, you can use the ``root'' account. You should setup the password for ``user'' account following the next steps:

$ ssh root@192.168.2.15
  root@192.168.2.15's password: <type root password here>
  Nokia-810:~# passwd user
  Changing password for user
  Enter the new password (minimum of 5, maximum of 8 characters)
  Please use a combination of upper and lower case letters and numbers.
  New password: <type new user password here>
  Re-enter new password: <retype user password>
  Password changed

If you want to mount host PC file system on your maemo device, you can execute the following commands:

$ mkdir ~/hostpc
$ sshfs <host_pc_user>@<host_pc_ip>:/ ~/hostpc -o rw,nonempty
  <host_pc_user>@<host_pc_ip>'s password: <type user password here>

As SSFH is a user file system, you can not use mount directly. For example, you should execute the following command to unmount maemo device file system on host PC:

$ fusermount -u ~/maemo

You can avoid SSH asking password every time by exchanging the SSH keys as described in section 6.1.

7.2 NFS

With NFS (Network File System), you can share folders of your maemo device or host PC over network. Next, it will be described how to share a folder of maemo device by using NFS.

7.2.1 Configuring Maemo Device

You should follow the next steps to share a folder of your maemo device through NFS by using Maemo PC Connectivity:

Run Settings - Control Panel - Connectivity - PC Connectivity Manager
Click on ``Advanced'' button
Go to ``Tool Manager'' tab
Select ``NFS'' option. After that, change the options according to your needs
Click on ``Exported Paths'' button. Then, add the folders to be shared
Click on ``Allowed IPs'' button. Then, add the host PCs (IP addresses) that can access the shared folders
Click on ``Apply'' button

If you want, you can share a folder of your maemo device manually. The following steps describe how to share a folder (/home/user/MyDocs) of a maemo device over network by giving access to host PC IP address (192.168.2.14):

Connect to maemo device via SSH
Edit the file /etc/exports. For that, you should add the folder you want to share and set the permissions of your host PC (IP address):
```
 /home/user/MyDocs 192.168.2.14(rw,no_root_squash,async,no_subtree_check)
```
After, restart the NFS server:
```
 /etc/init.d/unfs3 restart
```

7.2.2 Configuring Host PC

It follows the steps to share a folder of a host PC over network by giving access to maemo device IP address (192.168.2.15):

Edit the file /etc/exports. For that, you should add the folder you want to share and set the permissions of your host PC (IP address):
```
 /home/<host_pc_user> 192.168.2.15(rw,no_root_squash,async,no_subtree_check)
```
After, restart the NFS server:
```
 sudo /etc/init.d/unfs3 restart
```

7.2.3 Accessing Maemo Device

Once you configured NFS on your maemo device, you can access the shared folders from your host PC over network. Next, it is described how to access the shared folders on host PC:

On host PC, run showmount command to check if NFS sharing is working:

$ showmount -e <device_ip> 
  Export list for 192.168.2.15:
  /home/user/MyDocs 192.168.2.14

Now, mount the maemo device folder on host PC:

$ mkdir /tmp/MyDocs
$ sudo mount -t nfs <device_ip>:/home/user/MyDocs /tmp/MyDocs

You can unmount the folder with the following command:
```
$ sudo umount /tmp/MyDocs
```

7.2.4 Accessing Host PC

Once you configured NFS on your host PC, you can access the shared folders from your maemo device over network. Next, it is described how to access the shared folders on maemo device:

Mount the host PC folder on maemo device:

mkdir ~/hostpc
mount -t nfs <host_pc_ip>:/home/<host_pc_user> ~/hostpc

You can unmount the folder with the following command:
```
sudo umount ~/hostpc
```

7.3 SAMBA

Samba (Server Message Block) allows file sharing between computers over the network. With Samba, you can remotely access maemo device file system from host PC and vice-versa. Once you shared your file system through Samba, it will be available every time you reconnect to the network.

Note: for while Samba is not working on Fremantle

7.3.1 Maemo

In order to share a folder of your maemo device, you should follow the next steps:

Run Settings - Control Panel - Connectivity - PC Connectivity Manager
Click on ``Advanced'' button
Go to ``Tool Manager'' tab
Select ``Samba'' option. After that, change the options according to your needs (Workgroup, User and Password)
Click on ``Exported Paths'' button. Then, add the folders to be shared
Click on ``Apply'' button

Also, you can access your host PC shared folder from maemo device:

Open ``Utilities - File Manager'' application
Click on ``Shared folders'' option
Select the desired shared folder

7.3.2 Linux - Ubuntu

It follows the steps to share a folder of your Linux host PC:

Open the File Manager (``Nautilus'')
Right click the folder you want to share, and select ``Sharing options''
Type the ``Share name'' and check ``Guest access'' option
Click on ``Create share'' button. If samba is not installed, Ubuntu will request the installation at this point. Otherwise, you can install samba manually:
```
sudo apt-get install samba
```

To access a folder shared on your maemo device:

Open the File Manager (``Nautilus'') and type:

smb://<maemo_device_ip>
Press ``Enter''

7.3.3 Windows

It follows the steps to share a folder of your Windows host PC:

Open the File Manager (``Windows Explorer'')
Right click the appropriate folder, and then click Sharing
In the folder's properties, click ``Share this folder''. Use the default name for the share.
Click ``Permissions'' button to change permissions according to your needs

To access a folder shared on your maemo device:

Click ``Start'', and then click ``Run''
Type your maemo device address as follows:
```
\\<maemo_device_ip>
```
The shared folders of your maemo device will be shown

7.3.4 Mac OS

It follows the steps to share a folder of your Mac OS host PC:

Go to ``System Preferences'' and click on ``Sharing'' icon
Select ``File Sharing'' service
Add a folder you want to share, and then set the permissions to it

To access a folder shared on your maemo device:

Go to the File Manager application (``Finder'')
With the ``Finder'' open, click on ``Go'' menu and select ``Connect to Server'' option
Type your maemo device address as follows:

smb://<maemo_device_ip>
Click on ``Connect'' button

Walter 2009-12-21