Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
HLS(1)			    General Commands Manual			HLS(1)

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

       -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

       -f     Do  not sort directory contents; list them in the	order they ap-
	      pear 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 un-
	      less -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

       -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  re-
	      source and data lengths are used to compute a file's size.

       -U     Do  not sort directory contents; list them in the	order they ap-
	      pear in the directory. On	HFS volumes, this is usually an	alpha-
	      betical case-insensitive ordering, although there	are some idio-
	      syncrasies to the	Macintosh implementation of ordering. This op-
	      tion does	not affect -a, -l, or -s.

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


       Robert Leslie <>

HFSUTILS			  14-Jan-1997				HLS(1)


Want to link to this manual page? Use this URL:

home | help