Your company here ā€” click to reach over 10,000 unique daily visitors

hls - Man Page

list files in an HFS directory


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


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.



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


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.


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


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


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


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.


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


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".


Display entries in a continuous format separated by commas.


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


Sort entries in reverse order before displaying.


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


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.


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.


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


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 (*).


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


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


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


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


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)




Robert Leslie <rob@mars.org>

Referenced By

hattrib(1), hcd(1), hcopy(1), hdir(1), hfsutils(1), hmkdir(1), hmount(1).

14-Jan-1997 HFSUTILS