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>