Когда алиаса мало
Алиас подставляет текст, а аргументы ставит в его конец («Алиасы в Bash»). Пока нужна одна команда с
постоянными флагами, этого хватает. Но размер подкаталогов — это du -h -d1 /var | sort -h: путь стоит
в середине, между du и |. Алиас отдаёт его sort, и тот отвечает sort: read failed: /var: Is a directory.
Второй случай — создать каталог и сразу перейти в него. Здесь путь нужен дважды, в mkdir и в cd, а алиас
подставит его только один раз, в конец.
Для этого есть функции. Функция — своя команда из одной или нескольких команд, аргументы в ней ставим куда
нужно. Вызывается она так же, как алиас, — по имени: duh /var, mkcd /opt/app.
Как пишем функцию
# имя() { команды; }
duh() { du -h -d1 "${1:-.}" 2>/dev/null | sort -h; }
В одну строку после { нужен пробел, а перед } — ;. Без них Bash не поймёт, где тело функции (примеры
ошибок — в «Если не работает»). Функцию длиннее одной строки пишем в несколько строк, тогда ; не нужен:
# копия файла с датой рядом с ним — перед правкой конфига
bak() {
local copy="$1.bak-$(date +%F-%H%M)"
sudo cp -a -- "$1" "$copy" && echo "$copy"
}
Аргументы внутри функции:
| Запись | Что это |
|---|---|
$1, $2 |
первый, второй аргумент |
"$@" |
все аргументы как есть, каждый отдельным словом |
$# |
сколько аргументов передали |
${1:-.} |
первый аргумент, а если его нет — ., текущий каталог |
"$1" пишем в кавычках: без них путь с пробелом развалится на два аргумента.
Переменная, которую функция задала, остаётся в оболочке и после вызова: функция с x=1 внутри — и потом
echo $x печатает 1. Чтобы переменная жила только внутри, объявляем её local, как copy в bak.
Функция выполняется в нашей оболочке, а не в отдельном процессе. Поэтому cd в ней меняет каталог нам,
а скрипт с тем же cd поменял бы каталог только себе.
Где хранить и в каком порядке
В том же ~/.bash_aliases. Это обычный файл Bash: .bashrc выполняет его целиком, строку за строкой.
Поэтому в нём работает всё, что можно набрать в терминале: алиасы, функции, переменные.
Порядок в файле — сначала алиасы, потом функции. Bash раскрывает алиасы в функции один раз, когда читает
её определение. Алиас ниже функции в ней не сработает: при вызове будет command not found. А раскрытый алиас
остаётся в функции насовсем — после alias rm='rm -I' функция clean() { rm "$1"; } сохраняется так:
type clean
# clean is a function
# clean ()
# {
# rm -I "$1"
# }
Поменяли алиас — функция узнает об этом, только когда файл перечитают.
Алиас и функция вызывают друг друга:
- Алиас может вызвать функцию.
alias dlog='duh /var/log': Bash подставляет текст алиаса, а первое слово,duh, находит среди функций. Так у функции появляется короткое имя с готовым аргументом. - Функция может использовать алиас, если он стоит в файле выше.
- Имя функции не должно совпадать с алиасом. Функцию
ll()Bash не примет, пока есть алиасll: он раскроет алиас прямо в определении. Сначалаunalias ll.
Кто главнее при одинаковом имени: алиас, потом функция, потом встроенная команда Bash, потом программа.
\имя обходит только алиас, command имя — и алиас, и функцию. Функцию с именем команды пишем через
command, иначе она вызовет саму себя:
# после перехода — сразу список файлов
cd() { command cd "$@" && ls; }
Функции на каждый день
# что занимает место: каталоги по размеру, самый большой внизу
duh() { du -h -d1 "${1:-.}" 2>/dev/null | sort -h; }
# создать каталог и перейти в него
mkcd() { mkdir -p "$1" && cd "$1"; }
# кто слушает порт: port 8080
port() { sudo ss -tulpn "sport = :$1"; }
# копия файла с датой рядом с ним — перед правкой конфига
bak() {
local copy="$1.bak-$(date +%F-%H%M)"
sudo cp -a -- "$1" "$copy" && echo "$copy"
}
# оболочка в контейнере: dsh web, dsh web bash
dsh() { docker exec -it "$1" "${2:-sh}"; }
duhбез аргумента считает текущий каталог. Каталоги без доступа пропускает молча, их размер не считается.mkcdпереходит в каталог, только еслиmkdirпрошёл:&&не пускаетcdдальше после ошибки.portиbakзовутsudoвнутри. Саму функцию черезsudoне запустить, аsudoв ней работает как в обычной команде. Уportдля свободного порта — одна строка заголовка.bakкопирует с-a: владелец, права и время у копии те же. Печатает имя копии:nginx.conf.bak-2026-11-11-1548.dshпо умолчанию открываетsh: в образах на Alpine нетbash, иdsh web bashтам отвечаетexec: "bash": executable file not found in $PATH.
duh и mkcd уже есть в «Алиасы на каждый день»; port, bak и dsh дописываем в конец того же файла.
Где функция не работает
Там же, где и алиас: в скриптах, в ssh web1 'команда', в cron. Их выполняет новый Bash, который
~/.bash_aliases не читает. И отдельно — после sudo: sudo запускает только программы, а функция живёт
в нашей оболочке. Пробел в alias sudo='sudo ' раскрывает алиасы, а функции — нет.
Если не работает
f() {echo hi} отвечает syntax error near unexpected token и показывает {echo
- Причина
- Без пробела после
{Bash читает{echoкак одно слово, а не как начало тела функции. - Делаем
- Ставим пробел:
f() { echo hi; }.
Набрали f() { echo hi }, а терминал показывает > и ждёт
- Причина
- Без
;перед}Bash считает}аргументомechoи ждёт настоящую закрывающую скобку. - Делаем
- Ctrl+C и заново, с
;:f() { echo hi; }. В функции на несколько строк;в конце строк не нужен.
ll() { …; } отвечает syntax error near unexpected token и показывает скобку
- Причина
ll— алиас из.bashrcUbuntu, и Bash раскрыл его прямо в определении: вышлоls -alF() {. То же сl,la,ls,grep.- Делаем
- Сначала убираем алиас, потом пишем функцию:
unalias llстрокой выше. Записьfunction ll { …; }ошибку обходит, но при вызове алиас всё равно главнее функции.
Функция отвечает command not found на алиас, который есть в ~/.bash_aliases
- Причина
- Алиас стоит в файле ниже функции. Bash раскрывает алиасы, когда читает определение функции, а тогда этого алиаса ещё не было.
- Делаем
- В файле сначала алиасы, потом функции. Перечитываем:
source ~/.bash_aliases.
sudo duh /var отвечает sudo: duh: command not found
- Причина
sudoзапускает программы, а функция есть только в нашей оболочке.export -f duhне помогает:sudoне передаёт её дальше.- Делаем
sudoпишем внутри функции, как вportиbak. Или запускаем командой целиком:sudo du -h -d1 /var | sort -h.
После cd() { cd "$@" && ls; } команда cd вешает терминал, потом сеанс обрывается
- Причина
cdвнутри функции — снова эта же функция, она вызывает себя без конца, пока у Bash не кончится память. На машине с 2 ГБ такой Bash занял 1,7 ГБ, и ядро его убило:Out of memory: Killed process … (bash).- Делаем
- Внутри функции с именем команды пишем
command cd: так запускается сама команда, мимо алиасов и функций.
Скрипт не находит функцию: command not found
- Причина
- Скрипт выполняет новый Bash, а
~/.bash_aliasesчитает только интерактивная оболочка. - Делаем
- Команду для скриптов делаем скриптом в
~/.local/bin(«Алиасы в Bash», «Алиас, функция или скрипт»).
Как проверить
Что за именем — функция, и что в ней:
type port
# port is a function
# port ()
# {
# sudo ss -tulpn "sport = :$1"
# }
Работает:
port 22
# Netid State Recv-Q Send-Q Local Address:Port Peer Address:PortProcess
# tcp LISTEN 0 4096 0.0.0.0:22 0.0.0.0:* users:(("sshd",pid=1213,fd=3),("systemd",pid=1,fd=94))
# tcp LISTEN 0 4096 [::]:22 [::]:* users:(("sshd",pid=1213,fd=4),("systemd",pid=1,fd=95))