
--FINAL-RELEASE-- linfXp v0.3.2m (c) pSi --FINAL-RELEASE--

THIS IS NOT A TOOL FOR STANDARD-FTP USERS, SO PLEASE DON'T COMPLAIN!
THIS TOOL IS MEANT TO BE USED BY COURIERS.

overview:
^^^^^^^^^
	- powerful fXp for linux platforms
	- multithreading of actions
	- compatible with xftpd, bftpd, rftpd, warftpd, msftpd (NT), ftp4all
	  (NOT with cuftpd, this one really sucks)
	- compiled for ELF-linux 2.x.x
	- you'll need libc.so.5 and libncurses.so.1.9.9e (display-output)
	  (glibc instead of libc (5.4.38) will NOT work!)

features:
^^^^^^^^^
	- unlimited number of simultaneous connections and threads
	- easy selection of source/target server, clearly arranged windows
	- special optimized recover algorithm for failed FTP actions
	- easy transferring of whole directories while excluding user-defined
	  patterns (e.g. *.nfo, *.diz, ...)
	- userfriendly server-bookmarks
	- logout in case of seg-faults (almost in every case)
	- many useful options (per server)
	- automatic jump to newest dir, automatic refresh
	- large logwindow w/ scrollback and colorization
	- internal ASCII viewer to view remote files
	- preparing of a dir to be copied before actually copying files
	- marking of the 5 newest dirs/files
	- automatically mirroring to a server (saves creditz)
	- support for every standard terminal, every size
	- support for non-color terminals

short instructions:
^^^^^^^^^^^^^^^^^^^
NOTE:	due to some lame terminals you can use the followig additional keys
	(in case you have such a non-working emulation):

	cursor up	= 8
	cursor down	= 2
	page up		= 9
	page down	= 3

	cursor left	= 4
	cursor right	= 6

	(keys are taken from the numpad, but standard numbers work too.
	 if u use the numpad, be sure to have NUMLOCK enabled)

    -------------------------A-T-T-E-N-T-I-O-N-------------------------
    If you have a dynamic IP, then you'll have to use the the device
    name you actually use for the connection as the only parameter.
    e.g. "linfXp ppp0" (pppx for PPP-connection, ethx for network-cards)
    try "ifconfig" to see a list of supported devices on your system.

    You need at least a bookmark-file from v0.1.1+ otherwise the new
    version will behave unpredictable due to changed prefs!
    -------------------------A-T-T-E-N-T-I-O-N-------------------------

    You can omit the auto-login feature when appending the "-na" (no-auto)
    switch on startup (like "linfXp -na" or "linfXp ppp0 -na").

- Open a new connection with 'O'. If you have created previous  bookmarks,
  you can select the wanted entry in the upcoming window with RETURN. You
  should  select the  window in which this  connection will be  initially
  displayed with TAB or 'L' / 'R'.
  To add a new bookmark press 'A' and enter the label and host-information
  (use TAB to switch between the four input boxes).
  Edit an existing bookmark with 'E'.
  To delete a  bookmark use 'D',  the  actually selected  bookmark will be
  wiped out.
  Press double-ESC at any time to cancel.

  NOTE:	the bookmarks are saved in <user-homedir>/.linfXprc.
	The passwords are stored encrypted.
	DON'T TOUCH this file, you have been warned!

- View the logfile with 'L', use  UP/DOWN and  PGUP / PGDOWN to  navigate,
  double ESC to cancel.

- View the alternative directory-listing with 'F'

- Close the active connection with 'C'

- Switch a  connection  into a  window  with 'S'.  Use the  cursor keys to
  navigate and select the host you want to appear in the active window.

- Select file(s) and dir(s) with  SPACE,  navigate through  files and dirs
  with  cursor keys and  PGUP/PGDOWN,  change  the current  directory with
  RETURN or "->" (switch the active window with TAB).CD one level up again
  with "<-".

- Transfer  files and dirs with 'T'  from the active  window to the second
  one.  All selected  files/dirs  will be copied,  if nothing is selected,
  then the dir/file under the cursor will be copied instead.
  If an error occurs, then the copy-process will be continued with the next
  file(s) just if the error occured because the file already existed on the
  target system. If another error happened, the process will be stopped.
  Directories will be  copied ONE  level down ignoring  the patterns which
  you have specified, sub-dirs will be ignored unless the creation of sub-
  sub dirs is enabled! If linfXp encounters a dupe during the transfer of
  whole dirs, it will not try to up other files from this directory.
  Instead it will advance on to the next tagged directory.

