Some stuff (Записи о bash)

bash: условие если вывод команды содержит строку

None — Thu, 24 Sep 2026 10:21:03 GMT

if SomeCommand | grep -q 'TextToFind'; then
  echo "TextToFind was found in SomeCommand output"
else
  echo "No TextToFind in SomeCommand output found"
fi

bash: запуск процессов на фоне

None — Thu, 24 Sep 2026 10:17:16 GMT

Если надо запустить скрипт на фоне (типовая ситуация - запуск скрипта как CGI из веб-сервера), то перед запуском долгого процесса надо отсоединить stdout и stderr от скрипта. Тогда веб-сервер сможет продолжать работать.

Делается это так (перед запуском фоновой задачи):

exec >&-
exec 2>&-

Источники:

https://stackoverflow.com/questions/6033780/run-a-cgi-shell-script-in-background

https://tldp.org/LDP/abs/html/io-redirection.html

Функции в bash

None — Thu, 09 Oct 2025 10:42:46 GMT

Задать функцию

Функции в bash можно задавать двумя способами:

# Способ 1
function_name () {
  commands
}

# Способ 2
function function_name {
  commands
}

Простые функции можно объявлять в одну строку. При этом пробелы между фигурными скобками и телом функции важны!. И последним в теле должен быть ; (точка с запятой).

Объявление функций в одну строку:

# Способ 1
function_name () { commands; }

# Способ 2
function function_name { commands; }

Итого по объявлению функций:

Тело функций (всё что между фигурными скобками) должно отделяться от самих фигурных скобок переносом строки или пробелами;
Определение функции не вызывает её (как и в нормальных языках);
Определение функции должно быть выше чем её вызовы;
Тело однострочных функций должно заканчиваться ; (точкой с запятой).

Переменные

Глобальные переменные видны в функциях и могут быть модифицированы в функциях. Локальные переменные (область видимости внутри функции) должны объявляться с ключевым словом local.

Локальные переменные имеют приоритет над глобальными если используется одно и то же имя.

#!/bin/bash

var1='A'
var2='B'

my_function () {
  local var1='C'
  var2='D'
  echo "Inside function: var1: $var1, var2: $var2"
}

echo "Before executing function: var1: $var1, var2: $var2"

my_function

echo "After executing function: var1: $var1, var2: $var2"

Вывод этого скрипта:

Before executing function: var1: A, var2: B
Inside function: var1: C, var2: D
After executing function: var1: A, var2: D

Параметры

Чтобы передать параметры в функцию надо просто написать их после вызова, разделяя пробелами. Имеет смысл заключать их в кавычки, тогда можно передавать параметры с пробелами.

Внутри функции доступ к параметрам осуществляется через переменные $1, $2, $3 и т.д.
Переменная $0 содержит имя самой функции.
Переменная $# содержит количество переданных параметров.
Переменные $* и $@ содержать все парамеры, переданные функцию.

Отличия переменных `$*` и `$@`

Если эти переменные НЕ заключать в кавычки, то они эквивалентны;
В кавычках "$*" раскрывается в одну строку "$1 $2 ... $n";
В кавычках "$@" раскрывается в разные строки "$1" "$2" ... "$n".

Пример:

#!/bin/bash

greeting () {
  echo "Hello $1"
}

greeting "World"

Возвращаемые значения

В отличие от функций в "настоящих" языках программирования, функции в Bash не позволяют возвращать значения как это принято. Когда функция bash заканчивает выполнение, ее возвращаемое значение это статус последней выполненной команды в теле функции, обычно 0 при успешном завершении, число 1-255 код ошибки.

Это число можно указать явно при использовании команды return, после чего оно будет сохранено в специальной переменной $?. Команда return прерывает выполнение функции (как и в обычных языках), а код ошибки можно рассматривать как статус выполнения.

Пример:

#!/bin/bash

my_function () {
  echo "some result"
  return 55
}

my_function
echo $?

Вывод этого скрипта:

some result
55

Чтобы по-настоящему что-то вернуть из функции надо использовать что-то другое. Самый простой вариант - присвоить что-то глобальной переменной:

#!/bin/bash

my_function () {
  func_result="some result"
}

my_function
echo $func_result

Вывод этого скрипта:

some result

Есть способ получше. Отправить требуемое возвращаемое значение на вывод (при помощи echo или printf, например):

#!/bin/bash

my_function () {
  local func_result="some result"
  echo "$func_result"
}

func_result="$(my_function)"
echo $func_result

Вывод этого скрипта:

some result

Тут вместо простого вызова (который просто напечатает строку) вызов функции "оборачивается" в оператор $(...), после чего переменная будет содержать то, что функция "хотела" напечатать.

Переопределение команд

Можно сделать функцию с именем, таким же как существующая команда. В этом случае, вместо команды будет вызываться функция. так можно добавлять, например, дополнительные опции во все вызовы команд сразу, или ещё как-то шаманить, чтоб не править много мест в скрипте сразу.

Пример:

#!/bin/bash

#overriding command
echo(){
    builtin echo "The name is : $1"
}

echo "Edward III"

Вывод этого скрипта:

The name is : Edward III

Bash: сколько времени в секундах прошло

None — Tue, 21 Mar 2023 21:29:18 GMT

Допустим есть два события, по которым вызываются скрипты.

Требуется во втором скрипте (по второму событию) узнать сколько времени прошло с первого события. Например, чтобы определить длительность нажатия кнопки.

Идея такая:

