HIER

Section: User Commands (1)
Updated: Unsupported Utility
Index Return to Main Contents

NAME

hier - show filesystem hierarchy

SYNOPSIS

hier [ -adp ] [ -c columns ] [ -i indent ]
[ directories... ]

DESCRIPTION

This command shows you a filesystem hierarchy in a useful, indented way. At each level files are sorted in two groups: non-directory files, then directories (recursing into each one). It examines the named directories, or by default the present working directory.

Options are:

-a: All: include directories and files whose names start with ".".
-d: Show directories only; skip other types of files.
-p: Print filenames packed onto lines, not aligned in columns.
-c: Set width of display for showing multiple filenames on a line (or use the COLUMNS environment variable). The default is 80 columns.
-i: Set indentation (number of blanks) per hierarchy level. The default is 4 spaces per level.

EXAMPLES

hier: Show all non-"." files, recursively, in and under the current directory.
hier -apc 40 /etc: Show all directories and files, including any whose filenames start with ".", in a format 40 columns wide, and with filenames packed into lines, under directory "/etc".

DIAGNOSTICS

If a file is not stat-able, or a directory is not readable, the filename is printed on a line to itself, like a directory (sorted with directory names), with an appropriate message following.

BUGS

Unlike ls(1), it sorts files across lines rather than down columns. Fixing this would be non-trivial.

Also, due to the behavior of sftw(3) (like ftw(3)), it never lists "." and ".." files, even with the -a option.

This document was created by man2html, using the manual pages.
Time: 06:28:44 GMT, December 12, 2024