Linux Certif

Toute la documentation sur la certification Linux LPI

p3nfsd

NAME

p3nfsd - Mount Epoc / SymbianOS filesystems

SYNOPSIS

p3nfsd <client-type> [ options ]

DESCRIPTION

p3nfsd makes the filesystems of most SymbianOS based PDAs and phones available to an attached Unix computer. p3nfs talks to the local UNIX machine via NFS, and uses its own protocol to talk with its client program on the PDA/phone. The connection can be established via a Serial cable, IrDA, Bluetooth or USB.

As first option you have to define the client type to connect. These options preconfigure p3nfs for the corresponding device, in most cases you won't need further options. To list the preconfigures options type p3nfsd <client-type> -h

PDA/Phone counterparts

P3nfsd needs a client program on the PDA/Phone. Depending on the PDA/Phone you have, you have different options, read the CLIENT-TYPE section for details. These programs can be found along with the detailed HOWTOs in the documentation directory, which is /usr/share/doc/p3nfs-5.19

CLIENT-TYPE

In most cases you only have to specify the client type, p3nfsd tries to set the correct parameters for this client. Type p3nfsd <client-type> -h to see the defaults for this client-type.

-series3

for Psion Series 3. See /usr/share/doc/p3nfs/Epoc16 for a more detailed HOWTO. As client you have to use nfsc3.opl

-series3a

for Psion Series 3a / Series 3c / Series 3mx / Sienna . See /usr/share/doc/p3nfs/Epoc16 for a more detailed HOWTO. As client you can either use nfsc3a.opl or nfsc.app which comes with a builtin VT100 emulator. Note: You cannot use the Infrared interface of the Series3c as it is not IrDA compliant.

-series5

for Psion Series 5 / Series 5mx / Ericsson MC218 . As client you can use nfsc5.opl or nfsapp, the latter one comes as an application with its own SIS file (nfsapp-2.5-epocR5.sis). nfsapp supports cable and IrDA for this architecture. For a HOWTO see /usr/share/doc/p3nfs/Epoc32_R5

-series60

for Series 60 Phones like the Nokia 3650, 7650 and Siemens SX1. The client is nfsapp (nfsapp-2.5-series60.sis), and it supports IrDA and Bluetooth in the Series60 version. The HOWTO is /usr/share/doc/p3nfs/Epoc32_R6 and /usr/share/doc/p3nfs/bluetooth.linux respectively.

-crystal

for the Nokia 92x0 Communicator. The client is nfsapp (nfsapp-2.5-crystal.sis), and it supports serial cable or IrDA. The detailed HOWTO is /usr/share/doc/p3nfs/Epoc32_R6

-UIQ

for UIQ Phones like the Sony-Ericsson P800. The client is nfsapp (nfsapp-2.5-UIQ.sis), and it supports IrDA, Bluetooth and the connection over the USB docking station. The HOWTOs are /usr/share/doc/p3nfs/Epoc32_R6, /usr/share/doc/p3nfs/bluetooth.linux and /usr/share/doc/p3nfs/usb.linux

OPTIONS

-conn <prog>

Start <prog> after the connection is established. E.g. to do automatic backups.

-dir <directory>

Use <directory> as mount point instead of the default /mnt/psion. The directory has to be empty.

-disconn <prog>

Start <prog> after the connection is finished.

-epoc32_filesystem

Needed for a connection with a Epoc32 based device. You should not specify this option explicitely.

-nobackground

Do not go to background after mounting, used mostly for debugging.

-noflow

Do not use hardware flowcontrol. Needed e.g. for the Nokia Communicator.

-oldnfsc

Use the "old" protocol. Certain clients need this.

-shell prog

When using the Epoc16 client nfsc you can have a UNIX shell on the PDA. This option selects the shell program.

-speed <baud>

The baudrate used for communication.

-tcp

This options selects TCP as communication interface.

-timeout <msec>

The timeout for the communication with the client. Some clients/protocols need bigger timeouts. Use this option with care.

-tty <dev>

The serial device used for communication (not valid for TCP). Linux examples: /dev/ttyS0 for Serial cable, /dev/ircomm0 for IrDA, /dev/rfcomm0 for bluetooth.

-user <uid>

The files of the PDA/Phone should be accessible by <uid> only. Default is the uid of the caller. This option is only available when p3nfsd is started by the root user.

-v

Be more verbose. You can increase the debug level after p3nfsd is started by sending a SIGUSR1 signal to p3nfsd or accessing <mountpoint>/debug. The output is written to stdout. You can increase debugging from 0 to 3 and then back to 0 again.

-wakeup

Psion Series3* devices only. Specifying this option can wake up the device, if the cable switch is set accordingly.

Terminating p3nfsd

Make sure that no process has open files / current working directory on the PDA filesystem. Then access the file <mountpoint>/exit, with e.g. "ls /mnt/psion/exit" or ":> /mnt/psion/exit". You should receive the error message: File exists. After 2 seconds p3nfsd will try to unmount the directory and exit.

SEE ALSO

irobex_palm3

BUGS

p3nfs may hang your shell, if it cannot connect to the client. The following procedure might help you to recover without booting the host system:

First kill the program which tries to access the PDA filesystem. In some cases you have to wait some minutes until the process dies, even if killed with -KILL. Then either try to terminate p3nfsd normally (see above), or kill p3nfsd and unmount the <mountpoint> manually.

AUTHOR

Rudolf Koenig, (C) 1993-2003, Email: r_dot_koenig_at_koeniglich_dot_de