packages icon



 xdir(1)                                                             xdir(1)
                               10 January 1995



 NAME
      LLNL XDIR - A graphical network-oriented file manager


 SYNOPSIS
      xdir [standard X Window options]


 DESCRIPTION
      LLNL XDIR provides a graphical user interface for file transfer and
      for direct manipulation of local and remote directories on UNIX (and a
      number of non-UNIX) platforms.  LLNL XDIR offers the ability to view
      directory information in four different formats, ranging from long
      lists to tree structures.  LLNL XDIR is based on UNIX, the C
      programming language, OSF/Motif and FTP; hence, LLNL XDIR is highly
      portable.

      With LLNL XDIR, you can manage virtually all of your files in a
      network.  Specifically, LLNL XDIR can be used to browse directory
      structures, transfer files and directories, view local and remote
      files, delete files and directories, rename files and directories, and
      search directories on one or more hosts for entries matching a
      specified pattern.

      LLNL XDIR simultaneously displays any number of directories of any
      number of (local or remote) hosts, with each directory being displayed
      in its own window.  Several existing products are able to manage files
      on a single system, but LLNL XDIR extends this capability to manage
      files on an entire network.

      LLNL XDIR does not have a "main" window, as such, but instead consists
      of a number of windows, each of which displays the contents of a local
      or remote host's directory.  Each of these "directory windows" has a
      complete set of controls for setting modes and invoking operations.
      Several other windows are provided for setting general preferences and
      displaying diagnostic information.

      LLNL XDIR offers elaborate directory-browsing functionality.  Each
      directory can be viewed in several different formats, ranging from
      long lists to tree structures.  A number of mechanisms are provided to
      traverse directory structures, including: (1) double-clicking a
      directory name/icon to enter that directory, (2) a "go to parent
      directory" button, (3) a "go to home directory" button, and (4) a
      sophisticated history mechanism for easily reentering previously
      visited directories.

      LLNL XDIR provides powerful file transfer capability using drag-and-
      drop.  It is just as easy to copy a file between two remote systems as
      it is to copy a file from the local host to itself.  Files and
      directories may be transferred either singly or in groups with just a
      few movements of the mouse.



                                    - 1 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      One of LLNL XDIR's most powerful features is its ability to search
      directory structures for entry names matching a specified pattern.
      You are able to specify the range and depth of such searches.  The
      search can be restricted to a single subdirectory or can extend across
      machine boundaries.

      With LLNL XDIR, you are able to view local or remote files, using
      either the built-in viewer or any combination of external viewers of
      your choice (e.g., emacs or xv).

      LLNL XDIR's history mechanism makes it simple to establish a
      connection with a remote host.  This and other features make it
      especially painless to connect to an anonymous FTP site.

      A number of directory-manipulation features are provided for operating
      on selected entries.  There are several ways to select a group of
      directory entries to operate on, including direct toggling of entries,
      sweeping out a rectangular area, and wildcard selection.  Once entries
      are selected, you are able to rename entries, delete entries
      (including entire subdirectories), or move entries between directories
      within the same host.  You are also able to create directories, both
      on local and remote hosts.

      LLNL XDIR utilizes a history mechanism for automatically caching (1)
      wildcard expressions used in selecting directory entries, (2)
      previously visited directories, and (3) host/user name pairs used in
      connecting to remote hosts.  The purpose of each cache is to reduce
      the amount of typing and mouse movement required.  For example, when
      you wish to apply a wildcard expression to select directory entries to
      operate on, a list of recently referenced wildcard expressions for
      that host will be presented; you can then double-click on an existing
      wildcard expression to apply it.  The caches are automatically
      preserved across LLNL XDIR sessions.

      LLNL XDIR presents a graphical user interface for easily tailoring the
      program's behavior.  You are able to specify such things as whether
      you would like the delete operation to first pop up a verification
      dialog listing the entries to be deleted.

      Finally, an extensive on-line help facility, much of which is
      contextual, is provided.  However, experience has shown that the user
      interface is so intuitive that the user rarely needs to access the
      help package.


 GETTING STARTED
      When LLNL XDIR is started, a window appears that displays the contents
      of a directory on the local host.  This window is called a "directory
      window."  You can have any number of directory windows for any number
      of hosts.




                                    - 2 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      Use the Connect menu to connect to a remote host.  Select Connect to
      Anonymous to connect to an anonymous FTP site.  Choose Connect to
      Remote to connect to other remote hosts.  A directory window will be
      created for the specified host.

      You can use a host's directory window to create another directory
      window for that host,  First make sure that tunneling mode is off for
      that directory window (using the tunnel icon in the toolbar).  Then,
      simply change to another undisplayed directory by using any of the
      following techniques: (1) double-click an entry name or icon that
      represents a directory, (2) press the "go to parent directory" button
      (the up-arrow button in the toolbar), (3) press the "go to home
      directory" button (the house button in the toolbar), or (4) select an
      item in the Goto menu.  If tunneling mode happens to be on, the
      current directory window is used to display the specified directory.

      LLNL XDIR has several mechanisms to aid you in managing a
      proliferation of directory windows: (1) directory windows may be
      individually iconified (using the window manager), (2) all iconified
      LLNL XDIR windows can be redisplayed by selecting Deiconify All in the
      File menu, (3) any request to display a directory that is iconified or
      buried under other windows causes its directory window to be brought
      to the front, and (4) the Wins menu can be used to identify existing
      directory windows and bring them to the front.

      Change between different formats for displaying information within a
      directory window by toggling the layout buttons in the directory
      window's toolbar.

      Many operations require that entries in a directory window first be
      selected.  Select/deselect entries by (1) single-clicking on an entry
      (which toggles its selection state), (2) holding the left mouse button
      down and dragging to sweep out a selection rectangle (which
      individually toggles each entry's selection state), (3) selecting any
      of the items in the directory window's Select menu, or (4) typing a
      sequence of characters into a directory window to select the first
      entry that most closely matches the characters.

      Copy (i.e., transfer) selected entries by using the left mouse button
      to drag the entries.  The drop site of the drag can be (1) the
      background of another directory window, (2) a directory entry in any
      directory window (including the source directory window).
      Directories, as well as files, can be transferred.  LLNL XDIR does not
      permit transfers from a remote host to itself.  The desired file
      transfer mode can be specified by using the option menu in the toolbar
      of any directory window.

      Move selected entries by using the left mouse button to drag the
      entries, and holding down the control key when the mouse button is
      released over the drop site.  (A move differs from a transfer in that
      (1) the source entries are destroyed, and (2) a move is usually



                                    - 3 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      implemented by manipulating file system pointers rather than by
      actually copying bits.)  The drop site of the drag may be (1) the
      background of another directory window, (2) a directory entry in any
      directory window (including the source directory window).  LLNL XDIR
      only allows moves from a host to itself.

      View selected files by selecting View Selected Entries in the
      directory window's Ops menu.  Also, you may double-click on an entry
      that LLNL XDIR knows not to be a directory.  Configure the viewer by
      selecting item Viewer Preferences in the Prefs menu.  Be sure to first
      set the file transfer mode by using the option menu in the toolbar of
      any directory window.

      Delete selected entries by pressing the trash can button in the
      toolbar.  Directories, as well as files, may be deleted.

      Search for an entry that matches a specified wildcard expression by
      selecting Search in the Ops menu.  You are able to specify the range
      and depth of the search.  After a match has been found, you can
      continue the search by selecting Search Again in the Ops menu.

      Some other operations on selected entries may be invoked by selecting
      appropriate items in the directory window's Ops menu.

      Configure LLNL XDIR by selecting the General Preferences item in the
      Prefs menu.


 DIRECTORY WINDOW TOOLBAR
      Each directory window has a toolbar that can be used to set modes and
      to invoke operations.  From left to right, the toolbar controls are:

      Transfer Mode  (Option menu)
           The option menu at the left allows you to choose the file
           transfer mode (ASCII or Binary).  This mode is global in scope;
           hence, changing the value in one directory window will
           automatically change the value in all directory windows.

      Layout Mode  (Group of four buttons)
           The layout mode controls how the directory entries are displayed.
           The first button selects "Tabular Layout," in which only the
           entry names are displayed.  The second button selects "Iconic
           Layout," in which an icon and name is displayed for each entry.
           In Iconic Layout, five different icons are used to identify the
           entry type: directory, executable file, generic file, socket, and
           link.  The third button selects "Tree Layout," which is similar
           to Iconic Layout except that each entry that is a directory also
           has a small diamond-shaped button, which can be used to expand
           and collapse the subdirectory.  The last button selects "Full
           Info Layout," which displays as much information about each
           directory entry as possible (the amount of information available



                                    - 4 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           is limited by the host's FTP server).

      Tunneling Mode  (Button with picture of tunnel)
           If "tunneling mode" is off, entering a directory that is not
           already displayed will cause a new window to be created to
           display that directory.  If tunneling mode is on, an existing
           directory window (the one from the which the command was invoked)
           will be used to display a directory that does not already have it
           own window.

      Dot Files Mode  (Button with dot in dog-eared page)
           If "dot files mode" is on, then entry names that begin with a dot
           (i.e., period) will be displayed.

      Refresh Directory  (Button with starburst shape)
           Redisplay this window's directory.

      Go To Parent  (Up arrow button)
           Display this window's parent directory.

      Go To Home   (House button)
           Display the home directory of this directory window's host.

      Delete  (Trash can button)
           Delete selected directory entries.

      Make Directory  (Button containing folder labeled "New")
           Create a directory.

      Close  (Skull and cross bones button)
           Get rid of this directory window.


 DIRECTORY WINDOW COMMANDS
      LLNL XDIR contains a large number of commands that can be invoked from
      the directory windows.  Most commands are invoked (1) from the menus,
      (2) from the toolbars, and (3) by dragging and dropping directory
      entries.  Here is a list of the commands:

      About LLNL XDIR (in File menu)
           Give version information.

      Close (in File menu and toolbar)
           Remove (not iconify) this directory window.  If this directory
           window is the last for its host, the host is disconnected.

      Connect to Anonymous (in Connect menu)
           Easily connect to an anonymous FTP site.  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 general preference Anonymous Ftp Password



                                    - 5 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           (which you will probably want to set to your email address).  If
           the general preference Anonymous Ftp Password is blank, LLNL XDIR
           will attempt to create a password of the form "user@host".  An
           optional, space-delimited port number may follow the host name.
           Previously used host/user name pairs are cached, and those with
           user names "anonymous" or "ftp" are displayed in the scrolled
           list 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.  (If already connected, a directory window
           for that host is simply brought to the front.)  (See general
           preferences Add to Cache, Anonymous Ftp Password, Host Cache
           Size, User Cache Size, and Sort Caches.)

      Connect to Local (in Connect menu)
           Connect to the local host (i.e., the host upon which LLNL XDIR is
           executing).  If already connected, an existing directory window
           for the local host is brought to the front.

      Connect to Remote (in Connect menu)
           Connect to a remote host (use Connect to Anonymous to more easily
           connect to an anonymous FTP site).  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,
           space-delimited port number may follow the host name.  Previously
           used host/user name pairs are cached, and those with user names
           other than "anonymous" and "ftp" are displayed in the scrolled
           list 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.  (If already connected, a directory window
           for the host is simply popped to the top.)  (See general
           preferences Add to Cache, 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.  Click on any graphical element in the directory
           window that you wish to know more about.

      Copy (drag-and-drop operation)
           Copy (i.e., transfer) the selected files according to the mode
           (ASCII or Binary) specified in the toolbar's file transfer mode
           option menu.  Copy selected items by using the left mouse button
           to drag the items.  The drop site of the drag can be (1) the
           background of another directory window, (2) a directory entry in
           any directory window (including the source directory window).
           Directories, as well as files, can be transferred (but the
           general preference Copy Mode must be set to Recursive).  LLNL



                                    - 6 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           XDIR does not permit transfers from a remote host to itself.  The
           desired file transfer mode can be specified via the option menu
           in the toolbar of any directory window.  Set general preference
           Copy Mode to Recursive to allow copying of directories.  A dialog
           pops up to enable the user to monitor the progress of the
           transfers.  This dialog contains a button for aborting the
           transfers.  (See general preferences Beep When Ops Done, Copy
           Mode, Initial Transfer Mode, and Inquire On Copy.)

      Delete Selected Entries (in Ops menu and toolbar)
           Delete the selected entries.  Set general preference Delete Mode
           to Recursive to allow deletion of nonempty directories.  A dialog
           pops up to enable the user to monitor the progress of the
           deletions.  This dialog contains a button for aborting the
           deletions.  (See general preferences Beep When Ops Done, Delete
           Mode and Inquire On Delete.)

      Deselect All Entries (in Select menu)
           Deselect all the entries in this directory window.

      Deiconify All (in File menu)
           Deiconify all top-level windows in the application.

      Diagnostics (in Wins menu)
           Display the diagnostics window.

      Disconnect (in Connect menu)
           Terminate the connection to this directory window's host.  All
           directory windows associated with this host are closed.

      Getting Started (in Help menu)
           Learn how to get started using LLNL XDIR.

      General Preferences (in Prefs menu)
           Display the General Preferences window.  See section General
           Preferences for details.

      Go to Directory (in Goto menu)
           Display a directory.  A dialog pops up to prompt for the
           directory path.  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 display that directory.  Single click on a path in the
           list to place that entry into text field Directory, where it can
           be edited.  Click on the OK button to change to the directory
           displayed in the text field.  (See general preferences Add to
           Cache, Directory Cache Size, Host Cache Size, and Sort Caches.)

      Go to Home Directory (in Goto menu and toolbar)
           Display the home directory of this directory window's host.




                                    - 7 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      Go to Parent Directory (in Goto menu and toolbar)
           Display the parent directory of this directory window.

      Iconify All (in File menu)
           Iconify all top-level windows in the application.

      Launch (submenu in Ops menu)
           Launch application as a child process.  Select a command name in
           the Launch submenu to fork and exec the associated command.  See
           section Launcher Preferences for details on constructing
           commands.) When a command is launched, placeholders are replaced
           by their values as follows: "%u" is replaced by the user name,
           "%h" is replaced by the host name, "%s" is replaced by the name
           of a selected entry, and "%l" is replaced by the blank-delimited
           names of all selected entries.  If "%s" is used, then the command
           is launched once for each selected entry, each time "%s" being
           replaced by the full path of the next selected entry name.

      Launcher Preferences (in Prefs menu)
           Display the Launcher Preferences window.  See section Launcher
           Preferences for details.

      LLNL XDIR Overview (in Help menu)
           Give a high-level description of LLNL XDIR.

      Make Directory (in Ops menu and toolbar)
           Pop up a dialog to prompt for the name of a directory to create
           in the displayed directory.

      Move (drag-and-drop operation)
           Move selected entries from one directory to another on the same
           host.  Move selected items by using the left mouse button to drag
           the items, and holding down the control key when the mouse button
           is released over the drop site.  (A move differs from a transfer
           in that (1) the source entries are destroyed, and (2) a move is
           usually implemented by manipulating file system pointers rather
           than by actually copying bits.) The drop site of the drag can be
           (1) the background of another directory window, and (2) a
           directory entry in any directory window (including the source
           directory window).  LLNL XDIR only allows moves from a host to
           itself.  A dialog pops up to enable the user to monitor the
           progress of the moves.  This dialog contains a button for
           aborting the move operations.  (See general preferences Beep When
           Ops Done, and Inquire on Move.)

      Quit (in File menu)
           Terminate the application.

      Refresh Directory (in Ops menu)
           Redisplay this window's directory.




                                    - 8 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      Rename Selected Entries (in Ops menu)
           Pop up a dialog to individually rename selected entries.

      Save Preferences (in Prefs menu)
           Save the current settings of the general, viewer, and launcher
           preferences.

      Search (in Ops menu)
           Pop up a dialog to initiate a search of directory windows for
           entry names that match a specified pattern.  The pattern to be
           matched can contain the usual wildcard characters ('*', '?', '[',
           and ']').  The toggle item Match Case controls whether case
           (upper or lower) should be considered when looking for a match.
           The Maximum Search Depth slider is used to specify the maximum
           number of directory levels the search command will explore when
           looking for an entry that matches the specified pattern.  Choose
           one of the toggle items, Search this directory, Search all
           displayed directories of this host, or Search all displayed
           directories of all hosts, to specify which directory windows (and
           their descendants) are to be searched.

           When the OK button is pressed, a dialog appears to monitor the
           progress of the search.  This dialog contains a button that can
           be used to abort the search.

           If a match is found in a directory that is already displayed, the
           entry is selected, scrolled into view, and its directory window
           is brought to the front.  If a match is found in a directory that
           is not already displayed, there are two cases: If the search was
           initiated from a directory window with tunneling mode on, the
           entry's directory is displayed in that directory window;
           otherwise a new window is created to display the entry's
           directory.

           Use Search Again to continue the search once an entry has been
           found.  (See general preferences Beep When Ops Done, Initial Max
           Search Depth, Initial Search Case Match, and Initial Search
           Range).

      Search Again (in Ops menu)
           Search for the next entry that satisfies the search criteria
           specified by the last search command.  (See general preference
           Beep When Ops Done).

      Select All Entries (in Select menu)
           Select all the entries in this window.

      Send Quoted Command (in Ops menu)
           Pop 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



                                    - 9 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           in the list issues that command.  To have a command act on
           selected entries, use the quote placeholder ("%s") to represent a
           selected item.  For example, type "stage 1 %s" to send a STAGE
           command to the the remote host for each selected entry.  (See
           general preference Beep When Ops Done.)

      Use Wildcard (in Select menu)
           Pop up a dialog to prompt for a wildcard expression to use in
           selecting entries in this directory window.  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 Selection to cause the currently
           selected entries to be cleared before applying the wildcard.
           Choose the toggle item Add to Selection to cause the entries
           selected by the wildcard to be added to the current selection.
           (See general preference Initial Wildcard Mode).

      Using Help (in Help menu)
           Describe the online help package.

      View Selected Files (in Ops menu)
           Display the selected files.  The viewer preferences dialog
           (accessible via the Prefs menu) can be used to control whether
           files 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").

           The file is transferred according to the mode (ASCII or Binary)
           specified in the toolbar of the directory window.  A dialog pops
           up to enable the user to monitor the progress of the transfer.
           This 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
           "/usr/include/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 XDIR.

           If the file is recognized as being compressed, it is expanded
           before viewing.  LLNL XDIR 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 XDIR searches for the decompressor application in the
           standard way using the PATH environment variable.

      Viewer Preferences (in Prefs menus)
           Display the viewer preferences window.  See section Viewer



                                   - 10 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           Preferences for details.


 GENERAL PREFERENCES
      Selecting item General Preferences in a directory window's Prefs menu
      pops up a dialog that allows you to configure LLNL XDIR according to
      your preferences.  You are 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 XDIR sessions
      in a text file named ".xdirrc" in your home directory.  You may alter
      the order the preferences are presented in the dialog by (1)
      terminating LLNL XDIR, (2) using a text editor to change the order of
      lines in ".xdirrc" and (3) restarting LLNL XDIR.

      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.  If
           the value is blank, LLNL XDIR attempts to construct a password of
           the form "user@host".  The Connect to Anonymous dialog is
           accessible via each directory window's Connect menu.

      Auto Refresh
           Specifies whether to automatically refresh a directory window
           when it is brought to the front in response to a directory
           display request.

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

      Copy Mode
           Specifies whether to allow recursive file transfers.

      Delete Mode
           Specifies whether to allow recursive delete operations.

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




                                   - 11 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



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

      Initial Diagnostics
           The default level of diagnostics information to be written to the
           diagnostics 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.

      Initial Directory Layout
           The layout used by the first created directory window.  Each
           subsequently created directory window inherits its directory
           layout mode from its parent directory window.

      Initial Dot Files Mode
           Specifies whether the first created directory window will display
           dot files.  Each subsequently created directory window inherits
           its dot files mode from its parent directory window.

      Initial Max Search Depth
           The default maximum number of directory levels the search command
           will explore when looking for an entry that matches the specified
           pattern.

      Initial Search Case Match
           The default value that specifies whether the search command
           should consider case when looking for an entry that matches the
           specified pattern.

      Initial Search Range
           The default value used as the search range in the Search dialog.
           Choose This Dir to make Search this directory the default.
           Choose This Host to make Search all displayed directories of this
           host the default.  Choose All Hosts to make Search all displayed
           directories of all hosts the default.

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

      Initial Tunneling Mode
           The default tunneling mode.  Tunneling mode controls whether or
           not a new directory window is created to display a directory.

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



                                   - 12 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



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

      Inquire On Delete
           Specifies whether to pop up a dialog that asks the user to
           confirm that the indicated delete operations 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 Quoted Cmd
           Specifies whether to pop up a dialog that asks the user to
           confirm that the indicated commands should be sent.

      Max Ftp Retries
           Specifies the maximum number of retries LLNL XDIR 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 XDIR will wait
           for a response from an FTP server before concluding that the
           connection has been broken.

      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 version numbers (at least one
           server does not).

      Print Password In Debug
           Specifies whether to print passwords in the diagnostics window
           when the level of diagnostics messages is set to Debug.

      Quoted Cmd Cache Size
           The number of quoted commands to cache.  The cache is preserved
           across LLNL XDIR sessions.

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

      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



                                   - 13 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



           integer between 1 and 99.

      Type To Select Delay
           The number of milliseconds to wait before LLNL XDIR determines
           that you are finished typing characters into a directory window
           to select the first entry that best matches the characters.

      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), your home directory will be entered.

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

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


 VIEWER PREFERENCES
      Selecting item Viewer Preferences in a directory window's Prefs 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 XDIR (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 "%s" 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.




                                   - 14 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      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 its 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 XDIR sessions in a
      text file named ".xdirrc" in the user's home directory (select Save
      Preferences in a directory window's Prefs menu).


 LAUNCHER PREFERENCES
      Selecting item Launcher Preferences in a directory window's Prefs menu
      pops up a dialog that allows the user to specify commands that can be
      invoked using the Launch submenu of the Ops menu.  The idea is to be
      able to fork and exec child processes with execute lines based on
      information about selected entries.

      Single-click on an entry in the Command Names list to place that
      command name and its associated command line into the Command Name and
      Command Line text fields, respectively.

      The following placeholders can be specified in a command line: "%u"
      for the user name, "%h" for the host name, "%s" for the name of a
      selected entry, and "%l" for the blank-delimited names of all selected
      entries.  To add a new command to the list, fill in the Command Name
      and Command Line text fields and press the Add button.  If the command
      name is already in the list, it will be replaced.

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

      To delete a command from the list, single-click on the list item to
      select it and then press the Delete button.

      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 launcher preferences can be preserved across LLNL XDIR sessions in
      a text file named ".xdirrc" in the user's home directory (select Save
      Preferences in a directory window's Prefs menu).



                                   - 15 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      The names of the commands will be placed in the Launch submenu of the
      Ops menu.  (See command Launch in section Directory Window Commands
      for details on how commands are actually launched.)


 LIMITATIONS
      Here are some things to watch out for:

      LLNL XDIR 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 XDIR 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
      $HOME/.xdircache   cache file
      $HOME/.xdirrc      preferences
      XDir               application defaults file


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

                         IP Address:  phoenix.ocf.llnl.gov
                          Directory:  /llnlxdir


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

                                 llnlxdir@llnl.gov



 COPYRIGHT
      (c) 1995.  The Regents of the University of California.  All rights



                                   - 16 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995



      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 XDIR 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 XDIR 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




                                   - 17 -         Formatted:  March 28, 2024






 xdir(1)                                                             xdir(1)
                               10 January 1995






















































                                   - 18 -         Formatted:  March 28, 2024