obexftp(1)

1obexftp(1)                                                          obexftp(1)
2
3
4

NAME

6       obexftp - Mobile Equipment file transfer tool
7

SYNOPSIS

9       obexftp [OPTION] [COMMANDS]
10

DESCRIPTION

12       obexftp  is used to access files on mobile equipment, i.e. cell phones.
13       With obexftpd you can transfer files between any computers using  IrDA,
14       Bluetooth and TCP/IP.
15
16       This tool lets you access the ObexFTP library by the means of a command
17       line interface.  You might consider using the  other  means  available.
18       E.g. the ObexFS filesystem for Linux.
19

OPTIONS

21       The  ordering  of options is important. Every command will use the most
22       recent device set. Every file without command switch will apply to  the
23       command given most recent. See EXAMPLES
24
25   TRANSPORT OPTIONS
26       -i, --irda
27              Connect using the IrDA protocol. This is the default.
28
29       -b device, --bluetooth device
30              Connect to this bluetooth device. If the device is not given the
31              first device found will be used.
32
33       -B number, --channel number
34              Use this bluetooth channel when connecting.  The channel will be
35              discoverd automatically if this option is not used.
36
37       -d no/address, --hci no/address
38              Use  the  bluetooth  device  referenced  by number or address as
39              source device for the connection.
40
41       -u intf no, --usb intf no
42              Connect to this usb interface or list all available  usb  inter‐
43              faces.
44
45       -t device, --tty device
46              Connect to this tty device.
47
48       -n host, --network host
49              Connect to this network host.
50
51   COMPATIBILITY OPTIONS
52       -U uuid, --uuid uuid
53              Select the UUID to connect with. Recognized values are currently
54              "none" needed by some Nokia mobile devices, "FBS" (default)  for
55              the  normal  file browsing service, "IRMC" for IRMC synchronisa‐
56              tion and "S45" when connecting to a  Siemens  Mobile  phone  via
57              cable or "SHARP" for PCSOFTWARE UUID with Sharp devices.
58
59       -H, --noconn
60              Suppress  connection  IDs (i.e. send no connection header to the
61              mobile).
62
63       -S, --nopath
64              Don't use "setpath" commands (i.e. send the whole path as  file‐
65              name  to  the  mobile).   Can be used together with --noconn and
66              --uuid none to send an OBEX-PUSH.
67
68   SETTING THE FILE PATH
69       -c folder, --chdir folder
70              Set the mobiles current working directory.
71
72       -C folder, --mkdir folder
73              Set the mobiles current working directory.  The folder  will  be
74              created if it doesn't exist.
75
76       -l folder, --list folder
77              List a folder.
78
79   SENDING AND RETRIEVING FILES
80       -o path, --output path
81              Specify the target file name, overriding the implicit local name
82              from --get or the implicit remote name from --put
83
84       -g source, --get source
85              Retrieve files from mobile.
86
87       -G source, --getdelete source
88              Retrieve files from mobile and delete them on the mobile
89
90       -p source, --put source
91              Send files to the mobile.
92
93       -k source, --delete source
94              Delete files from the mobile.
95
96   EXPERIMENTAL EXTRAS
97       -X, --capability
98              Retrieve the capability object from the mobile (if available).
99
100       -Y, --probe
101              Probe and report device characteristics
102
103       -x, --info
104              Retrieve misc infos from mobile. I.e. memory size and free  mem‐
105              ory.  Siemens specific for now.
106
107       -m src dest, --move src dest
108              Move (rename) files on the mobile. Siemens specific for now.
109
110   VERSION INFORMATION AND HELP
111       -v, --verbose
112              Be verbose and give some additional infos.
113
114       -V, --version
115              Print version string and exit.
116
117       -h, --help, --usage
118              Print short usage instructions.
119

EXAMPLES

121       To get the directory listing from the first irda device
122              obexftp -i -l or just obexftp -l as IrDA is the default.
123
124       To get the file bar from directory foo from the first bluetooth device
125              obexftp -b -c foo -g bar
126
127       To send the file bar to directory foo with device on first serial port
128              obexftp -t /dev/ttyS0 -c foo -p bar
129
130       It is possible to use RfComm (serial port over bluetooth)
131              obexftp -t /dev/rfcomm0 -c foo -p bar
132
133       And also IrComm (serial port over IrDA)
134              obexftp -t /dev/ircomm0 -c foo -p bar
135
136       To send the file bar using plain OBEX PUSH
137              obexftp --bluetooth --nopath --noconn --uuid none --put bar
138

BUGS

143       Bugs ? Features !
144

NOTES

146       The  software has been tested and reported working on at least Siemens,
147       Ericsson, and Nokia phones.
148

AUTHOR

150       Christian W. Zuckschwerdt <zany@triq.net>
151
152
153
154                               17 February 2009                     obexftp(1)