packages icon


                    LLNL XFTP Version 2.1, October 19, 1995


    **********************************************************************
    **************************  ABOUT LLNL XFTP  *************************
    **********************************************************************

    LLNL XFTP, an OSF/Motif-based FTP client, enables you to graphically
    transfer files and perform various directory manipulation commands,
    both locally and remotely.  Two especially notable features are the
	ability to (1) perform "third-party" (i.e., remote-to-remote) file
    transfers, and (2) transfer or delete entire directory substructures.
    LLNL XFTP has many features, is configurable, and has an intuitive
    user interface.

    LLNL XFTP is a precursor to LLNL XDIR, a much more sophisticated
    graphical FTP client.  LLNL XDIR features drag-and-drop file transfer,
    powerful directory browsing, and multihost searching.  Unless you
    would prefer LLNL XFTP's compact interface over LLNL XDIR's multiwindow
    approach, we recommend that you use LLNL XDIR.  Source code for LLNL
    XDIR is available as follows:

        ftp://coral.ocf.llnl.gov/pub/ia/llnlxdir/latest_xdir.tar.Z
        http://www.llnl.gov/liv_comp/xdir.html

    LLNL XFTP was written by Neale Smith of the Lawrence Livermore National
    Laboratory, which is operated by the University of California.


    **********************************************************************
    ************************  BUILDING LLNL XFTP  ************************
    **********************************************************************

    LLNL XFTP requires OSF/Motif 1.2 or later (earlier versions of Motif
    might work okay, but don't bother with anything earlier than 1.1.4).

    One version or another of LLNL XFTP has been successfully built on the
    following platforms (and a bunch of others):

          Computer            System                        Motif
          --------            ------                        -----
          SPARCstation        Sun OS 4.1.3                  1.2.1
          DECsystem 5830      ULTRIX V4.3 (Rev. 44)         1.2.1
          SGI                 IRIX 5.3                      1.2.3
          IBM RS6000          IBM AIX 3.2.5                 1.2.3
          IBM RS6000          IBM AIX 4.1.2                 1.2.3
          HP9000/819          HP-UX A.10.00                 1.2.4
          HP9000/735          HP-UX A.09.01                 1.2.0
          Cray YMP            UNICOS 7.0.6.2 bin.14         1.2.1
          DEC 4000/710        DEC OSF/1 V3.2 (Rev. 214)     1.2.3
          Sun 4/390           Solaris 2.3                   1.2.2
          Meiko               Solaris 2.3 Meiko_Patch_012   1.2.1
          Convex              CONVEX OS 10.1                1.?
          Intel 486           BSD/386                       1.2.2
          i486                System V R4.0.3               1.2
          i386                SVR4                          1.2.1
          Intel               SCO Open Desktop 3.0          1.2.1
          PowerMac 6100       MachTen 4.0                   1.1.4

    Perform the following steps to build LLNL XFTP:

    1. Enter the "sources" directory and type "xmkmf" to create "Makefile"
       from "Imakefile".  If you are unable to get this to work, use the
       backup makefile, "Makefile.alt", by uncommenting (and possibly
       editing) the section which seems most promising for your platform.

       NOTE: Follow instructions at beginning of Imakefile or Makefile.alt
             if you wish to build a SOCKSified executable.

    2. Type "make" to build the executable "xftp".

    3. Type "make install" to install the executable and the application
       defaults file.

    4. Type "make install.man" to install the man page.


    **********************************************************************
    ********************  Application Defaults File  *********************
    **********************************************************************

    It is usually not necessary to use an application defaults file with
    LLNL XFTP (since LLNL XFTP contains built-in fallback values).  You may
    wish to use an application defaults file with LLNL XFTP if you want to
    customize certain widget attributes such as fonts or colors.

    The application defaults file is named "XFtp".  (A symbolic link to
    XFtp is in the "sources" subdirectory.)  Make sure that XFtp is in
    the search path of one of the X application defaults file environment
    variables (e.g., XAPPLRESDIR, XFILESEARCHPATH, or XUSERFILESEARCHPATH).
    Consult the usual X documentation on how to set and use these environment
    variables.

    NOTE: LLNL XFTP 2.1 is not compatible with the earlier versions of the
    app defaults file.  A sure sign that an old XFtp is being picked up is
    that the file transfer monitor (the dialog that appears during file
    transfers) will look funny.


    **********************************************************************
    ***************************  Limitations  ****************************
    **********************************************************************
    
    Here are some things to watch out for:

      (1) LLNL XFTP might not work with some old X servers.  For example,
          some older OpenWindows servers might dump core.  MacX fans should
          use nothing older than version 1.1.7b.

      (2) Old, buggy versions of Motif can cause weirdness.

      (3) LLNL XFTP might not work correctly with some non-Unix FTP servers
          (If you can give us temporary access to such a server, we might
          be able to fix the problem.)

      (4) Out-of-spec FTP servers can cause untold grief.  (Most Unix-based
          servers work correctly.)

      (5) Third-party file transfers will not work unless at least one of
          the remote FTP servers supports the PASV (passive) command.


    **********************************************************************
    *****************************  Support  ******************************
    **********************************************************************

    Because our resources are limited, we will not be able to give you
    individual assistance in building and using LLNL XFTP.  However, your
    comments, suggestions and bug reports are valuable in helping us
    determine how to best direct our efforts.  Our email address is

                            llnlxftp@llnl.gov


    **********************************************************************
    ***************************  Availability  ***************************
    **********************************************************************

    Source code for LLNL XFTP is tarred and compressed, and is available
    as follows:

        ftp://coral.ocf.llnl.gov/pub/ia/llnlxftp/latest_xftp.tar.Z

        http://www.llnl.gov/liv_comp/xftp.html



    **********************************************************************
    *************************  Acknowledgements  *************************
    **********************************************************************

    Thanks to Robyne Sumpter, Sam Coleman, Mike Nemanic, Mark Seager, and
    Bob Cooper for their suggestions, encouragement, and help in getting
    LLNL XFTP out the door.

    Thanks to Fred Allen, Rich Fischer, Lee Busby, Mike Zollinger, and
    Art Rodrigues for their help in coordinating the alpha/beta testing
    of LLNL XFTP.

    Thanks to Jeff Long for his help in the design of the remote file
    viewer and the anonymous FTP user interfaces.

    And thanks to the many users out there, too numerous to list, who
    have sent me bug reports, suggestions and patches, and who made
    valuable contributions to the debugging and testing of LLNL XFTP.


    **********************************************************************
    ************************  Copyright Notices  *************************
    **********************************************************************

    (c) 1993-1995.  The Regents of the University of California.  All
    rights reserved.

    This work was produced at the University of California, Lawrence
    Livermore National Laboratory (UC LLNL) under contract no.
    W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy
    (DOE) and The Regents of the University of California (University)
    for the operation of UC LLNL.  Copyright is reserved to the
    University for purposes of controlled dissemination,
    commercialization through formal licensing, or other disposition
    under terms of Contract 48; DOE policies, regulations and orders;
    and U.S. statutes.  The rights of the Federal Government are
    reserved under Contract 48 subject to the restrictions agreed upon
    by the DOE and University.


                           DISCLAIMER

    This software was prepared as an account of work sponsored by an
    agency of the United States Government.  Neither the United States
    Government nor the University of California nor any of their
    employees, makes any warranty, express or implied, or assumes any
    liability or responsibility for the accuracy, completeness, or
    usefulness of any information, apparatus, product, or process
    disclosed, or represents that its specific commercial products,
    process, or service by trade name, trademark, manufacturer, or
    otherwise, does not necessarily constitute or imply its
    endorsement, recommendation, or favoring by the United States
    Government or the University of California. The views and opinions
    of the authors expressed herein do not necessarily state or reflect
    those of the United States Government or the University of
    California, and shall not be used for advertising or product
    endorsement purposes.

    Permission to use, copy, modify and distribute this software and its
    documentation for any non-commercial purpose, without fee, is
    hereby granted, provided that the above copyright notice and this
    permission notice appear in all copies of the software and
    supporting documentation, and that all UC LLNL identification in
    the user interface remain unchanged.  The title to copyright LLNL
    XFTP shall at all times remain with The Regents of the University
    of California and users agree to preserve same. Users seeking the
    right to make derivative works with LLNL XFTP for commercial
    purposes may obtain a license from the Lawrence Livermore National
    Laboratory's Technology Transfer Office, P.O. Box 808, L-795,
    Livermore, CA 94550.