1HLS(1) General Commands Manual HLS(1)
2
3
4
6 hls - list files in an HFS directory
7
9 hls [options] [hfs-path ...]
10
12 hls lists files and directories contained in an HFS volume. If one or
13 more arguments are given, each specified file or directory is shown;
14 otherwise, the contents of the current working directory are shown.
15
17 -1 Output is formatted such that each entry appears on a single
18 line. This is the default when stdout is not a terminal.
19
20 -a All files and directories are shown, including "invisible"
21 files, as would be perceived by the Macintosh Finder. Normally
22 invisible files are omitted from directory listings.
23
24 -b Special characters are displayed in an escaped backslash nota‐
25 tion. Normally special or non-printable characters in filenames
26 are replaced by a question mark (?).
27
28 -c Sort and display entries by their creation date, rather than
29 their modification date.
30
31 -d List directory entries themselves rather than their contents.
32 Normally the contents are shown for named directories on the
33 command-line.
34
35 -f Do not sort directory contents; list them in the order they
36 appear in the directory. This option effectively enables -a and
37 -U and disables -l, -s, and -t.
38
39 -i Show the catalog IDs for each entry. Every file and directory on
40 an HFS volume has a unique catalog ID.
41
42 -l Display entries in long format. This format shows the entry type
43 ("d" for directory or "f" for file), flags ("i" for invisible),
44 file type and creator (four-character strings for files only),
45 size (number of directory sub-contents or file resource and data
46 bytes, respectively), date of last modification (or creation,
47 with -c flag), and pathname. Macintosh "locked" files are indi‐
48 cated by "F" in place of "f".
49
50 -m Display entries in a continuous format separated by commas.
51
52 -q Replace special and non-printable characters in displayed file‐
53 names with question marks (?). This is the default when stdout
54 is connected to a terminal.
55
56 -r Sort entries in reverse order before displaying.
57
58 -s Show the file size for each entry in 1K block units. The size
59 includes blocks used for both data and resource forks.
60
61 -t Sort and display entries by time. Normally files will be sorted
62 by name. This option uses the last modification date to sort
63 unless -c is also specified.
64
65 -x Display entries in column format like -C, but sorted horizon‐
66 tally into rows rather than columns.
67
68 -w width
69 Format output lines suitable for display in the given width.
70 Normally the width will be determined from your terminal, from
71 the environment variable COLUMNS, or from a default value of 80.
72
73 -C Display entries in column format with entries sorted vertically.
74 This is the default output format when stdout is connected to a
75 terminal.
76
77 -F Cause certain output filenames to be followed by a single-char‐
78 acter flag indicating the nature of the entry; directories are
79 followed by a colon (:) and executable Macintosh applications
80 are followed by an asterisk (*).
81
82 -N Cause all filenames to be output verbatim without any escaping
83 or question-mark substitution.
84
85 -Q Cause all filenames to be enclosed within double-quotes (") and
86 special/non-printable characters to be properly escaped.
87
88 -R For each directory that is encountered in a listing, recursively
89 descend into and display its contents.
90
91 -S Sort and display entries by size. For files, the combined
92 resource and data lengths are used to compute a file's size.
93
94 -U Do not sort directory contents; list them in the order they
95 appear in the directory. On HFS volumes, this is usually an
96 alphabetical case-insensitive ordering, although there are some
97 idiosyncrasies to the Macintosh implementation of ordering. This
98 option does not affect -a, -l, or -s.
99
101 hfsutils(1), hcd(1), hpwd(1), hdir(1), hcopy(1)
102
104 $HOME/.hcwd
105
107 Robert Leslie <rob@mars.org>
108
109
110
111HFSUTILS 14-Jan-1997 HLS(1)