apt-cache

title: apt-cache(8)

summary: утилита управления APT \-\- управление кэшем

text:
# apt-cache(8)

## НАЗВАНИЕ
apt-cache - утилита управления APT -- управление кэшем

## ОБЗОР
apt-cache команда [аргумент ...]

## ОПИСАНИЕ
apt-cache выполняет ряд операций над кэшем пакетов APT. apt-cache названа так просто для того, чтобы отделить те операции, которые она выполняет от тех, которые выполняют другие утилиты apt.

команда может принимать одно из следующих значений:

o

add файл1 [файл2] [...]

o

gencaches

o

showpkg пакет1 [пакет2] [...]

o

stats

o

dump

o

dumpavail

o

unmet

o

check

o

search

o

show

o

showpkg

o

depends

o

pkgnames

o

dotty

Если не используется одна из опций, -h или --help, то должна быть указана одна из вышеприведённых команд.

add

add добавляет индексные файлы имен пакетов к кэшу пакетов.

gencaches

gencaches выполняет такую же операцию как и apt-get check. Cтроит кэш источников и кэш пакетов из их источников в /etc/apt/sources.list и из /var/lib/dpkg/status (или из базы RPM).

showpkg

showpkg выводит информацию о пакетах, перечисленных в командой строке. Остальные аргументы являются именами пакетов. Перечисляются как доступные версии так и обратные зависимости каждого пакета, а также прямые зависимости для каждой версии. Прямые (обычные) зависимости - это те зависимости, от которых зависит данный пакет; обратные зависимости указывают на то, что существуют другие пакеты, которые зависят от данного пакета. Таким образом, прямые зависимости должны быть удовлетворены для установки пакета, а обратные могут и не быть удовлетворены. Для примера, apt-cache showpkg libreadline2 выведет нечто похожее на следующее:

```

Package: libreadline2
Versions:
2.1-12(/var/state/apt/lists/debian.midco.net_debian_dists_slink_main_binary-i386_Packages),
Reverse Depends:

  libreadlineg2,libreadline2

  libreadline2-altdev,libreadline2
Dependencies:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null)) ldso (2 1.9.0-1)
Provides:
2.1-12 -
Reverse Provides:

```

Здесь можно увидеть, что пакет libreadline2, версия 2.1-8, зависит от libc5, ncurses3.0, и ldso, что они должны быть установлены, чтобы libreadline2 заработал. Далее libreadlineg2 и libreadline2-altdev зависят от libreadline2. Если пакет libreadline2 устанавливается, то и пакеты libc5, ncurses3.0 и ldso также должны быть установлены, а libreadlineg2 и libreadline2-altdev могут и не быть установлены. Для того, чтобы понять остальную информацию лучше всего посмотреть исходные тексты apt.

stats

stats отображает некоторую статистику касательно кэша. Аргументы не нужны. Статистический отчет выглядит так (поля):

o

Имён пакетов - это количество имен пакетов, найденных в кэше.

o

Нормальные пакеты - это количество обычных имен пакетов; таких пакетов у которых имя пакета и имя используемое другими пакетами в зависимостях совпадают один к одному. Большинство пакетов относятся именно к этой категории.

o

Целиком виртуальные пакеты - это количество пакетов, которые существуют только как виртуальные; те пакеты которые только "предоставляют" виртуальное имя пакета, за которым нет фактического пакета, использующего это имя. Например, "mail-transport-agent" в системе Debian GNU/Linux -- это чистый виртуальный пакет; несколько пакетов предоставляют "mail-transport-agent", но нет ни одного пакета с названием "mail-transport-agent".

o

Одиночные виртуальные пакеты - это количество пакетов, в которых только один из пакетов предоставляет соответствующих виртуальный пакет. Например, в системе Debian GNU/Linux, "X11-text-viewer" - это виртуальный пакет, но только один пакет, xless, предоставляет "X11-text-viewer".

o

Смешанные виртуальные пакеты - это количество пакетов, которые и предоставляют соответствующий виртуальный пакет и имеют имя виртуального пакета в качестве имени пакета. Например, в системе Debian GNU/Linux, e2fsprogs - это и реальный пакет и пакет, который предоставляет пакет e2compr.

o

Отсутствуют - это количество имен пакетов, на которые ссылаются в зависимостях, но которые не предоставляются ни одним из пакетов. Отсутствующие пакеты могут быть в отсутствующей части, если полный дистрибутив недоступен или если пакет (реальный или виртуальный) был удален из дистрибутива.

o

Различных версий - это количество версий пакетов, найденных в кэше; данное значение по крайней мере должно быть равно общему количеству имен пакетов. Если доступен более чем один дистрибутив (например, и "stable" и "unstable"), то данное значение может быть значительно больше, чем общее количество имен пакетов.

o

Всего зависимостей - это количество зависимостей требуемых всеми пакетами в кэше.

dump

dump показывает краткий список по каждому пакету в кэше. Команда в первую очередь нужна для отладки.

dumpavail

dumpavail выдает список всех доступных пакетов. Команда полезна для использования с dpkg и используется в dselect.

unmet

unmet выдает краткую справку об неудовлетворенных зависимостях в кэше пакетов.

check

check это случайная функция для тестирования определенных акцептов кэша. Не используйте ее.

showpkg

showpkg выдает список состоящий из структуры кэша по заданным пакетам и некоторую относящуюся к ним информацию. Список в первую очередь нужен для отладки.

show

show выполняет функцию похожую на --print-avail или rpm -qi, выводит записи по пакетам с указанными именами.

search

search выполняет полный поиск текста по всем доступным файлам пакетов по заданному шаблону. Команда просматривает имена пакетов и описания, для поиска определенной строки, а также выводит имя пакета и его краткое описание. Если задана опция --full то вывод будет идентичен команде show если найдутся пакеты удовлетворяющие условию, а если задана опция --names-only то поиск в длинном описании производиться не будет, только в именах пакетов.

depends

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

pkgnames

Данная команда выдает имя каждого пакета в системе. Необязательный аргумент - это префикс для фильтрации списка имен. Вывод этой команды обычно используется в функциях оболочки и генерируется очень быстро. Данную команду лучше всего использовать с опцией --no-generate.

dotty

