ttytest

package: ttytest

title: ttytest(1)

text:
# ttytest(1)

## NAME
ttytest - асинхронный тест чтения-записи и логическая заглушка для терминальных линий

## SYNOPSIS
ttytest [параметры] <tty_dev>

## ОПИСАНИЕ
ttytest это маленький и простой консольный тест терминальных линий (соединений между двумя последовательными устройствами). Идея теста состоит в асинхронной записи тестовой последовательности в поседовательное устройство и в одновременном чтении этой последовательности из того-же устройства с выводом данных на терминал (TTY). Для создания обратной петли данных можно использовать стандартную аппаратную заглушку на последовательном порту или пару последовательных портов, связанных с нульмодемным кабелем, в последнем случае на одной из сторон необходимо запустить ttytest в режиме заглушки- stub (см. опцию - mode ). В случае положительного результата ttytest печатает на стандартный вывод "лестницу" тестовой последовательности вида:

test test test test test

test test test test test

test test test test test

test test test test test

test test test test test

test test test test test

test test test test test

test test test test test

## ОПЦИИ
ttytest поддерживает короткий и "длинный" варианты POSIX опций.

-h --help

Показать справку по командной строке.

-V --version

Информация о версии.

-v --verbose

Больше информации (отладочный вывод).

-dСТРОКА, --data-string=СТРОКА

Пользовательский вариант тестовой СТРОКИ. Значение по умолчанию: "test test test test test" ПРИМЕР: ttytest --data-string="В ЧАЩАХ ЮГА ЖИЛ-БЫ ЦИТРУС. ДА, НО ФАЛЬШИВЫЙ ЭКЗЕМПЛЯР!"

-e, --enum-strings

Если эта опция данных строк перечислил перед написать устройства. Последовательность имеет вид:

1 test test test test test

2 test test test test test

3 test test test test test

4 test test test test test

-u, --no-offset

этой опцией отключается автовставка периодического смещения ( "лестница") перед тестовой строкой.

test test test test test

test test test test test

test test test test test

test test test test test

-pСЕКУНД, --pause=СЕКУНД

Опция устанавливает время "засыпания" передатчика в СЕКУНДАХ (может быть использована десятичная нотация) перед началом теста (без паузы по умолчанию)

-mРЕЖИМ, --mode=РЕЖИМ

Вариант установки запустить РЕЖИМ работы ttytest. РЕЖИМ может быть установлен в следующие значения: "loopback ", "read ", "stub ", "terminal " и "write ". Значение РЕЖИМА является регистро-нечувствительным. loopback: в этом (по умолчанию) режиме ttytest создает два асинхронных потока для приемника и передатчика. Поток передатчика ttytest непрерывно пишет тестовую СТРОКУ сконфигурированую опциями -D, -е, -U в последовательное устройство (<tty_dev>). Процессом передачи можно управлять с помощью -a, -w и -q опций. Одновременно поток приемника производит чтение из того-же устройства с выводом принятых данных на стандартный вывод программы.

stub: В этом режиме ttytest реализует "логическую заглушку". Программа читает данные из устройства (<tty_dev>) и записывает эти данные обратно. Так-же как и в loopback режиме, принятые данные выводятся на стандартный вывод программы.

terminal: режим простого терминала - аналогичный loopback, но вместо передатчика используется получение входных данных со стандартного ввода (клавиатуры) с передачей в последовательное устройство (<tty_dev>).

read: в этом режиме работает только приемник.

write: в этом режиме работают только передатчик.

-a, --adaptive-tx

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

TIOCGICOUNT IOCTL. Если установлены -q или -w - данная опция не имеет эффекта.

-w, --wait-tx

Если данная опция установлена передатчик ожидает (используется tcdrain функция) полной передачи данных после каждой записи тестовой СТРОКИ

-qКОЛИЧЕСТВО, --queue-size=КОЛИЧЕСТВО

этот опция устанавливает максимальное КОЛИЧЕСТВО символов в выходой очереди передатчика. Для контроля размера очереди передатчика используется возврат TIOCOUTQ IOCTL.

-sСЕКУНД, --send-interval=СЕКУНД

опцией устанавливается интервал времени в СЕКУНДах между передачей двух тестовых СТРОК (может быть использована десятичная нотация) По умолчанию, отправляется непрерывный поток.

-x, --hex-dump

Если установлена эта опция, то прочитанные из устройства (<tty_dev>) данные печатаются на стандартном выводе в виде шестнадцатиричного дампа. Опция имеет эффект только в sttub режиме.

-BСКОРОСТЬ, --tty-baud=СКОРОСТЬ

Опцией устанавливается СКОРОСТЬ передачи данных (50, 100, 200 ...)

-WКОЛИЧЕСТВО_БИТ, --tty-databits=КОЛИЧЕСТВО_БИТ

Опция устанавливает КОЛИЧЕСТВО_БИТ данных (1 .. 8)

-SКОЛИЧЕСТВО_СТОПОВ, --tty-stopb=КОЛИЧЕСТВО_СТОПОВ

Опция устанавливает КОЛИЧЕСТВО_СТОПОВых бит в потоке (1, 1,5, 2)

-PЧЕТНОСТЬ, --tty-parity=ЧЕТНОСТЬ

Опцией устанавливается контроль ЧЕТНОСТИ. Значение ЧЕТНОСТИ может быть одним из: "no", "odd","even", "mark" и "space"

-R, --tty-crtscts

Опция предписывает использовать RTS/CTS управление потоком.

-C, --tty-codepage

Опция устанавливает кодовую страницу удаленной стороны в стиле, используемом программой iconv . Может быть указана кодировка MTK-2 .

-N, --tty-nonprint_show

Если опция установлена то ttytest отображает в выводе символы переключения регистров кода MTK-2

-U, --mtk-rprefix

Если опция установлена то символы переключения регистров кода MTK-2 префиксируются как управляющие последовательности терминала .

-X, --tty-xonxoff

Опция предписывает использовать XON/XOFF управление потоком.

-D, --tty-dsr

Опция устанавливает чувствительность приемника к DSR.

## ПРИМЕРЫ
Быстрое использование:

Соединить COM1 и COM2 порты нульмодемным кабелем.

Открыть две консоли

Запустить на одной консоли команду

