lc(1)                 MPE/iX Shell and Utilities                 lc(1)
  ______________________________________________________________________

  NAME
       lc -- list file system elements in categories

  SYNOPSIS
       lc [-adfn1] [directory ...]

  DESCRIPTION
       lc is an alternative to the UNIX ls command and the DOS dir com-
       mand.  It distinguishes its output by type -- generally files or
       directories.  lc displays names in columns, sorted horizontally.

  Options
       lc accepts the following options:

       -a   display files and directories the names of which begin with
            ..  These path names are not usually shown.

       -d   displays directories only.

       -f   displays files only.

       -n   suppresses all output.  This is useful when you only want to
            use the exit status.

       -1   displays one file per line.

  DIAGNOSTICS
       Possible exit status values are:

       0  lc successfully found files under the specified directory and
          displayed their names.

       1  directory contains no files or subdirectories.  For example,
          you can use the option combination -nd to determine if a
          directory has any subdirectories.

       2  Failure because of an invalid command line option or insuffi-
          cient memory.

       Under rare conditions, lc cannot identify the type of a file.
       Such files are listed under the category **GOK**.

  Messages

       Message:  directory: Component `name' makes path name too long.
       Cause:    The name component of the specified path name makes the
                 overall path name longer than the maximum length indi-
                 cated by the configuration variable PATH_MAX.
       Action:   Use cd to move deeper into the directory structure and
                 try lc again.  This should result in a shorter overall
                 path name.

                                                                       1

  lc(1)                 MPE/iX Shell and Utilities                 lc(1)
  ______________________________________________________________________

       Message:  directory: Path name component too long
       Cause:    You specified a directory with a name that was longer
                 than the maximum length indicated by the configuration
                 variable PATH_MAX.  The specified directory is invalid,
                 since no directory can exist with a path name that
                 long.
       Action:   Specify a valid directory.

       Message:  insufficient memory
       Cause:    There were not enough free system resources to perform
                 the requested operation.
       Action:   Free up more resources.

       Message:  strcoll error, cannot malloc space.
       Cause:    There are not enough free system resources to allocate
                 string space.
       Action:   Free up more resources.

       Message:  Unknown option "-option"
       Cause:    You specified an option that is not valid for lc.
       Action:   Check the DESCRIPTION section of this man page for a
                 list of valid lc options.

  PORTABILITY
       A frequent add-on to UNIX systems.

  MPE/iX NOTES
       For information on how the current MPE/iX implementation may
       affect the operation of this utility, see Appendix A, MPE/iX
       Implementation Considerations.

  SEE ALSO
       c(1), ls(1)

                                                                       2