.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.35)

.\"

.\" Standard preamble:

.\" ========================================================================

.de Sp \" Vertical space (when we can't use .PP)

.if t .sp .5v

.if n .sp

..

.de Vb \" Begin verbatim text

.ft CW

.nf

.ne \\$1

..

.de Ve \" End verbatim text

.ft R

.fi

..

.\" Set up some character translations and predefined strings.  \*(-- will

.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left

.\" double quote, and \*(R" will give a right double quote.  \*(C+ will

.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and

.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,

.\" nothing in troff, for use with C<>.

.tr \(*W-

.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'

.ie n \{\

.    ds -- \(*W-

.    ds PI pi

.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch

.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch

.    ds L" ""

.    ds R" ""

.    ds C` ""

.    ds C' ""

'br\}

.el\{\

.    ds -- \|\(em\|

.    ds PI \(*p

.    ds L" ``

.    ds R" ''

.    ds C`

.    ds C'

'br\}

.\"

.\" Escape single quotes in literal strings from groff's Unicode transform.

.ie \n(.g .ds Aq \(aq

.el       .ds Aq '

.\"

.\" If the F register is turned on, we'll generate index entries on stderr for

.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index

.\" entries marked with X<> in POD.  Of course, you'll have to process the

.\" output yourself in some meaningful fashion.

.\"

.\" Avoid warning from groff about undefined register 'F'.

.de IX

..

.nr rF 0

.if \n(.g .if rF .nr rF 1

.if (\n(rF:(\n(.g==0)) \{

.    if \nF \{

.        de IX

.        tm Index:\\$1\t\\n%\t"\\$2"

..

.        if !\nF==2 \{

.            nr % 0

.            nr F 2

.        \}

.    \}

.\}

.rr rF

.\" ========================================================================

.\"

.IX Title "dos2unix 1"

.TH dos2unix 1 "2017-10-10" "dos2unix" "2017-10-10"

.\" For nroff, turn off justification.  Always turn off hyphenation; it makes

.\" way too many mistakes in technical documents.

.if n .ad l

.nh

.SH "НАЗВА"

.IX Header "НАЗВА"

dos2unix \- програма для перетворення даних у текстовому форматі DOS/Mac у

формат Unix, і навпаки

.SH "КОРОТКИЙ ОПИС"

.IX Header "КОРОТКИЙ ОПИС"

.Vb 2

\&    dos2unix [параметри] [ФАЙЛ ...] [\-n ВХІДНИЙ_ФАЙЛ ВИХІДНИЙ_ФАЙЛ ...]

\&    unix2dos [параметри] [ФАЙЛ ...] [\-n ВХІДНИЙ_ФАЙЛ ВИХІДНИЙ_ФАЙЛ ...]

.Ve

.SH "ОПИС"

.IX Header "ОПИС"

До складу пакунка Dos2unix включено програми \f(CW\*(C`dos2unix\*(C'\fR та \f(CW\*(C`unix2dos\*(C'\fR,

призначені для перетворення звичайних текстових даних у форматі \s-1DOS\s0 або Mac

на дані у форматі Unix, і навпаки.

.PP

У текстових файлах DOS/Windows розрив рядка або перехід на новий рядок

здійснюється за допомогою комбінації двох символів: повернення каретки (\s-1CR\s0)

і переведення рядка (\s-1LF\s0). У текстових файлах Unix за перехід на новий рядок

відповідає один символ: переведення рядка (\s-1LF\s0). У текстових файлах Mac, до

Mac \s-1OS X,\s0 за розрив рядка відповідав один символ: повернення каретки (\s-1CR\s0). У

сучасних версіях Mac \s-1OS\s0 використовується типовий для Unix розрив рядка (\s-1LF\s0).

.PP

Окрім символів розриву рядка, програма Dos2unix здатна виконувати

перетворення кодування файлів. Можна перетворити дані у декількох кодуваннях

\&\s-1DOS\s0 на файли у кодуванні Latin\-1 Unix. Також можна перетворити дані у файлах

Windows Unicode (\s-1UTF\-16\s0) на дані у кодуванні Unix Unicode (\s-1UTF\-8\s0).

.PP

Під час перетворення програма пропускатиме двійкові файли, якщо ви не

накажете їй виконати перетворення таких файлів безпосередньо.

.PP

Програма автоматично пропускатиме файли, які не є звичайними файлами,

зокрема каталоги та канали \s-1FIFO.\s0

.PP

Типово, програма не вноситиме змін до символічних посилань та об’єктів

посилань. Якщо потрібно, програма може замінити символічні посилання або

записати перетворені дані до файла\-призначення символічного посилання. У

Windows запису до об’єкта символічного посилання не передбачено.

.PP

Програму dos2unix було створено за зразком програми dos2unix для

SunOS/Solaris. Втім, існує одна важлива відмінність від оригінальної версії

для SunOS/Solaris. Ця версія типово виконує заміну файлів під час

перетворення (старий режим обробки файлів), а у оригінальній версії для

SunOS/Solaris передбачено підтримку лише парного перетворення (новий режим

обробки файлів). Див. також параметри \f(CW\*(C`\-o\*(C'\fR та \f(CW\*(C`\-n\*(C'\fR. Ще однією відмінністю

є те, що у версії для SunOS/Solaris типово використовувався режим

перетворення \fIiso\fR, а у цій версії типовим є режим перетворення \fIascii\fR.

.SH "ПАРАМЕТРИ"

.IX Header "ПАРАМЕТРИ"

.IP "\fB\-\-\fR" 4

.IX Item "--"

Вважати усі наступні параметри назвами файлів. Цим параметром слід

користуватися, якщо вам потрібно виконати перетворення файлів, чиї назви

містять дефіси. Наприклад, щоб виконати перетворення файла «\-foo»,

скористайтеся такою командою:

.Sp

.Vb 1

\&    dos2unix \-\- \-foo

.Ve

.Sp

Або у новому режимі файлів:

.Sp

.Vb 1

\&    dos2unix \-n \-\- \-foo out.txt

.Ve

.IP "\fB\-\-allow\-chown\fR" 4

.IX Item "--allow-chown"

Allow file ownership change in old file mode.

.Sp

When this option is used, the conversion will not be aborted when the user

and/or group ownership of the original file can't be preserved in old file

mode. Conversion will continue and the converted file will get the same new

ownership as if it was converted in new file mode. See also options \f(CW\*(C`\-o\*(C'\fR

and \f(CW\*(C`\-n\*(C'\fR. This option is only available if dos2unix has support for

preserving the user and group ownership of files.

.IP "\fB\-ascii\fR" 4

.IX Item "-ascii"

Виконати лише перетворення символів розриву рядків. Типовий режим

перетворення.

.IP "\fB\-iso\fR" 4

.IX Item "-iso"

Виконати перетворення з кодування \s-1DOS\s0 на кодування \s-1ISO\-8859\-1.\s0 Див. розділ

щодо режимів перетворення.

.IP "\fB\-1252\fR" 4

.IX Item "-1252"

Використати кодову таблицю 1252 Windows (західноєвропейські мови).

.IP "\fB\-437\fR" 4

.IX Item "-437"

Використовувати кодову сторінку \s-1DOS 437 \s0(США). Це типова кодова сторінка для

перетворення \s-1ISO.\s0

.IP "\fB\-850\fR" 4

.IX Item "-850"

Використовувати кодову сторінку \s-1DOS 850 \s0(західноєвропейські мови).

.IP "\fB\-860\fR" 4

.IX Item "-860"

Використовувати сторінку \s-1DOS 860 \s0(португальська).

.IP "\fB\-863\fR" 4

.IX Item "-863"

Використовувати сторінку \s-1DOS 863 \s0(канадська французька).

.IP "\fB\-865\fR" 4

.IX Item "-865"

Використовувати сторінку \s-1DOS 865 \s0(скандинавські мови).

.IP "\fB\-7\fR" 4

.IX Item "-7"

Перетворювати 8\-бітові символи на 7\-бітові.

.IP "\fB\-b, \-\-keep\-bom\fR" 4

.IX Item "-b, --keep-bom"

Зберегти позначку порядку байтів (\s-1BOM\s0). Якщо у файлі вхідних даних є \s-1BOM,\s0

записати \s-1BOM\s0 до файла результатів. Це типова поведінка під час перетворення

у формат із символами розриву рядків \s-1DOS.\s0 Див. також параметр \f(CW\*(C`\-r\*(C'\fR.

.IP "\fB\-c, \-\-convmode РЕЖИМ\fR" 4

.IX Item "-c, --convmode РЕЖИМ"

Встановити режим перетворення. Значенням аргументу РЕЖИМ може бути один з

таких рядків: \fIascii\fR, \fI7bit\fR, \fIiso\fR, \fImac\fR. Типовим є режим ascii.

.IP "\fB\-D, \-\-display\-enc КОДУВАННЯ\fR" 4

.IX Item "-D, --display-enc КОДУВАННЯ"

Встановити кодування показаного тексту. Можливі варіанти значень параметра

КОДУВАННЯ: \fIansi\fR, \fIunicode\fR, \fIunicodebom\fR, \fIutf8\fR, \fIutf8bom\fR, типовим

є ansi.

.Sp

Цей параметр доступний лише у dos2unix для Windows з підтримкою назв файлів

у Unicode. Цей параметр не впливає на справжнє читання та запис назв файлів,

лише на те, як буде показано ці назви.

.Sp

Існує декілька способів показу тексту у консолі Windows, заснованих на

кодуванні тексту. Усі ці способи мають свої переваги і недоліки.

.RS 4

.IP "\fBansi\fR" 4

.IX Item "ansi"

Типовим способом для dos2unix є кодування тексту у форматі \s-1ANSI.\s0 Перевагою є

зворотна сумісність. Цей варіант працює з растровими шрифтами та шрифтами

TrueType. У деяких регіонах, ймовірно, вам доведеться змінити активну кодову

сторінку \s-1DOS OEM\s0 на системну кодову сторінку \s-1ANSI\s0 Windows за допомогою

команди \f(CW\*(C`chcp\*(C'\fR, оскільки dos2unix використовує системну кодову сторінку

Windows.

.Sp

Недоліком ansi є те, що назви файлів із символами, яких немає у типовому

системному кодуванні, буде показано неправильно. Замість цих символів ви

побачите знак питання або не той символ. Якщо у вашій системі немає файлів

із назвами, які містять нетипові символи, можна скористатися цим варіантом.

.IP "\fBunicode, unicodebom\fR" 4

.IX Item "unicode, unicodebom"

Перевагою кодування unicode (назва у Windows кодування \s-1UTF\-16\s0) є те, що

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

потрібно. Ймовірно, вам потрібно встановити шрифт консолі TrueType для

належного показу нестандартних символів. Якщо символ не передбачено у шрифті

TrueType, зазвичай ви побачите невеличкий квадратик замість символу, іноді

із знаком питання у ньому.

.Sp

Якщо ви користуєтеся консоллю ConEmu, весь текст буде показано належним

чином, оскільки ConEmu автоматично вибирає належний шрифт.

.Sp

Недоліком unicode є те, що це кодування несумісне з \s-1ASCII.\s0 Обробка виведених

даних є непростою, якщо ви передаватимете ці дані до іншої програми або

файла.

.Sp

Якщо використовується метод \f(CW\*(C`unicodebom\*(C'\fR, текст у кодуванні Unicode буде

оброблено з урахуванням \s-1BOM \s0(позначки порядку байтів). \s-1BOM\s0 потрібна для

правильного переспрямовування або тунелювання даних у PowerShell.

.IP "\fButf8, utf8bom\fR" 4

.IX Item "utf8, utf8bom"

Перевагою utf8 є те, що це кодування сумісне з \s-1ASCII.\s0 Вам слід встановити

шрифт консолі TrueType. Якщо використано шрифт TrueType, текст буде показано

подібно до того, як його показано, якщо визначено кодування \f(CW\*(C`unicode\*(C'\fR.

.Sp

Недоліком є те, що якщо ви скористаєтеся типовим растровим шрифтом, усі

символи поза \s-1ASCII\s0 буде показано неправильно. Не лише назви файлів у

unicode, а й перекладені повідомлення стануть непридатними до читання. У

Windows, налаштованому на роботі у східно\-азійському регіоні, ви можете

помітити значне блимання під час показу повідомлень.

.Sp

У консолі ConEmu добре працює спосіб кодування utf8.

.Sp

Якщо використовується метод \f(CW\*(C`utf8bom\*(C'\fR, текст у кодуванні \s-1UTF\-8\s0 буде

оброблено з урахуванням \s-1BOM \s0(позначки порядку байтів). \s-1BOM\s0 потрібна для

правильного переспрямовування або тунелювання даних у PowerShell.

.RE

.RS 4

.Sp

Типове кодування можна змінити за допомогою змінної середовища

\&\s-1DOS2UNIX_DISPLAY_ENC\s0 встановленням для неї значення \f(CW\*(C`unicode\*(C'\fR,

\&\f(CW\*(C`unicodebom\*(C'\fR, \f(CW\*(C`utf8\*(C'\fR або \f(CW\*(C`utf8bom\*(C'\fR.

.RE

.IP "\fB\-f, \-\-force\fR" 4

.IX Item "-f, --force"

Примусове перетворення двійкових файлів.

.IP "\fB\-gb, \-\-gb18030\fR" 4

.IX Item "-gb, --gb18030"

У Windows файли в \s-1UTF\-16\s0 типово перетворюються на файли в \s-1UTF\-8,\s0 незалежно

від встановленої локалі. За допомогою цього параметра ви можете наказати

програмі перетворювати файли в \s-1UTF\-16\s0 на файли у \s-1GB18030.\s0 Цим параметром

можна скористатися лише у Windows. Див. також розділ, присвячений \s-1GB18030.\s0

.IP "\fB\-h, \-\-help\fR" 4

.IX Item "-h, --help"

Показати довідкові дані і завершити роботу.

.IP "\fB\-i[ПРАПОРЦІ], \-\-info[=ПРАПОРЦІ] ФАЙЛ ...\fR" 4

.IX Item "-i[ПРАПОРЦІ], --info[=ПРАПОРЦІ] ФАЙЛ ..."

Вивести дані щодо файла. Не виконувати перетворення.

.Sp

Буде виведено такі дані, у вказаному порядку: кількість розривів рядків у

форматі \s-1DOS,\s0 кількість розривів рядків у форматі Unix, кількість розривів

рядків у форматі Mac, позначка порядку байтів, текстовим чи бінарним є файл

та назву файла.

.Sp

Приклад результатів:

.Sp

.Vb 8

\&     6       0       0  no_bom    text    dos.txt

\&     0       6       0  no_bom    text    unix.txt

\&     0       0       6  no_bom    text    mac.txt

\&     6       6       6  no_bom    text    mixed.txt

\&    50       0       0  UTF\-16LE  text    utf16le.txt

\&     0      50       0  no_bom    text    utf8unix.txt

\&    50       0       0  UTF\-8     text    utf8dos.txt

\&     2     418     219  no_bom    binary  dos2unix.exe

.Ve

.Sp

Зауважте, що іноді бінарні файли помилково розпізнаються як

текстові. Див. також параметр \f(CW\*(C`\-s\*(C'\fR.

.Sp

Крім того, можна вказати додаткові прапорці для внесення змін у виведені

дані. Можна використовувати один або декілька таких прапорців.

.RS 4

.IP "\fB0\fR" 4

.IX Item "0"

Виводити рядки даних щодо файла із завершенням на нульовий символ, а не

символ розриву рядка. Це уможливлює правильну інтерпретацію назв файлів, що

містять пробіли або символи лапок, якщо використано прапорець

«c». Скористайтеся цим прапорцем у поєднанні із параметром \f(CW\*(C`\-0\*(C'\fR або

\&\f(CW\*(C`\-\-null\*(C'\fR \fIxargs\fR\|(1).

.IP "\fBd\fR" 4

.IX Item "d"

Вивести кількість символів розривів рядка \s-1DOS.\s0

.IP "\fBu\fR" 4

.IX Item "u"

Вивести кількість символів розривів рядка Unix.

.IP "\fBm\fR" 4

.IX Item "m"

Вивести кількість символів розривів рядка Mac.

.IP "\fBb\fR" 4

.IX Item "b"

Вивести позначку порядку байтів.

.IP "\fBt\fR" 4

.IX Item "t"

Вивести дані щодо того, є файл текстовим чи бінарним.

.IP "\fBc\fR" 4

.IX Item "c"

Вивести дані лише тих файлів, які було б перетворено.

.Sp

Із прапорцем \f(CW\*(C`c\*(C'\fR dos2unix виведе лише назви файлів, у яких містяться

розриви рядків \s-1DOS.\s0 unix2dos виведе лише назви файлів, у яких містяться

розриви рядків Unix.

.IP "\fBh\fR" 4

.IX Item "h"

Вивести заголовок.

.IP "\fBp\fR" 4

.IX Item "p"

Показувати назви файлів без шляхів.

.RE

.RS 4

.Sp

Приклади:

.Sp

Вивести дані щодо усіх файлів *.txt:

.Sp

.Vb 1

\&    dos2unix \-i *.txt

.Ve

.Sp

Вивести кількість розривів рядків у форматі \s-1DOS\s0 і розривів рядків у форматі

Unix:

.Sp

.Vb 1

\&    dos2unix \-idu *.txt

.Ve

.Sp

Вивести лише позначку порядку байтів:

.Sp

.Vb 1

\&    dos2unix \-\-info=b *.txt

.Ve

.Sp

Вивести список файлів, у яких є символи розриву рядків \s-1DOS:\s0

.Sp

.Vb 1

\&    dos2unix \-ic *.txt

.Ve

.Sp

Вивести список файлів, у яких використано символи розриву рядків Unix:

.Sp

.Vb 1

\&    unix2dos \-ic *.txt

.Ve

.Sp

Перетворити лише файли із розривами рядків \s-1DOS\s0 і не чіпати інших файлів:

.Sp

.Vb 1

\&    dos2unix \-ic0 *.txt | xargs \-0 dos2unix

.Ve

.Sp

Знайти текстові файли і розривами рядків \s-1DOS:\s0

.Sp

.Vb 1

\&    find \-name \*(Aq*.txt\*(Aq \-print0 | xargs \-0 dos2unix \-ic

.Ve

.RE

.IP "\fB\-k, \-\-keepdate\fR" 4

.IX Item "-k, --keepdate"

Зберегти часову позначку файла вхідних даних у файлі результатів

перетворення.

.IP "\fB\-L, \-\-license\fR" 4

.IX Item "-L, --license"

Вивести умови ліцензування програми.

.IP "\fB\-l, \-\-newline\fR" 4

.IX Item "-l, --newline"

Вставити додатковий символ розриву рядка.

.Sp

\&\fBdos2unix\fR: перетворення на два символи розриву рядків Unix відбуватиметься

лише для комбінацій розриву рядків \s-1DOS.\s0 У режимі Mac виконуватиметься

перетворення на два розриви рядків Unix лише символів розриву рядків Mac.

.Sp

\&\fBunix2dos\fR: перетворення на дві комбінації розриву рядків \s-1DOS\s0

відбуватиметься лише для символів розриву рядків \s-1DOS.\s0 У режимі Mac

виконуватиметься перетворення на два розриви рядків Mac лише символів

розриву рядків Unix.

.IP "\fB\-m, \-\-add\-bom\fR" 4

.IX Item "-m, --add-bom"

Записати до файла результатів позначку порядку байтів (\s-1BOM\s0). Типово буде

записано позначку порядку байтів \s-1UTF\-8.\s0

.Sp

Якщо дані початкового файла закодовано у \s-1UTF\-16\s0 і використано параметр

\&\f(CW\*(C`\-u\*(C'\fR, буде дописано позначку порядку байтів \s-1UTF\-16.\s0

.Sp

Не використовуйте цей параметр для кодувань результатів, відмінних від

\&\s-1UTF\-8, UTF\-16\s0 або \s-1GB18030.\s0 Див. також розділ щодо \s-1UNICODE.\s0

.IP "\fB\-n, \-\-newfile ВХІДНИЙ_ФАЙЛ ВИХІДНИЙ_ФАЙЛ ...\fR" 4

.IX Item "-n, --newfile ВХІДНИЙ_ФАЙЛ ВИХІДНИЙ_ФАЙЛ ..."

Новий режим обробки файлів. Перетворити дані з файла ВХІДНИЙ_ФАЙЛ і записати

результати до файла ВИХІДНИЙ_ФАЙЛ. Назви файлів слід вказувати парами, \fIне

слід\fR використовувати шаблони заміни, інакше вміст файлів \fIбуде втрачено\fR.

.Sp

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

розпочато перетворення у режимі нового файла (парному режимі). Права доступу

на читання або запис нового файла буде визначено на основі прав доступу до

початкового файла мінус \fIumask\fR\|(1) для користувача, яким було розпочато

перетворення.

.IP "\fB\-\-no\-allow\-chown\fR" 4

.IX Item "--no-allow-chown"

Don't allow file ownership change in old file mode (default).

.Sp

Abort conversion when the user and/or group ownership of the original file

can't be preserved in old file mode. See also options \f(CW\*(C`\-o\*(C'\fR and \f(CW\*(C`\-n\*(C'\fR. This

option is only available if dos2unix has support for preserving the user and

group ownership of files.

.IP "\fB\-o, \-\-oldfile ФАЙЛ ...\fR" 4

.IX Item "-o, --oldfile ФАЙЛ ..."

Застарілий режим обробки. Виконати перетворення файла ФАЙЛ і перезаписати

його вміст. Типово, програма працює у цьому режимі. Можна використовувати

шаблони заміни.

.Sp

У застарілому режимі (режимі заміщення) перетворений файл належатиме тому

самому власнику і групі і матиме ті самі права доступу на читання або запис,

що і початковий файл. Крім того, якщо перетворення файла виконується іншим

користувачем, який має права доступу на запис до файла (наприклад

користувачем root), перетворення буде перервано, якщо зберегти початкові

значення не вдасться. Зміна власника може означати неможливість читання

файла для його початкового власника. Зміна групи може призвести до проблем

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

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

та прав доступу до файла передбачено лише у Unix.

.Sp

To check if dos2unix has support for preserving the user and group ownership

of files type \f(CW\*(C`dos2unix \-V\*(C'\fR.

.Sp

Conversion is always done via a temporary file. When an error occurs halfway

the conversion, the temporary file is deleted and the original file stays

intact. When the conversion is successful, the original file is replaced

with the temporary file. You may have write permission on the original file,

but no permission to put the same user and/or group ownership properties on

the temporary file as the original file has. This means you are not able to

preserve the user and/or group ownership of the original file. In this case

you can use option \f(CW\*(C`\-\-allow\-chown\*(C'\fR to continue with the conversion:

.Sp

.Vb 1

\&    dos2unix \-\-allow\-chown foo.txt

.Ve

.Sp

Another option is to use new file mode:

.Sp

.Vb 1

\&    dos2unix \-n foo.txt foo.txt

.Ve

.Sp

The advantage of the \f(CW\*(C`\-\-allow\-chown\*(C'\fR option is that you can use wildcards,

and the ownership properties will be preserved when possible.

.IP "\fB\-q, \-\-quiet\fR" 4

.IX Item "-q, --quiet"

Режим без виведення повідомлень. Програма не виводитиме жодних попереджень

або повідомлень про помилки. Повернутим значенням завжди буде нуль, якщо

вказано правильні параметри командного рядка.

.IP "\fB\-r, \-\-remove\-bom\fR" 4

.IX Item "-r, --remove-bom"

Вилучити позначку порядку байтів (\s-1BOM\s0). Не записувати \s-1BOM\s0 до файла

результатів. Це типова поведінка під час перетворення файлів з форматом

розриву рядків Unix. Див. також параметр \f(CW\*(C`\-b\*(C'\fR.

.IP "\fB\-s, \-\-safe\fR" 4

.IX Item "-s, --safe"

Пропускати двійкові файли (типово).

.Sp

Пропускання бінарних файлів реалізовано для того, щоб уникнути випадкових

помилок. Майте на увазі, що визначення бінарних файлів не є 100%

точним. Програма просто шукає у файлах бінарні символи, які типово не

трапляються у текстових файлах. Може так статися, що у бінарному файлі

містяться лише звичайні текстові символи. Такий бінарний файл буде помилково

сприйнято програмою як текстовий.

.IP "\fB\-u, \-\-keep\-utf16\fR" 4

.IX Item "-u, --keep-utf16"

Зберегти початкове кодування \s-1UTF\-16.\s0 Файл результатів буде записано у тому

самому кодуванні \s-1UTF\-16,\s0 із прямим або зворотним порядком байтів, що і

початковий файл. Таким чином можна запобігти перетворенню даних у кодування

\&\s-1UTF\-8.\s0 До файла буде записано відповідну позначку порядку байтів

\&\s-1UTF\-16.\s0 Вимкнути цей параметр можна за допомогою параметра \f(CW\*(C`\-ascii\*(C'\fR.

.IP "\fB\-ul, \-\-assume\-utf16le\fR" 4

.IX Item "-ul, --assume-utf16le"

Припускати, що кодуванням вхідних файлів є \s-1UTF\-16LE.\s0

.Sp

Якщо у початковому файлі є позначка порядку байтів (\s-1BOM\s0), її буде

використано у файлі\-результаті, незалежно від використання цього параметра.

.Sp

Якщо вами було зроблено помилкове припущення щодо формату файла (файл

вхідних даних насправді не є файлом у форматі \s-1UTF\-16LE\s0), і дані вдасться

успішно перетворити, ви отримаєте файл у кодуванні \s-1UTF\-8\s0 з помилковим

вмістом. Скасувати таке помилкове перетворення можна за допомогою зворотного

перетворення \fIiconv\fR\|(1) з даних у форматі \s-1UTF\-8\s0 на дані у форматі

\&\s-1UTF\-16LE.\s0 Таким чином ви повернетеся до початкового кодування даних у файлі.

.Sp

Припущення щодо форматування \s-1UTF\-16LE\s0 працює як визначення \fIрежиму

перетворення\fR. Перемиканням на типовий режим \fIascii\fR можна вимкнути

припущення щодо форматування \s-1UTF\-16LE.\s0

.IP "\fB\-ub, \-\-assume\-utf16be\fR" 4

.IX Item "-ub, --assume-utf16be"

Припускати, що вхідним форматом є \s-1UTF\-16BE.\s0

.Sp

Цей параметр працює у спосіб, тотожний до параметра \f(CW\*(C`\-ul\*(C'\fR.

.IP "\fB\-v, \-\-verbose\fR" 4

.IX Item "-v, --verbose"

Виводити докладні повідомлення. Буде показано додаткові дані щодо позначок

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

.IP "\fB\-F, \-\-follow\-symlink\fR" 4

.IX Item "-F, --follow-symlink"

Переходити за символічними посиланням і перетворювати файли, на які вони

вказують.

.IP "\fB\-R, \-\-replace\-symlink\fR" 4

.IX Item "-R, --replace-symlink"

Замінити символічні посилання перетвореними файлами (початкові файли, на які

вони вказують, змінено не буде).

.IP "\fB\-S, \-\-skip\-symlink\fR" 4

.IX Item "-S, --skip-symlink"

Не змінювати символічні посилання та файли, на які вони посилаються

(типово).

.IP "\fB\-V, \-\-version\fR" 4

.IX Item "-V, --version"

Вивести дані щодо версії і завершити роботу.

.SH "РЕЖИМ MAC"

.IX Header "РЕЖИМ MAC"

У звичайному режимі розриви рядків \s-1DOS\s0 перетворюються на розриви рядків

Unix, і навпаки. Розриви рядків Mac перетворенню не підлягають.

.PP

У режимі Mac розриви рядків Mac перетворюються на розриви рядків Unix, і

навпаки. Розриви рядків \s-1DOS\s0 перетворенню не підлягають.

.PP

Щоб запустити програму у режимі перетворення Mac, скористайтеся параметром

командного рядка \f(CW\*(C`\-c mac\*(C'\fR або програмами \f(CW\*(C`mac2unix\*(C'\fR та \f(CW\*(C`unix2mac\*(C'\fR.

.SH "РЕЖИМИ ПЕРЕТВОРЕННЯ"

.IX Header "РЕЖИМИ ПЕРЕТВОРЕННЯ"

.IP "\fBascii\fR" 4

.IX Item "ascii"

У режимі \f(CW\*(C`ascii\*(C'\fR виконуватиметься лише перетворення символів розриву

рядків. Цей режим є типовим режимом перетворення.

.Sp

Хоча цей режим і називається режимом \s-1ASCII \s0(стандарту 7\-бітового кодування),

насправді кодування символів у ньому є 8\-бітовим. Завжди користуйтеся цим

режимом для перетворення файлів у кодуванні \s-1UTF\-8 \s0(Unicode).

.IP "\fB7bit\fR" 4

.IX Item "7bit"

У цьому режимі усі 8\-бітові символи, які не є частиною \s-1ASCII, \s0(з номерами

від 128 до 255) буде перетворено на відповідні 7\-бітові символи.

.IP "\fBiso\fR" 4

.IX Item "iso"

Перетворення символів буде виконано з кодування (кодової сторінки) \s-1DOS\s0 до

кодування \s-1ISO\-8859\-1 \s0(Latin\-1) у Unix. Символи \s-1DOS,\s0 які не мають

еквівалентів у \s-1ISO\-8859\-1\s0 і перетворення яких неможливе, буде перетворено на

символ крапки. Те саме стосується символів \s-1ISO\-8859\-1,\s0 які не мають

еквівалентів у \s-1DOS.\s0

.Sp

Якщо буде використано лише параметр \f(CW\*(C`\-iso\*(C'\fR, програма dos2unix спробує

визначити активне кодування. Якщо це виявиться неможливим, dos2unix

використає типове кодування \s-1CP437,\s0 яке здебільшого використовується у

США. Щоб примусово визначити кодування, скористайтеся параметром \f(CW\*(C`\-437\*(C'\fR

(США), \f(CW\*(C`\-850\*(C'\fR (західноєвропейські мови), \f(CW\*(C`\-860\*(C'\fR (португальська), \f(CW\*(C`\-863\*(C'\fR

(канадська французька) або \f(CW\*(C`\-865\*(C'\fR (скандинавські мови). Використати

кодування Windows \s-1CP1252 \s0(західноєвропейські мови) можна за допомогою

параметра \f(CW\*(C`\-1252\*(C'\fR. Для інших кодувань використовуйте поєднання dos2unix з

\&\fIiconv\fR\|(1). Програма iconv здатна виконувати перетворення даних у доволі

широкому спектрі кодувань символів.

.Sp

Ніколи не користуйтеся перетворенням \s-1ISO\s0 для текстових файлів у форматі

Unicode. Використання подібного перетворення призведе до ушкодження вмісту

файлів у кодуванні \s-1UTF\-8.\s0

.Sp

Декілька прикладів:

.Sp

Перетворити дані у типовому кодуванні \s-1DOS\s0 на дані у кодуванні Latin\-1 Unix:

.Sp

.Vb 1

\&    dos2unix \-iso \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні \s-1DOS CP850\s0 на дані у кодуванні Latin\-1 Unix:

.Sp

.Vb 1

\&    dos2unix \-850 \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні \s-1CP1252\s0 Windows на дані у кодуванні Latin\-1

Unix:

.Sp

.Vb 1

\&    dos2unix \-1252 \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні \s-1CP252\s0 Windows на дані у кодуванні \s-1UTF\-8\s0 Unix

(Unicode):

.Sp

.Vb 1

\&    iconv \-f CP1252 \-t UTF\-8 in.txt | dos2unix > out.txt

.Ve

.Sp

Перетворити дані у кодуванні Latin\-1 Unix на дані у типовому кодуванні \s-1DOS:\s0

.Sp

.Vb 1

\&    unix2dos \-iso \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні Latin\-1 Unix на дані у кодуванні \s-1DOS CP850:\s0

.Sp

.Vb 1

\&    unix2dos \-850 \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні Latin\-1 Unix на дані у кодуванні Windows

\&\s-1CP1252:\s0

.Sp

.Vb 1

\&    unix2dos \-1252 \-n in.txt out.txt

.Ve

.Sp

Перетворити дані у кодуванні \s-1UTF\-8\s0 Unix (Unicode) на дані у кодуванні

Windows \s-1CP1252:\s0

.Sp

.Vb 1

\&    unix2dos < in.txt | iconv \-f UTF\-8 \-t CP1252 > out.txt

.Ve

.Sp

Див. також <http://czyborra.com/charsets/codepages.html> та

<http://czyborra.com/charsets/iso8859.html>.

.SH "UNICODE"

.IX Header "UNICODE"

.SS "Кодування"

.IX Subsection "Кодування"

Існує декілька різних кодувань Unicode. У Unix та Linux у файлах Unicode

здебільшого використовується кодування \s-1UTF\-8.\s0 У Windows для текстових файлів

Unicode може бути використано кодування \s-1UTF\-8, UTF\-16\s0 або \s-1UTF\-16\s0 зі

зворотним порядком байтів. Втім, здебільшого, використовується формат

\&\s-1UTF\-16.\s0

.SS "Перетворення"

.IX Subsection "Перетворення"

У текстових файлах Unicode, як і у звичайних текстових файлах, може бути

використано розриви рядків \s-1DOS,\s0 Unix або Mac.

.PP

Усі версії dos2unix та unix2dos здатні виконувати перетворення у кодуванні

\&\s-1UTF\-8,\s0 оскільки \s-1UTF\-8\s0 було розроблено так, що зворотну сумісність з \s-1ASCII\s0

збережено.

.PP

Програми dos2unix та unix2dos, зібрані з підтримкою Unicode \s-1UTF\-16,\s0 можуть

читати текстові файли у кодуванні \s-1UTF\-16\s0 з прямим та зворотним порядком

байтів. Щоб дізнатися про те, чи було dos2unix зібрано з підтримкою \s-1UTF\-16,\s0

віддайте команду \f(CW\*(C`dos2unix \-V\*(C'\fR.

.PP

У Unix/Linux файли у кодуванні \s-1UTF\-16\s0 перетворюються на файли у кодуванні

локалі. Для визначення поточного кодування символів локалі скористайтеся

командою \fIlocale\fR\|(1). Якщо перетворення виявиться неможливим, програма

повідомить про помилку перетворення і пропустить відповідний файл.

.PP

У Windows файли \s-1UTF\-16\s0 типово буде перетворено на файли \s-1UTF\-8.\s0 Обидва типи

систем, Windows та Unix/Linux, мають непогані можливості з підтримки файлів

у форматуванні \s-1UTF\-8.\s0

.PP

Кодування \s-1UTF\-16\s0 та \s-1UTF\-8\s0 є повністю сумісними. Під час перетворення не буде

втрачено жодної інформації. Якщо під час перетворення даних у кодуванні

\&\s-1UTF\-16\s0 на дані у кодуванні \s-1UTF\-8\s0 трапиться помилка, наприклад, якщо у

вхідному файлі \s-1UTF\-16\s0 міститиметься якась помилка, файл буде пропущено.

.PP

Якщо використано параметр \f(CW\*(C`\-u\*(C'\fR, файл результатів буде записано у тому

самому кодуванні \s-1UTF\-16,\s0 що і початковий файл. Використання параметра Option

\&\f(CW\*(C`\-u\*(C'\fR запобігає перетворенню даних у кодування \s-1UTF\-8.\s0

.PP

У dos2unix та unix2dos не передбачено параметра для перетворення даних у

кодуванні \s-1UTF\-8\s0 на дані у кодуванні \s-1UTF\-16.\s0

.PP

Режим перетворення \s-1ISO\s0 та 7\-бітовий режим не працюють для файлів \s-1UTF\-16.\s0

.SS "Позначка порядку байтів"

.IX Subsection "Позначка порядку байтів"

У Windows до текстових файлів у кодуванні Unicode типово дописується

позначка порядку байтів (\s-1BOM\s0), оскільки багато програм Windows (зокрема

Notepad) додають таку позначку автоматично. Див. також

<http://en.wikipedia.org/wiki/Byte_order_mark>.

.PP

У Unix файли у кодуванні Unicode типово не містять позначки порядку

байтів. Вважається, що кодуванням текстових файлів є те кодування, яке

визначається поточною локаллю.

.PP

Програма dos2unix може визначити, чи є кодуванням файла \s-1UTF\-16,\s0 лише якщо у

файлі міститься позначка порядку байтів. Якщо у файлі, де використано

кодування \s-1UTF\-16,\s0 немає такої позначки, dos2unix вважатиме такий файл

двійковим (бінарним).

.PP

Для перетворення файлів \s-1UTF\-16\s0 без позначки порядку байтів скористайтеся

параметром \f(CW\*(C`\-ul\*(C'\fR або \f(CW\*(C`\-ub\*(C'\fR.

.PP

Типово dos2unix не записує до файлів результатів перетворення позначки

порядку байтів (\s-1BOM\s0). Якщо використано параметр \f(CW\*(C`\-b\*(C'\fR, dos2unix запише до

файла результатів \s-1BOM,\s0 якщо \s-1BOM\s0 була у файлі початкових даних.

.PP

Типово unix2dos записує позначку порядку байтів (\s-1BOM\s0) до файла результатів,

якщо \s-1BOM\s0 є у початковому файлі. Скористайтеся параметром \f(CW\*(C`\-r\*(C'\fR, щоб вилучити

\&\s-1BOM.\s0

.PP

Dos2unix та unix2dos завжди записують до файла результатів позначку порядку

байтів (\s-1BOM\s0), якщо використано параметр \f(CW\*(C`\-m\*(C'\fR.

.SS "Назви файлів у Unicode у Windows"

.IX Subsection "Назви файлів у Unicode у Windows"

У dos2unix передбачено підтримку читання і запису назв файлів Unicode у

командному рядку Windows. Це означає, що dos2unix може відкривати файли, у

назвах яких є символи, які не є частиною типової системної кодової сторінки

\&\s-1ANSI.\s0 Щоб визначити, чи зібрано dos2unix для Windows з підтримкою назв

файлів у кодуванні Unicode, скористайтеся командою \f(CW\*(C`dos2unix \-V\*(C'\fR.

.PP

Із показом назв файлів у кодуванні Unicode у консолі Windows пов’язано

декілька проблем. Див. параметр \f(CW\*(C`\-D\*(C'\fR, \f(CW\*(C`\-\-display\-enc\*(C'\fR. Назви файлів може

бути некоректно показано у консолі, але запис цих назв відбуватиметься

належним чином.

.SS "Приклади для Unicode"

.IX Subsection "Приклади для Unicode"

Перетворити дані з Windows \s-1UTF\-16 \s0(з позначкою порядку байтів (\s-1BOM\s0)) у

формат Unix \s-1UTF\-8:\s0

.PP

.Vb 1

\&    dos2unix \-n in.txt out.txt

.Ve

.PP

Перетворити дані у форматі Windows \s-1UTF\-16LE \s0(без \s-1BOM\s0) на дані у форматі

\&\s-1UTF\-8\s0 Unix:

.PP

.Vb 1

\&    dos2unix \-ul \-n in.txt out.txt

.Ve

.PP

Перетворити дані у кодуванні \s-1UTF\-8\s0 Unix на дані у кодуванні Windows \s-1UTF\-8\s0

без \s-1BOM:\s0

.PP

.Vb 1

\&    unix2dos \-m \-n in.txt out.txt

.Ve

.PP

Перетворити дані у кодуванні \s-1UTF\-8\s0 Unix на дані у кодуванні Windows \s-1UTF\-16:\s0

.PP

.Vb 1

\&    unix2dos < in.txt | iconv \-f UTF\-8 \-t UTF\-16 > out.txt

.Ve

.SH "GB18030"

.IX Header "GB18030"

\&\s-1GB18030\s0 є китайським урядовим стандартом. Підтримка обов’язкової підмножини

стандарту \s-1GB18030\s0 є неодмінною вимогою до будь\-яких програмних продуктів,

які продаються у Китаї. Див. також <http://en.wikipedia.org/wiki/GB_18030>.

.PP

Кодування \s-1GB18030\s0 є повністю сумісним із Unicode. Його можна розглядати як

формат перетворення unicode. Подібно до \s-1UTF\-8, GB18030\s0 є сумісним із

\&\s-1ASCII. GB18030\s0 також є сумісним із кодовою сторінкою Windows 936, яку ще

називають \s-1GBK.\s0

.PP

У Unix/Linux файли \s-1UTF\-16\s0 буде перетворено до кодування \s-1GB18030,\s0 якщо

кодуванням локалі є \s-1GB18030.\s0 Зауважте, що це спрацює, лише якщо підтримку

локалі передбачено у системі. Щоб отримати список підтримуваних локалей,

скористайтеся командою \f(CW\*(C`locale \-a\*(C'\fR.

.PP

У Windows для перетворення файлів \s-1UTF\-16\s0 на файли \s-1GB18030\s0 слід вказати

параметр \f(CW\*(C`\-gb\*(C'\fR.

.PP

У файлах у кодуванні \s-1GB18030\s0 може міститися позначка порядку байтів, так

само, як у файлах у кодуванні Unicode.

.SH "ПРИКЛАДИ"

.IX Header "ПРИКЛАДИ"

Прочитати вхідні дані зі стандартного джерела (stdin) і записати результат

до стандартного виведення (stdout):

.PP

.Vb 2

\&    dos2unix < a.txt

\&    cat a.txt | dos2unix

.Ve

.PP

Перетворити дані у a.txt і замістити цей файл. Перетворити дані у b.txt і

замістити цей файл:

.PP

.Vb 2

\&    dos2unix a.txt b.txt

\&    dos2unix \-o a.txt b.txt

.Ve

.PP

Перетворити дані у a.txt і замістити файл у режимі перетворення ascii:

.PP

.Vb 1

\&    dos2unix a.txt

.Ve

.PP

Перетворити дані у a.txt і замістити файл у режимі перетворення

ascii. Перетворити дані у b.txt і замістити цей файл у режимі 7\-бітового

перетворення:

.PP

.Vb 3

\&    dos2unix a.txt \-c 7bit b.txt

\&    dos2unix \-c ascii a.txt \-c 7bit b.txt

\&    dos2unix \-ascii a.txt \-7 b.txt

.Ve

.PP

Перетворити файл a.txt з формату Mac на формат Unix:

.PP

.Vb 2

\&    dos2unix \-c mac a.txt

\&    mac2unix a.txt

.Ve

.PP

Перетворити файл a.txt з формату Unix на формат Mac:

.PP

.Vb 2

\&    unix2dos \-c mac a.txt

\&    unix2mac a.txt

.Ve

.PP

Перетворити дані у a.txt, замістити цей файл і зберегти часову позначку

початкового файла:

.PP

.Vb 2

\&    dos2unix \-k a.txt

\&    dos2unix \-k \-o a.txt

.Ve

.PP

Перетворити дані у файлі a.txt і записати результати до файла e.txt:

.PP

.Vb 1

\&    dos2unix \-n a.txt e.txt

.Ve

.PP

Перетворити дані у файлі a.txt і записати результати до файла

e.txt. Скопіювати часову позначку файла a.txt для файла e.txt:

.PP

.Vb 1

\&    dos2unix \-k \-n a.txt e.txt

.Ve

.PP

Перетворити дані у a.txt і замістити цей файл. Перетворити дані у b.txt і

записати результат до e.txt:

.PP

.Vb 2

\&    dos2unix a.txt \-n b.txt e.txt

\&    dos2unix \-o a.txt \-n b.txt e.txt

.Ve

.PP

Перетворити дані у c.txt і записати результати до e.txt. Перетворити дані у

a.txt і замістити ними цей файл. Перетворити дані у b.txt і замістити ними

цей файл. Перетворити дані у d.txt і записати результати до f.txt:

.PP

.Vb 1

\&    dos2unix \-n c.txt e.txt \-o a.txt b.txt \-n d.txt f.txt

.Ve

.SH "РЕКУРСИВНЕ ПЕРЕТВОРЕННЯ"

.IX Header "РЕКУРСИВНЕ ПЕРЕТВОРЕННЯ"

У оболонці \s-1UNIX\s0 можна скористатися командами \fIfind\fR\|(1) і \fIxargs\fR\|(1) для запуску

dos2unix рекурсивно для усіх текстових файлів у ієрархії

каталогів. Наприклад, щоб виконати перетворення усіх файлів .txt у структурі

підкаталогів поточного каталогу, віддайте таку команду:

.PP

.Vb 1

\&    find . \-name \*(Aq*.txt\*(Aq \-print0 |xargs \-0 dos2unix

.Ve

.PP

Параметр \fIfind\fR\|(1) \f(CW\*(C`\-print0\*(C'\fR і відповідний параметр \fIxargs\fR\|(1) \f(CW\*(C`\-0\*(C'\fR потрібні,

якщо у назва файлів є пробіли або лапки. Інакше, ці параметри можна

пропустити. Іншим варіантом дій є використання \fIfind\fR\|(1) з параметром

\&\f(CW\*(C`\-exec\*(C'\fR:

.PP