dotty берет список пакетов в командной строке и генерирует вывод, удобный для использования пакетом dotty фирмы GraphVis (http://www.research.att.com/sw/tools/graphviz/). Результатом будет список узлов и краев, который представляет собой отношения между пакетами. По умолчанию заданные пакеты будут отслеживаться на предмет всех зависимостей, что будет представлять из себя очень большую схему. Такое поведение можно отключить установкой опции APT::Cache::GivenOnly.

Результирующие узлы будут выглядеть определенными фигурами, обычные пакеты как боксы, чистые представляются треугольниками, смешанные ромбами, отсутствующие пакеты шестиугольниками. Оранжевые боксы означают рекурсию, которая была остановлена [leaf packages], синие линии - это предварительные зависимости, зеленые - конфликты.

Внимание, dotty не может отображать большие списки пакетов.

## ОПЦИИ
Все опции командной строки могут быть заданы при помощи файла настроек, описания обозначают устанавливаемые элементы настройки. Для логических опций вы можете перекрыть файл с настройками используя конструкцию вида -f-, --no-f, -f=no или некоторые другие вариации.

-h, --help

Выдает краткую подсказку.

-v, --version

Выдает версию программы.

-p --pkg-cache

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

Элемент настройки: Dir::Cache::pkgcache.

-s --src-cache

Выбрать файл для записи кэша источника. Этот источник используется только gencaches и он хранит обработанную версию информации о пакете из удаленного источника. Когда строится кэш пакетов, кэш источника используется для предотвращения повторной обработки всех файлов пакетов.

Элемент настройки: Dir::Cache::srcpkgcache.

-q, --quiet

Производится вывод годный для протоколирования, в котором опускается индикаторы хода выполнения задачи. Указание большего числа опций -q приведет к более урезанному выводу, максимально вы можете указать их еще два раза. Вы также можете использовать конструкцию -q=# для установки нужного вам количества сообщений вывода, перекрывая файл с настройками.

Элемент настройки: quiet.

-i --important

Выводить только важные зависимости; при использовании этой опции с командой unmet, будут выводиться только отношения Depends и Pre-Depends.

Элемент настройки: APT::Cache::Important.

-f --full

Выдавать полные записи пакета во время поиска.

Элемент настройки: APT::Cache::ShowFull.

-a --all-versions

Выдавать все записи для всех доступных версий. Эта опция применима только к команде show.

Элемент настройки: APT::Cache::AllVersions

-g --no-generate

Не выполнять автоматическую регенерацию кэша, использовать кэш в том виде, как есть.

Элемент настройки: APT::Cache::NoGenerate.

--names-only

Искать только имена пакетов, а не длинные описания.

Элемент настройки: APT::Cache::NamesOnly.

--all-names

Заставляет команду pkgnames выдавать все имена, включая имена виртуальных пакетов и отсутствующие зависимости.

Элемент настройки: APT::Cache::AllNames.

-c, --config-file

Файл с настройками; Задать для использования файл с настройками. apt-get будет читать файл с настройками по умолчанию и затем данный файл с настройками. Смотрите информацию о синтаксисе в apt.conf(5).

-o, --option

Установить Опцию Настройки; Она будет установлена определенной опцией настройки. Используется следующий синтаксис:

```

-o Foo::Bar=bar
```

## ФАЙЛЫ
o

/etc/apt/sources.list - источники для получения пакетов

o

/var/lib/apt/lists/ - область хранения информации о состоянии каждого ресурса пакетов, заданного в списке источников

o

/var/lib/apt/lists/partial/ - временная область хранения информации в процессе скачивания

## СМОТРИТЕ ТАКЖЕ
apt-get(8), sources.list(5), apt.conf(5)

## ДИАГНОСТИКА
apt-cache возвращает ноль при нормальной работе и десятичную 100 при ошибке.

## ОШИБКИ
Смотрите http://bugs.debian.org/apt. Если вы хотите отправить сообщение об ошибке в apt-cache, пожалуйста смотрите /usr/doc/debian/bug-reporting.txt или команду bug(1). Если вы используете систему базирующуюся на RPM, то в этом случае, пожалуйста, воспользуйтесь http://distro.conectiva.com.br /bugzilla/.

## АВТОР
apt-cache была написана командой APT <apt@packages.debian.org> и портирован на системы базирующиеся на RPM Alfredo K. Kojima, <kojima@conectiva.com.br >, из Conectiva S.A.

## ПЕРЕВОД
Перевод с английского сделал Виктор Вислобоков <victor_v@permonline.ru>


apt-cdrom

package: man-pages-ru-extra

title: apt-cdrom(8)

summary: APT утилита управления CDROM

text:
# apt-cdrom(8)

## НАЗВАНИЕ
apt-cdrom - APT утилита управления CDROM

## СИНТАКСИС
apt-cdrom команда

## ОПИСАНИЕ
apt-cdrom используется для добавления нового CDROM в список доступных источников APT. apt-cdrom производит безопасное определение структуры диска, а также коррекцию для некоторых возможных ошибок записи и проверку индексных файлов. Для добавления CD в систему APT необходимо использовать apt-cdrom, эту операцию нельзя выполнить вручную. При необходимости, каждый диск в многодисковом наборе должен быть вставлен и просканирован отдельно, для выявления возможных ошибок записи.

Для добавления диска в базу данных APT используется следующая команда:

o add

Если не используется одна из опций, -h или --help, то необходимо задать команду указанную выше.

add

add используется для добавления нового диска в список источников. Будет произведено размонтирование устройства CDROM, выведено на экран приглашение на вставку нового диска и, затем, сканирование этого диска и копирование индексных файлов. Если диск не содержит соответствующего каталога .disk/, то пользователю будет предложено ввести заголовок-описание самостоятельно.

APT использует CDROM ID для определения какой диск в настоящий момент находится в дисководе и обслуживает базу данных таких ID в /var/lib/apt/cdroms.list

## ОПЦИИ
Все опции командной строки могут быть установлены при помощи файла с настройками, описания показывают какой элемент настройки надо установить. Для логических опций вы можете перекрыть файл с настройками используя конструкцию вида -f-, --no-f, -f=no или некоторые другие вариации.

-h, --help

Выдает краткую подсказку.

-v, --version

Выдает версию программы.

-d --cdrom

Точка монтирования; задает местоположение монтирования cdrom. Данная точка монтирования должна быть указана в /etc/fstab и соответствующим образом настроена.

Элемент настройки: Acquire::cdrom::mount.

-r --rename

Переименовать диск; изменить метку диска или перекрыть метку данную диском. Данная опция заставит apt-cdrom вывести приглашение на ввод новой метки.

Элемент настройки: APT::CDROM::Rename.

-m, --no-mount

Не монтировать; предотвращает операции монтирования и де-монтирования точки монтирования, которые обычно осуществляет apt-cdrom.

Элемент настройки: APT::CDROM::NoMount.

-f, --fast

Быстрое копирование; Считать файлы пакетов правильными и не выполнять проверку каждого пакета. Данная опция должна использоваться только если apt-cdrom запущен на такой диск, который перед этим уже проверялся и не содержит ошибок.

Элемент настройки: APT::CDROM::Fast.

-a, --thorough

Полное сканирование пакетов; Данная опция может быть необходима для некоторых старых дисков дистрибутивов Debian 1.1/1.2, где файлы Package находятся в странных местах. Операция может занять много времени, но зато вытащит эти файлы на свет божий.

-n --just-print, --recon, --no-act

Нет изменений; Не изменять sources.list и не выполнять запись файлов пакетов. Однако, будет произведена полная проверка.

Элемент настройки: APT::CDROM::NoAct.

-c, --config-file

Файл с настройками; Задать файл с настройками. apt-get будет читать файл с настройками по умолчанию и затем указанный файл с настройками. Смотри синтаксис в apt.conf(5).

-o, --option

Установить опцию настройки; Она будет установлена определенной опцией настройки. Синтаксис будет следующим:

```

-o Foo::Bar=bar
```

## ФАЙЛЫ
o

/etc/apt/sources.list источники для получения пакетов

o

/var/lib/apt/lists/ область хранения информации о состоянии каждого ресурса пакетов, заданного в списке источников

o

/var/lib/apt/lists/partial/ временная область хранения информации в процессе скачивания

o

/var/lib/apt/cdroms.list список идентификаторов и имён CD.

## СМОТРИ ТАКЖЕ
apt-get(8), sources.list(5), apt.conf(5)

## ДИАГНОСТИКА
apt-cdrom возвращает ноль при обычной работе и десятичную 100 при ошибке.

## ОШИБКИ
Смотри http://bugs.debian.org/apt. Если вы хотите отправить отчет об ошибке в apt-cache, пожалуйста смотрите /usr/doc/debian/bug-reporting.txt или команду bug(1). Если вы используете систему базирующуюся на RPM, то в этом случае, пожалуйста, воспользуйтесь http://distro.conectiva.com.br /bugzilla/.

## АВТОР
apt-get была написана командой APT <apt@packages.debian.org> и портирован на системы базирующиеся на RPM Alfredo K. Kojima, <kojima@conectiva.com.br >, из Conectiva S.A.

## ПЕРЕВОД
Перевод с английского сделал Виктор Вислобоков <victor_v@permonline.ru>

branch: sisyphus


apt-config

title: apt-config(8)

summary: Программа настройки запросов APT

text:
# apt-config(8)

## НАЗВАНИЕ
apt-config - Программа настройки запросов APT

## ОБЗОР
apt-config команда

## ОПИСАНИЕ
apt-config - это внутренняя программа, используемая разными частями системы APT для обеспечения единых настроек. Она читает основной файл с настройками /etc/apt/apt.conf в такой манере, которая делает легким ее использование в сценариях.

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

o

shell

o

dump

Если не используется одна из опций, -h или --help, то должна быть указана одна из вышеприведённых команд.

shell

shell используется для доступа к информации о настройках из сценариев оболочки. Команда получает пары аргументов, первый является переменной окружения оболочки, а второй запрашиваемым значением настройки. В качестве вывода программа дает серии команд присваивания оболочки для каждой из представленной пар. В сценарии оболочки это может быть использовано примерно так:

```
OPTS="-f"
RES=`apt-config shell OPTS MyApp::Options`
eval $RES

```

В данном примере в переменную окружения оболочки с именем $OPTS помещается значение MyApp::Options, а -f является значением по умолчанию.

dump

Просто показывает все настройки.

## ОПЦИИ
Все опции командной строки могут быть установлены при помощи файла с настройками, описания показывают какой элемент настройки надо установить. Для логических опций вы можете перекрыть файл с настройками используя конструкцию вида -f-, --no-f, -f=no или некоторые другие вариации.

-h, --help

Выдает краткую подсказку.

-v, --version

Выдает версию программы.

-c, --config-file

Файл с настройками; Задать файл с настройками. apt-get будет читать файл с настройками по умолчанию и затем указанный файл с настройками.

Смотри синтаксис в apt.conf(5).

-o, --option

Установить опцию настройки; Она будет установлена определенной опцией настройки. Синтаксис такой:

```

-o Foo::Bar=bar
```

## СМОТРИТЕ ТАКЖЕ
apt.conf(5)

## ДИАГНОСТИКА
apt-config возвращает ноль при нормальной работе и десятичную 100 при ошибке.

## ОШИБКИ
Смотри http://bugs.debian.org/apt. Если вы хотите отправить отчет об ошибке в apt-cache, пожалуйста смотрите /usr/doc/debian/bug-reporting.txt или команду bug(1). Если вы используете систему базирующуюся на RPM, то в этом случае, пожалуйста, воспользуйтесь http://distro.conectiva.com.br /bugzilla/.

## АВТОР
apt-get была написана командой APT <apt@packages.debian.org> и портирован на системы базирующиеся на RPM Alfredo K. Kojima, <kojima@conectiva.com.br >, из Conectiva S.A.

## ПЕРЕВОД
Перевод с английского сделал Виктор Вислобоков <victor_v@permonline.ru>


apt-get

title: apt-get(8)

summary: утилита управления APT \-\- интерфейс командной строки

text:
# apt-get(8)

## НАЗВАНИЕ
apt-get - утилита управления APT -- интерфейс командной строки

## ОБЗОР
apt-get [опции] [команда] [пакет ...]

## ОПИСАНИЕ
apt-get это инструмент командной строки для управления пакетами и может рассматриваться как пользовательский интерфейс к apt(8).

командами служат:

o update

o upgrade

o dselect-upgrade [1]

o dist-upgrade

o install пакет1 [пакет2] [...]

o remove пакет1 [пакет2] [...]

o source пакет1 [пакет2] [...]

o check

o clean

o autoclean

Если не используется одна из опций, -h или --help, то должна быть указана одна из команд, перечисленных выше.

Примечание: [1] - только для систем на базе Debian.

update

update используется для повторной синхронизации файлов описаний пакетов с их источником. Описания доступных пакетов будут получены из источников, указанных в /etc/apt/sources.list. Например, при использовании архива Debian, эта команда разыскивает и просматривает файлы Packages.gz, таким образом становится доступной информация о новых и обновлённых пакетах. Перед upgrade и dist-upgrade всегда должно выполняться update. Пожалуйста помните, что индикатор прогресса показывает не точную информацию, поскольку размер файлов пакетов заранее не известен.

upgrade

upgrade используется для установки новейших версий всех установленных пакетов системы из источников, указанных в /etc/apt/sources.list. Будут разысканы новейшие версии установленных в настоящий момент пакетов и произведено обновление; ни в коем случае не будет удалено ни одного установленного пакета или установлено нового пакета, не имеющего уже установленной в системе предыдущей версии. Текущие версии установленных в настоящий момент пакетов, если они не могут быть обновлены новыми версиями без изменения статуса других пакетов, будут оставлены в неизменном виде. Для того, чтобы apt-get узнал о существовании доступных новых версиях пакетов, данной команде должна предшествовать команда update.

dselect-upgrade

dselect-upgrade используется совместно с традиционным инструментом управления пакетов в Debian GNU/Linux - dselect(8). dselect-upgrade следует изменениям, которые делает dselect с полем Status доступных пакетов и выполняет действие, необходимое для реализации этого состояния (например, удаление старых и установка новых пакетов).

dist-upgrade

dist-upgrade, в дополнение выполняет функцию upgrade, а также разумно управляет изменением зависимостей с новыми версиями пакетов; apt-get имеет "умную" систему разрешения конфликтов и она будет в случае необходимости пытаться произвести обновление наиболее важных пакетов за счет менее важных. Файл /etc/apt/sources.list содержит список источников для получения пакетов, из которых будут получены файлы пакетов.

install

install устанавливает один или более пакетов отмеченных к установке. Каждый пакет - это имя пакета, а не полное имя файла, содержащее этот пакет (например, в системе Debian GNU/Linux, в качестве пакета может быть указано имя ldso, а не ldso_1.9.6-2.deb). Все пакеты, требуемые заданным пакетом (пакетами) отмеченными к установке, также будут получены и установлены. Файл /etc/apt/sources.list используется для определения местонахождения нужных пакетов. Если к имени пакета добавляется символ переноса (без разделяющего пробела), то заданный пакет будет удален, если он установлен. Эта особенность может быть использована для перекрытия решения, сделанного системой разрешения конфликтов apt-get.

Если нет пакетов, совпадающих с заданным выражением и выражение содержит один из символов ´.´, ´?´ или ´*´, то оно рассматривается как шаблон для регулярных выражений POSIX и уже этот шаблон применяется ко всем именам пакетов в базе данных. Любые совпадающие с шаблоном пакеты будут затем установлены (или удалены). Заметим, что к примеру, подстрока ´lo*´ совпадает с ´how-lo´ и ´lowest´. Если это нежелательно, предваряйте их символом ´^´.

remove

remove идентична install за исключением того, что пакеты вместо установки удаляются. Если к имени пакета добавляется знак плюс (без разделяющего пробела), то указанные пакеты будут установлены.

source

source принуждает получать пакеты с исходными текстами. APT проверит доступные пакеты на предмет получения их исходных текстов. Затем он ищет и копирует в текущий каталог новейшую доступную версию этих исходных текстов. Пакеты исходных текстов обслуживаются отдельно от бинарных через ввод строк deb-src или rpm-src в файл /etc/apt/sources.list. Предполагается, что для получения исходных текстов, вы будете использовать источник, отличный от того, из которого вы получаете готовые пакеты. Если задана опция --compile, то пакет с исходными текстами будет скомпилирован в бинарный deb-пакет с помощью утилиты dpkg-buildpackage или, на системах использующих RPM, при помощи rpm -ba будет собран бинарный пакет. Если задана опция --download-only, то пакет с исходными текстами не будет распакован.

Заметим, что пакеты с исходными текстами не отслеживаются как бинарные пакеты, они существуют только в текущем каталоге, что очень похоже на простое выкачивание архивов исходных текстов .ta r.gz.

check

check - это диагностический инструмент; он обновляет кэш пакетов и проверяет пакеты, которые недо-установлены в силу каких-либо причин.

clean

clean очищает локальное хранилище полученных файлов пакетов. Команда удаляет все, но оставляет файлы из /var/cache/apt/archives/ и /var/cache/apt/archives/partial/. Когда APT используется как один из методов dselect(8), clean запускается автоматически. Те, кто не пользуется dselect, для освобождения места на диске могут время от времени использовать apt-get clean.

autoclean

Как и clean, autoclean очищает локальное хранилище полученных файлов пакетов. Отличие состоит в том, что эта команда удаляет только те файлы пакетов, которые больше не могут быть получены и использованы. Это позволяет обслуживать кэш в течении длительного периода без потери контроля над ним.

## ОПЦИИ
Все опции командной строки могут быть установлены при помощи файла настроек; описания показывают какой элемент настройки надо установить. Для логических опций вы можете перекрыть файл с настройками используя конструкцию вида -f-, --no-f, -f=no или некоторые другие вариации.

-d, --download-only

Только выкачивать; файлы пакетов будут только выкачиваться, но не будут распаковываться и устанавливаться.

Элемент настройки: APT::Get::Download-Only.

-f, --fix-broken

Править; попытка исправить систему с нарушенными зависимостями. Данная опция, когда используется при операциях установки и удаления, может опускать некоторые пакеты, чтобы позволить APT решить проблему. Любой указанный пакет должен полностью исправлять проблему. Данная опция иногда необходима при запуске APT в первый раз; APT сам не позволяет нарушенным зависимостям пакетов существовать в системе. Возможно, что структура зависимостей в системе может быть нарушена и требовать исправления вручную (что обычно достигается использованием dselect или dpkg --remove для удаления некоторых пакетов). Использование данной опции вместе с -m в некоторых ситуациях приведет к выводу сообщения об ошибке.

Элемент настройки: APT::Get::Fix-Broken.

-h, --help

Помощь; выдать подсказку и завершить работу.

-v, --version

Сообщить версию программы.

-m, --ignore-missing, --fix-missing

Игнорировать отсутствующие пакеты; Если пакеты не могут быть получены или их полная проверка после получения окончилось неудачно (поврежденный файл пакета), то состояние пакета возвращается к предыдущему и результат обрабатывается. Использование этой опции совместно с -f в некоторых случаях может привести к ошибке. Если какой-либо пакет выбирается к установке (например, если он указан в командной строке) и он не может быть получен, то без каких-либо сообщений будет восстановлено исходное состояние.

Элемент настройки: APT::Get::ignore-missing.

--no-download

Запрещает получение пакетов. Лучше всего использовать вместе с --ignore-missing для того, чтобы заставить APT использовать только те .deb файлы, которые уже получены.

Элемент настройки: APT::Get::No-Download.

-q, --quiet

Производится вывод годный для протоколирования, в котором опускаются индикаторы хода выполнения задачи. Указание большего числа опций -q приведет к более урезанному выводу, максимально вы можете указать их в два раза. Вы также можете использовать конструкцию -q=# для установки нужного вам количества сообщений вывода, перекрывая файл с настройками. Заметим, что уровень 2 неявно включает -y, вы никогда не должны использовать -qq без модификатора, который запрещает действия, такого как -d, --print-uris или -s, поскольку APT может сделать что-либо неожиданное для вас.

Элемент настройки: quiet.

-s, --simulate, --just-print, --dry-run, --recon, --no-act

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

Элемент настройки: APT::Get::Simulate.

В режиме симуляции на экран будут выведены серии строк, которые будут отображать операции dpkg, Настройка (Conf), Удаление (Remv), Распаковка (Inst). В квадратных скобках будут указаны пакеты, которые недо-установлены по каким-либо причинам вместе со списком (или без него) заключенных в квадратные скобки причин.

-y, --yes, --assume-yes

Автоматически отвечать "да" в ответ на запрос программы; на все запросы, которые будет выводить программа будет автоматически выдаваться ответ "да". При возникновении нежелательной ситуации, как то: изменения пакета в состоянии удержания или удаления необходимого для работы системы пакета, apt-get будет аварийно завершать свою работу.

Элемент настройки: APT::Get::Assume-Yes.

-u, --show-upgraded

Показать обновленные пакеты; Выдает список всех пакетов, которые были обновлены.

Элемент настройки: APT::Get::Show-Upgraded.

-b, --compile, --build

Компилировать пакеты исходных текстов после их получения.

Элемент настройки: APT::Get::Compile.

--ignore-hold

Игнорировать состояние удержания. Это заставит apt-get игнорировать состояние удержания в котором находится пакет. Это может быть полезным совместно с командой dist-upgrade для перекрытия большого числа нежелательных пакетов в состоянии удержания.

Элемент настройки: APT::Ignore-Hold.

--no-upgrade

Не производить обновлений пакетов; Когда эта опция используется совместно с командой install то no-upgrade предотвратит обновление уже установленных пакетов.

Элемент настройки: APT::Get::no-upgrade.

--force-yes

Принудительное выполнение заданной операции не взирая ни на что. Это опасная опция, которая заставит apt продолжать выполнение операции без каких-либо диалогов с пользователем, даже если возникнет потенциальная возможность ошибки. Она не должна использоваться кроме как в специальных ситуациях. Использование force-yes потенциально способно уничтожить вашу систему!

Элемент настройки: APT::Get::force-yes.

--print-uris

Вместо копирования файлов для установки будут печататься их URI. Каждый URI будет иметь путь, имя файла, размер и ожидаемый хэш md5. Заметим, что выводимое имя файл не всегда совпадает с именем файла на удаленном сайте. Опция также работает и с командой source.

Элемент настройки: APT::Get::Print-URIs.

--purge

Использовать purge (зачистку) вместо remove (удаления) для всех пакетов, которые будут удалены. Эта опция не имеет эффекта на системах использующих RPM.

Элемент настройки: APT::Get::Purge.

--reinstall

Переустановить пакеты, которые уже являются новейшими версиями.

--list-cleanup

Данная опция по умолчанию включена, используйте --no-list-cleanup для ее выключения. Когда apt-get будет автоматически управлять содержимым /var/lib/apt/lists чтобы убедиться, что устаревшие файлы удалены. Выключите данную опцию, если вы часто изменяете ваш список источников.

Элемент настройки: APT::Get::List-Cleanup

--trivial-only

Выполняет только тривиальные операции. Логически это может быть отнесено к --assume-yes, только --assume-yes будет выдавать ответ "да" на любое приглашение, а --trivial-only будет отвечать "нет".

Элемент настройки: APT::Get::Trivial-Only

--no-remove

Если какие-либо пакеты отмечены к удалению, то apt-get немедленно, без вопросов, завершит работу.

Элемент настройки: APT::Get::No-Remove

--diff-only, --tar-only

Получить только diff- или tar-файл из архива исходных текстов.

Элемент настройки: APT::Get::Diff-Only

-c, --config-file

Файл с настройками; Задать файл с настройками. apt-get будет читать файл с настройками по умолчанию и затем указанный файл с настройками.

Смотри синтаксис в apt.conf(5).

-o, --option

Установить опцию настройки; Она будет установлена определенной опцией настройки. Синтаксис такой:

```

-o Foo::Bar=bar
```

## ФАЙЛЫ
o

/etc/apt/sources.list источники для получения пакетов

o

/var/cache/apt/archives/ область хранения полученных файлов

o

/var/cache/apt/archives/partial/ область хранения получаемых файлов

o

/var/state/apt/lists/ область хранения информации о состоянии каждого ресурса пакетов, заданного в списке источников

o

/var/state/apt/lists/partial/ временная область хранения информации в процессе скачивания

## СМОТРИ ТАКЖЕ
apt-cache(8), dpkg(8), dselect(8), sources.list(5), apt.conf(5), The APT Users Guide in /usr/doc/apt/

## ДИАГНОСТИКА
apt-get возвращает ноль при нормальной работе и десятичную 100 при ошибке.

## ОШИБКИ
Смотри http://bugs.debian.org/apt. Если вы хотите отправить отчет об ошибке в apt-cache, пожалуйста смотрите /usr/doc/debian/bug-reporting.txt или команду bug(1). Если вы используете систему базирующуюся на RPM, то в этом случае, пожалуйста, воспользуйтесь http://distro.conectiva.com.br /bugzilla/.

## АВТОР
apt-get была написана командой APT <apt@packages.debian.org> и портирован на системы базирующиеся на RPM Alfredo K. Kojima, <kojima@conectiva.com.br >, из Conectiva S.A.

## ПЕРЕВОД
Перевод с английского сделал Виктор Вислобоков <victor_v@permonline.ru>


arping

title: arping(8)

summary: отправляет ARP-запрос окружающим хостам

text:
# arping(8)

## ИМЯ
arping - отправляет ARP-запрос окружающим хостам

## СИНТАКСИС
arping [ -AbDfhqUV] [ -c счетчик] [ -w дедлайн] [ -s отправитель] -I интерфейс адресат

## ОПИСАНИЕ
Отправляет ARP-запрос устройству с MAC адресат через сетевой интерфейс интерфейс, используя адрес отправителя отправитель.

## ОПЦИИ
-A

Аналогично -U, но используются пакеты ARP REPLY вместо ARP REQUEST.

-b

Отправляет только широковещательные пакеты уровня MAC. Обычно arping сначала отправляет широковещательные пакеты, а после приема ответа - только адресату.

-c счетчик

Останавливает отправку после отсылки счетчик пакетов ARP REQUEST. С дедлайн опцией, arping ожидает счетчик пакетов ARP REPLY, пока не истечет указанное время.

-D

Режим дублированного обнаружения адреса. См. RFC2131, 4.4.1. Возвращает 0, если дублированное определение адреса прошло успешно, т.е. ответы не приняты

-f

Завершает работу после первого приема ответа.

-I интерфейс

Наименование сетевого устройства (интерфейса), через который отправляются пакеты ARP REQUEST. Указание интерфейса для этой опции обязательно.

-h

Отображает страницу помощи и завершает работу.

-q

Вывод не отображается.

-s отправитель

IP адрес отправителя, использующийся в ARP пакетах. Если эта опция не указана, используется следующий адрес отправителя:

•

В режиме сдублированного определения адреса (с опцией -D) - 0.0.0.0.

•

В обычном ARP-режиме (с опцией -U или -A) используется адресат.

•

В других случаях адрес вычисляется по таблице маршрутизации.

-U

Предоставляет содержимое кэша ARP для обновления ARP кэшей соседних систем. Ответы не ожидаются.

-V

Показывает номер версии программы и завершает работу.

-w дедлайн

Указывает таймаут в секундах перед тем, как arping завершит работу и отобразит сколько пакетов было отправлено или принято. В этом случае arping не останавливается после отправки счетчик пакетов, он ожидает пока дедлайн истечет или пока не будет принято счетчик ответов.

## СМ. ТАКЖЕ
ping(8), clockdiff(8), tracepath(8).

## АВТОР
arping написан Алексеем Кузнецовым <kuznet@ms2.inr.ac.ru>.

## БЕЗОПАСНОСТЬ
arping требует возможности выполнения CAP_NET_RAWIO. Это не рекомендуется использовать с битом set-uid root, т.к. позволяет пользователям модифицировать ARP кэш на окружающих системах.

## РАСПРОСТРАНЕНИЕ
arping часть пакета iputils, последние версии доступны в исходных текстах на ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Сергей Быбин <bybin@telros.ru> 2007


arpsend

title: arpsend(8)

summary: утилита для отправки ARP запросов.

text:
# arpsend(8)

## ИМЯ
arpsend - утилита для отправки ARP запросов.

## ОБЗОР
arpsend < -U -i ip_источника | -D -e ip_цели [-e ip_цели] ... > [-c количество] [-w время_ожидания] интерфейс

## ОПИСАНИЕ
Служебная программа arpsend отправляет ARP пакеты на устройство, заданное параметром интерфейс, чтобы обнаружить соседей или обновить ARP-кэши, используя указанный IP адрес.

## КОМАНДЫ
Запустите программу с одной из следующих команд:

-D

Отправить ARP запрос всем узлам, чтобы обнаружить соседей с ip, равным ip_цели. Можно указать конкретный ip_цели (опция -e).

-U

Отправить ARP запрос всем узлам, чтобы обновить ARP-кэши соседей, используя ip_источника. Можно указать конкретный ip_источника (опция -i).

## ОПЦИИ
-c количество

Число пакетов для отправки. По умолчанию число пакетов не ограничено.

-w интервал

Интервал между пакетами в секундах. По умолчанию равен 1 секунда.

-i ip_адрес_источника

Установить значение IP адреса источника в ARP пакете.

-e ip_адрес_назначения

Установить IP адрес назначения в ARP пакете. Обратите внимание, что можно указать флаг -e несколько раз, чтобы обнаружить несколько IP адресов за один вызов программы.

## ДИАГНОСТИКА
arpsend возвращает 0 при успешном завершении. Если что-то идет не так, возвращается соответствующий код ошибки.

1 EXC_USAGE

Ошибка использования.

2 EXC_SYSTEM

Системная ошибка.

3 EXC_RECV

ARP ответ был получен.

## ПРИМЕРЫ
Чтобы обнаружить любой соседний компьютер с IP адресом 192.168.10.200, отправив запрос на интерфейс eth0 :

arpsend -D -e 192.168.10.200 eth0

Чтобы отправить запрос на обновление ARP кэшей соседей через интерфейс eth0, используя IP адрес 192.168.10.200:

arpsend -U -i 192.168.10.200 eth0

## ПРИМЕЧАНИЕ
Используемый интерфейс должен понимать ARP-запросы и не должен быть loopback интерфейсом (т.е. команда /sbin/ip link show интерфейс не должна выводить ни NOARP, ни LOOPBACK флагов в параметрах интерфейса).

## СМ. ТАКЖЕ
vzctl(8),

## АВТОРСКИЕ ПРАВА
Copyright (C) 2000-2007, SWsoft. Распространяется на условиях GNU GPL.

## ПЕРЕВОД
Перевод с английского Виктор Ерёмин <ErV2005@rambler.ru> 2007.


auditctl

title: auditctl(8)

text:
# auditctl(8)

## ИМЯ
auditctl - инструмент для управления аудитом, предоставляемого Linux ядром.

## ОБЗОР
auditctl [опции]

## ОПИСАНИЕ
auditctl используется для настройки параметров ядра, связанных с аудитом, для просмотра конфигурации аудита и для добавления/удаления правил аудита.

## ОПЦИИ КОНФИГУРАЦИИ
-b количество

Установить максимальное количество буферов аудита (значение в ядре по умолчанию - 64). Если все буферы заполнены, то флаг сбоя будет выставлен ядром для его дальнейшей обработки.

--backlog_wait_time время_ожидания

Установить время ожидания для ядра достижения значения backlog_limit (значение в ядре по умолчанию - 60*HZ), прежде, чем ставить в очередь дополнительные события аудита для их передачи аудиту. Число должно быть больше или равно нулю, но меньше, чем десятикратное значение по умолчанию.

-c

Продолжать загружать правила, несмотря на ошибку. Суммирует результат загрузки правил. Код завершения будет ошибочным, если какое-либо правило не будет загружено.

-D

Удалить все правила и точки наблюдения. Может также принимать параметр -k.

-e [0..2]

Установить флаг блокировки. 0 - отключить аудит, 1 - включить аудит, 2 - защитить конфигурацию аудита от изменений. Для использования данной возможности необходимо внести данную команду последней строкой в audit.rules. После этой команды все попытки изменить конфигурацию будут отвергнуты с уведомлением в журналах аудита. В дальнейшем, чтобы задействовать новую конфигурацию аудита, необходимо перезагрузить систему.

-f [0..2]

Установить способ обработки для флага сбоя: 0=silent 1=printk 2=panic. Позволяет определить каким образом ядро будет обрабатывать критические ошибки. Например, флаг сбоя выставляется при следующих условиях: ошибки передачи в пространство службы аудита, превышение лимита буферов, ожидающих обработки, выход за пределы памяти ядра, превышение лимита скорости выдачи сообщений. Значение по умолчанию: 1. Для систем с повышенными требованиями к безопасности, может быть более предпочтительно значение 2.

-h

Краткая помощь по аргументам командной строки.

-i

Игнорировать ошибки при чтении правил из файла. В этом случае auditctl будет всегда возвращать успешный код завершения. Если этот параметр передан в качестве аргумента -s то привести, если это возможно, числа к удобочитаемому виду.

--loginuid-immutable

Сделать login UID неизменяемым сразу после его установки. Для изменения login UID требуется CAP_AUDIT_CONTROL, поэтому непривилигированный пользователь не может его изменить. Установка этого параметра может вызвать проблемы в некоторых контейнерах.

-q точка-монтирования,поддерево

При наличии точки наблюдения за каталогом и объединении или перемещении монтирования другого поддерева в наблюдаемое поддерево, необходимо указать ядру, сделать монтируемое поддерево эквивалентным просматриваемому каталогу. Если поддерево уже смонтировано во время создания точки наблюдения за каталогом, поддерево автоматически помечается для просмотра. Эти два значения разделяет запятая, отсутствие запятой приведет к ошибке.

-r частота

Установить ограничение скорости выдачи сообщений в секунду (0 - нет ограничения). Если эта частота не нулевая и она превышается в ходе аудита, ядром выставляется флаг сбоя для выполнения соответствующего действия. Значение по умолчанию: 0.

--reset-lost

Сбросить счетчик потерянных записей, отображаемых командой статуса.

-R файл

Читать правила из файла. Правила должны быть организованы следующим образом: располагаться по одному в строке и в том порядке, в каком должны исполняться. На файл накладываются следующие ограничения: владельцем должен быть root и доступ на чтение должен быть только у него; файл может содержать комментарии, начинающиеся с символа '#'; правила, расположенные в файле, идентичны тем, что набираются в командной строке, без указания 'auditctl' (так как auditctl - это тот, кто выполняет файл), и без экранирования символов подстановки (так как файл читает auditctl).

-t

Обрезать поддеревья после команды монтирования.

## ОПЦИИ СОСТОЯНИЯ
-l

Вывести список всех правил по одному правилу в строке. Этой команде могут быть предоставлены две опции. Можно указать либо ключ фильтрации -k, чтобы вывести список правил, соответствующих ключу, либо опцию -i интерпретирующую значения полей от a0 до a3, для корректного определения значений аргументов системных вызовов.

-m текст

Послать в систему аудита пользовательское сообщение. Это может быть сделано только если у пользователя есть возможность CAP_AUDIT_WRITE (обычно есть у пользователя root). Результирующее событие будет типом USER.

-s

Получить статус аудита. Будут показаны значения, которые можно установить с помощью опций -e, -f, -r и -b. Значение pid - это номер процесса демона аудита. Значение pid 0 указывает, что демон аудита не работает. Поле lost сообщает, сколько записей событий аудита было отброшено из-за переполнения буфера аудита. Поле backlog сообщает, сколько записей событий аудита находится в очереди, ожидая, когда auditd прочитает их. С этим параметром можно использовать опцию -i для интерпретации значений некоторых полей.

-v

Вывести версию auditctl.

## ОПЦИИ ПРАВИЛ
-a [список,действие|действие,список]

Добавить правило с указанным действием к концу списка. Необходимо учитывать, что значения fIдействие и список разделены запятой, и ее отсутствие вызовет ошибку. Поля могут быть указаны в любом порядке. Ниже описаны имена доступных списков:

task

Добавить правило к списку, отвечающему за процессы. Этот список правил используется только во время создания процесса - когда родительский процесс вызывает fork() или clone(). При использовании этого списка вы можете использовать только те поля, которые известны во время создания процесса: uid, gid и т.д.

exit

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

user

Добавить правило, отвечающего за список фильтрации пользовательских сообщений. Этот список используется ядром, чтобы отфильтровать события приходящие из пользовательского пространства, перед тем как они будут переданы демону аудита. Необходимо отметить, что только следующие поля могут быть использованы: uid, auid, gid, pid, subj_user, subj_role, subj_type, subj_sen, subj_clr и msgtype. Все остальные поля будут обработаны, как если бы они не совпали. Следует понимать, что любое событие, происходящее из пространства пользователя от процесса имеющего CAP_AUDIT_WRITE, будет записано в аудит. Это означает, что наиболее вероятно использование этого фильтра с правилами, которые имеют действие "никогда", так как ничего не нужно делать, чтобы события были записаны.

exclude

Добавить правило к списку, отвечающего за фильтрацию событий определенного типа. Этот список используется, чтобы отфильтровывать ненужные события. Например, если вы не хотите видеть avc сообщения, вы должны использовать этот список. События могут быть исключены по идентификатору процесса, идентификатору пользователя, идентификатору группы, идентификатору логина пользователя, типу сообщения или контексту объекта. Действие игнорируется и по умолчанию используется значение "never" ("никогда").

Ниже описаны доступные действия для правил:

never

Аудит не будет генерировать никаких записей. Может быть использовано для подавления генерации событий. Обычно необходимо подавлять генерацию вверху списка, а не внизу, поскольку событие инициируется на первом совпавшем правиле.

always

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

-A список,действие

Добавить правило с указанным действием в начало списка.

-C [f=f | f!=f]

Создать правило сравнения между полями: поле, операция, поле. Можно передавать несколько сравнений в одной командной строке. Каждое из них должно начинаться с -C. Каждое правило сравнения добавляется друг к другу, а также к правилам начинающимся с -F для инициирования записи аудита. Поддерживаются 2 оператора - равно и не равно. Допустимые поля:

auid, uid, euid, suid, fsuid, obj_uid; и gid, egid, sgid, fsgid, obj_gid

Две группы uid и gid не могут быть смешаны. Внутри группы может быть сделано любое сравнение. Поля obj_uid/gid собираются из объекта события, такого как файл или каталог.

-d список,действие

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

-F [n=v | n!=v | n<v | n>v | n<=v | n>=v | n&v | n&=v]

Задать поле сравнения для правила. Атрибуты поля следующие: объект, операция, значение. В одной команде допускается задавать до 64 полей сравнения. Каждое новое поле должн начинаться с -F. Аудит будет генерировать запись, если произошло совпадение по всем полями сравнения. Допустимо использование одного из следующих 8 операторов: равно, не равно, меньше, больше, меньше либо равно, больше либо равно, битовая маска (n&v) и битовая проверка (n&=v). Битовая проверка выполняет операцию 'and' над значениями и проверяет, равны ли они. Битовая маска просто выполняет операцию 'and'. Поля, оперирующие с идентификатором пользователя, могут также работать с именем пользователя - программа автоматически получит идентификатор пользователя из его имени. То же самое можно сказать и про имя группы. Поля сравнения могут быть заданы для следующих объектов:

a0, a1, a2, a3

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

arch

Архитектура процессора, на котором выполняется системный вызов. Для определения архитектуры необходимо использовать команду 'uname -m'. В случае если архитектура машины неизвестна, однако необходимо использовать таблицу 32-х битных системных вызовов, и машина поддерживает 32 бита, можно использовать b32. Аналогичным образом применяется таблица системных вызовов b64. Можно написать правила, которые в некоторой степени не зависят от архитектуры, потому что тип будет определяться автоматически. Однако системные вызовы могут зависеть от архитектуры, и то, что доступно на x86_64, может быть недоступно на PPC. Директива arch должна предшествовать опции -S, чтобы auditctl знал, какую внутреннюю таблицу использовать для поиска номеров системных вызовов.

auid

Оригинальный идентификатор, с которым пользователь вошел в систему. Это аббревиатура: audit uid. Можно использовать либо имя пользователя, либо идентификатор пользователя.

devmajor

Главный номер устройства (Device Major Number).

devminor

Вспомогательный номер устройства (Device Minor Number).

dir

Полный путь к каталогу для создания точки наблюдения. Помещает точку наблюдения в каталог и рекурсивно во все его поддерево. Можно использовать только в списке exit. См. описание опции "-w".

egid

Действительный идентификатор группы. Можно использовать либо идентификатор, либо имя группы.

euid

Действительный идентификатор пользователя. Можно использовать либо идентификатор, либо имя пользователя.

exe

Абсолютный путь к приложению, к которому будет применяться это правило. Можно использовать только в списке exit.

exit

Значение, возвращаемое системным вызовом при выходе. Если кодом выхода является errno, можно также использовать текстовое представление.

fsgid

Идентификатор группы, применяемый к файловой системе. Можно использовать либо идентификатор, либо имя группы.

fsuid

Идентификатор пользователя, применяемый к файловой системе. Можно использовать либо идентификатор, либо имя пользователя.

filetype

Тип целевого файла: файл, каталог, сокет, ссылка, символ, блок или FIFO.

gid

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

inode

Номер inode.

key

Альтернативный способ установить ключ фильтрации. См. выше описание опции -k.

msgtype

Используется для проверки совпадения с числом, описывающим тип сообщения. Может быть использован только в списках exclude и user.

obj_uid

UID объекта.

obj_gid

GID объекта.

obj_user

Имя пользователя-владельца ресурса (в контексте SELinux).

obj_role

Роль ресурса (в контексте SELinux).

obj_type

Тип ресурса (в контексте SELinux).

obj_lev_low

Нижний уровень ресурса (в контексте SELinux).

obj_lev_high

Верхний уровень ресурса (в контексте SELinux).

path

Полный путь к файлу для точки наблюдения. Может быть использован только в списке exit.

perm

Фильтр прав доступа для файловых операций. См. описание опции "-p". Может быть использован только в списке exit. Можно использовать без указания системного вызова, при этом ядро выберет системные вызовы, которые удовлетворяют запрашиваемым разрешениям.

pers

Персональный номер операционной системы.

pid

Идентификатор процесса.

ppid

Идентификатор родительского процесса.

sessionid

Идентификатор сеанса пользователя.

subj_user

Имя пользователя-владельца процесса (в контексте SELinux).

subj_role

Роль процесса (в контексте SELinux).

subj_type

Тип процесса (в контексте SELinux).

subj_sen

Чувствительность процесса (в контексте SELinux).

subj_clr

Допуск процесса (в контексте SELinux).

sgid

Установленный идентификатор группы. Подробнее об этом в руководстве getresgid(2).

success

Если значение, возвращаемое системным вызовом, больше либо равно 0, данный объект будет равен "true/yes", иначе "false/no". При создании правила следует использовать 1 вместо "true/yes" и 0 вместо "false/no".

suid

Установленный идентификатор пользователя. Подробнее об этом в руководстве getresuid(2).

uid

Идентификатор пользователя. Можно использовать либо идентификатор, либо имя пользователя.

-k ключ

Установить на правило ключ фильтрации. Ключ фильтрации - это произвольная текстовая строка длиной не больше 31 символа. Ключ помогает уникально идентифицировать записи, генерируемые в хода аудита за точкой наблюдения. Поиск значения ключа можно выполнить с помощью команды ausearch, чтобы независимо от того, какое правило вызвало событие, можно было найти его результаты. Ключ также можно использовать для удаления всех правил (-D), или правил с определенным ключом (-l). В правиле можно использовать несколько ключей, если необходимо иметь возможность поиска зарегистрированных событий несколькими способами или если применяется плагин audispd, который в своем анализе использует ключ.

-p [r|w|x|a]

Установить фильтр прав доступа для точки наблюдения. r=чтение, w=запись, x=исполнение, a=изменение атрибута. Не путайте эти права доступа с обычными правами доступа к файлу - они определяют типы системных вызовов, которые выполняют данные действия. Заметьте, что системные вызовы read и write не включены в этот набор, поскольку логи аудита были бы перегружены информацией о работе этих вызовов.

-S [Имя или номер системного вызова|all]

Любой номер или имя системного вызова может быть использован. Также возможно использование ключевого слова all. Если какой-либо процесс выполняет указанный системный вызов, то аудит генерирует соответствующую запись. В случае если значения полей сравнения заданы, а системный вызов не указан, правило будет применяться ко всем системным вызовам. В одном правиле может быть задано несколько системных вызовов (используя несколько параметров -S в одном правиле) - это положительно сказывается на производительности, поскольку заменяет обработку нескольких правил. Кроме того, список системных вызовов может быть передан через запятую. При работе в двухархитектурной системе, например x86_64, необходимо помнить, что auditctl просто берет текст, ищет его для собственной архитектуры и отправляет это правило в ядро. Если никаких дополнительных директив по архитектуре нет, правило БУДЕТ ПРИМЕНЯТЬСЯ К 32 И 64 БИТОВЫМ СИСТЕМНЫМ ВЫЗОВАМ. Это может иметь нежелательные последствия, поскольку нет гарантии того, что любой системный вызов имеет одинаковый номер на 32- и 64-разрядных интерфейсах. Следует написать 2 правила: одно для 32-битной архитектуры (b32), другое для 64-битной (b64), чтобы убедиться, что ядро находит все ожидаемые события. Для получения дополнительной информации см. описание поля arch.

-w путь

Добавить точку наблюдения за файловым объектом, находящемуся по указанному пути. Добавление точки наблюдения к каталогу верхнего уровня запрещено ядром. Групповые символы (wildcards) также не могут быть использованы, попытки их использования будут генерировать предупреждающее сообщение. Внутренне точки наблюдения реализованы как слежение за inode. Установка точки наблюдения за файлом аналогична использованию параметра path в правиле системного вызова -F. Установка точки наблюдения за каталогом аналогична использованию параметра dir в правиле системного вызова -F. Форма -w предназначена для обратной совместимости, а форма на основе системного вызова более выразительна. В противоположность к правилам аудита системных вызовов, точки наблюдения не оказывают влияния на производительность, связанную с количеством правил посылаемых в ядро. Единственными допустимыми параметрами при использовании точек наблюдения являются -p и -k. Если необходим аудит чего-то необычного, например определенного пользователя обращающегося к файлу, следует использовать аудит системных вызовов с полями path или dir. В разделе ПРИМЕРЫ приведен пример преобразования одной формы в другую.

-W путь

Удалить точку наблюдения за файловым объектом, находящемуся по указанному пути. Правило должно точно совпадать. Для получения дополнительной информации см. описание параметра -d.

## СОВЕТЫ ПО ИСПОЛЬЗОВАНИЮ
Правила системных вызовов оцениваются для каждого системного вызова каждой программы. При наличии 10 правил системных вызовов, каждая программа в системе будет задержана во время системного вызова, пока система аудита оценивает каждое правило. Большое количество системных вызовов негативно отразиться на производительности. Можно объединять правила если фильтр, действие, ключ и поля совпадают. Например:

```
auditctl -a always,exit -S openat -F success=0
```

```
auditctl -a always,exit -S truncate -F success=0
```

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

```
auditctl -a always,exit -S openat -S truncate -F success=0
```

Кроме того, следует стараться использовать аудит файловой системы везде, где это возможно. Это улучшает производительность. Например, для того, чтобы захватывать все неудачные вызовы openat и truncate, как в примере выше, но только для файлов в каталоге /etc и не заботиться о файлах в /usr или /sbin, можно использовать это правило:

```
auditctl -a always,exit -S openat -S truncate -F dir=/etc -F success=0
```

При этом производительность будет выше, так как ядро не будет оценивать каждый системный вызов. Он будет обрабатываться аудитом файловой системы и будет проверяться только в системных вызовах, связанных с файловой системой.

## ПРИМЕРЫ
Чтобы увидеть все системные вызовы, используемые определенным процессом:

```
auditctl -a always,exit -S all -F pid=1005
```

Чтобы увидеть все файлы, открытые определенным пользователем:

```
auditctl -a always,exit -S openat -F auid=510
```

Чтобы увидеть неудачные попытки вызова системной функции 'openat':

```
auditctl -a always,exit -S openat -F success=0
```

Чтобы отслеживать изменения файла (2 способа):

```
auditctl -w /etc/shadow -p wa
auditctl -a always,exit -F path=/etc/shadow -F perm=wa
```

Чтобы отслеживать попытки администратора получить доступ к файлам других пользователей:

```
auditctl -a always,exit -F dir=/home/ -F uid=0 -C auid!=obj_uid
```

## ФАЙЛЫ
/etc/audit/audit.rules

## СМ. ТАКЖЕ
audit.rules(7), auditd(8).

## АВТОР
Стив Граб (Steve Grubb)

## ПЕРЕВОД
Перевод с английского Alexander Kolotov (alexandr.kolotov@gmail.com) 2007

Перевод с английского Елена Мишина <lepata@altlinux.org> 2019


auditd

title: auditd(8)

summary: демон аудита Linux

text:
# auditd(8)

## ИМЯ
auditd - демон аудита Linux

## СИНТАКСИС
auditd [-f] [-l] [-n] [-s disable|enable|nochange] [-c <config_dir>]

## ОПИСАНИЕ
auditd - это прикладной компонент системы аудита Linux. Он ведёт протокол аудита на диске. Для просмотра протоколов предназначены команды ausearch и aureport. Настройка системы аудита и загрузка правил выполняется с помощью команды auditctl. Кроме того, при загрузке auditctl читает правила из файла /etc/audit/audit.rules и загружает их в ядро. Кроме того, существует также программа augenrules, которая читает правила, расположенные в /etc/audit/rules.d/, и компилирует их в файл audit.rules. У демона аудита есть некоторые параметры конфигурации, которые администратор может настроить. Их можно найти в файле auditd.conf.

## ОПЦИИ
-f

не переходить в фоновый режим (для отладки). Сообщения программы будут направляться в стандартный вывод для ошибок (stderr), а не в журнал аудита.

-l

включить следование по символическим ссылкам при поиске конфигурационных файлов.

-n

не создавать дочерний процесс. Для запуска из inittab или systemd.

-s=ENABLE_STATE

указать, должен ли auditd при старте изменять текущее значение флага ядра - enabled. Допустимые значения ENABLE_STATE: disable, enable и nochange. Значение по умолчанию enable (и disable когда auditd остановлен). Значение флага может быть изменено во время жизненного цикла auditd с помощью 'auditctl -e'.

-c

указать альтернативный каталог конфигурационного файла (по умолчанию: /etc/audit/). Обратите внимание, что этот же каталог будет передан диспетчеру.

## СИГНАЛЫ
SIGHUP

перезагрузить конфигурацию - загрузить файл конфигурации с диска. Если в файле не окажется синтаксических ошибок, внесенные в него изменения вступят в силу. При этом в протокол будет добавлена запись о событии DAEMON_CONFIG. В противном случае действия службы будут зависеть от параметров space_left_action, admin_space_left_action, disk_full_action, disk_error_action файла auditd.conf.

SIGTERM

прекратить обработку событий аудита и завершить работу, о чём предварительно занести запись в протокол.

SIGUSR1

произвести ротацию файлов журналов auditd. Создать новый файл для протокола, перенумеровав старые файлы или удалив часть из них, в зависимости от параметра max_log_file_action.

SIGUSR2

попытаться возобовить ведение журналов auditd (обычно необходимо после приостановки ведения журнала).

## ФАЙЛЫ
/etc/audit/auditd.conf - файл конфигурации демона аудита

/etc/audit/audit.rules - правила аудита (загружается при запуске службы)

/etc/audit/rules.d/ - каталог, содержащий отдельные наборы правил, которые будут скомпилированы в один файл утилитой augenrules.

## ПРИМЕЧАНИЯ
Для того чтобы сделать возможным аудит всех процессов, запущенных до демона аудита, необходимо добавить в строку параметров ядра (в конфигурации загрузчика) audit=1. В противном случае аудит некоторых процессов будет невозможен.

Демон аудита может получать события аудита от других демонов аудита через плагин audispd: audisp-remote. Демон аудита может быть связан с tcp_wrappers, чтобы контролировать, какие машины могут подключаться. В этом случае можно добавить запись в hosts.allow и отказать в соединении.

## СМ. ТАКЖЕ
auditd.conf(5), audispd(8), ausearch(8), aureport(8), auditctl(8), augenrules(8), audit.rules(7).

## АВТОР
Стив Граб (Steve Grubb)

## ПЕРЕВОД
Перевод с английского Николай Шафоростов <shafff@ukr.net> 2007

Перевод с английского Елена Мишина <lepata@altlinux.org> 2019


augenrules

title: augenrules(8)

text:
# augenrules(8)

## ИМЯ
augenrules - скрипт, объединяющий файлы правил аудита

## ОБЗОР
augenrules [--check] [--load]

## ОПИСАНИE
augenrules - скрипт, читает правила, расположенные в каталоге /etc/audit/rules.d и объединяет их в файле /etc/audit/audit.rules. Этот скрипт обрабатывает все файлы, оканчивающиеся на .rules. Все остальные файлы в /etc/audit/rules.d игнорируются.

Файлы объединяются в порядке, основанном на их естественной сортировке (смотри параметр -v в ls(1)), пустые строки и строки комментариев (#) исключаются.

Последняя обработанная директива -D без параметров, если она есть, всегда выводится в качестве первой строки в результирующем файле. Последняя обработанная директива -b directive, если она есть, всегда выводится как вторая строка в результирующем файле. Последняя обработанная директива -f directive, если она есть, всегда выводится в качестве третьей строки в результирующем файле. Последняя обработанная директива -e directive, если она есть, всегда выводится как последняя строка в результирующем файле.

Сгенерированный файл копируется в /etc/audit/audit.rules только если он отличается от уже существующего.

## ОПЦИИ
--check

проверить, изменились ли правила и нужно ли их обновлять, не перезаписывая audit.rules.

--load

загрузить старые или новые правила в ядро.

## ФАЙЛЫ
/etc/audit/rules.d/ /etc/audit/audit.rules

## СМ. ТАКЖЕ
audit.rules(8), auditctl(8), auditd(8).

## ПЕРЕВОД
Перевод с английского Elena Mishina <lepata@altlinux.org> 2019


aureport

title: aureport(8)

text:
# aureport(8)

## ИМЯ
aureport - инструмент для генерации итоговых отчетов на основе логов демона аудита.

## ОБЗОР
aureport [опции]

## ОПИСАНИE
aureport - это инструмент, который генерирует итоговые отчеты на основе логов демона аудита. aureport может также принимать данные со стандартного ввода (stdin) до тех пор, пока на входе будут необработанные данные логов. В шапке каждого отчета для каждого столбца есть заголовок - это облегчает понимание данных. Все отчеты, кроме основного итогового отчета, содержат номера событий аудита. Используя их, можно найти полные данные о событии с помощью команды ausearch -a номер события. Если в отчете слишком много данных, можно задать время начала и время окончания для уточнения временного промежутка. Отчеты, генерируемые aureport, могут быть использованы как исходный материал для получения более развернутых отчетов.

## ОПЦИИ
-au, --auth

Отчет о всех попытках аутентификации

-a, --avc

Отчет о всех avc сообщениях

--comm

Отчет о выполнении команд

-c, --config

Отчет об изменениях конфигурации

-cr, --crypto

Отчет о событиях, связанных с шифрованием

-e, --event

Отчет о событиях

--escape option

Экранировать вывод. Возможные значения raw, tty, shell и shell_quote. Каждый режим включает в себя символы предыдущего режима и экранирует больше символов. То есть shell включает все символы, экранируемые tty, и добавляет новые. Значение по умолчанию - tty.

-f, --file

Отчет о файлах и сокетах af_unix

--failed

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

-h, --host

Отчет о хостах

-i, --interpret

Транслировать числовые значения в текстовые. Например, идентификатор пользователя будет преобразован в имя пользователя. Трансляция выполняется с использованием данных с той машины, где запущен aureport. То есть если вы переименовали учетные записи пользователей или не имеете таких же учетных записей на вашей машине, то вы можете получить результаты, вводящие в заблуждение.

-if, --input файл | каталог

Использовать указанный файл или каталог вместо логов аудита. Это может быть полезно при анализе логов с другой машины или при анализе частично сохраненных логов.

--input-logs

Использовать местоположение файла журнала из auditd.conf как исходные данные для анализа. Применяется при использовании команды aureport в задании cron.

--integrity

Отчет о событиях целостности

-k, --key

Отчет о ключевых словах в правилах

-l, --login

Отчет о попытках входа в систему

-m, --mods

Отчет об изменениях пользовательских учетных записей

-ma, --mac

Отчет о событиях в системе обеспечивающей мандатное управление доступом - Mandatory Access Control (MAC)

-n, --anomaly

Отчет об аномальных событиях. Эти события включают переход сетевой карты в беспорядочный режим и ошибки сегментации

--node node-name

Отобразить в отчете только события со строкой имя узла. По умолчанию включены все узлы. Допускается перечисление нескольких узлов

-nc, --no-config

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

-p, --pid

Отчет о процессах

-r, --response

Отчет о реакциях на аномальные события

-s, --syscall

Отчеты о системных вызовах

--success

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

--summary

Генерировать итоговый отчет, который дает информацию только о количестве элементов в том или ином отчете. Такой режим есть не у всех отчетов

-t, --log

Этот параметр генерирует отчет о временных рамках каждого отчета

--tty

Отчеты о нажатых клавишах

-te, --end [end-date] [end-time]

Искать события, которые произошли раньше (или во время) указанной временной точки. Формат даты и времени зависит от региональных настроек. Если дата не указана, то подразумевается текущий день (today). Если не указано время, то подразумевается текущий момент (now). Используйте 24-часовую нотацию времени, а не AM/PM. Например, дата может быть задана как 09/03/2009, а время - как 18:00:00. На принятый формат даты влияет переменная среды LC_TIME. Также допускается использовать следующие ключевые слова: now (сейчас), recent, boot, today, yesterday, this-week, week-ago, this-month, this-year. Now - сейчас. Recent - 10 минут назад. Boot - время за секунду до того, когда система загружалась в последний раз. Today - первая секунда после полуночи текущего дня. Yesterday - первая секунда после полуночи предыдущего дня. This-week - первая секунда после полуночи первого дня текущей недели, первый день недели определяется из ваших региональных настроек (см. localtime). Week-ago - первая секунда после полуночи ровно 7 дней назад. This-month - первая секунда после полуночи первого числа текущего месяца. This-year - первая секунда после полуночи первого числа первого месяца текущего года.

-tm, --terminal

Отчет о терминалах

-ts, --start [start-date] [start-time]

Искать события, которые произошли после (или во время) указанной временной точки. Формат даты и времени зависит от региональных настроек. Если дата не указана, то подразумевается текущий день (today). Если не указано время, то подразумевается полночь (midnight). Используйте 24-часовую нотацию времени, а не AM/PM. Например, дата может быть задана как 09/03/2009, а время - как 18:00:00. Также допускается использовать следующие ключевые слова: now (сейчас), recent, boot, today, yesterday, this-week, week-ago, this-month, this-year. now (сейчас), recent, boot, today, yesterday, this-week, week-ago, this-month, this-year. Now - сейчас. Recent - 10 минут назад. Boot - время за секунду до того, когда система загружалась в последний раз. Today - первая секунда после полуночи текущего дня. Yesterday - первая секунда после полуночи предыдущего дня. This-week - первая секунда после полуночи первого дня текущей недели, первый день недели определяется из ваших региональных настроек (см. localtime). Week-ago - первая секунда после полуночи ровно 7 дней назад. This-month - первая секунда после полуночи первого числа текущего месяца. This-year - первая секунда после полуночи первого числа первого месяца текущего года.

-u, --user

Отчет о пользователях

-v, --version

Вывести версию программы и выйти

--virt

Отчеты о событиях виртуализации

-x, --executable

Отчет об исполняемых объектах

## СМ. ТАКЖЕ
ausearch(8), auditd(8).

## ПЕРЕВОД
Перевод с английского Alexander Kolotov (alexandr.kolotov@gmail.com) 2007

Перевод с английского Елена Мишина <lepata@altlinux.org> 2019


ausearch

title: ausearch(8)

summary: инструмент поиска по журналу аудита

text:
# ausearch(8)

## ИМЯ
ausearch - инструмент поиска по журналу аудита

## СИНТАКСИС
ausearch [опции]

## ОПИСАНИЕ
Программа ausearch является инструментом поиска по журналу аудита. ausearch может также принимать данные со стандартного ввода (stdin) до тех пор, пока на входе будут необработанные данные логов. Все условия, указанные в параметрах, объединяются логическим И. К примеру, при указании -m и -ui в качестве параметров будут показаны события, соответствующие заданному типу и идентификатору пользователя. Исключением являются параметры -m и -n (в строке поиска допускается указание несколько типов записей и имен узлов, которые будут возвращать любой соответствующий узел и запись).

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

Различные части ядра могут добавлять дополнительные записи. Например, в событие аудита для системного вызова "open" добавляется запись PATH с именем файла. ausearch показывает все записи события вместе. Это означает, что при запросе определенных записей результат может содержать записи SYSCALL.

Также помните, что не все типы записей содержат указанную информацию. Например, запись PATH не содержит имя узла или loginuid.

## ОПЦИИ
-a, --event идентификатор_события

Искать события с заданным идентификатором события. В сообщении msg=audit(1116360555.329:2401771), идентификатор события - число после ':'. Все события аудита, связанные с одним системным вызовом имеют одинаковый идентификатор. Второй системный вызов, сделанный тем же приложением, будет иметь другой идентификатор события.

--arch CPU

Искать события на основе определенной архитектуры процессора. В случае если архитектура машины неизвестна, однако необходимо использовать таблицу 32-х битных системных вызовов, и машина поддерживает 32 бита, можно использовать b32. Аналогичным образом применяется таблица системных вызовов b64. Для определения архитектуры необходимо использовать команду 'uname -m'.

-c, --comm comm-name

Искать события с заданным comm-name, именем исполняемого файла из структуры задачи.

--debug

Вывести сообщения, пропущенные stderr.

--checkpoint контрольная_точка

Контрольная точка это вывод между последовательными вызовами ausearch, ак что в последующих вызовах будут выводиться только события, не попавшие в предыдущий вывод. Событие auditd состоит из одной или нескольких записей. При обработке события ausearch определяет события как завершенные и незавершенные. Завершенное событие - это одно событие записи или то, которое произошло раньше, чем за 2 секунды по сравнению с текущим обрабатываемым событием.

Контрольная точка обеспечивается путем записи последнего завершенного события вывода вместе с номером устройства и индексом файла последнего завершившегося события в файл контрольной точки. При следующем вызове ausearch загрузит данные контрольной точки и при обработке файлов журнала, будет отбрасывать все завершенные события, пока они не соответствуют контрольной точке, в этот момент ausearch начнет выводить события.

Если файл или последнее событие контрольной точки не будут найдены, произойдет ошибка, и команда ausearch прекратит работу. Подробнее см. EXIT STATUS.

-e, --exit exit-или-errno

Искать события на основе кода системного вызова exit или errno.

--escape option

Экранировать вывод. Возможные значения raw, tty, shell и shell_quote. Каждый режим включает в себя символы предыдущего режима и экранирует больше символов. То есть shell включает все символы экранируемые tty и добавляет новые. Значение по умолчанию - tty.

--extra-keys

Если параметр format имеет значение csv, вывести столбец с дополнительной информацией. Работает только с записями SYSCALL, которые были записаны в результате запуска правила аудита определенного ключом.

--extra-labels

Если параметр format имеет значение csv, добавить информацию о метках субъекта и объекта (если метки существуют).

--extra-obj2

Если параметр format имеет значение csv, добавить информацию о втором объекте (если он существует). Второй объект иногда является частью записи, например, при переименовании файла или монтировании устройства.

--extra-time

Если параметр format имеет значение csv, добавить информацию о времени простоя.

-f, --file файл

Искать события с заданным именем файла. Аргумент будет соответствовать обычным файлам, а также сокетам af_unix.

--format опция

Отформатировать события, которые соответствуют критериям поиска. Поддерживаемые форматы: raw, default, interpret, csv и text. Значение raw описано в опции --raw. При значении default строки выводятся без форматирования, в выводе используется одна строка в качестве визуального разделителя, далее указывается метка времени, а затем следуют записи события. Значение interpret объясняется в описании опции -i. При значении csv результат поиска выводится в формате CSV (от англ. Comma-Separated Values - значения, разделённые запятыми). Значение text преобразует вывод к формату предложений, что упрощает понимание вывода, но происходит это за счет потери деталей. В большинстве случаев это очень удобно, так при этом сохраняется почти вся исходная информация.

-ga, --gid-all идентификатор_группы

Искать события с заданным эффективным или обычным идентификатором группы.

-ge, --gid-effective эффективный_идентификатор_группы

Искать события с заданным эффективным идентификатором группы или именем группы.

-gi, --gid группа

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

-h, --help

Справка

-hn, --host имя_узла

Искать события с заданным именем узла. Имя узла может быть именем узла, полным доменным именем или цифровым сетевым адресом. Попытка разрешить числовые адреса в доменные имена или псевдонимы не производится. Поиск обычно соответствует полю addr или host событий аудита. Также см. команду --node, которая ищет поле узла.

-i, --interpret

Транслировать числовые значения в текстовые. Например, идентификатор пользователя будет транслирован в имя пользователя. Трансляция выполняется с использованием данных с той машины, где запущен ausearch. То есть если вы переименовали учетные записи пользователей или не имеете таких же учетных записей на вашей машине, то вы можете получить результаты, вводящие в заблуждение. Если журналы расширены, для преобразования используются дополнительные данные. Это позволяет получать точные отчеты журнала, даже если поиск запускается на компьютере, отличном от исходного журнала.

-if, --input файл | каталог

Использовать указанный файл или каталог вместо логов аудита. Это может быть полезно при анализе логов с другой машины или при анализе частично сохраненных логов.

--input-logs

Использовать местоположение файла журнала из auditd.conf как исходные данные для поиска. Применяется при использовании команды ausearch из задания cron.

--just-one

Остановиться после выдачи первого события, соответствующего критериям поиска.

-k, --key ключевое_слово

Искать события с заданным ключевым словом.

-l, --line-buffered

Сбрасывать вывод после каждой строки. Полезно если стратегия буферизации блоков по умолчанию нежелательна.

-m, --message тип_сообщения | список_типов_сообщений

Искать события с заданным типом, при этом можно указать список значений, разделенных запятыми или несколько отдельных типов сообщений, каждый со своей опцией -m. Можно указать несуществующий в событиях тип ALL, который позволяет получить все сообщения системы аудита. Список допустимых типов будет выведен, если указать эту опцию без значения. Тип сообщения может быть строкой или числом. В списке значений этого параметра в качестве разделителя используются запятые и пробелы недопустимы.

-n, --node

Искать события с определенного узла. Допускается указание нескольких узлов (для вывода достаточно совпадение любого узла). Поиск использует поле node в событиях аудита. Также см. описание опции --host, которая позволяет искать события, связанные с заданным именем узла.

-o, --object контекст

Искать события с заданным контекстом (в контексте SELinux).

-p, --pid идентификатор_процесса

Искать события с заданным идентификатором процесса.

-pp, --ppid идентификатор_родительского_процесса

Искать события с заданным идентификатором родительского процесса.

-r, --raw

Необработанный вывод. Используется для извлечения записей для дальнейшего анализа.

-sc, --success системный_вызов

Искать события с заданным системным вызовом. Можно указать номер или имя системного вызова. При указании имени системного вызова, оно будет проверено по таблице системных вызовов на машине, где запущен ausearch.

-se, --context контекст_SELinux

Искать события с заданным контекстом SELinux (scontext/субъект или tcontext/object).

--session идентификатор_сеанса

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

-su, --subject SE-Linux-context-string

Искать события с заданным контекстом SELinux - scontext (субъект).

-sv, --success флаг

Искать события с заданным флагом успешного выполнения. Допустимые значения: yes (успешно) и no(неудачно).

-te, --end [дата] [время]

Искать события, которые произошли раньше (или во время) указанной временной точки. Формат даты и времени зависит от региональных настроек. Просмотреть формат, можно выполнив команду date '+%x'. Если дата не указана, то подразумевается текущий день (today). Если не указано время, то подразумевается текущий момент (now). Используйте 24-часовую нотацию времени, а не AM/PM. Например, дата может быть задана как 09/03/2009, а время - как 18:00:00. На принятый формат даты влияет переменная среды LC_TIME. Также допускается использовать следующие ключевые слова: now (сейчас), recent, boot, today, yesterday, this-week, week-ago, this-month, this-year. Now - сейчас. Recent - 10 минут назад. Boot - время за секунду до того, когда система загружалась в последний раз. Today - первая секунда после полуночи текущего дня. Yesterday - первая секунда после полуночи предыдущего дня. This-week - первая секунда после полуночи первого дня текущей недели, первый день недели определяется из ваших региональных настроек (см. localtime). Week-ago - первая секунда после полуночи ровно 7 дней назад. This-month - первая секунда после полуночи первого числа текущего месяца. This-year - первая секунда после полуночи первого числа первого месяца текущего года.

-ts, --start [дата] [время]

Искать события, которые произошли после (или во время) указанной временной точки. Формат даты и времени зависит от региональных настроек. Просмотреть формат, можно выполнив команду date '+%x'. Если дата не указана, то подразумевается текущий день (today). Если не указано время, то подразумевается полночь (midnight). Используйте 24-часовую нотацию времени, а не AM/PM. Например, дата может быть задана как 09/03/2009, а время - как 18:00:00. Также допускается использовать следующие ключевые слова: now (сейчас), recent, boot, today, yesterday, this-week, week-ago, this-month, this-year. Now - сейчас. Recent - 10 минут назад. Boot - время за секунду до того, когда система загружалась в последний раз. Today - первая секунда после полуночи текущего дня. Yesterday - первая секунда после полуночи предыдущего дня. This-week - первая секунда после полуночи первого дня текущей недели, первый день недели определяется из ваших региональных настроек (см. localtime). Week-ago - первая секунда после полуночи ровно 7 дней назад. This-month - первая секунда после полуночи первого числа текущего месяца. This-year - первая секунда после полуночи первого числа первого месяца текущего года.

Контрольная точка означает, что ausearch будет использовать метку времени, найденную в файле контрольных точек, игнорируя inode, device, serial, node и тип события, а также найденные в файле контрольные точки. По сути, это восстановление в случае сбоя вызова ausearch с опцией контрольной точки с кодом выхода 10, 11 или 12. Его можно использовать в скрипте примерно так:

```
ausearch --checkpoint /etc/audit/auditd_checkpoint.txt -i
_au_status=$?
if test ${_au_status} eq 10 -o ${_au_status} eq 11 -o ${_au_status} eq 12
then

  ausearch --checkpoint /etc/audit/auditd_checkpoint.txt --start checkpoint -i
fi
```

-tm, --terminal терминал

Искать события с заданным терминалом. Некоторые демоны (такие, как cron и atd) используют имя демона как имя терминала.

-ua, --uid-all идентификатор_пользователяfP

Искать события, у которых любой из идентификатора пользователя, эффективного идентификатора пользователя или loginuid (auid) совпадают с заданным идентификатором пользователя.

-ue, --uid-effective Эффективный_идентификатор_пользователя

Искать события с заданным эффективным идентификатором пользователя.

-ui, --uid идентификатор_пользователя

Искать события с заданным идентификатором пользователя.

-ul, --loginuid идентификатор_пользователя

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

-uu, --uuid идентификатор_гостя

Искать события с заданным идентификатором гостя.

-v, --verbose

Показать версию и выйти.

-vm, --vm-name имя_гостя

Искать события с заданным именем гостя.

-w, --word

Совпадение с полным словом. Поддерживается для имени файла, имени узла, терминала, ключевого слова и контекста SELinux.

-x, --executable программа

Искать события с заданным именем исполняемой программы.

## СТАТУС ВЫХОДА
0

все хорошо,

1

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

10

в файле контрольной точки найдены неверные данные,

11

ошибка обработки контрольной точки,

12

событие контрольной точки не найдено в соответствующем файле журнала.

## СМ. ТАКЖЕ
auditd(8), pam_loginuid(8).

## ПЕРЕВОД
Перевод с английского Николай Шафоростов <shafff@ukr.net> 2007

Перевод с английского Елена Мишина <lepata@altlinux.org> 2019


autofs

title: autofs(8)

text:
# autofs(8)

## НАЗВАНИЕ
/etc/init.d/autofs - Сценарий управления автоматическим монтированием

## ФОРМАТ
/etc/init.d/autofs start|stop|reload

## ОПИСАНИЕ
В системе Linux autofs управляет работой демонов automount(8). Как правило, autofs вызывается во время загрузки системы с параметром start, а во время остановки системы с параметром stop. Кроме того, системный администратор может вызывать сценарий autofs вручную для завершения, перезапуска или перезагрузки демонов автоматического монтирования.

## РАБОТА
При поиске в системе точек монтирования autofs просматривает конфигурационный файл /etc/auto.master (см. auto.master(5)). Для каждой из этих точек монтирования запускается процесс automount(8) с соответствующими параметрами. Проверить активные точки автоматического монтирования можно с помощью команды /etc/init.d/autofs status. После обработки конфигурационного файла auto.master сценарий autofs проверяет таблицу NIS с тем же именем. При наличии такой таблицы она будет обработана также, как и таблица auto.master. Таблица NIS обрабатывается в последнюю очередь.

/etc/init.d/autofs reload сравнивает текущую таблицу auto.master с выполняющимися демонами. Демоны, чьи записи были изменены, будут остановлены, после чего будут запущены демоны для новых или измененных записей.

Изменения в таблице начнут действовать немедленно. Для активизации изменений в таблице auto.master необходимо перезапустить сценарий autofs.

/etc/init.d/autofs status выводит текущую конфигурацию и список выполняющихся в данный момент демонов автомонтирования.

## СМОТРИ ТАКЖЕ
automount(8), autofs(5), auto.master(5).

## АВТОР
Эта страница руководства была написана Кристофером Лэмитером (Christoph Lameter) <chris@waterf.org> для системы Debian GNU/Linux. Отредактирована Х. Питером Энвином (H. Peter Anvin) <hpa@transmeta.com> и переведена на русский язык Александром Саввиным (Alex Savvin) <savvin@mail.ru>.


automount

title: automount(8)

summary: настройка точек монтирования для autofs

text:
# automount(8)

## НАЗВАНИЕ
automount - настройка точек монтирования для autofs

## ФОРМАТ
automount [options] mount-point map-type[,format] map [map-options]

## ОПИСАНИЕ
Программа autmount выполняет настройку точек монтирования для autofs -- встроенного система автоматического монтирования Linux. При запуске automount берёт базовую точку mount-point и просматривает map-файл, используя их (вместе с другими options) для автоматического монтирования файловых систем в пределах mount-point при каждом обращении к ним. При отсутствии активности в течение заданного периода эти файловые системы автоматически размонтируются.

## ОПЦИИ
-p, --pid-file

Записать pid демона в указанный файл.

-t, --timeout

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

-v, --verbose

Разрешает вывод сообщений общего состояния и прогресса.

-d, --debug

Разрешает вывод сообщений общего состояния и прогресса, а также отладочных сообщений.

-g, --ghost

Показывать каталоги в automount, но не монтировать их, пока к ним не будет обращения. Эта опция не действует на шаблонный (wildcard) map-файл.

-V, --version

Показать номер версии и завершить работу.

## АРГУМЕНТЫ
automount принимает, по крайней мере, три параметра. Обязательными параметрами являются mount-point, map-type и map. Все обязательные и опциональные параметры описаны ниже.

mount-point

Базовая точка для присоединения автоматически монтируемых файловых систем. Это имя каталога, который уже должен существовать.

map-type

Тип таблицы, используемой для данного вызова automount. Допустимы следующие типы таблиц:

file

Таблица является обычным текстовым файлом.

program

Исполняемая программа, которой передаётся ключ в командной строке и в случае совпадения возвращает запись в stdout.

yp

Таблицей является база данных NIS (YP).

nisplus

Таблицей является база данных NIS+.

hesiod

Таблицей является хешированная база данных, чьи записи filsys используются для отображения (maps).

ldap

map names в виде [//servername/]basedn, где дополнительный servername является именем опрашиваемого сервера LDAP, а basedn является DN, в поддереве которого осуществляется поиск. Поддерживаются две схемы LDAP -- классы объектов i automountMap и nisMap (RFC 2307).

Записи в схеме automountMap являются объектами automount в заданном поддереве, где атрибут cn является ключом (wildcard ключ -- "/"), а атрибут automountInformation содержит информацию, используемую автомонтировщиком. Документация по схеме, используемой данным модулем, доступна на http://docs.sun.com/source/806-4251-10/mapping.htm.

Записи схемы RFC 2307 являются объектами nisObject и используют атрибут cn в качестве ключа, а nisMapEntry содержит информацию, используемую автомонтировщиком.

format Формат данных таблицы; в настоящее время распознаются

только форматы sun, которые являются подмножеством формата таблицы автомонтировщика Sun, и hesiod для записей hesiod filesys. Если формат не задан, то по умолчанию для всех типов таблиц, кроме hesiod, будет использован формат Sun.

map

Расположение используемого файла таблицы. В случае таблиц типа file и program это абсолютный путь UNIX, а для таблиц типа yp, nisplus или hesiod -- имя базы данных.

options

Любые оставшиеся параметры командной строки без знака тире (-) используются как опции (-o) для mount. Параметры с впереди стоящим знаком тире рассматриваются как опции для таблиц. Формат sun поддерживает следующие параметры:

-Dvariable=value

В табличных подстановках заменить variable на value.

-strict

Трактовать ошибки при монтировании файловых систем как фатальные. Это важно при необходимости монтирования нескольких файловых систем (`multimounts'). Если задана эта опция, то ни одна файловая система не будет примонтирована, если невозможно примонтировать хотя бы одну какую-либо файловую систему.

## ЗАМЕЧАНИЯ
При получении демоном automount сигнала USR1, будут отмонтированы все неиспользуемые в данный момент файловые системы, монтированные autofs, и демон продолжит работу (forced expire). При получении сигналов TERM или USR2 демон размонтирует все неиспользуемые файловые системы autofs и завершит работу, если размонтированы будут все ФС. Используемые ФС размонтироваться не будут. Также демон реагирует на сигнал HUP, который запускает обновление таблиц, для которых реализован ghosting (в настоящее время таблицы FILE и NIS).

Если во время получение демоном сигнала выхода будет занят сам каталог autofs, демон завершает работу без размонтирования файловой системы autofs. Файловая система остаётся в кататоническом (нерабочем) состоянии и может быть размонтирована после того, как будет освобождена.

## СМОТРИ ТАКЖЕ
autofs(5), mount(8).

## ОШИБКИ
Отсутствие целой кучи необходимых возможностей (см. файл TODO).

Также необходима документация.

Сообщайте о других ошибках с подробным описание на адрес <autofs@linux.kernel.org>. Для подписки на эту рассылку пришлите сообщение со строкой "subscribe autofs" на адрес <majordomo@linux.kernel.org>.

## АВТОР
H. Peter Anvin <hpa@transmeta.com>

Перевод на русский язык выполнил Александр Саввин <savvin@mail.ru>


autrace

title: autrace(8)

summary: strace-подобная программа для аудита.

text:
# autrace(8)

## ИМЯ
autrace - strace-подобная программа для аудита.

## ОБЗОР
autrace [-r] процесс [аргументы]...

## ОПИСАНИE
autrace - это программа, которая добавляет правила аудита для того, чтобы следить за использованием системных вызовов в указанном процессе подобно тому, как это делает strace. После добавления правил она запускает процесс с указанными аргументами. Результаты аудита будут либо в логах аудита (если демон аудита запущен), либо в системных логах. Внутри autrace устроена так, что удаляет все предыдущие правила аудита, перед тем как запустить указанный процесс и после его завершения. Поэтому, в качестве дополнительной меры предосторожности, программа не запустится, если перед ее использованием правила не будут удалены с помощью audtictl - предупреждающее сообщение известит об этом.

## ОПЦИИ
-r

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

## ПРИМЕРЫ
Ниже представлен пример обычного использования программы:

```
autrace /bin/ls /tmp
ausearch --start recent -p 2442 -i
```

Еще один пример для режима ограниченного сбора информации:

```
autrace -r /bin/ls
ausearch --start recent -p 2450 --raw | aureport --file --summary
ausearch --start recent -p 2450 --raw | aureport --host --summary
```

## СМ. ТАКЖЕ
ausearch(8), auditctl(8).

## ПЕРЕВОД
Перевод с английского Alexander Kolotov (alexandr.kolotov@gmail.com) 2007


badblocks

title: badblocks(8)

summary: поиск на диске сбойных блоков

text:
# badblocks(8)

## НАЗВАНИЕ
badblocks - поиск на диске сбойных блоков

## СИНТАКСИС
badblocks [ -svwnf ] [ -b размер-блока ] [ -c порция_блоков ] [ -i входящий_файл ] [ -o исходящий_файл ] [ -p число_поисков ] [ -t проверяемый_образец ] устройство [ конечный-блок ] [ начальный-блок ]

## ОПИСАНИЕ
badblocks используется для поиска сбойных блоков на \[u0443]стройстве (обычно раздел диска). Устройство это специальный файл, который соответствует диску (например, /dev/hdc1). Конечный-блок является последним тестируемым блоком; если он не указан, тогда (по умолчанию) им будет самый последний блок, который используется на устройстве. Начальный-блок является не обязательным параметром, указывающим на номер блока, начиная с которого будет выполнятся проверка диска. Если он не указан, тогда (по умолчанию) им будет самый первый блок, который используется на устройстве.

Важное замечание: Если вывод результатов работы команды badblocks перенаправляется программам e2fsck или mke2fs, очень важно, чтобы размер блока был правильно указан параметром -b, поскольку порождаемые им номера блоков сильно зависят от используемого размера блока. По этой причине, настоятельно рекомендуется пользователям не запускать команду badblocks непосредственно, а лучше всего использовать программы e2fsck и mke2fs с параметром -c (означает делать проверку файловой системы на наличие сбойных блоков).

## ПАРАМЕТРЫ
-b размер-блока

Задаёт используемый на диске размер блоков в байтах.

-c порция_блоков

Указывает порцию блоков, которые будут проверены за раз. По умолчанию это 64 блока.

-f

Обычно команда badblocks не будетe выполнять операции чтения/записи или не будет выполнять проверку, которая может привести к уничтожению данных на смонтированном устройстве в следующих случаях: если система была потенциально аварийно завершена и/или файловая система повреждена и смонтирована только для чтения. Этот режим блокировки можно отменить, используя параметр -f, но в большинстве случаев этого не следует делать (если думаете, что программа badblocks очень умна, то вы глубоко ошибаетесь). Только в одном случае применение этого параметра может быть не опасным - это когда используемая из файла /etc/mtab информация об устройствах не корректна и необходимое устройство в действительности не смонтировано.

-i входной_файл

Читает список уже существующих (найденных ранее) сбойных блоков. Badblocks будет пропускать эти блоки во время проверки, считая их сбойными. Если входной_файл указан как "-", список будет считываться из стандартного устройства ввода. Блоки, перечисленные в этом списке, будут пропущены в списке найденных новых сбойных блоков, который будет выводиться на стандартное устройство вывода или в исходящий файл. Используя команду dumpe2fs(8) с параметром -b можно получить список блоков, помеченных как сбойные на существующей файловой системе. Формат этого списка пригоден для использования с параметром -i.

-o исходящий_файл

Сохраняет список сбойных блоков в указанный исходящий файл. Без этого параметра команда badblocks выводит этот список на стандартное устройство вывода. Формат этого списка в файле пригоден для использования в командах e2fsck(8) или mke2fs(8) с параметром -l.

-p число_раз_поиска

Повторяет поиск сбойных блоков на одном и том же пространстве диска указанное в параметре число раз. По умолчанию значение этого параметра равно 0. Это означает, что команда badblocks завершит поиск после первого прохода.

-t проверяемый_образец

Задаёт проверяемый образец для операций чтения/записи блоков диска. проверяемый_образец может быть или числовым значением лежащим между 0 и ULONG_MAX-1 включительно, или словом "random", которое указывает на то, что блок должен быть заполнен образцом в виде случайных бит. Для режима чтения/записи (-w) или безопасного (-n) режима проверки может быть указан один или более проверяемых образцов, каждый из которых должен быть описан параметром -t. Для режима только-чтение может быть задан исключительно один образец и это не может быть образец "random". Проверка с образцом в режиме только-чтение означает, что указанный образец должен быть предварительно записан на диск - если это невозможно сделать, тогда при тестировании будет пропущено большое количество блоков. Если указана проверка по множеству образцов, тогда все блоки будут сначала проверены по одному образцу, а затем по следующим.

-n

Заставляет использовать режим чтения-записи, который не разрушает данные. Этот режим используется по умолчанию для выполнения проверки диска. Этот параметр не должен сочетаться с параметром -w, поскольку их действия исключают друг друга.

-s

Отображает ход процесса проверки, выводя номера блоков в том порядке, как они проверялись.

-v

Подробно сообщать о происходящем.

-w

Для проверки используется режим реальной записи. С этим параметром команда badblocks выполняет поиск сбойных блоков, сначала записывая специальные образцы (0xaa, 0x55, 0xff, 0x00) в каждый проверяемый блок устройства, затем читая каждый блок и сравнивая его содержимое делает вывод. Этот параметр не может сочетаться с параметром -n, поскольку их действия исключают друг друга.

## БУДЬТЕ ОСТОРОЖНЫ!
Никогда не применяйте параметр -w на устройстве, которое содержит используемую файловую систему. Этот параметр приводит к уничтожению информации на диске! Если вы желаете использовать для проверки файловой системы режим записи, тогда применяйте параметр -n. В этом случае проверка будет более медленной, но ваши данные не пострадают.

## ПРИМЕР
Проверить устройство /dev/hdb1 (второй жёсткий диск) и вывести результаты в файл badblocks.list:

\# badblocks -o badblocks.list /dev/hdb1

## АВТОР
badblocks была написана Remy Card <Remy.Card@linux.org>. В настоящее время её сопровождает Theodore Ts'o <tytso@alum.mit.edu>. Проверка на безопасность операций чтения/записи выполнена David Beattie <dbeattie@softhome.net>.

## МЕСТОНАХОЖДЕНИЕ
badblocks как часть пакета e2fsprogs доступна через Web на сайте SourceForge http://e2fsprogs.sourceforge.net.

## СМ. ТАКЖЕ
e2fsck(8), mke2fs(8)

## ПЕРЕВОД
оригинального файла на английском badblocks.8.gz (2212 байт от 28.02.2004) + пример выполнен Aleksander N.Gorohovski <angel@feht.dgtu.donetsk.ua> 03.12.2006.

## РЕЦЕНЗИЯ ПЕРЕВОДА
Michael Shigorin <mike@osdn.org.ua>


clockdiff

title: clockdiff(8)

text:
# clockdiff(8)

## ИМЯ
clockdiff - измерить рассинхронизацию между двумя системами

## ОБЗОР
clockdiff [ -o] [ -o1] удаленная система

## ОПИСАНИЕ
clockdiff измеряет рассихронизацию между нашей и удаленной системой с точностью в 1 мс, используя пакеты ICMP TIMESTAMP [2] или опцию IP TIMESTAMP [3], (по желанию) совместно с ICMP ECHO. [1]

## ОПЦИИ
-o

Использовать IP TIMESTAMP с ICMP ECHO вместо сообщений ICMP TIMESTAMP. Это бывает полезно для некоторых удаленных систем, которые не поддерживают ICMP TIMESTAMP (например, Solaris <2.4).

-o1

Немного отличается от -o, а именно - использует трех-условный IP TIMESTAMP с предзаданными адресами пересылки, вместо четырех-условного. В зависимости от типа удаленной системы это может быть использовано для более лучшей работы. В особенности, это лучше для Linux.

## ПРЕДУПРЕЖДЕНИЯ
•

Некоторые узлы (Cisco) используют нестандартные временные метки, которые допускаются RFC, но делают использование временных меток почти бесполезным.

•

Некоторые узлы генерируют испорченные временные метки (Solaris>2.4), когда используются xntpd. Похоже, их IP стек использует испорченный источник времени, который периодически синхронизируется и непредсказуемо изменяется, делая использование временных меток почти бесполезным. Хорошей новостью является то, что в этом случае вы можете использовать NTP, который даже лучше.

•

clockdiff показывает рассинхронизацию по модулю в 24 дня.

## СМ. ТАКЖЕ
ping(8), arping(8), tracepath(8).

## ССЫЛКИ
[1] ICMP ECHO, RFC0792, страница 14.

[2] ICMP TIMESTAMP, RFC0792, страница 16.

[3] IP TIMESTAMP опция, RFC0791, 3.1, страница 16.

## АВТОР
clockdiff был собран Алексеем Кузнецовым <kuznet@ms2.inr.ac.ru>. Программа базировалась на коде, позаимствованном из BSD демона timed.

## БЕЗОПАСНОСТЬ
Для исполнения, clockdiff требует прав CAP_NET_RAWIO. Программа может быть безопасно использована с выставленным set-uid битом для root.

## ДОСТУПНОСТЬ
clockdiff это часть пакета iputils, и самые последние версии этого пакета доступны в исходных кодах на анонимном ftp ftp://ftp.inr.ac.ru/ip-routing/iputils-current.tar.gz.

## ПЕРЕВОД
Alexander Kolotov <alexandr.kolotov@gmail.com> 2007