ttytest --mode=stub /dev/ttyS1

Запустить на второй консоли команду

ttytest --mode=loop /dev/ttyS0

Или

Установить аппаратную заглушку на порт COM1

Открыть консоль и выполнить команду

ttytest /dev/ttyS0

Наблюдать на консолях "лестницу" из тестовых СТРОК.

## СМОТРИ ТАКЖЕ
stty(1) ioctl_list(2) iconv(1)


evim

title: evim(1)

text:
# evim(1)

## НАЗНАЧЕНИЕ
Программа evim — это упрощённый Vim, которая производит запуск редактора Vim в безрежимном варианте редактирования файлов.

## КРАТКИЙ ОБЗОР
evim [аргументы] [файл ...]

eview

## ОПИСАНИЕ
По команде evim запускается редактор Vim и выполняется настройка ряда параметров таким образом, чтобы его работа была как у простых безрежимных редакторов. В этом режиме редактор Vim напоминает редактор Notepad из MS Windows. Вариант редактора eVim всегда запускается с поддержкой графического интерфейса, чтобы была возможность взаимодействия с программой через меню и панель инструментов.

Этот вариант редактора сделан для тех, кто по каким-то причинам не в состоянии работать с обычным редактором Vim. Редактирование файлов при этом происходит гораздо менее эффективно, чем при использовании стандартного варианта редактора.

По команде eview выполняются почти те же самые действия, но файл будет открыт "только для чтения". Использование этой команды полностью идентично команде evim -R.

Подробнее о редакторе Vim, аргументах запуска и т. п. смотрите в справочнике vim(1).

По команде evim будет установлен параметр 'insertmode', что обеспечивает ввод текста напрямую в буфер.

Кроме того, настраиваются клавиатурные команды, позволяющие выполнять копирование и вставку текста, используя такие же комбинации клавиш, как в MS Windows. Клавиши CTRL+X используются для вырезания текста, CTRL+C для копирования и CTRL+V для вставки. Чтобы выполнить ту же команду, которая раньше была назначена на клавиши CTRL+V, используйте клавиши CTRL+Q.

## АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
См. справочник vim(1).

## ФАЙЛЫ
/usr/share/vim/evim.vim

Сценарий, который загружается для инициализации eVim.

Здесь vim?? означает сокращённую запись номера версии, например, vim91 для версии редактора Vim 9.1

## ДРУГИМИ СЛОВАМИ
Вариант eVim также известен как "Vim для чайников". Для наилучшего эффекта рекомендуется во время использования повязать на голове платок, предварительно завязав на каждом конце по узелку.

## СМОТРИТЕ ТАКЖЕ
vim(1)

## АВТОРЫ
Большая часть редактора Vim была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное количество людей. См. меню Справка пункт Соавторы.


vim

package: vim-common

title: vim(1)

text:
# vim(1)

## НАЗНАЧЕНИЕ
Программа Vim — это Vi IMproved (Улучшенный Vi), текстовый редактор для программистов.

## КРАТКИЙ ОБЗОР
vim [аргументы] [файл ...]

vim [аргументы] -

vim [аргументы] -t индекс

vim [аргументы] -q [файл результатов]

ex

view

gvim gview evim eview

rvim rview rgvim rgview

## ОПИСАНИЕ
Программа Vim — это текстовый редактор, совместимый с редактором Vi. Она может быть использована для правки всех видов обычных текстовых документов. Особенно полезна она будет для редактирования исходных текстов программ.

По сравнению с редактором Vi, в редакторе Vim представлено много усовершенствований: многократная отмена операций, множественность окон и буферов, подсветка синтаксиса, правка командной строки, подстановка наименований файлов, встроенная документация, визуальное выделение и прочее. См. ":help vi_diff.txt" чтобы ознакомиться с полным перечнем различий между редактором Vim и редактором Vi.

Чтобы получить полезную информацию о работе с редактором Vim, можно воспользоваться встроенной в программу документацией, набрав в редакторе команду ":help". См. раздел "ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ" далее в тексте.

Чаще всего редактор Vim запускают для правки одного файла при помощи команды

vim файл

В общем виде команда запуска редактора Vim выглядит так:

vim [аргументы] [файлы]

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

файл ...

Перечень наименований файлов. Первый файл из перечня будет объявлен активным и загружен в буфер, а каретка установлена на первой строке этого буфера. Доступ к другим файлам из этого перечня может быть осуществлён при помощи команды ":next". Чтобы править файл, наименование которого начинается с символа "дефис" (-), перед перечнем файлов необходимо указать символы "--".

-

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

-t {индекс}

Файла для правки и начальная позиция каретки зависят от значения "индекса", являющийся своего рода меткой goto. Поиск самого {индекса} выполняется в файле индексов, а сопоставленный с ним файл будет открыт в редакторе и выполнена связанная с этим {индексом} команда. Чаще всего этот способ используется для программ на языке Си, где {индекс} может быть наименованием функции. Файл, содержащий такую функцию, становится активным, а каретка помещается в начало этой функции. См. ":help tag-commands".

-q [файл результатов]

Начать работу редактора в цикле быстрого исправления текста программ. Будет считан [файл результатов] и отображена первая запись из этого файла. Если [файл результатов] не указан, то его наименование берётся из значения параметра 'errorfile' (по умолчанию для ОС Amiga это "AztecC.Err", а для других систем — "errors.err"). К следующей записи в файле результатов можно перейти по команде ":cn". См. ":help quickfix".

Программа Vim ведёт себя по-разному в зависимости от указанной в командной строке команды вызова редактора (исполняемый файл при этом может быть одним и тем же).

vim

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

ex

Запуск редактора в Ex-режиме. Для переключения в обычный режим, необходимо набрать команду ":vi". Ex-режим также может быть активирован через аргумент "-e".

view

Запуск редактора в режиме "только для чтения". В этом режиме есть некоторая защита от случайной перезаписи файлов. То же самое можно сделать через указание аргумента "-R".

gvim gview

Запуск редактора с графическим интерфейсом. Для этого будет открыто новое окно. То же самое можно сделать при запуске с аргументом "-g".

evim eview

Упрощённый вариант редактора с графическим интерфейсом. Запускается в новом окне. То же самое можно сделать через аргумент "-y".

rvim rview rgvim rgview

