basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Функции в Bash: свои команды с аргументами

    Функция — своя команда из одной или нескольких команд, аргументы в ней ставим в любое место: duh /var выполняет du -h -d1 /var | sort -h. Пишем её в тот же ~/.bash_aliases, что и алиасы, после них, и вызываем так же — по имени. Через sudo и из скриптов функцию не запустить.

    Когда алиаса мало

    Алиас подставляет текст, а аргументы ставит в его конец («Алиасы в 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 — алиас из .bashrc Ubuntu, и 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))