Встроенные команды работы со стеком каталогов

dirs

dirs [-clpv] [+N | -N]

Если параметры не указаны, выводит список каталогов, сохранённых в данный момент. Каталоги добавляются в список командой pushd; команда popd удаляет каталоги из списка. Текущий каталог всегда является первым каталогом в стеке.

Если указаны параметры, они имеют следующие значения:

-c

Очищает стек каталогов, удаляя все его элементы.

-l

Выводит список с полными именами путей; в формате списка по умолчанию для обозначения домашнего каталога используется тильда.

-p

Заставляет dirs выводить стек каталогов, размещая каждый элемент на отдельной строке.

-v

Заставляет dirs выводить стек каталогов, размещая каждый элемент на отдельной строке и указывая перед ним его индекс в стеке.

+N

Выводит N-й каталог (считая слева в списке, выводимом командой dirs без параметров), начиная с нуля.

-N

Выводит N-й каталог (считая справа в списке, выводимом командой dirs без параметров), начиная с нуля.

popd

popd [-n] [+N | -N]

Удаляет элементы из стека каталогов. Элементы нумеруются с 0, начиная с первого каталога, выведенного командой dirs; то есть popd эквивалентна popd +0.

Если аргументы не указаны, popd удаляет верхний каталог из стека и переходит в новый верхний каталог.

Если указаны аргументы, они имеют следующие значения:

-n

Не выполняет обычный переход в каталог при удалении каталогов из стека, а только изменяет стек.

+N

Удаляет из стека N-й каталог (считая слева в списке, выводимом командой dirs), начиная с нуля.

-N

Удаляет из стека N-й каталог (считая справа в списке, выводимом командой dirs), начиная с нуля.

Если верхний элемент стека каталогов изменён и параметр -n не указан, popd использует встроенную команду cd, чтобы перейти в каталог, находящийся на вершине стека. Если команда cd завершается с ошибкой, popd возвращает ненулевое значение.

В противном случае popd возвращает неуспешный код завершения, если указан недопустимый параметр, стек каталогов пуст или N указывает на несуществующий элемент стека каталогов.

Если команда popd выполнена успешно, Bash запускает dirs, чтобы показать итоговое содержимое стека каталогов; код возврата равен 0.

pushd

pushd [-n] [+N | -N | dir]

Добавляет каталог на вершину стека каталогов или циклически сдвигает стек, делая новый верхний каталог текущим рабочим каталогом. Если аргументы не указаны, pushd меняет местами два верхних элемента стека каталогов.

Если указаны аргументы, они имеют следующие значения:

-n

Не выполняет обычный переход в каталог при циклическом сдвиге или добавлении каталогов в стек, а только изменяет стек.

+N

Циклически сдвигает стек так, чтобы N-й каталог (считая слева в списке, выводимом командой dirs, начиная с нуля) оказался на вершине.

-N

Циклически сдвигает стек так, чтобы N-й каталог (считая справа в списке, выводимом командой dirs, начиная с нуля) оказался на вершине.

dir

Помещает dir на вершину стека.

После изменения стека, если параметр -n не указан, pushd использует встроенную команду cd, чтобы перейти в каталог, находящийся на вершине стека. Если команда cd завершается с ошибкой, pushd возвращает ненулевое значение.

В противном случае, если аргументы не указаны, pushd возвращает ноль, если стек каталогов не пуст. При циклическом сдвиге стека каталогов pushd возвращает ноль, если стек каталогов не пуст и N указывает на существующий элемент стека.

Если команда pushd выполнена успешно, Bash запускает dirs, чтобы показать итоговое содержимое стека каталогов.