Как и предыдущие команды, но с некоторыми ограничениями в функциональности. Нельзя запускать команды оболочки или приостанавливать работу редактора Vim. Вместо приставки "r" можно использовать аргумент командной строки "-Z".

## АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
Аргументы могут быть указаны в любом порядке, до или после наименований файлов. Аргументы, не требующие значений, могут быть объединены с указанием только одного дефиса.

+[номер]

Установка каретки на [номер] строки. В первом открытом файле каретка будет установлена на строку с указанным номером. Если "номер" не задан, каретка устанавливается на последней строке файла.

+/{шаблон}

Установка каретки на найденной строке. В открытом файле каретка будет установлена в строке первого совпадения с указанным шаблоном. См. ":help search-pattern" для ознакомления с допустимыми шаблонами.

+{команда}

-c {команда}

Исполнение указанной {команды}. После загрузки первого файла будет исполнена указанная {команда} как Ex-команда. Если в тексте {команда} есть пробелы, то она должна быть заключена в двойные кавычки (в зависимости от используемой командной оболочки). Пример: vim "+set si" main.c

Примечание. Можно указывать до десяти команд "+" или "-c".

-A

Запуск программы с поддержкой арабской письменности. Если программа Vim была собрана с поддержкой правки текста с написанием справа налево и с поддержкой клавиатуры для арабского языка, то будет выполнен запуск редактора Vim в режиме работы с арабской письменностью, т. е. установлен параметр 'arabic'. В противном случае редактор Vim завершит работу с сообщением об ошибке.

-b

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

-C

Работа в варианте совместимости с редактором Vi. Будет установлен параметр 'compatible', и редактор Vim будет работать почти как редактор Vi, даже если существует файл ".vimrc".

-d

Режим сравнения различий. Может быть указано от двух до восьми наименований файлов. В редакторе Vim будут открыты все файлы и показаны различия между ними (как vimdiff(1)).

-d {устройство}, -dev {устройство}

Использовать {устройство} для операций ввода-вывода. Открыть {устройство} для использования в качестве терминала (только в ОС Amiga). Пример: "-d con:20/30/600/150".

-D

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

-e

Запуск программы в Ex-режиме. Редактор Vim будет работоать в Ex-режиме, тоже, что в командной строке оболочки набрать команду "ex".

-E

Запуск программы в улучшенном Ex-режиме. Редактор Vim будет работать в улучшенном Ex-режиме, это аналогично набору в командной оболочке команды "exim".

-f

Режим активного приложения. Редактор Vim с графическим интерфейсом не будет наследоваться и отключаться от командной оболочки, в которой выполнена команда его запуска. На платформе Amiga редактор Vim не будет перезапускаться для создания нового окна. Этот аргумент командной строки нужно использовать, когда редактор Vim запускается программой, которая должна ждать завершения сеанса правки (например, программа для работы с электронной почтой). На платформе Amiga в этом случае команды ":sh" и ":!" не будут работать.

-F

Запуск программы с поддержкой персидской письменности. Если программа Vim была собрана с поддержкой правки текста с написанием справа налево и с поддержкой клавиатуры для персидского языка, то будет выполнен запуск редактора Vim в режиме работы с персидской письменностью, т. е. установлены параметры 'fkmap' и 'rightleft'. В противном случае редактор Vim завершит работу с сообщением об ошибке.

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

-g

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

-H

Запуск программы с поддержкой еврейской письменности. Если программа Vim была собрана с поддержкой правки текста с написанием справа налево и с поддержкой клавиатуры для еврейского языка, то будет выполнен запуск редактора Vim в режиме работы с еврейской письменностью, т. е. установлены параметры 'hkmap' и 'rightleft'. В противном случае редактор Vim завершит работу с сообщением об ошибке.

-i {файл}

Использовать в качестве файла подкачки указанный {файл}. Через этот аргумент задаётся наименование viminfo-файла (вместо принятого по умолчанию ".viminfo"). Здесь же можно отключить использование viminfo-файла через указание слова "NONE" (прописными буквами).

-l

Запуск программы в режиме Lisp. Выполняется установка параметров 'lisp' и 'showmatch'.

-L

То же, что и аргумент командной строки -r.

-m

Работа без возможности сохранения изменений. Выполняется сброс параметра 'write', поэтому становится невозможным записать в файл изменения, внесённые в буфер.

-M

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

-n

Работа без создания файла подкачки. В этом случае восстановление при сбое в работе редактора будет невозможно. Удобно для правки файла на очень медленном носителе (например, гибком диске). То же самое можно сделать командой ":set uc=0". Включение файла подкачки — ":set uc=200".

-N

Работа в варианте неполной совместимости с редактором Vi. Будет сброшен параметр 'compatible'. Редактор Vim будет работать лучше, но не будет полностью совместим с редактором Vi, даже если отсутствует файл начальных настроек (".vimrc").

-nb

Назначить программу Vim сервером редактора для ИСР NetBeans. Подробности смотрите в документации.

-o[N]

Создать для N файлов отдельные окна, расположенные по горизонтали. Если N не указано, то создаётся по одному окну на каждый файл.

-O[N]

Создать для N файлов отдельные окна, расположенные по вертикали. Если N не указано, то создаётся по одному окну на каждый файл.

-p[N]

Создать для N файлов отдельные вкладки. Если N не указано, то создаётся по одной вкладке на каждый файл.

-P {заголовок окна}

Открыть программу в многодокументном приложении. Только для ГИП в MS Windows. Задаёт заголовок окна родительского приложения. Если возможно, то программа Vim будет запущена внутри окна многодокументного приложения. Многодокументное приложение должно иметь указанный {заголовок окна}. Убедитесь, что этот {заголовок окна} уникален для приложения. Обращаем внимание, что реализация данного функционала всё ещё не до конца отработана. Внедрение программы возможно не во все приложения и не поддерживается меню окна.

-r

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

-r {файл}

Восстановление аварийно завершённого сеанса. Для восстановления после сбоя в работе будет использован указанный файл подкачки. Файл подкачки имеет то же наименование, что и редактируемый текстовый файл, но с добавлением расширения ".swp". См. ":help recovery".

-R

