1HLS(1)                      General Commands Manual                     HLS(1)
2
3
4

NAME

6       hls - list files in an HFS directory
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

SEE ALSO

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

FILES

104       $HOME/.hcwd
105

AUTHOR

107       Robert Leslie <rob@mars.org>
108
109
110
111HFSUTILS                          14-Jan-1997                           HLS(1)
Impressum