## LTOOLS Help

## Using LTOOLS's graphical user interface LREADsrv with your web browser

- Start your favorite web browser.
- Set the address location to 'http://localhost', if LREADsrv is on your local machine.
- Use your server's IP address or hostname, if LREADsrv is on a remote machine.
- Note: To use LTOOLS on a remote machine, LTOOLS have to be configured appropriately (see below).
- Note: If LREADsrv is not using default port number 80 (see below), you must use 'http://hostname:portnumber'.
- Note:If LREADsrv runs under a UNIX operating system instead under DOS/Windows, in the following please substitute the term UNIX where you read DOS/Windows
- Note:Copying files from DOS to LINUX or vice versa via the graphical user interface is slow. For large or multiple files you might consider using the command line tools lread.bat and lwrite.bat instead.

After successfully connecting to LREADsrv, you should see the listing of Linux's root directory, e.g.:

LTOOLS LINUX Directory / |  |  |  |

     ..                                  drwxr-xr-x    0    0      1024 Mon Mar 15 11:04:35 1999
     lost+found                          drwxr-xr-x    0    0     12288 Tue Jan 19 10:39:24 1999
     readme.txt                          -rwxrwxrwx   55  222     17546 Mon Feb 01 03:33:30 1999
    ...

Meaning of the icons: Linux Directory : Normal file : Symbolic link: Device file : DOS Directory :
Switching to DOS:

- Click on the DOS button to see a listing of DOS's root directory:

- Note: If LREADsrv is running on a remote machine, this will browse the remote machine's DOS directory, not your local one.

  LTOOLS DOS Directory / |  |  |  |

       windows                                  0   28.02.1997
       bootlog.txt                          13334   30.03.1998
      ...

  Navigating:
  - To change to a subdirectory, click on the subdirectory's name or icon.
  - To change to the parent directory, click on the directory named '..'.
  - To load a file to your local machine, click on the filename or icon.
  - To change to DOS, click on the DOS button.
  - To change to LINUX, click on the LINUX button.
- Note: Whenever possible, navigate as described and do not use your web browser's 'Forward' and 'Back' tabs to help LREADsrv keep track where you are.
  Modifying or deleting Linux files
  - Click on the 'MODIFY' icon. A HTML form will show up.
  - If you want to delete a file, select the checkbox in the '... delete ...' field and click 'OK to modify or delete'
  - To modify UID, GID and the access rights, fill in the appropriate values in the text fields and click 'OK to modify or delete'.
  - Leave empty all fields, which you do not want to change.
  - Click on 'Cancel' to go back to the directory without modifications.
  Creating Linux directories or symlinks
  - Click on the 'NEW' icon. A HTML form will show up.
  - Enter the name of the new directory or symlink including the full path.
  - If you want to create a directory, select the radio button 'Directory'.
  - If you want to create a symbolic link, select the radio button 'Symlink' and enter the symbolic link's target.
  - Click 'OK to create the directory or symlink.
  - Click on 'Cancel' to abort.
  Selecting another DOS or LINUX drive
  - Click on the 'DRIVE' icon. A HTML form will show up.
  - If you want to change the LINUX drive, enter a LINUX drive name (including a partition number), eg. /dev/hdb8 and click 'OK to change'
  - If you want to change the DOS drive, enter a DOS drive name, eg. C: and click 'OK to change'
  - Click on 'Cancel' to leave the drive name unchanged.
  Copying files from DOS to LINUX and
  - In LINUX's directory view navigate to the LINUX directory, where you want to copy the file to.
  - In DOS's directory go to the directory, where the file, which you want to copy, resides.
  - In the line of the file click on the 'WRITE' icon. A HTML form will show up.
  - Fill out the appropriate fields. Leave empty fields to accept default values.
  - Click on 'OK to write' to start the copy process.
  - Click on 'Cancel' to go back to the directory without copying files.
- Note: If you know the file and pathnames you can click on write at any point and directly enter them without navigating to the directories.
- Note: You can only copy one file at a time, wildcards cannot be used.
- Note: For security reasons, 'WRITE' only works on the host, where LREADsrv is running. You cannot upload files to remote machines!

  ## Configuring LTOOLS's graphical user interface LREADsrv

  - LREADsrv requires network protocol TCP/IP to be installed.
  - Start LREADsrv by typing 'LREADsrv' from your command line.
  - Note: Files named 'zzz...htm' and 'zzz...gif' must be in the same directory as LREADsrv.exe. The executables LDIR.exe, LREAD.BAT, ... must either be in the same directory or on your Windows path. Environment variables 'LDRIVE' and 'LDIR' must have been set appropriately (see file README.txt). Users can change the LINUX drive using the 'DRIVE' button.
  - LREADsrv simulates a simple HTTP server running under Windows 9x or NT and issues LTOOLS commands to get files from LINUX. You can also compile and run the LTOOLS toolsuite under various UNIX operating systems including Solaris (read the file readme.txt for details).
  - If you do not want to use the standard HTTP server port number 80, start with 'LREADsrv portnumber', eg. 'LREADsrv 1234'
  - Note: Portnumber 80 is the standard for HTTP servers. If you're already running a HTTP server, you must specify a different number here. You probably should use a number above 1024.
  - Note: If you use this feature, your users must use this port number each time when connecting (see above).
  - In default mode, LREADsrv does only allow connects from the local machine (IP=127.0.0.1='localhost'). If you want to allow remote access, you may specify the remote machine's IP number when starting LREADsrv, eg. 'LREADsrv 80 192.128.92.3 192.128.92.4'
  - Note: Up to 3 IP numbers can be specified. You cannot use hostnames here. When using this feature, you must specify the portnumber, even if it is the default 80.
  - Note: Users of these remote machines can see Linux directory listings, read (download) Linux files and modify GID, UID and access rights, but they cannot write (upload) files from their machine to LINUX.
  - LREADsrv does not completely implement HTTP protocol 1.0, so it may fail with certain combinations of operating systems and web browsers. It was successfully tested with Windows 95, version b and c, and with Windows NT 4.0, service pack 3. As web browsers we used Internet Explorer 4.0 and Netscape Navigator 4.5. Go to README.txt for further reading.
  - You can stop LREADsrv by pressing CTRL-Break

  LREADsrv is ALPHA software, published under the GNU Public License (GPL). You are invited to help us debugging and improving it. Please send bug reports and bug fixes with a clear description of what has happened and what you have done.
  ENJOY!
  Werner Zimmermann
  FHTE Esslingen - University of Applied Sciences Esslingen, Germany
  March 2003

  GO BACK Use this, to go back to the previous directory listing (Note: This only works when connected to LREADsrv).