Работа в варианте только для чтения. Будет установлен параметр 'readonly'. Файл в буфере доступен для редактирования, но его копию на диске нельзя случайно перезаписать. Для сохранения файла необходимо добавить восклицательный знак к соответствующей Ex-команде (например, ":w!"). При задании аргумента "-R" также подразумевается, что используется и аргумент "-n" (см. выше). Параметр 'readonly' может быть сброшен по команде ":set noro". См. ":help 'readonly'".

-s

Тихий режим. Только при запуске в командной оболочке как программы "ex" или если перед аргументом "-s" указан аргумент "-e".

-s {командный файл}

Считывание команд режима команд из {командного файла}. Содержимое файла воспринимается в виде команд, как если бы они были набраны непосредственно в редакторе. То же самое достигается командой ":source! {командный файл}". Если после исполнения всех команд из {командного файла} работа редактора продолжается, то дальнейший ввод команд и текста ожидается с клавиатуры.

-S {файл}

Исполнение указанного {файла}. После загрузки в буфер первого файла, будет исполнен указанный командный {файл}. Это аналогично команде в командной строке -c "source {файл}". Наименование {файла} не может начинаться с символа '-'. Если не указан {файл}, то будет исполнен файл "Session.vim" (это будет работать только если аргумент -S является последним в командной строке).

-T {терминал}

Назначить указанный тип {терминала}. Редактору Vim будет передан тип используемого терминала. Необходимо только в тех ситуациях, когда автоматическое определение терминала не работает. Наименование терминала должно быть известно редактору Vim (предопределено в редакторе) либо указано в базе termcap или terminfo.

-u {файл}

Использовать для начальной настройки указанный командный {файл}. Все остальные файлы настроек игнорируются. Удобно для редактирования специальных типов файлов. Через этот аргумент можно также отключить обработку всех файлов начальной настройки, используйте для этого слово "NONE" (прописными буквами). См. ":help initialization".

-U {файл}

Использовать для начальной настройки графического интерфейса указанный командный {файл}. Все остальные файлы настроек для графического интерфейса игнорируются. Через этот аргумент можно также отключить обработку всех файлов настройки графического интерфейса, используйте для этого слово "NONE" (прописными буквами). См. ":help gui-init".

-v

Запуск программы в режиме Vi. Редактор Vim будет работать в режиме редактора Vi, как будто исполняемый файл называется "vi". Имеет смысл только если исполняемый файл называется "ex".

-V[N]

Режим подробного вывода. Будут выводиться сообщения о том, какие командные файлы исполняются, и какая информация считывается и записывается в viminfo-файле. Необязательное число N задаёт уровень детализации информации. По умолчанию это значение установлено равным 10.

-V[N]{файл}

Аналогично аргументу -V, а также выполняется установка параметру 'verbosefile' значение {файл}. Как результат, сообщения будут записываться в {файл}, а не отображаться на экране. Наименование {файла} не может начинаться с какой-либо цифры.

-w{число}

Для параметра 'window' будет установлено значение, равное указанному {числу}.

-w {файл}

Добавление всех введённых команд в {файл}. Все символы, введённые с клавиатуры вплоть до момента завершения работы редактора, записываются в {файл}. Удобно в том случае, когда вы хотите создать командный файл для последующего его использования в командной строке "vim -s" или в команде ":source!". Если {файл} уже существует, то набранный текст будет добавляются в конец файла.

-W {файл}

Запись всех введённых команд в {файл}. Как аргумент "-w", но существующий {файл} будет перезаписан.

-x

Редактирование шифрованных файлов. Если редактор Vim был собран с поддержкой шифрования, то выполнять шифрование при записи файлов. Будет выдано приглашение ввести пароль.

-X

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

-Y

Запуск программы без подключения к Wayland Compositor.

-y

Работа в упрощённом варианте. Редактор Vim будет работать в упрощённом варианте, как будто исполняемый файл имеет название "evim" или "eview". Поведение редактора Vim будет походить на редакторы, созданные по безрежимному принципу работы.

-Z

Работа с ограничением функциональности. Работает так же, как и запуск исполняемого файла, наименование которого начинается с буквы "r".

--

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

--clean

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

--cmd {команда}

Как аргумент "-c", но команда исполняется перед обработкой любого файла настроек (vimrc). Можно указывать до десяти таких команд, независимо от количества команд "-c".

--echo-wid

Только для графического интерфейса GTK. Отобразить идентификатор окна (Window ID) в поток стандартного вывода (stdout).

--gui-dialog-file {файл}

При работе редактора в графическом интерфейсе пользователя, заголовок и сообщение диалогового окна будут записаны в {файл} без отображения на экране. Если указанный {файл} не существует, то он будет создан, а при его наличии сообщения будут дописываться в этот {файл}. Данный аргумент полезен только для тестирования работы редактора, чтобы избежать остановки программы, так как отображаемое диалоговое окно может быть скрыто. Если не поддерживается графический интерфейс пользователя, то этот аргумент игнорируется программой.

--help, -h, -?

Будет показана краткая информация об аргументах и параметрах командной строки. После этого редактор Vim завершит работу.

--literal

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

--log {файл}

Будет выполнена запись протокола работы с этапа инициализации программы. Если при сборке программы Vim были включены компоненты "eval" и "channel", будет выполняться протоколирование работы с самой ранней стадии запуска программы, а журнал записываться в {файл}. Это работает аналогично вызову функции ch_logfile({filename}, 'ao')

--nofork

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

--noplugin

Будет выполнен запуск программы без загрузки внешних подключаемых модулей. Это же подразумевается при указании аргумента -u NONE.

--not-a-term

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

--remote

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

--remote-expr {выражение}

Будет выполнено подключение к Vim-серверу и передача указанного {выражение} для вычисления. Результат вычисления будет выведен в поток стандартного вывода (stdout).

--remote-send {код клавиши}

Будет выполнено подключение к Vim-серверу и передача указанных {кодов клавиш}.

--remote-silent

Как "--remote", но без вывода предупреждения, если сервер не найден.

--remote-wait

Как "--remote", но редактор Vim не будет завершать работу до тех пор, пока не будет выполнена правка всех файлов.

--remote-wait-silent

Как "--remote-wait", но без вывода предупреждения, если сервер не найден.

--serverlist

Будет выведен перечень всех доступных Vim-серверов.

--servername {название}