первый скрипт сохраняет временную метку в файл
второй скрипт вычисляет разность временных меток (сейчас минус то, что в файле)

Первый скрипт просто сохраняет метку:

date +"%s" > /tmp/stamp

Второй скрипт вычисляет разность:

TIMEDIFF=$(( ( $(date +%s) - $(date -r /tmp/stamp +%s) ) ))
echo $TIMEDIFF

if (( ${TIMEDIFF} > 2 )); then
  echo "### More than 2 seconds passed"
else
  echo "### Less than 2 seconds passed"
fi

bash и аргументы командной строки

None — Mon, 29 Nov 2021 10:05:48 GMT

Пример разбора нескольких опций командной строки

VERBOSE=
NINGEN_OPTS=

function usage {
        echo "Usage: $(basename $0) [-hwv] [-n ningen_opts]" 2>&1
        echo '   -h   shows usage'
        echo '   -v   set verbose mode ON'
        echo '   -w   build for windows (using mingw on linux)'
        echo '   -n   options passed to ningen'
        exit 1
}

while getopts ":hvwn:" opt; do
  case ${opt} in
    #-----------------------------
    h ) usage ;;
    v ) VERBOSE="-v" ;;
    w ) BUILD_FOR_WINDOWS=1 ;;
    n ) NINGEN_OPTS=$OPTARG ;;
    #-----------------------------
    \? )
      echo "Invalid Option: -$OPTARG" 1>&2
      exit 1
      ;;
    :)                                    # If expected argument omitted:
      echo "Error: -${OPTARG} requires an argument."
      exit 1                              # Exit abnormally.
      ;;
    *)                                    # If unknown (any other) option:
      usage                               # Exit abnormally.
      ;;
  esac
done
shift $((OPTIND -1))

# берем первый аргумент из списка - директория на сервере куда копировать
#TARGET_DIR="$1"
#shift

echo "Main script running"

Отказ запуска без аргументов

Для того, чтобы обработать случай отсутствия аргументов, после usage добавить:

if [[ ${#} -eq 0 ]]; then
   usage
fi

Несколько приёмов для bash

None — Wed, 24 Nov 2021 14:13:18 GMT

Запуск python в зависимости от платформы

Требуется под linux запускать python как python3, а под windows как python

В скрипте можно сделать так:

if [[ "$OSTYPE" == "linux"* ]]; then
  PY=python3
else
  PY=python
fi

В дальнейшем коде запускать $PY вместо python.

Возврат кода ошибки

Чтобы вернуть код ошибки из одного и того же скрипта может быть два варианта:

скрипт запустили прямо из bash
скрипт вызвали из другого скрипта

Если скрипт запустили прямо из bash, то надо использовать exit, а если из другого скрипта, то с высокой долей вероятности требуется return.

Можно это делать автоматически:

### define $ret command as 'exit' if run standalone or
### define $ret command as 'return' if called from another script
[[ "$0" == "$BASH_SOURCE" ]] && ret=exit || ret=return

Потом это можно использовать примерно так:

mysupercommand || $ret $? 

или

$ret 1

Присвоить значение переменной если такой переменной ещё нет

[ -z "${OUTDIR}" ] && OUTDIR=__output

ну или полноценное условие если переменной не существует

if [[ -z "${USE_VAR}" ]]; then
  echo "### No USE_VAR defined"
else
  echo "### USE_VAR = ${USE_VAR}"
  ......
fi

Дополнение строковой переменной новой строкой

MYVAR=

MYVAR+=$'\n'
MYVAR+="string number 1"


MYVAR+=$'\n'
MYVAR+="string number 2"

echo "${MYVAR}"

Цикл по строкам или файлам и каталогам в bash

None — Mon, 18 Oct 2021 23:19:46 GMT

Однострочник - выполнение команды в цикле

while true; do echo 'Hit CTRL+C'; sleep 1; done

Цикл по массиву строк

#!/bin/bash

####################################
# Массив строк с именем "arrayname"
####################################
arrayname=( one two three )

####################################
# Цикл по элементам массива
####################################
for i in "${arrayname[@]}"
do
    echo "$i"
done

Цикл по файлам и каталогам

#!/bin/bash

################################
# Цикл по файлам и каталогам
################################
for v in ../src/*
do
  echo "$v"
done

Цикл по каталогам c формированием списка в переменной

#!/bin/bash

################################
# Пустой список каталогов
all_dirs=""

################################
# Цикл по каталогам
################################
for v in ../src/*
do
  if [ -d "$v" ]; then
    echo "$v"
    # Дополнение списка каталогов (разделитель - перенос строки)
    all_dirs+="$v"$'\n'
  fi
done

echo "----"

echo "$all_dirs"

Some stuff (Записи о bash)

bash: условие если вывод команды содержит строку

bash: запуск процессов на фоне

Функции в bash

Задать функцию

Переменные

Параметры

Отличия переменных $* и $@

Возвращаемые значения

Переопределение команд

Bash: сколько времени в секундах прошло

bash и аргументы командной строки

Пример разбора нескольких опций командной строки

Отказ запуска без аргументов

Несколько приёмов для bash

Запуск python в зависимости от платформы

Возврат кода ошибки

Присвоить значение переменной если такой переменной ещё нет

Дополнение строковой переменной новой строкой

Цикл по строкам или файлам и каталогам в bash

Однострочник - выполнение команды в цикле

Цикл по массиву строк

Цикл по файлам и каталогам

Цикл по каталогам c формированием списка в переменной

Отличия переменных `$*` и `$@`