LC(1) LC(1)
Usenet Source
NAME
lc - categorize and list directory and file names in columns
SYNOPSIS
lc [ -abcdDefFIlLmMrsS1 ] [ directory ... ]
DESCRIPTION
lc lists the elements of the given directories. The elements are
divided into minimally five basic types (files, directories, character
special files, block special files, and fifos) and are printed in
alphabetical order. They are normally printed column-wise across the
screen, preceded by a title indicating the type. The -1 option can be
used to force single-column untitled output.
lc uses the environment variables LC , CDPATH and COLS to allow you to
set up a default set of display options that lc should use each time
is it run. Options on the command line override options specified in
the environment if there is a conflict. LC is used to set lc specific
options. All command line options shown in the option list below can
be used in setting default options within the environment variable LC.
CDPATH is searched for a file not found at the requested location or
in the current directory. This is an extremely handy feature of lc.
COLS is used to switch the column width between 80 and 132 column
display.
lc has incorporated the minimal spell checking routines found in the
book, The UNIX Programming Environment, by Brian Kernighan and Rob
Pike.
If the command line argument list contains more than one name, the
contents of the directories named in the list are displayed and all
other names are displayed one per line with the type of the file
displayed on the same line. If the -D option is supplied in the
environment or on the command line all non-directory files are
ignored. If no file or directory is specified the current working
directory is listed by default. The special entries ``.'' and ``..''
are not listed.
Not all options are supported on every system. (e.g. no symbolic links
on your system ? Options -s, -I -L or -l won't be available...) On
systems which support symbolic links, the symbolic links are normally
followed, and each prints under the category of the type of file to
which it is linked. If the symbolic link points to a nonexistent path
name, or if you do not have permission to resolve the path name, lc
prints out an error message indicating it cannot resolve the link.
This type of message can be suppressed through the use of the 'I'
option described below.
OPTIONS
-a List dot files as well. Normally lc does not display files
beginning with a '.' unless this option is specified. The system
- 1 - Formatted: June 9, 2026
LC(1) LC(1)
Usenet Source
'.' and '.. files are never displayed since they give you no
real additional information and would just clutter up the
display.
-b List block special files only.
-c List character special files only.
-d List directories only.
-D Do not display singular files. If you do not use this option and
execute "lc /unix", your output will be "/unix: file". This is
useful in shell scripts but is sometimes annoying if you execute
a command such as "lc /usr/lib/*" and all you wish to see is the
first level of directories and not a lot of "filename: file"
messages.
-e Mark executable files with '*'. This options allows you to have
executables displayed with a '*' appended to the end of the file
name.
-f List regular files only.
-F List fifo files only.
-I Do not report unresolved symbolic link messages. Normally lc
prints out a message stating that it cannot resolve the symbolic
link. Use of this option suppresses the display of those
messages.
-l Mark symbolic links with '@'. This options allows you to have
symbolic links displayed with a '@' appended to the end of the
file name.
-L Display symbolic links. This options allows you to have lc
output a display showing what files the symbolic links refer to.
-m List shared memory name space entry files only.
-M List semaphore name space entry files only.
-r List the directory entries as they appear in the directory file.
No sorting of output prior to displaying.
-s List symbolic links only.
-S List AF_UNIX socket files only.
-1 List files one per line instead of in columns.
- 2 - Formatted: June 9, 2026
LC(1) LC(1)
Usenet Source
DIAGNOSTICS
The "only" options can be combined.
The spell checking does not work when the CDPATH is searched for a
file or directory not found in the current directory.
lc does not support recursion but I have never found this to be that
necessary to put in.
$ find directory-to-descend -type d -print | xargs lc
works just fine when recursion is needed.
AUTHOR
Kent Landfield <kent@sparky.IMD.Sterling.COM>
CREDITS
Jeff Minnig <jeff@dsndata>,
Rick Ohnemus <rick@sparky.IMD.Sterling.COM>,
Mike Peterson <root@alchemy.chem.utoronto.ca> and
Ivan Fris <neumann.une.oz.au!ivan>
were a *great* help with this program at different stages
of its development... Thanks!
- 3 - Formatted: June 9, 2026