Использовать указанное {название} в качестве наименования сервера. Если аргумент "--remote" не указан, то {название} присваивается данной копии редактора Vim, в противном случае указывает на сервер, к которому следует подключиться. Если используется сервер сокетов, и если {название} начинается с символа "/", "./" или "../", она рассматривается как абсолютный или относительный маршрут к сокету

--clientserver {движок}

Использовать соответствующий {движок} в качестве серверной части для функционала клиент-сервер. Допустимыми значениями является "soket" или "x11". Доступно только при компиляции с активированными компонентами soketserver и X11.

--socketid {id}

Только для графического интерфейса GTK. Будет использован механизм GtkPlug для запуска редактора gVim в отдельном окне.

--startuptime {файл}

Будет выполнена запись хронометража запуска программы в {файл}.

--ttyfail

Будт сразу же завершена работа, если ввод-вывод получен не с терминала (tty).

--version

Будет выведена информация о версии программы и завершена работа.

--windowid {ИД}

Только для графического интерфейса в MS Windows. Редактор gVim будет использовать окно с указанным {ИД} в качестве родительского, чтобы попытаться выполнить запуск внутри этого окна.

## ВСТРОЕННАЯ ДОКУМЕНТАЦИЯ
Для начала работы с документацией, наберите в редакторе Vim команду ":help". Введите ":help тема", чтобы получить справку по интересующей теме. Например, по команде ":help ZZ" будет выведена информация о команде "ZZ". Используйте клавиши <TAB> и CTRL+D для подстановки нужного названия темы (см. ":help cmdline-completion"). Для быстрого перемещения по документации используются индексы (что-то вроде гипертекстовых ссылок, см. ":help"). Таким образом можно переходить от одного файла документации к другому, например, ":help syntax.txt".

