NAME

       hpls — list the contents of a directory on an HFS+ volume

SYNOPSIS

       hpls [options]  [hfs-path ...]

Description

       hpls  is  used  to list files and directories on an HFS+ volume.  If one or more arguments
       are given, each file or directory is shown; otherwise, the contents of the current working
       directory are displayed.

Options

       -1        Each  entry appears on a line by itself.  This is the default if standard output
                 is not a terminal.

       -a        All entries are shown, including "invisible" files.   The  default  is  to  omit
                 invisible files.

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

       -i        Show  the  catalogue  ID  for  each  entry.  Every file and directory on an HFS+
                 volume has a unique catalogue ID.

       -l        Display entries in long format.  This format  shows  the  entry  type  ("d"  for
                 directory,  "f"  for file, "F" for locked file), flags ("i" for invisible), type
                 and creator (four-character strings) for files only, size (number of items in  a
                 directory  or  resource  and  data  bytes of a file, respectively), date of last
                 modification (or creation if the -c          flag is given), and name.

       -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 standard output is 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 standard output is 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 slash "/"  and
                 executable Macintosh applications are followed by an asterisk "*".

       -N        Cause all filenames to be output verbatim without question-mark substitution.

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

See also

       hfsplus(7), hpmount(1), hpcd(1), hppwd(1), hprm(1),  hpmkdir(1),  hpcopy(1),  hpumount(1),
       hpfsck(1).

Author

       This  manual  page was written by Jens Schmalzing <jensen@debian.org> for Debian GNU/Linux
       using the manual page by Klaus Halfmann <halfmann@libra.de> that  comes  with  the  source
       code and documentation from the Tech Info Library.

                                                                                          hpls(1)