X-Git-Url: https://git.phdru.name/?p=extfs.d.git;a=blobdiff_plain;f=obexftp;h=7b34288d3028f3b4deb60c78feed12bbc126ac56;hp=3f6d25f2c7cf5f191bc5edb024122490c918d657;hb=a96601f24ae6fa8c6cca96daedbeee9ecdda89a9;hpb=de10e73a2dfd1892868f836912280a405945ff7a diff --git a/obexftp b/obexftp index 3f6d25f..7b34288 100755 --- a/obexftp +++ b/obexftp @@ -1,50 +1,69 @@ #! /usr/local/bin/python -O """ -ObexFTP VFS for Midnight Commander. Manipulate a cell phone's filesystem using obexftp. +ObexFTP Virtual FileSystem for Midnight Commander. Author: Oleg BroytMann . Copyright (C) 2004 PhiloSoft Design. License: GPL. +Manipulate a cell phone's filesystem calling obexftp binary. This is a +complete user-mode solution, no kernel modules required (unlike SieFS or +such). The script implements all commands of Midnight VFS, except for +undocumented "run"; anyway there are no runnable files in the cell phone. The +script is written in Python because I love Python, the best of all languages ;), +and I need to parse XML directory listings from obexftp. + The script requires Midnight Commander 3.1+ (http://www.ibiblio.org/mc/), -Python 2.2+ (http://www.python.org/), OpenOBEX 1.0.1+ (http://openobex.sourceforge.net/) -and ObexFTP 0.10.4+ (http://triq.net/obexftp). +Python 2.2+ (http://www.python.org/), +OpenOBEX 1.0.1+ (http://openobex.sourceforge.net/) and +ObexFTP 0.10.4+ (http://triq.net/obexftp). -Edit the full path to the obexftp binary (see below). Put the file to the -/usr/[local/]lib/mc/extfs, and add a line "obexftp" to the -/usr/[local/]lib/mc/extfs/extfs.ini. Then create somewhere a transport file. +Edit the script, and correct the shebang path, if your python is not in the +/usr/local. Edit the full path to the obexftp binary (see below). Put the file +in the /usr/[local/]lib/mc/extfs, and add a line "obexftp" to the +/usr/[local/]lib/mc/extfs/extfs.ini. -The transport file can have any name, and is expected to be a text file with at -least one line defining the transport to your device. Other lines in the file -are ignored. +Create somewhere a transport file. The transport file may have any name, and +is expected to be a text file with at least one line defining the transport to +your device. Other lines in the file are ignored. -First word in the line is a transport name - Bluetooth, IrDA or TTY. The name +First word in the line is a transport name - Bluetooth, TTY or IrDA. The name is case-insensitive. For the Bluetooth transport put there a line "Bluetooth CP:AD:RE:SS channel", -where CP:AD:RE:SS is the hardware address of the device you want to connect to, -and channel is the OBEX File Transfer channel; you can discover the address and -the channel for your device by using commands like "hcitool scan" and "sdptool -browse". - -For the TTY put a device name: "tty /dev/rfcomm0". - -The content with the IrDA just put "IrDA" in the file. - -Now run this "cd" command in the Midnight Commander (in the "bindings" files -the command is "%cd"): cd description#obexftp. The VFS script uses obexftp to -connect to the device and list files and directories. Plese be warned that -opening the VFS for the first time is VERY slow, because the script needs to -scan the entire cell phone's filesystem. And there must be a timeout between -connections, which doesn't make the scanning process faster. Midnight Commander -caches the result, so you can browse directories quickly. +where CP:AD:RE:SS is the hardware address of the device you want to connect +to, and "channel" is the OBEX File Transfer channel; you can discover the +address and the channel for your device by using commands like "hcitool scan" +and "sdptool browse". + +For the TTY put the device name: "tty /dev/ttyUSB0". + +For the IrDA: just put "IrDA" in the file. + +Now run this "cd" command in the Midnight Commander (in the "bindings" file +the command is "%cd"): cd transport#obexftp, where "transport" is the name of +your transport file. The script uses obexftp to connect to the device and list +files and directories. Please be warned that opening the VFS for the first +time is VERY slow, because the script needs to scan the entire cell phone's +filesystem. And there must be timeouts between connections, which don't make +the scanning faster. Midnight Commander caches the result so you can browse +and manipulate files and directories quickly. + +Please note that manipulating the filesystem using your phone's internal +filemanager in parallel with the VFS leads to disagreement between the VFS +cache and the phone. It is not very dangerous but inconvenient. There is no +way to clear the VFS cache in Midnight Commander and reread the filesystem. +You have to exit the VFS (cd /, for example) and return back using cd +transport#obexftp command. Sometimes even this doesn't help - Midnight +Commander shows the same cached VFS image. Exit Midnight Commander and +restart it. """ -__version__ = "0.5.1" -__revision__ = "$Id: obexftp,v 1.7 2004/06/13 22:04:56 phd Exp $" -__date__ = "$Date: 2004/06/13 22:04:56 $"[7:-2] +__version__ = "1.0.2" +__revision__ = "$Id: obexftp,v 1.13 2004/07/27 15:39:54 phd Exp $" +__date__ = "$Date: 2004/07/27 15:39:54 $"[7:-2] __author__ = "Oleg Broytmann " __copyright__ = "Copyright (C) 2004 PhiloSoft Design" @@ -69,17 +88,21 @@ def error(msg): if len(sys.argv) < 2: error("""\ -It is not a program - it is a VFS for Midnight Commander. -Put it in /usr/lib/mc/extfs. For more information read the source!""") +ObexFTP Virtual FileSystem for Midnight Commander version %s +Author: %s +%s +Put it in /usr/lib/mc/extfs. For more information read the source!""" % ( + __version__, __author__, __copyright__ +)) def setup_transport(): """Setup transport parameters for the obexftp program""" transport_file = open(sys.argv[2], 'r') - line = transport_file.readline().strip() + line = transport_file.readline() transport_file.close() - parts = line.split() + parts = line.strip().split() transport = parts[0].lower() if transport == "bluetooth": @@ -89,7 +112,7 @@ def setup_transport(): elif transport == "irda": return "-i" else: - error("Unknown transport '%s'; expected 'bluetooth', 'tty' or 'irda'" % base_filename) + error("Unknown transport '%s'; expected 'bluetooth', 'tty' or 'irda'" % transport) # Parse ObexFTP XML directory listings