## ФАЙЛЫ
/usr/share/vim/doc/*.txt

Файлы документации редактора Vim. См. ":help doc-file-list" для получения полного перечня файлов.

Здесь и далее vim?? означает сокращённую запись номера версии, например, vim91 для версии редактора Vim 9.1

/usr/share/vim/doc/tags

Файл индексов, используемый для поиска информации в файлах документации.

/usr/share/vim/syntax/syntax.vim

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

/usr/share/vim/syntax/*.vim

Файлы распознавания и подсветки синтаксиса для различных языков программирования.

/usr/share/vim/vimrc

Общесистемный файл начальной настройки для консольного редактора Vim.

~/.vimrc, ~/.vim/vimrc, $XDG_CONFIG_HOME/vim/vimrc

Пользовательские файлы начальной настройки для консольного редактора Vim (будет использован первый найденный файл из указанных).

/usr/share/vim/gvimrc

Общесистемный файл начальной настройки для редактора с графическим интерфейсом gVim.

~/.gvimrc, ~/.vim/gvimrc, $XDG_CONFIG_HOME/vim/gvimrc

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

/usr/share/vim/optwin.vim

Командный файл, используемый при выполнении команды ":options". По этой команде предоставляется удобный способ просмотра и изменения настроек.

/usr/share/vim/menu.vim

Системные настройки меню для графического интерфейса редактора gVim.

/usr/share/vim/bugreport.vim

Командный файл для создания отчёта об обнаруженных ошибках. См. ":help bugs".

/usr/share/vim/filetype.vim

Командный файл для распознавания типов файлов по наименованию. См. ":help 'filetype'".

/usr/share/vim/scripts.vim

Командный файл для распознавания типов файлов по содержимому. См. ":help 'filetype'".

/usr/share/vim/print/*.ps

Файлы, используемые для печати через интерфейс PostScript.

Всю последнюю информацию о редакторе можно получить на веб-странице VIM:

<URL:http://www.vim.org/>

## СМОТРИТЕ ТАКЖЕ
vimtutor(1)

## АВТОРЫ
Большая часть редактора Vim была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное количество людей. См. ":help credits" в редакторе Vim.

Редактор Vim базируется на коде редактора Stevie, написанного Тимом Томпсоном (Tim Thompson), Тони Эндрюсом (Tony Andrews) и Г. Р. (Фредом) Уолтером (G.R. (Fred) Walter). Однако, в настоящее время в программе Vim почти ничего не осталось от исторического кода его предшественника.

Русская локализация редактора Vim выполняется в рамках проекта "РуВим", см. <URL:https://github.com/restorerz/ruvim/>.

## ОШИБКИ
Скорее всего есть. См. ":help todo" — перечень известных ошибок в работе.

Заметим, что многие вещи, которые считаются ошибками, на самом деле являются результатом слишком полного воспроизведения поведения редактора Vi. Если вы думаете, что что-то является ошибкой только потому, что "Vi делает это по-другому", внимательно прочитайте файл vi_diff.txt (или наберите ":help vi_diff.txt" в редакторе Vim) и посмотрите параметры

'compatible' и 'cpoptions'.


vimdiff

title: vimdiff(1)

text:
# vimdiff(1)

## НАЗНАЧЕНИЕ
Программа vimdiff — запускает редактор Vim для сравнения и правки от двух до восьми версий текстового файла.

## КАТКИЙ ОБЗОР
vimdiff [аргументы] file1 file2 [file3 [file4 [file5 [file6 [file7 [file8]]]]]]

gvimdiff

## ОПИСАНИЕ
По команде vimdiff выполняется загрузка в редактор Vim от двух до восьми файлов, и для каждого файла создаётся отдельное окно. Различия между файлами выделяются с помощью подсветки. Этот способ очень удобен для наглядного отображения внесённых изменений и переноса различающихся фрагментов текста из одной версии файла в другую.

Подробнее о редакторе Vim см. в справочнике vim(1).

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

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

Для улучшения работы с файлами в режиме сравнения различий также будут установлены параметры 'wrap' и 'scrollbind'.

Для параметра 'foldmethod' устанавливается значение "diff", что позволяет сворачивать области текста, которые идентичны в различных версиях файла. Значение параметра 'foldcolumn' устанавливается равным 2, чтобы было проще находить, открывать и закрывать такие области свёрнутого текста.

## АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
При сопоставлении файлов, используется вертикальное расположение окон, как если бы был указан аргумент "-O". Для того, чтобы окна располагались по горизонтали, следует указать в командной строке аргумент "-o".

Остальные аргументы командной строки описаны в справочнике vim(1).

## СМОТРИТЕ ТАКЖЕ
vim(1)

## АВТОРЫ
Большая часть редактора Vim была создана Брамом Моленаром (Bram Moolenaar), которому помогало огромное количество людей. См. ":help credits" в редакторе Vim.


vimtutor

package: vimtutor

title: vimtutor(1)

text:
# vimtutor(1)

## НАЗНАЧЕНИЕ
Программа vimtutor — выполняет запуск учебника по редактору Vim

## КРАТКИЙ ОБЗОР
vimtutor [-l | --language ISO639] [-c | --chapter НОМЕР] [-g | --gui] [ISO639]

vimtutor [-h | --help]

vimtutor [--list]

## ОПИСАНИЕ
По команде vimtutor выполняется запуск редактора Vim. с загруженным файлом, содержащем текст учебника.

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

Необязательный аргумент [ISO639] задаётся как двух- или трёхсимвольный код языка, например, "ru" или "it", или "bar".

По команде Vimtutor будет открыта созданная копии файла учебника, чтобы в нём можно было выполнять практические задания без опасения испортить исходный файл.

При работе с учебником, редактор Vim всегда запускается в варианте неполной совместимости с редактором Vi.

## АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
-l, --language=ISO639

Задаёт двух- или трёхсимволный код языка. Например, "ru", "es", "bar". По умолчанию используется язык, заданный в действующих региональных настройках, если такие настройки есть. В противном случае используется английский язык.

-c, --chapter=НОМЕР

Задаёт номер главы учебника. Значением может быть 1 или 2. По умолчанию будет открыта первая глава учебника.

-g, --gui

Указывает на запуск учебника в графическом интерфейсе редактора, если это возможно. В противном случае будет запущен консольный вариант редактора Vim.

-h, --help

Будет показана краткая информация об аргументах и параметрах командной строки.

--list

Будет показана информация о доступных главах и языках учебника.

## ПРИМЕРЫ
Чтобы открыть первую главу учебника на немецком языке, наберите команду

```
vimtutor de
```

```

```

Чтобы открыть вторую главу учебника на английском языке, наберите команду

```
vimtutor -c2
```

```

```

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

```
vimtutor --language bar --chapter 1 --gui
```

```

```

## ФАЙЛЫ
/usr/share/vim/tutor/tutor1[.ISO639]

Файлы с текстом первой главы учебника Vimtutor.

/usr/share/vim/tutor/tutor2[.ISO639]

Файлы с текстом второй главы учебника Vimtutor.

/usr/share/vim/tutor/tutor.vim

Командный файл редактора Vim, который используется для создания рабочей копии файла учебника Vimtutor.

## АВТОРЫ
Учебник Vimtutor был впервые написан для Vi Майклом К. Пирсом (Michael C. Pierce) и Робертом К. Уэа (Robert K. Ware) из Colorado School of Mines по идее Чарльза Смита (Charles Smith) из Colorado State University. E-mail: bware@mines.colorado.edu (теперь недоступен).

Впоследствии учебник был доработан для использования в редакторе Vim Брамом Моленаром (Bram Moolenaar).

Имена переводчиков указаны в соответствующих файлах с переводами учебника.

## СМОТРИТЕ ТАКЖЕ
vim(1)


xxd

package: xxd

title: xxd(1)

text:
# xxd(1)

## НАЗНАЧЕНИЕ
Программа xxd — выполняет преобразование данных или в шестнадцатеричный вид, или выполняет обратное преобразование из шестнадцатеричного кода в исходный формат

## КРАТКИЙ ОБЗОР
xxd -h[elp]

xxd [аргументы] [входной_файл [выходной_файл]]

xxd -r[evert] [аргументы] [входной_файл [выходной_файл]]

## ОПИСАНИЕ
Программа xxd создаёт представление указанного файла или данных, прочитанных из стандартного потока ввода, в виде шестнадцатеричных кодов. Эта программа также может выполнять обратное преобразование заданных шестнадцатеричными кодами данных в исходный двоичных формат. Подобно программам uuencode(1) и uudecode(1) , она позволяет выполнять преобразование двоичных данных в символы кодировки ASCII, которые можно передавать по электронной почте, однако, помимо этого, программа xxd позволяет выполнять декодирование в поток стандартного вывода, а также может применяться для создания исправлений для двоичных файлов.

## АРГУМЕНТЫ КОМАНДНОЙ СТРОКИ
Если входной_файл не задан, то требуемые данные считываются из стандартного потока ввода. В случае, если в качестве входного_файла используется символ '-', источником данных также выступает стандартный поток ввода. В том случае, если не указан выходной_файл (или вместо него используется символ '-' ), результат преобразования направляется в стандартный поток вывода.

Обратите внимание, что применяется "ленивый" алгоритм разбора аргументов, который проверяет только первую букву аргумента, если, конечно, для этого аргумента не указано какое-то значение. Пробелы между односимвольным аргументом и его значением не являются обязательными. Значения аргументов могут быть заданы в десятичном, шестнадцатеричном или восьмеричном формате. Таким образом, аргументы -c8, -c 8, -c 010 и -cols 8 являются равнозначными.

-a | -autoskip

Включить автоматический пропуск, т. е., вместо нескольких идущих подряд строк с нулевым значением, используется одиночный символ '*'. По умолчанию не применяется.

-b | -bits

Использовать биты (двоичный код), а не шестнадцатеричные цифры. При указании этого аргумента, вместо обычного шестнадцатеричного представления октетов, будет отображается набор из восьми цифр "1" и "0". Каждая строка предваряется её номером в шестнадцатеричном виде, а завершается в виде символов в кодировке ASCII (или в кодировке EBCDIC). Аргумент командной строки -p в этом режиме не применяется. Аргумент -i может быть указан для этого режима.

-c кол | -cols кол

Задаёт количество октетов <кол>, которое выводится на каждой строке. По умолчанию используется значение 16 (для аргумента -i используется 12, для -ps — 30, для -b — 6). Максимально допустимое значение — 256. Максимальное значение не применяется с аргументом -ps. Если с аргументом -ps, указано значение 0, то будет выведена просто одна длинная строка.

-C | -capitalize

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

-d

Отображать смещение не в шестнадцатеричном, а в десятичном формате.

-E | -EBCDIC

Отображать символы в крайне правой колонке не в кодировке ASCII, а в кодировке EBCDIC. Этот аргумент не влияет на шестнадцатеричное представление данных. Данный аргумент не имеет смысла, если используются аргументы командной строки -r, -p или -i.

-e

Использовать обратный порядок байт при отображение шестнадцатеричного представления данных. Группа байт будет показана как двоичное слово от младших разрядов к старшим. Используемое по умолчанию группирование по четыре байта может быть изменено через аргумент командной строки -g. Действие этого аргумента распространяется только на шестнадцатеричное представление данных и не оказывает влияние на символьное представление в кодировке ASCII (или EBCDIC). Аргументы командной строки -r, -p, -i не применяются в этом режиме.

-g байт | -groupsize байт

Выполнить группирование указанного количества <байт> (две шестнадцатеричные цифры или восемь двоичных цифр), отделяя группы друг от друга пробелами. Значение -g 0 применяется для отказа от использования группирования. По умолчанию используется значение <байт>, равное 2 при отображении в прямом порядке байт, 4 при отображении в обратном порядке байт и 1 в двоичном режиме. Группировка не применяется в режиме PostScript или include.

-h | -help

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

-i | -include

Создавать вывод в стиле подключаемых заголовочных файлов языка Си. Вывод содержит полноценное определение статического массива данных, название которого соответствует наименованию входного файла, если программа xxd не считывает данные из стандартного потока ввода. Возможно совмещение аргументов -i и -b. -b.

-l длина | -len длина

Указывает, что после записи заданного в параметре <длина> количества октетов, работа программы будет завершена.

-n название | -name название

Изменить возвращаемое наименование переменной при использовании аргумента -i. Применяется к массиву байт, который будет именоваться как название и длина файла как название_len.

-o смещение

Указывает добавить <смещение> в отображаемую позицию файла.

-p | -ps | -postscript | -plain

Использовать непрерывный формата вывода шестнадцатеричного кода, известного как "простой" стиль или стиль "PostScript".

-r | -revert

Выполнить операцию обратного преобразования, т. е. преобразование шестнадцатеричного представления в двоичный код (или применить результат в качестве исправления). Если вывод происходит не в стандартного поток вывода, то программа xxd выполняет добавление кода к выходному файлу. При использовании комбинации аргументов -r -p происходит чтение "простого" шестнадцатеричного представления без использования информации о номерах строк и какого-либо специального распределения колонок. Пробелы и символы новой строки могут встречаться в любом месте исходных данных. При использовании комбинации аргументов -r -b будет происходить считывание двоичного представления вместо шестнадцатеричного.

-R когда

В выходных данных одни и те же шестнадцатеричные значения и строковые значения будут подсвечиваться одним и тем же цветом. В основном это помогает различать печатаемые и непечатаемые символы. Где когда может принимать значение never (никогда), always (всегда), или auto (автовыбор, по умолчанию). Если установлена переменная окружения $NO_COLOR , то цветовая подсветка будет отключена.

-seek смещение

При указании после аргумента -r , будет добавляться указанное <смещение> к файловым позициям, обнаруженным в исходных данных.

-s [+][-]seek

Начинать обработку с указанного абсолютного (или относительного) <смещения> в байтах во входном_файле. Где + указывает, что смещение является относительным по отношению к текущей позиции данных в стандартном потоке ввода (бессмысленно, если чтение происходит не из стандартного потока ввода). А параметр - указывает, что должно быть прочитано указанное количество символов от конца ввода (либо, если одновременно с параметром +, то перед текущей позицией данных в стандартном потоке ввода). Если аргумент -s не используется, то программа xxd начинает обработку от текущей позиции в файле.

-t

При использовании аргумента -i для вывода в стиле подключаемых заголовочных файлов языка Си также включать завершающий нулевой символ

-u

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

-v | -version

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

## НЕКОТОРЫЕ РАЗЪЯСНЕНИЯ
При указании команды xxd -r при запуске программы, будет применяться некий встроенный алгоритм для распознавания информации о номерах строк. Если возможен поиск по входному файлу, то номера строк в начале каждой строки шестнадцатеричного представления могут быть неупорядоченными, некоторые строки могут быть пропущены или пересекаться друг с другом. В этих случаях программа xxd использует функцию lseek(2) для перехода к следующей позиции. Если поиск по входному файлу невозможен, то допустимы только пропуски строк, которые заполняются нулевыми байтами.

Использование команды xxd -r приводит к тому, что сообщения об ошибках не будут отображаться. Посторонние данные просто молча пропускаются.

При редактировании шестнадцатеричного представления двоичных файлов, обращайте внимание, что по команде xxd -r , после считывания достаточного количества колонок шестнадцатеричных данных (см. аргумент -c), в строке ввода не будут обрабатываться остальные данные. Это означает, что изменения, внесённые в колонке с текстом в кодировке ASCII (или EBCDIC), всегда игнорируются. При обратном преобразовании шестнадцатеричного представления в стиле PostScript с помощью команды xxd -r -p количество колонок не учитывается. В этом случае распознаются все символы, которые похожи на пары шестнадцатеричных цифр.

Обратите внимание на различие между командами

% xxd -i файл

и

% xxd -i < файл

Команда xxd -s +seek может отличаться от xxd -s seek, поскольку для того, чтобы "отмотать" данные на входе назад, используется вызов функции lseek(2). При указании параметра '+' поведение будет отличаться, если входные данные поступают со стандартного потока ввода, а позиция в файле стандартного ввода не находится в начале файла к тому моменту, когда программа xxd запущена и приступает к чтению ввода. Нижеследующие примеры помогут прояснить (или ещё больше запутать!) ситуацию...

Отмотка потока стандартного ввода назад необходима, поскольку программа 'cat' уже выполнила чтение данных до конца из стандартного потока ввода:

% sh -c "cat > plain_copy; xxd -s 0 > hex_copy" < file

Вывод шестнадцатеричного представления от позиции в файле 0x480 (=1024+128). Параметр '+' означает "относительно текущей позиции", таким образом '128' добавляется к первому килобайту, где завершает работу программа dd:

% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +128 > hex_snippet" < file

Вывод шестнадцатеричного представления от позиции в файле 0x100 (=1024−768):

% sh -c "dd of=plain_snippet bs=1k count=1; xxd -s +-768 > hex_snippet" < file

В то же время, следует заметить, что подобные ситуации встречаются довольно редко, так что параметр '+' обычно не используется. Автор предпочитает наблюдать за работой программы xxd с помощью инструментов strace(1) или truss(1) в тех случаях, когда применяется аргумент -s.

## ПРИМЕРЫ
Вывести всё, кроме первых трёх строк (0x30 байт) файла :

% xxd -s 0x30 file

Вывести три строки (0x30 байт) от конца файла :

% xxd -s -0x30 file

Вывести 120 байт в виде непрерывного шестнадцатеричного представления по 20 октетов в строке

(этот пример для справочника xxd.1 на английском языке, для русского языка будет немного другой результат):

% xxd -l 120 -ps -c 20 xxd.1

2e544820585844203120224d6172203230323622

20224d616e75616c207061676520666f72207878

64220a2e5c220a2e5c222032317374204d617920

313939360a2e5c22204d616e2070616765206175

74686f723a0a2e5c2220202020546f6e79204e75

67656e74203c746f6e79407363746e7567656e2e

Вывести первые 120 байт этого справочника по 12 октетов в строке

(этот пример для справочника xxd.1 на английском языке, для русского языка будет немного другой результат):

% xxd -l 120 -c 12 xxd.1

00000000: 2e54 4820 5858 4420 3120 224d .TH XXD 1 "M

0000000c: 6172 2032 3032 3622 2022 4d61 ar 2026" "Ma

00000018: 6e75 616c 2070 6167 6520 666f nual page fo

00000024: 7220 7878 6422 0a2e 5c22 0a2e r xxd"..\"..

00000030: 5c22 2032 3173 7420 4d61 7920 \" 21st May

0000003c: 3139 3936 0a2e 5c22 204d 616e 1996..\" Man

00000048: 2070 6167 6520 6175 7468 6f72 page author

00000054: 3a0a 2e5c 2220 2020 2054 6f6e :..\" Ton

00000060: 7920 4e75 6765 6e74 203c 746f y Nugent <to

0000006c: 6e79 4073 6374 6e75 6765 6e2e ny@sctnugen.

Показать дату из файла xxd.1

(этот пример для справочника xxd.1 на английском языке, для русского языка будет немного другая команда, например, для UTF-8 — xxd -s 0x50 -l 13 -c 13 xxd.1):

% xxd -s 0x33 -l 13 -c 13 xxd.1

00000033: 3231 7374 204d 6179 2031 3939 36 21st May 1996

Скопировать входной_файл в выходной_файл с добавлением 100 байт со значением 0x00 в начало файла:

% xxd входной_файл | xxd -r -s 100 > выходной_файл

Заменить дату в файле xxd.1

(этот пример для справочника xxd.1 на английском языке, для русского языка будут немного другие команды):

% echo "0000034: 3574 68" | xxd -r - xxd.1

% xxd -s 0x33 -l 13 -c 13 xxd.1

00000033: 3235 7468 204d 6179 2031 3939 36 25th May 1996

Создать 65537-байтный файл, все байты которого имеют значение 0x00, кроме последнего байта, который должен иметь значение 'A' (0x41):

% echo "010000: 41" | xxd -r > file

Создать шестнадцатеричное представление этого файла с использованием автоматического пропуска:

% xxd -a -c 12 file

00000000: 0000 0000 0000 0000 0000 0000 ............

*

0000fffc: 0000 0000 41 ....A

Создать 1-байтный файл, содержащий символ 'A'. Число после аргументов '-r -s' добавляется к номерам строк, найденным в файле, иначе говоря, предшествующие байты пропускаются:

% echo '010000: 41' | xxd -r -s -0x10000 > file

Программу xxd можно использовать в качестве фильтра в редакторе, например в vim(1) , чтобы создать шестнадцатеричное представление области между закладками 'a' и 'z':

:'a,'z!xxd

Можно использовать программу xxd в качестве фильтра в редакторе, например в vim(1) , для восстановления данных из шестнадцатеричного представления между закладками 'a' и 'z':

:'a,'z!xxd -r

Можно использовать программу xxd в качестве фильтра в редакторе, например в vim(1) , для восстановления данных из единственной строки шестнадцатеричного представления. Поместите курсор в соответствующую строку и наберите

!!xxd -r

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

% xxd -c1 < /dev/term/b &

% stty < /dev/term/b -echo -opost -isig -icanon min 1

% echo -n foo > /dev/term/b

Вывод в стиле подключаемых заголовочных файлв языка Си с завершающим нулём

% echo -n "0123456789" > digits

% xxd -i -t digits

unsigned char digits[] = {

0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x00

};

unsigned int digits_len = 10;

## КОДЫ ЗАВЕРШЕНИЯ
При завершении работы, программа xxd возвращает следующие значения:

0

Ошибки не обнаружены.

-1

Операция не поддерживается (выполнение xxd -r -i пока невозможно).

1

Ошибка при разборе аргументов командной строки.

2

Ошибки во входном файле.

3

Ошибки в выходном файле.

4,5

Желательная позиция поиска недостижима.

## СМОТРИТЕ ТАКЖЕ
uuencode(1), uudecode(1), patch(1)

## ПРЕДУПРЕЖДЕНИЕ
Странность этой программы соответствует особенностям мозга её создателя. Используйте её на свой страх и риск. Копируйте файлы, отслеживайте вызовы, становитесь волшебником.

## ВЕРСИЯ
Этот справочник документирует программу xxd версии 1.7 от 2024-05.

## АВТОР
(c) Юрген Вайгерт (Juergen Weigert), 1990-1997

<jnweiger@informatik.uni-erlangen.de>

Вы можете свободно распространять программу со ссылкой на меня.

Если использование этой программы принесло вам какой-то доход, поделитесь со мной.

Если вы потеряли деньги, то я тут ни при чём.

Первый вариант справочника написан Тони Наджентом (Tony Nugent)

<tony@sctnugen.ppp.gu.edu.au> <T.Nugent@sct.gu.edu.au>

Небольшие изменения внесены Брамом Моленаром (Bram Moolenaar). Справочник отредактирован Юргеном Вайгертом (Juergen Weigert).