NAME

       hls - list files in an HFS directory

SYNOPSIS

       hls [options] [hfs-path ...]

DESCRIPTION

       hls  lists  files and directories contained in an HFS volume. If one or more arguments are
       given, each specified file or directory is shown; otherwise, the contents of  the  current
       working directory are shown.

OPTIONS

       -1     Output  is  formatted  such  that  each entry appears on a single line. This is the
              default when stdout is not a terminal.

       -a     All files and directories are shown,  including  "invisible"  files,  as  would  be
              perceived  by  the  Macintosh  Finder.  Normally  invisible  files are omitted from
              directory listings.

       -b     Special characters are displayed in an escaped backslash notation. Normally special
              or non-printable characters in filenames are replaced by a question mark (?).

       -c     Sort  and  display  entries  by their creation date, rather than their modification
              date.

       -d     List directory entries themselves rather than their contents. Normally the contents
              are shown for named directories on the command-line.

       -f     Do  not  sort  directory  contents;  list  them  in  the  order  they appear in the
              directory. This option effectively enables -a and -U and disables -l, -s, and -t.

       -i     Show the catalog IDs for each entry. Every file and directory on an HFS volume  has
              a unique catalog ID.

       -l     Display entries in long format. This format shows the entry type ("d" for directory
              or "f" for file), flags ("i" for invisible), file type and creator  (four-character
              strings  for  files  only), size (number of directory sub-contents or file resource
              and data bytes, respectively), date of last  modification  (or  creation,  with  -c
              flag), and pathname. Macintosh "locked" files are indicated by "F" in place of "f".

       -m     Display entries in a continuous format separated by commas.

       -q     Replace  special  and non-printable characters in displayed filenames with question
              marks (?). This is the default when stdout is connected to a terminal.

       -r     Sort entries in reverse order before displaying.

       -s     Show the file size for each entry in 1K block units. The size includes blocks  used
              for both data and resource forks.

       -t     Sort  and  display  entries  by  time.  Normally files will be sorted by name. This
              option uses the last modification date to sort unless -c is also specified.

       -x     Display entries in column format like -C, but sorted horizontally into rows  rather
              than columns.

       -w width
              Format  output  lines  suitable for display in the given width.  Normally the width
              will be determined from your terminal, from the environment  variable  COLUMNS,  or
              from a default value of 80.

       -C     Display  entries  in  column  format  with  entries  sorted vertically. This is the
              default output format when stdout is connected to a terminal.

       -F     Cause certain output filenames to be followed by a single-character flag indicating
              the  nature  of  the  entry; directories are followed by a colon (:) and executable
              Macintosh applications are followed by an asterisk (*).

       -N     Cause all filenames to be output verbatim without  any  escaping  or  question-mark
              substitution.

       -Q     Cause  all  filenames  to  be  enclosed  within  double-quotes (") and special/non-
              printable characters to be properly escaped.

       -R     For each directory that is encountered in a listing, recursively descend  into  and
              display its contents.

       -S     Sort and display entries by size. For files, the combined resource and data lengths
              are used to compute a file's size.

       -U     Do not sort directory  contents;  list  them  in  the  order  they  appear  in  the
              directory.  On  HFS  volumes,  this  is  usually  an  alphabetical case-insensitive
              ordering, although there are some idiosyncrasies to the Macintosh implementation of
              ordering. This option does not affect -a, -l, or -s.

SEE ALSO

       hfsutils(1), hcd(1), hpwd(1), hdir(1), hcopy(1)

FILES

       $HOME/.hcwd

AUTHOR

       Robert Leslie <rob@mars.org>