- When using 'K' then all files transferred will have an appended '.ok'
  in front of the file-extension. Behaviour is like 'T'.

- Refresh the dir-listing of the actual working dir with 'r'. Shift-R re-
  freshes all sitez.

- Prepare a dir (create just the dir on the other side without yet copying
  it's  contents and CD  into it on both sides)  with 'p'.  Use SHIFT-P to
  prepare the dir you are actually in on the other side. 

- Rename a file with 'N'. Simply enter the new name.

- Compare two listings with 'A'. All entries which can't  be found (search
  is not case sensitive) on  each other  side will  get  selected  and the
  cursor jumps to the first entry.

- Delete files with 'D'. Works like copy  (just files and EMPTY  dirs will
  be deleted)

- Make new directories with 'M'. Enter the dir-name (double ESC to cancel)
  If successful, the active working dir will be changed to the new dir.

- Change the working dir to somewhere with 'W'.

- View ASCII files with 'V'. The actually  selected file will be displayed
  (not the marked file(s)).  Navigate in viewer  with PGUP/PGDOWN,  double
  ESC to close.

- Enter a SITE command with 'X' (double ESC to cancel).

- Modify the preferences for the active server with 'E'.
  The 'Create sub-sub dirs' defines the behavior when copying whole dir's.
  If enabled, dir's contained  in the to-be-copied-dir will be  created on
  the target (but NOT copied!).
  The rest should be clear. If not, go and shoot yourself.
  Just one thing: the timer for the  auto-refresh will be  resettet every-
  time you press a key, so it will not disturb you while working.

- Define the interim-server to  use for hosts which  have the "Use interim
  server" option enabled with 'I'. Selecting the same host twice  disables
  the use of such an server globaly.
  Using the interim-server means, if you upload file(s)/dir(s) to an server
  which has  the option  enabled,  then those  files and  dirs will  not be
  transferred directly, but with the use of another server.  This  lets you
  save credits when uploading the same files to more sites.
  The files are copied to the interim server, and then from this  server to
  the original selected destination.  After that  you can  use  the interim
  server as the source for another destination. Thats all. No fancy thing.
  Btw, if you didn't already get a clue what the interim server should be:
  What about choosing your own shell? With no ratio? Now you got it...
  Just one more thought: lets say, you have the source A and want to upload
  to B and C.  Your own  shell is D.  Now you have  set B and C  to use the
  interim-server, and you copy from A to B. Internally the files are copied
  this way: A -> D -> B. Good. Now you switch to your interim server  D and
  select  the  files  to copy  them  now to C. You can safely copy, because
  if the interim server is equal the source, then the interim step will not
  be executed.  Same  happens if  the interim  server is  the same  as  the
  destination one.
  Most times you just select your favourite server to have the interim opt.
  enabled, and then transfer from your  shell to all others.  Otherwise you
  might get confused and loose races just because all files are mirrored to
  your shell first. If no interim server is  selected,  then no  mirror  is
  used (no warning), so you'll have to keep track of what you are doing.
  Especially when using your own warezserver as your interim storage,you'll
  have to take care of file-rights. If an error occurs while mirroring then
  you might be confused what happened,  so please use an  account on  which
  you really can up everything you want (and download too).
  When copying whole dirs, then the dirs are created on the mirror  and the
  actual destination, and then the first file is copied to the mirror, then
  from the mirror to the dest, then the second one and so on.
  Ah, yes: the actually working-dir on the interim-server  is used for  the
  actions, so be sure to CD into the right dir b4 using the server.
  NOTE: most standard-shell-ftp-daemons (like wu-ftpd) doesn't support PASV
  transfers (don't know why, but they will not accept the PORT command).

- Scroll in the status-window with '7' / '1' up and down (enable NUMLOCK!)

- CTRL-C at any time to stop a TCP-command, double-ESC to cancel requesters,
  'Q' to quit (a requester will pop up)


special thanx goes to my beta-testers and to other ppl which supported me
with many nice ideas:
  hiTop, _eCs_, |Flex|, demo, Minga and of course ds!SAC for the cool logo

thanx to MR_Y and ESPRiT for the webspace ;)

"pSi_" on us-efnet
psi@esprit.org
http://www.esprit.org/linfxp
ftp.esprit.org/pub/linfxp

--FINAL-RELEASE-- linfXp v0.3.2m (c) pSi --FINAL-RELEASE--
