hls



HLS(1)                                                                  HLS(1)




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  nota-
              tion.  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 indi-
              cated 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  file-
              names  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 horizon-
              tally 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-char-
              acter 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>



HFSUTILS                          14-Jan-1997                           HLS(1)

Man(1) output converted with man2html