Advanced FTP v0.3 (C) 1999 by Arpad Gereoffy (a.k.a. A'rpi/ESP-team) ~~~~~~~~~~~~~~~~~ report bugs and ideas to <arpi@esp.kign.org> Featuers & changes: [v0.1] - very short commands - file selection - !entrynum & masks - path history - directory cache - recursive get subdirs - wget script creation [v0.2] - code cleanup, some parts rewritten - line editor & history [v0.3] - keep-alive function - handle symlinks correctly ('CDROM -> /mnt/cdrom') - automatic reconnect if login failed (user-defined timeout!) - display welcome banners/messages Usage: aftp host - connect to 'host' as anonymous with fake password aftp @host - connect to 'host' as anonymous and ask password aftp user@host - connect to 'host' as 'user' and ask password Note: host may include port number/name: aftp mp3@warezsite.org:1999 1. Control commands: q - Quit ? - Help help - Help keep [t1][,t2] - Set keep-alive time (t1 seconds) and maxtime (t2 mins) t1=0 disable keep-alive, t2=0 means no max time limit 2. Change directory commands: . - refresh (re-read current dir) .. - CDUP (cd ..) >dirname - CD dirname < - step back (CD to previous path) << - step back twice... > - step forward h - view path history Note: dirname can be !entrynum or mask too ('>!5' and '>A*') 3. Commands on files/dirs: General: [+-][lgw+-][s][df] [mask] Prefixes: + = select all - = unselect all Commands: l = list g = get w = get with wget (generate script 'wget-it') + = select (and list) - = unselect Modifiers: s = selected only d = dirs only f = files only p = prompt (Y/n) Mask: - can contain space and other specials without quoting - '*' matching multiple characters - '?' matching exactly one character - '!n' is replaced with nth name (command 'g !3' gets 3rd file...) Examples: l - List all lsf - List Selected Files gf *.mp3 - Get Files with .mp3 extension g !3 - Get 3rd directory (recursive) ws - generate Wget script for downloading Selected things + X* - select files beginning with char 'X' -+f X* - select _only_ files beginning with char 'X' (first unselect all) -+s *p - select only things from currently Selected ones which ends to 'p' Notes for 'g': - AFtp recursive download directories! (with all files and subdirs inside) Notes for 'w': - AFtp will append a wget line to a script called 'wget-it', so you can create a script for download many things in easy way. - options of wget are defined in 'aftp1b.c', you must recompile it if you modify! sorry. To do: - reconnect - re-get/resume - put files - local commands (cd, ls, md, sh) - du (recursive disk-usage) Legal things: 1. This program is based on ftplib - callable ftp access routines Copyright (C) 1996, 1997, 1998 Thomas Pfau, pfau@cnj.digex.net 73 Catherine Street, South Bound Brook, NJ,08880 Modified in ftplib by me: - FtpXfer() now reports number of xfered bytes (requires for log_progress() at the end of transfer) - FtpXfer() now opens remote before local (to avoid creation of 0-byte files when trying open a directory) - Added 'DEBUG' define to print out server commands (not really important) - fixed: segfault if invalid port name specified ('localhost:ft[') - Added display_resp() to readresp() (prints welcome banners and messages) 2. This package includes the editline library sources, without modification. Read ./editline/README for details and its licence. Editline lib is a small but powerfull replacement of GNU-Readline. 3. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation. 4. This software is provided as-is. The author can not be held liable for any damage that might arise from the use of this software. Use it at your own risk.
