---
name: "hpls"
section: "1"
platform: "linux"
package: "hfsplus"
version: "1.0.4-19"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/hpls"
---

# hpls(1)

list the contents of a directory on an HFS+ volume

## 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)](/hfsplus/7.md), [hpmount(1)](/hpmount/1.md), [hpcd(1)](/hpcd/1.md), [hppwd(1)](/hppwd/1.md), [hprm(1)](/hprm/1.md), [hpmkdir(1)](/hpmkdir/1.md), [hpcopy(1)](/hpcopy/1.md), [hpumount(1)](/hpumount/1.md), [hpfsck(1)](/hpfsck/1.md).

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