NAME

     LLNL XFTP - an X-based interface to FTP

SYNOPSIS

     xftp [options]

DESCRIPTION

     LLNL XFTP is a graphical user interface to FTP (File Transfer Protocol).
     LLNL XFTP does not execute the ftp program; instead, it directly
     communicates with remote FTP servers.  LLNL XFTP is an X client and
     follows the OSF/Motif look-and-feel.  LLNL XFTP enables users to transfer
     files and perform various directory manipulation commands,	both remotely
     and locally.  Two especially notable features are the ability to (1)
     perform "third-party" file	transfers, and (2) transfer or delete entire
     directory substructures.

     LLNL XFTP's main window is divided into five main sections: (1) the main
     menu bar at the top of the	window,	 (2) the diagnostics log at the
     bottom, (3) the file transfer controls in the center, and (4 and 5) the
     "left" and	"right"	host sections to either	side of	the file transfer
     controls.

     LLNL XFTP can be connected to zero, one, or two hosts.  The hosts may be
     any combination of	local and remote hosts (the local host is the client
     host upon which LLNL XFTP is running).  In this document, a connected
     host is referred to as either the "left" or "right" host, depending on
     whether it	is displayed in	the left or right host section,	respectively.

     Each host section consists	of four	major graphical	elements: (1) a	label
     which displays the	host's name; (2) a menu	bar whose menus	contain	many
     commands that operate on the host;	(3) a "directory" menu;	and (4)	a
     scrollable	"directory list."

     Each host's Connect menu contains commands for connecting/disconnecting
     local and remote hosts.

     Each host's Dir menu contains various commands for creating new
     directories, and for changing and displaying the current directory.

     Each host's Select menu contains commands for selecting/deselecting
     entries in	the current directory (the selections appear in	the scrollable
     list of directory entries).

     Each host's Ops menu contains several commands that operate on selected
     directory entries.

     Each host's directory menu	contains each link of the path of the current
     directory (the last link is displayed).  By selecting a link in the path,
     the current directory is correspondingly changed.	(Hence,	this is	a
     mechanism to traverse up the host's directory structure.)

     Each host's directory list	contains the entries of	the current directory.
     One way to select/deselect a directory entry is to click on it.  If an
     entry is double-clicked, an attempt is made to change the current
     directory to that entry.  (Hence, this is a way to traverse down the
     host's directory structure.)

     The file transfer controls	in the middle of the main window allow the
     user to initiate file transfers on	selected entries.  The transfers can
     go	from left to right or from right to left.  Angle brackets in the Copy
     and Rcopy buttons indicate the direction of the transfer (e.g.,
     ">>Copy>>" indicates that a left-to-right transfer would take place).
     The View button causes the selected file to be displayed.

     The scrollable diagnostics	log window at the bottom of the	main window
     displays error and	status information.  The user can control the level of
     verbosity of messages written to this window via the user preference
     Diagnostics.  The contents of this window can be saved to a file by
     selecting the Save Log item in the Log menu.  The diagnostics window can
     be	cleared	by selecting the Clear Log item in the Log menu.

     There is a	flag to	the left of the	diagnostics log	window that indicates
     whether an	operation completes successfully or not.  If an	operation
     fails then	(1) a beep is emitted, (2) the flag changes from green to red
     (white to black on	monochrome displays), (3) the "OK" in the flag changes
     to	"E", and (4) an	error message is written to the	diagnostic  log
     window. The next operation	will clear the error flag.

     LLNL XFTP automatically caches (1) wildcard expressions, (2) paths of
     current directories, (3) host names and user names	used in	connecting to
     remote hosts, and (4) quoted commands.  The purpose of each cache is to
     reduce the	amount of typing required.  For	example, when the user wishes
     to	apply a	wildcard expression to select directory	entries, a list	of
     recently referenced wildcard expressions for that host will be presented
     to	the user; the user can then double-click on an existing	wildcard
     expression	to apply it.  The cache	is automatically preserved across LLNL
     XFTP sessions in a file named ".xftpcache" in the users home directory.

OPTIONS

     LLNL XFTP accepts all of the standard X Toolkit command line options, as
     well as the following option:

     -color
	  Force	LLNL XFTP to use a nice color scheme, even if the application
	  defaults file, XFtp, is not found.

GETTING STARTED

     Use the Connect menus to connect the two sides to the desired combination
     of	local and/or remote hosts.  (Depending on how the user preferences are
     set, when LLNL XFTP comes up some combination of the left and right sides
     might already be connected	to the local host.)

     Once connected, traverse through a	host's directory structure by (1)
     using the directory name menu (the	menu just above	the directory list),
     (2) double-clicking on entries in the directory list, (3) selecting an
     item in the Go to Previous Directory submenu in the host's Dir menu, or
     in	the host's Dir menu.

     Obtain different types of views into a host's current directory by
     selecting the Display Directory (Long) or Display Directory (Table) items
     in the host's Dir menu.

     Select/deselect directory entries to operate on by	(1) single-clicking on
     entries in	the main directory list, (2) single-clicking on	entries	in the
     tabular directory list, (3) dragging the mouse with the left button held
     down over entries in the tabular directory	list, or (4) by	selecting any
     of	the items in the host's	Select menu.

     Transfer selected items by	clicking on the	Copy or Rcopy (recursive copy)
     buttons.  Be sure to first	set the	file transfer mode by toggling the
     appropriate button	(ASCII or Binary) in the main window.

     View a selected file by clicking on the View button.  Configure the
     viewer by selecting item Viewer Preferences in the Options menu.  Be sure
     to	first set the file transfer mode by toggling the appropriate button
     (ASCII or Binary) in the main window.

     Perform other types of operations on selected items by selecting any one
     of	the items in the host's	Ops menu.

     Configure LLNL XFTP by selecting the Preferences item in the Options
     menu.

COMMANDS

     LLNL XFTP contains a large number of commands.  The commands are found in
     (1) the main menus, (2) the host menus, and (3) in	the Xfer Ops controls.
     Here is a list of the commands:

     About LLNL	XFTP (in File menu)
	  Gives	version	information.

     Change Directory (in Dir menus)
	  Change the current directory.	 A dialog pops up to prompt for	the
	  directory to change to.  The directory may be	specified with a full
	  or relative path.  Previously	referenced directories are cached and
	  displayed in a scrollable list.  Double-click	on a path in the list
	  to change to that directory.	Single click on	a path in the list to
	  place	that entry into	the text field labeled "Directory:", where it
	  can be edited.  Click	on the OK button to change to the directory
	  displayed in the text	field.	(See user preferences Add to Cache,
	  Diagnostics, Directory Cache Size, Host Cache Size, and Sort
	  Caches.)

     Clear Log (in Log menu)
	  Clear	the diagnostics	log window.

     Connect to	Anonymous (in Connect menus)
	  Easily connect to an anonymous FTP site.  If currently connected,
	  the connection is first closed.  A dialog pops up to prompt for the
	  remote host, user name and password.	The user name is initialized
	  to "anonymous".  The password	is initialized to the value of the
          user preference Anonymous Ftp Password (which you will probably want
          to set to your email address).  An optional port number may follow
          the host name (using a space as the delimiter).  Previously used
          host/user name pairs are cached, and those with user names
	  "anonymous" or "ftp" are displayed in	a scolled list labeled
	  "Recently Referenced Hosts:".	 Double-clicking on a host/user	name
	  pair initiates a connection.	Single-clicking	on a host/user name
	  pair places those values in to the host name and user	name fields,
	  where	they can be edited.  Click on the Connect button to initiate a
	  connection.  (See user preferences Add To Cache, Anonymous Ftp
	  Password, Diagnostics, Host Cache Size, User Cache Size, and Sort
	  Caches.)

     Connect to	Local (in Connect menus)
	  Connect to the local (client)	host.  If currently connected, the
	  connection is	first closed.  (See user preferences Left Auto Local
	  Login and Right Auto Local Login.)

     Connect to	Remote (in Connect menus)
	  Connect to a remote host (use	Connect to Anonymous to more easily
	  connect to an	anonymous FTP site).  If currently connected, the
	  connection is	first closed.  A dialog	pops up	to prompt for the
	  remote host and user names.  The user	name is	initialized to the
	  value	of the environment variable USER.  An optional port number may
	  follow the host name (using a	space as the delimiter).  Previously
	  used host/user name pairs are	cached and those with user names other
	  than "anonymous" and "ftp" displayed in a scolled list labeled
	  "Recently Referenced Hosts:".	 Double-clicking on a host/user	name
	  pair initiates a connection.	Single-clicking	on a host/user name
	  pair places those values into	the host name and user name fields,
	  where	they can be edited.  Click on the Connect button to initiate a
	  connection.  (See user preferences Add To Cache, Diagnostics, Host
	  Cache Size, User Cache Size, and Sort Caches.)

     Contextual	Help (in Help menu)
	  Enter	contextual-help	mode.  The mouse cursor	changes	to a pointing
	  hand.	 Move the hand and click on any	graphical element in the main
	  window that you wish to know more about.

     Copy (in Xfer Ops controls)
	  Transfers the	selected files according to the	mode (ASCII or Binary)
	  specified in Xfer Mode.  A dialog pops up to enable the user to
	  monitor the progress of the transfers.  The dialog contains a	button
	  for aborting the transfers.  (See user preferences Beep When Ops
	  Done, Diagnostics, Initial Transfer Mode, and Inquire On Copy.)

     Delete Selected Entry(s) (in Ops menus)
	  Deletes the selected entries.	 A dialog pops up to enable the	user
	  to monitor the progress of the deletions.  The dialog	contains a
	  button for aborting the deletions.  (See user	preferences Beep When
	  Ops Done, Diagnostics, and Inquire On	Delete.)

     Deselect All Entries (in Select menus)
	  Deselect all the entries in the host's current directory.

     Disconnect	(in Connect menus)
          Close the currently connected host.  (See user preference
          Diagnostics.)

     Display Directory (Long) (in Dir menus)
          Pops up a dialog that displays the contents of the current directory
	  in a scrollable list.	 If supported by the host (and this is almost
	  always the case), additional information about each directory	entry
	  is displayed,	such as	file length and	access restrictions.  This
	  display is automatically updated as the current directory changes.
	  This directory display does not support selecting entries or
	  displaying the current selection.  Warning: Using this feature can
	  increase network traffic, put	an additional load on the remote host,
	  and slow down	interactivity.	 (See user preference Diagnostics and
	  Sort Long Lists By Date.)

     Display Directory Path (in	Dir menus)
	  Pops up a dialog that	displays the current directory for that	host.
	  It will be automatically updated as the current directory changes.
	  (See user preference Diagnostics.)

     Display Directory (Table) (in Dir menus)
	  Pops up a dialog that	displays the contents of the current directory
	  in tabular form.  This dialog	may be used to view and	modify the
	  directory's selected entries.	 Entries may be	selected/deselected
	  either by clicking or	by moving the cursor over the entries with the
	  mouse	button down.  Moving the mouse too quickly can cause some of
	  the entries to be skipped.  If an entry is double-clicked, an
	  attempt is made to change the	current	directory to that entry.  This
	  display is automatically updated as the current directory changes.
	  (See user preference Diagnostics.)

     Getting Started (in Help menu)
	  Describes how	to get started using LLNL XFTP.

     Go	to Previous Directory (in Dir menus)
	  Displays a pullright menu that allows	the user to easily change the
	  current directory to a previously referenced directory.  (See	user
	  preferences Add to Cache, Diagnostics, Directory Cache Size, Host
	  Cache Size, and Sort Caches.)

     LLNL XFTP Overview	(in Help menu)
	  Gives	a high-level description of LLNL XFTP.

     Make Directory (in	Dir menus)
	  Pops up a dialog to prompt for the name of a directory to make in
	  the current directory.  The user preference Enter Dir Upon Creation
	  controls whether the the newly created directory is automatically
	  entered upon creation.  (See user preferences	Diagnostics and Enter
	  Dir Upon Creation.)

     Move Selected Entry(s) (in	Ops menus)
	  Move selected	entries	from the current directory to another
	  directory on the same	host.  This is similar to the UNIX mv command,
	  but without rename capability.  (See user preferences	Beep When Ops
	  Done,	and Diagnostics.)

     Preferences (in Options menu)
          Display the user preferences dialog.  See USER PREFERENCES section
          for a description of user preferences.

     Quit (in File menu)
          Terminate LLNL XFTP.

     Rcopy (in Xfer Ops controls)
	  Recursively transfers	the selected entries according to the mode
	  (ASCII or Binary) specified in Xfer Mode.  If a selected entry is a
	  directory, an	attempt	is made	to transfer its	entire directory
	  subtree.  The	user preference	Overwrite Dir On Copy lets the user
	  control whether or not it is okay to overwrite an existing
	  directory.  A	dialog pops up to enable the user to monitor the
	  progress of the transfers.  The dialog contains a button for
	  aborting the transfers.  (See	user preferences Beep When Ops Done,
	  Diagnostics, Initial Xfer Mode, Inquire On Copy, and Overwrite Dir
	  On Copy.)

     Recursively Delete	Selected Entry(s) (in Ops menus)
	  Recursively deletes the selected entries.  A dialog pops up to
	  enable the user to monitor the progress of the deletions.  The
	  dialog contains a button for aborting	the deletions.	Warning:
	  Exercise extreme caution when	using this command because it deletes
	  entire directory subtrees.  To minimize the chance of	an
	  unintentional	deletion, this menu item is greyed out unless the user
	  preference Recursive Delete Enabled is enabled.  (See user
	  preferences Beep When Ops Done, Diagnostics, Inquire On Delete, and
	  Recursive Delete Enabled.)

     Rename Selected Entry(s) (in Ops menus)
	  Pop up a dialog to individually rename selected entries.  This is
	  similar to the UNIX mv command except that the renamed entries
	  cannot be moved to another directory.	 (See user preference
	  Diagnostics.)

     Save Log (in Log menu)
	  Write	the contents of	the diagnostics	window to a user-specified
	  file.	 The existing contents of the diagnostics window are not
	  removed.

     Save Preferences (in Options menu)
	  Save the current settings of the user	and viewer preferences.

     Select All	Entries	(in Select menus)
	  Select all the entries in the	host's current directory.

     Send Quoted Command (in Ops menus)
	  Pops up a dialog to prompt for a "raw" command to send to the	FTP
	  server of the	remote host.  Previously issued	commands are cached
	  and displayed	in a scrolled list.  Double-clicking on	a command in
	  the list issues that command.	 To have a command act on items
	  selected in the host's directory list, use the quote placeholder
	  (which by default is "<>") to represent a selected item.  For
	  example, type	"stage 1 <>" to send a STAGE command to the the remote
	  host for each	selected item.	The quote placeholder can changed via
	  the user preferences.	 (See user preferences Beep When Ops Done,
	  Diagnostics, and Quote Placeholder.)

     Use Wildcard (in Select menus)
          Pops up a dialog to prompt for a wildcard expression to use in
          selecting entries in the host's current directory list.  Previously
	  referenced wildcard expressions are cached and displayed in a
	  scrolled list.  Double-clicking on an	item in	the list applies that
	  wildcard expression.	Single-clicking	on an item in the list places
	  the expression in a text field where it may be edited.  Choose the
	  toggle item Replace Filename Selection to cause the currently
	  selected entries to be cleared before	applying the wildcard.	Choose
	  the toggle item Add to Filename Selection to cause the entries
	  selected by the wildcard to be added to the current selection.  (See
	  user preference Initial Wildcard Mode).

     Using Help	(in Help menu)
	  Gives	a description of the online help package.

     View (in Xfer Ops controls)
	  Displays the selected	file.  The Viewer Preferences dialog
	  (accessible via the Options menu) can be used to control whether the
	  file will be displayed using the built-in viewer or using an
	  external viewer of the user's	choice (e.g., emacs or xv).  The
	  selection of the viewer is configurable, based on the	file extension
	  (e.g., ".gif"	or ".jpg").  There is no limit on the number or	types
	  of viewers that can be simultaneously	displayed.

	  The file is transferred according to the mode	(ASCII or Binary)
	  specified in Xfer Mode.  A dialog pops up to enable the user to
	  monitor the progress of the transfer.	 The dialog contains a button
	  for aborting the transfer.

	  The destination of the transfer is a temporary directory created in
	  the directory	defined	as P_tmpdir in the include file stdio.h.  If
	  the environment variable TMPDIR is defined, it is used as the
	  directory.  The temporary directory, and the files it	contains, are
	  automatically	deleted	when the user dismisses	the viewer or
	  terminates LLNL XFTP.

	  If the file is recognized as being compressed, it is expanded	before
	  viewing.  LLNL XFTP excutes the following decompressors based on the
	  file extension: gunzip for ".z" and ".gz"; uncompress for ".Z"; atob
	  for "atob"; and uudecode for ".uu".  LLNL XFTP searches for the
	  decompressor application in the standard way using the PATH
	  environment variable.

     Viewer Preferences	(in Options menu)
	  Display the viewer preferences dialog.  See VIEWER PREFERENCES
	  section for a	description of viewer preferences.

USER PREFERENCES

     Selecting item Preferences in the Options menu pops up a dialog that
     allows the	user to	configure LLNL XFTP according to his/her preferences.
     The user is presented with	a number of configuration parameters, which
     are set by	either toggling, sliding, or typing.  Click the	Apply button
     to	cause the new values to	take effect.  The OK button has the same
     effect as Apply, but the dialog is also closed.  The Cancel button undoes
     changes made since OK or Apply were last pressed.  The preferences can be
     preserved across LLNL XFTP sessions in a text file named ".xftprc" in the
     user's home directory.  The user may alter the order the preferences are
     presented in the dialog by	(1) terminating	LLNL XFTP, (2) using a text
     editor to change the order	of lines in ".xftprc" and (3) restarting LLNL
     XFTP.

     Add To Cache
	  Specifies whether newly referenced items should be added to the
	  directory, quoted command, wildcard, and host/user caches.  It is
	  usually desirable to choose Yes.  Choose No if referencing a series
	  of seldom-referenced items that would	clear the cache	of your
	  favorite entries.

     Anonymous Ftp Password
	  The value to initialize the "Password" field of the Connect to
	  Anonymous dialog to.	This is	normally your email address.  The
	  Connect to Anonymous dialog is accessible via each host's Connect
	  menu.

     Beep When Ops Done
	  Specifes whether to beep when	each set of deletion, move, quoted
	  command, and file transfer operations	completes.

     Diagnostics
	  Specifies the	level of diagnostics information to be written to the
	  diagnostics log window.  Choose Quiet for error messages, only.
	  Choose Normal for error messages and success messages.  Choose
	  Verbose for error messages, success messages, and replies received
	  from the FTP servers.	 Choose	Debug for error messages, success
	  messages, commands sent to the FTP servers, replies received from
	  the FTP servers, and other assorted diagnostics.

     Directory Cache Size
	  The maximum number of	previously referenced directory	paths cached
	  per host.  The cache is preserved across LLNL XFTP sessions.

     Enhance Colors
	  Speficies whether to "pretty up" some	of the graphical elements
	  (such	as scrolled lists and text fields) by changing the normal
	  background colors.  This preference has no effect on monochrome
	  displays.  Choose Yes to enhance the appearance, or No for the usual
	  Motif	look.

     Enter Dir Upon Creation
	  Specifies whether to automatically enter a newly created directory.

     Host Cache	Size
	  The maximum number of	hosts to cache items for.  The cache is
	  preserved across LLNL XFTP sessions.

     Initial Logfile Name
	  The default file name	to be presented	to the user in the "Save Log"
	  dialog.

     Initial Transfer Mode
          The default file transfer mode (ASCII or Binary).

     Initial Wildcard Mode
          The default mode of the "Use Wildcard" dialog.  Choose Replace to
	  make "Replace	Filename Selection" the	default.  Choose Add to make
	  "Add to Filename Selection" the default.

     Inquire On	Copy
	  Specifies whether to pop up a	dialog that asks the user to confirm
	  that the indicated transfers should take place.

     Inquire On	Delete
	  Specifies whether to pop up a	dialog that asks the user to confirm
	  that the indicated deletions should take place.

     Inquire On	Move
	  Specifies whether to pop up a	dialog that asks the user to confirm
	  that the indicated moves should take place.

     Inquire On	Quote
	  Specifies whether to pop up a	dialog that asks the user to confirm
	  that the indicated commands should be	sent.

     Left Auto Local Login
	  Specifies whether to automatically connect the left side to the
	  local	(client) host upon starting LLNL XFTP.

     Max Ftp Retries
	  Specifies the	maximum	number of retries LLNL XFTP will attempt if it
	  receives a response from an FTP server that indicates	the desired
	  operation failed because of some temporary condition on the remote
	  host.

     Max Time For Ftp Reply
	  Specifies the	maximum	time in	seconds	that LLNL XFTP will wait for a
	  response from	an FTP server before concluding	that the connection
	  has been broken.

     Overwrite Dir On Copy
	  Specifies whether it is okay to overwrite an existing	directory when
	  recursively copying another directory	by the same name.  If a	sink
	  directory is overwritten then	none of	its subdirectories will	be
	  deleted, but new files and subdirectories might be added to it, and
	  some existing	files might be replaced.

     Preserve Vms Ver Nums
	  Specifies whether to preserve	VMS file version numbers when
	  transferring files from a VMS	system.	 This is only an issue for
	  those	VMS FTP	servers	that provide numbers (not all do).

     Print Password In Debug
	  Specifies whether to print passwords in the log window when the user
	  preference Diagnostics is set to Debug.

     Quote Cache Size
	  The number of	quoted commands	to cache.  The cache is	preserved
          across LLNL XFTP sessions.

     Quote Placeholder
          This is used as a placeholder in a quoted command to represent items
	  selected in the directory list.  For example,	the quoted command
	  "stage 1 <>" will send a STAGE command to the remote host for each
	  selected item.  The default value is "<>", but the placeholder can
	  be set to any	nonnull	printable string.

     Recursive Delete Enabled
	  Specifies whether to enable the Recursively Delete Selected Entry(s)
	  item in the Ops menus.  Choose No to help prevent accidental
	  recursive deletions.

     Right Auto	Local Login
	  Specifies whether to automatically connect the right side to the
	  local	(client) host upon starting LLNL XFTP.

     Sort Caches
	  Specifies whether to sort (by	ASCII-collating	sequence) cached items
	  when they are	displayed in dialogs.  If Yes, then sort.  If No, then
	  the most recently referenced items are placed	at the top of the
	  list.

     Sort Longs	Lists By Date
	  Specifies whether to attempt to sort the "long" directory lists by
	  time modified	(with most recent listed first)	instead	of by name.
	  The Yes option is considered unsafe because some FTP servers to not
	  support this option and may give unpredictable results.  (Most UNIX
	  hosts	support	this option.)

     Store Unique
	  Specifies whether existing sink files	are to be renamed before file
	  transfer occurs.  If Yes then the existing sink file is typically
	  renamed by appending a "." (period) followed by an integer between 1
	  and 99.

     Symbols On	Dir Entries
	  Specifies whether to append single characters	to directory entries
	  in order to distinguish their	types.	If Yes(Unsafe) is chosen, "/"
	  is appended to directories, "*" is appended to executables, "@" is
	  appended to symbolic links, and "=" is appended to AF_UNIX address
	  family sockets.  The "Yes" option is considered to be	unsafe because
	  some FTP servers do not support this feature and may give
	  unpredictable	results.  (Most	UNIX hosts support this	option.)
	  Furthermore, if you are referencing a	directory or directory entry
	  whose	name ends with one of the special characters, you will need to
	  select No(Safe).  When in doubt, select No(Safe).  One further note:
	  use of this feature can dramatically degrade interactivity.

     Use Last Dir At Login
	  Specifies whether to automatically enter the most recently
	  referenced directory after connecting	to a host.  If this option is
	  requested, but is not	possible to perform (e.g., because the
	  directory no longer exists), an error	message	will be	generated, and
	  your home directory will be entered.	Note: This mechanism attempts
          to enter the last directory referenced on the host, regardless of
          whether it is another user's directory.

     User Cache Size
          The number of user names to cache (for remote hosts).  The cache is
	  preserved across LLNL XFTP sessions.

     Wildcard Cache Size
	  The number of	wildcard expressions to	cache.	The cache is preserved
	  across LLNL XFTP sessions.

VIEWER PREFERENCES

     Selecting item Viewer Preferences in the Options menu pops	up a dialog
     that allows the user to control which file	will be	displayed with which
     viewer, based on the file extension.

     A file to be viewed is first transferred to a temporary directory and
     then, if necessary, is decompressed.  The file extension (e.g., ".gif")
     is	then examined to determine which viewer	the file is to be displayed
     in.  There	are two	types of viewers: the viewer built into	LLNL XFTP
     (which is suitable	for displaying text files) and external	viewers	(e.g.,
     emacs for text and xv for graphics).

     Single-click on an	entry in the Extensions	list to	place that extension
     and its associated	command	line into the Extension and Viewer Command
     Line text fields, respectively.

     An	extension is a file suffix that	begins with a period (".").  A special
     entry in the extensions list, "OTHERS" represents all files that do not
     have their	extension listed (including files with no extensions).

     The pattern "<>" in a command line	is a placeholder for the name of the
     file to be	viewed.	 A blank command line indicates	that the built-in
     viewer is to be used.  To add a new extension to the list,	fill in	the
     Extension and Viewer Command Line text fields and press the Add button.
     If	the text in Extension does not begin with a period, one will be added.
     If	the extension is already in the	list, it will be replaced.

     To	replace	the command line associated with an extension, (1) single-
     click on the list item to select it, (2) edit the command line, and (3)
     press the Replace button.

     To	delete an extension from the list, single-click	on the list item to
     select it and then	press the Delete button.  The "OTHERS" entry cannot be
     deleted (but it's command line can	be replaced).

     Click the Apply button to cause the new changes to take effect.  The OK
     button has	the same effect	as Apply, but the dialog is also closed.  The
     Cancel button undoes the changes made since OK or Apply were last
     pressed.

     The viewer	preferences can	be preserved across LLNL XFTP sessions in a
     text file named ".xftpview" in the	user's home directory (select Save
     Preferences in the main window's Options menu).

LIMITATIONS

     Here are some things to watch out for:

     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.

     Old, buggy	versions of Motif can cause weirdness.

     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.)

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

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

FILES

     /.xftpcache	cache file
     /.xftprc	user preferences
     /.xftpview	viewer preferences
     XFtp		application defaults file

AVAILABILITY

     The sources for LLNL XFTP are tarred and compressed, and are available
     via anonymous ftp:

	 ftp://coral.ocf.llnl.gov/pub/ia/llnlxftp/latest_xftp.tar.Z
	 http://www.llnl.gov/liv_comp/xftp.html

SUPPORT

     Because our resources are limited,	we will	not be able to give 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

COPYRIGHT

     (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.

SEE ALSO

     ftpd(8C)

AUTHOR

	  Neale	G. Smith, Lawrence Livermore National Laboratory