Usage - Description - Example - Options - Limitations - Return codes
lsx [log logfile] [options] [directory]
lsx is an alternative directory lister, for directories with many files with the same basename(s) but with different extensions, for example directories containing C programming projects.
By default, lsx recognizes the extensions .h .c .obj, but is configurable (see -x option) to any set of 1-10 extensions.
lsx writes directory contents to standard output.
lsx writes error messages to standard error (or logfile, if given).
For example, if the current directory contains:
TRANS.C
TCOLS.OBJ
MAKEFILE
TCOLS.C
TROWS.C
EVAL.H
TREE.H
TREE.OBJ
PARSER.OBJ
TRANS.OBJ
TESTCOLS (dir)
TESTROWS (dir)
EVAL.OBJ
PARSER.C
TROWS.OBJ
EVAL.C
TRANS.H
PARSER.H
TREE.C
then the command:
lsx -f -d
prints the following:
EVAL .H .C .OBJ
PARSER .H .C .OBJ
TCOLS .C .OBJ
TRANS .H .C .OBJ
TREE .H .C .OBJ
TROWS .C .OBJ
MAKEFILE
. (dir)
.. (dir)
TESTCOLS (dir)
TESTROWS (dir)
lsx recognizes the following command line options:
| Option | Function |
|---|---|
| -x=ext/ext/... | Set (up to 10) extensions to be
recognized. (Don't include . in extensions.) For, say, a directory with a C++ Windows programming project, you could use the command: lsx -x=h/cpp/obj/rc |
| -f | Also list files that don't have sought extensions. |
| -d | Also list directories. |
| -r | List read-only files in red, others in green. |
| -l | List all file names in lower case. |
| -u | List all file names in upper case. |
| -v | Print version banner and usage info to standard error (or logfile, if given), then exit. |
lsx handles directories of up to 1000 entries.
The DOS version of lsx doesn't display long file names properly; the Win32 version does.
To use the -r option:
lsx requires a colour display.
If you're running the DOS version of lsx, the ANSI.SYS driver must be loaded. If not already present, add the following line (typically) to your "config.sys" file:
DEVICE=C:\DOS\ANSI.SYS
If you're running the Win32 version of lsx, no special setup is necessary.
lsx returns with one of the following codes ("error levels"):
| Code | Meaning |
|---|---|
| 0 | Success |
| 101 | Out of memory |
| 102 | Incorrect command line arguments |
| 104 | Error opening file |
| 105 | I/O error |
| 106 | Capacity overrun |
| 107 | File name clash |
| 110 | Failed to get standard output handle |