LorgLuath v1.1a

A blazingly fast command-line file index and search tool

https://www.LorgLuath.com
(coming soon)

(c) Richard T.A. Neal, 2026

------------------------------------------------------------------------

Quick Start

Run INSTALL.CMD, accept the default installation directory or type
something else, then reboot when prompted.

Once you've rebooted drop to an OS/2 Command Prompt and type:

> ll /index all

This will create an index for all drives, including any mapped
network drives

You can then search for files by simply typing

> ll tom

This will show all files containing "tom" in the name. If the list is
too long and scrolls off the screen you can use /p to pause:

> ll tom /p

I haven't yet worked out to how account for the fact that the
OS/2 Command Prompt "window" is sometimes larger than the "screen"
(or is it the other way around?!) so this may not work quite as
expected on OS/2 Warp 3. It seems to work fine on Warp 4.52 and
ArcaOS 5.1.2

------------------------------------------------------------------------

Overview

LorgLuath is a fast command-line file search utility designed for
systems where scanning the filesystem for every search is too slow.

Instead of searching the disk each time, LorgLuath builds a compact
binary index of the filesystem. Searches are then performed against the
index, making them extremely fast even on older hardware.

The project has two platform implementations:
 -  OS/2 version - written in C using IBM C Set++
 -  Windows version - written in VB.NET and using SQLite

Both versions aim to behave the same from the user's perspective.

LorgLuath is designed to:
 -  search extremely quickly
 -  use very little memory
 -  work well on older systems
 -  remain simple and robust

Why LorgLuath?
"LorgLuath" is Scottish Gaelic and roughly translates as:

    "Fast Find"

The name reflects the core goal of the tool: incredibly fast file searching.
(Or maybe it was just the first available domain name I could find...)
------------------------------------------------------------------------

Installation

1. Run the installer:
   INSTALL.CMD

2. The installer will:
    - create the installation directory if needed (default: C:\LorgLuath)
    - back up CONFIG.SYS to CONFIG.LL1 / CONFIG.LL2 etc
    - update the system PATH to include the installation directory
    - add:
      SET LorgLuath=C:\[installation directory]

3. Reboot only if the installer reports that CONFIG.SYS was modified.

------------------------------------------------------------------------

Runtime Files

LorgLuath stores its files in the directory specified by:

    %LorgLuath%

If this environment variable is not set, the current directory is used.

Files created:

    LorgLuath.db     file index database
    LorgLuath.log    log file
    LorgLuath.ini    configuration file

------------------------------------------------------------------------

Basic Usage

To build the index:

    ll /index c:

To index all drives:

    ll /index all

To update an existing index:

    ll /update

To check database integrity:

    ll /verify

To view index statistics:

    ll /status

------------------------------------------------------------------------

Searching

Basic search:

    ll searchterm

Example:

    ll tom

Wildcard searches:

    ll tom*
    ll *tom
    ll *.txt

Search switches:

    /f        folder names only
    /d:c,d    restrict search to specific drives
    /c        case sensitive search
    /path     restrict results to current path subtree
    /p        pause after each screen

Examples:

    ll /f temp
    ll /d:c,d report
    ll /path tom

------------------------------------------------------------------------

Pausing

When pausing is enabled:

Press SPACE or ENTER to load the next screen
Paging uses the current console height rather than a fixed page size.
A temporary Warp 3 paging safety hack used in v0.37/v0.37a has been
removed in v1.0 because it made paging happen too early in other
situations, especially full-screen sessions.
Press Ctrl-C to cancel the search and return to the command line

------------------------------------------------------------------------

Configuration (LorgLuath.ini)

Example configuration file:

    LLVersion=1.0
    AlwaysPause=No
    HighlightColour=Red

Settings:

AlwaysPause

    If enabled, results pause after each screen.
    Equivalent to always using the /p switch.

Accepted values:

    Yes / No
    On / Off
    1 / 0

HighlightColour

Sets the colour used for highlighting the matched search term.

Supported colours:

    Black
    Blue
    Green
    Cyan
    Red
    Magenta
    Yellow
    White

------------------------------------------------------------------------

Upgrading

Run the INSTALL.CMD and make sure you select the same installation
directory. This will preserve your existing LorgLuath.ini

------------------------------------------------------------------------

Removing LorgLuath Manually

To remove LorgLuath:

1. Delete the installation directory, for example:

    C:\LorgLuath

2. Edit CONFIG.SYS and remove:
     - the directory from the PATH statement
     - the line:
       SET LorgLuath=C:\[installation directory]

3. Reboot (to clear the environment variables from memory)

------------------------------------------------------------------------

End of file
