man/man1/dos2unix.htm

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>dos2unix 7.2 - DOS/MAC to UNIX and vice versa text file format converter</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:root@localhost" />
   8 </head>
   9
  10 <body style="background-color: white">
  11
  12
  13
  14 <ul id="index">
  15   <li><a href="#NAME">NAME</a></li>
  16   <li><a href="#SYNOPSIS">SYNOPSIS</a></li>
  17   <li><a href="#DESCRIPTION">DESCRIPTION</a></li>
  18   <li><a href="#OPTIONS">OPTIONS</a></li>
  19   <li><a href="#MAC-MODE">MAC MODE</a></li>
  20   <li><a href="#CONVERSION-MODES">CONVERSION MODES</a></li>
  21   <li><a href="#UNICODE">UNICODE</a>
  22     <ul>
  23       <li><a href="#Encodings">Encodings</a></li>
  24       <li><a href="#Conversion">Conversion</a></li>
  25       <li><a href="#Byte-Order-Mark">Byte Order Mark</a></li>
  26       <li><a href="#Unicode-examples">Unicode examples</a></li>
  27     </ul>
  28   </li>
  29   <li><a href="#GB18030">GB18030</a></li>
  30   <li><a href="#EXAMPLES">EXAMPLES</a></li>
  31   <li><a href="#RECURSIVE-CONVERSION">RECURSIVE CONVERSION</a></li>
  32   <li><a href="#LOCALIZATION">LOCALIZATION</a></li>
  33   <li><a href="#RETURN-VALUE">RETURN VALUE</a></li>
  34   <li><a href="#STANDARDS">STANDARDS</a></li>
  35   <li><a href="#AUTHORS">AUTHORS</a></li>
  36   <li><a href="#SEE-ALSO">SEE ALSO</a></li>
  37 </ul>
  38
  39 <h1 id="NAME">NAME</h1>
  40
  41 <p>dos2unix - DOS/Mac to Unix and vice versa text file format converter</p>
  42
  43 <h1 id="SYNOPSIS">SYNOPSIS</h1>
  44
  45 <pre><code>    dos2unix [options] [FILE ...] [-n INFILE OUTFILE ...]
  46     unix2dos [options] [FILE ...] [-n INFILE OUTFILE ...]</code></pre>
  47
  48 <h1 id="DESCRIPTION">DESCRIPTION</h1>
  49
  50 <p>The Dos2unix package includes utilities <code>dos2unix</code> and <code>unix2dos</code> to convert plain text files in DOS or Mac format to Unix format and vice versa.</p>
  51
  52 <p>In DOS/Windows text files a line break, also known as newline, is a combination of two characters: a Carriage Return (CR) followed by a Line Feed (LF). In Unix text files a line break is a single character: the Line Feed (LF). In Mac text files, prior to Mac OS X, a line break was single Carriage Return (CR) character. Nowadays Mac OS uses Unix style (LF) line breaks.</p>
  53
  54 <p>Besides line breaks Dos2unix can also convert the encoding of files. A few DOS code pages can be converted to Unix Latin-1. And Windows Unicode (UTF-16) files can be converted to Unix Unicode (UTF-8) files.</p>
  55
  56 <p>Binary files are automatically skipped, unless conversion is forced.</p>
  57
  58 <p>Non-regular files, such as directories and FIFOs, are automatically skipped.</p>
  59
  60 <p>Symbolic links and their targets are by default kept untouched. Symbolic links can optionally be replaced, or the output can be written to the symbolic link target. Writing to a symbolic link target is not supported on Windows.</p>
  61
  62 <p>Dos2unix was modelled after dos2unix under SunOS/Solaris. There is one important difference with the original SunOS/Solaris version. This version does by default in-place conversion (old file mode), while the original SunOS/Solaris version only supports paired conversion (new file mode). See also options <code>-o</code> and <code>-n</code>.</p>
  63
  64 <h1 id="OPTIONS">OPTIONS</h1>
  65
  66 <dl>
  67
  68 <dt id="pod"><b>--</b></dt>
  69 <dd>
  70
  71 <p>Treat all following options as file names. Use this option if you want to convert files whose names start with a dash. For instance to convert a file named &quot;-foo&quot;, you can use this command:</p>
  72
  73 <pre><code>    dos2unix -- -foo</code></pre>
  74
  75 <p>Or in new file mode:</p>
  76
  77 <pre><code>    dos2unix -n -- -foo out.txt</code></pre>
  78
  79 </dd>
  80 <dt id="ascii"><b>-ascii</b></dt>
  81 <dd>
  82
  83 <p>Convert only line breaks. This is the default conversion mode.</p>
  84
  85 </dd>
  86 <dt id="iso"><b>-iso</b></dt>
  87 <dd>
  88
  89 <p>Conversion between DOS and ISO-8859-1 character set. See also section CONVERSION MODES.</p>
  90
  91 </dd>
  92 <dt id="pod-1252"><b>-1252</b></dt>
  93 <dd>
  94
  95 <p>Use Windows code page 1252 (Western European).</p>
  96
  97 </dd>
  98 <dt id="pod-437"><b>-437</b></dt>
  99 <dd>
 100
 101 <p>Use DOS code page 437 (US). This is the default code page used for ISO conversion.</p>
 102
 103 </dd>
 104 <dt id="pod-850"><b>-850</b></dt>
 105 <dd>
 106
 107 <p>Use DOS code page 850 (Western European).</p>
 108
 109 </dd>
 110 <dt id="pod-860"><b>-860</b></dt>
 111 <dd>
 112
 113 <p>Use DOS code page 860 (Portuguese).</p>
 114
 115 </dd>
 116 <dt id="pod-863"><b>-863</b></dt>
 117 <dd>
 118
 119 <p>Use DOS code page 863 (French Canadian).</p>
 120
 121 </dd>
 122 <dt id="pod-865"><b>-865</b></dt>
 123 <dd>
 124
 125 <p>Use DOS code page 865 (Nordic).</p>
 126
 127 </dd>
 128 <dt id="pod-7"><b>-7</b></dt>
 129 <dd>
 130
 131 <p>Convert 8 bit characters to 7 bit space.</p>
 132
 133 </dd>
 134 <dt id="b---keep-bom"><b>-b, --keep-bom</b></dt>
 135 <dd>
 136
 137 <p>Keep Byte Order Mark (BOM). When the input file has a BOM, write a BOM in the output file. This is the default behavior when converting to DOS line breaks. See also option <code>-r</code>.</p>
 138
 139 </dd>
 140 <dt id="c---convmode-CONVMODE"><b>-c, --convmode CONVMODE</b></dt>
 141 <dd>
 142
 143 <p>Set conversion mode. Where CONVMODE is one of: <i>ascii</i>, <i>7bit</i>, <i>iso</i>, <i>mac</i> with ascii being the default.</p>
 144
 145 </dd>
 146 <dt id="f---force"><b>-f, --force</b></dt>
 147 <dd>
 148
 149 <p>Force conversion of binary files.</p>
 150
 151 </dd>
 152 <dt id="gb---gb18030"><b>-gb, --gb18030</b></dt>
 153 <dd>
 154
 155 <p>On Windows UTF-16 files are by default converted to UTF-8, regardless of the locale setting. Use this option to convert UTF-16 files to GB18030. This option is only available on Windows. See also section GB18030.</p>
 156
 157 </dd>
 158 <dt id="h---help"><b>-h, --help</b></dt>
 159 <dd>
 160
 161 <p>Display help and exit.</p>
 162
 163 </dd>
 164 <dt id="i-FLAGS---info-FLAGS-FILE"><b>-i[FLAGS], --info[=FLAGS] FILE ...</b></dt>
 165 <dd>
 166
 167 <p>Display file information. No conversion is done.</p>
 168
 169 <p>The following information is printed, in this order: number of DOS line breaks, number of Unix line breaks, number of Mac line breaks, byte order mark, text or binary, file name.</p>
 170
 171 <p>Example output:</p>
 172
 173 <pre><code>     6       0       0  no_bom    text    dos.txt
 174      0       6       0  no_bom    text    unix.txt
 175      0       0       6  no_bom    text    mac.txt
 176      6       6       6  no_bom    text    mixed.txt
 177     50       0       0  UTF-16LE  text    utf16le.txt
 178      0      50       0  no_bom    text    utf8unix.txt
 179     50       0       0  UTF-8     text    utf8dos.txt
 180      2     418     219  no_bom    binary  dos2unix.exe</code></pre>
 181
 182 <p>Optionally extra flags can be set to change the output. One or more flags can be added.</p>
 183
 184 <dl>
 185
 186 <dt id="d"><b>d</b></dt>
 187 <dd>
 188
 189 <p>Print number of DOS line breaks.</p>
 190
 191 </dd>
 192 <dt id="u"><b>u</b></dt>
 193 <dd>
 194
 195 <p>Print number of Unix line breaks.</p>
 196
 197 </dd>
 198 <dt id="m"><b>m</b></dt>
 199 <dd>
 200
 201 <p>Print number of Mac line breaks.</p>
 202
 203 </dd>
 204 <dt id="b"><b>b</b></dt>
 205 <dd>
 206
 207 <p>Print the byte order mark.</p>
 208
 209 </dd>
 210 <dt id="t"><b>t</b></dt>
 211 <dd>
 212
 213 <p>Print if file is text or binary.</p>
 214
 215 </dd>
 216 <dt id="c"><b>c</b></dt>
 217 <dd>
 218
 219 <p>Print only the files that would be converted.</p>
 220
 221 <p>With the <code>c</code> flag dos2unix will print only the files that contain DOS line breaks, unix2dos will print only file names that have Unix line breaks.</p>
 222
 223 </dd>
 224 </dl>
 225
 226 <p>Examples:</p>
 227
 228 <p>Show information for all *.txt files:</p>
 229
 230 <pre><code>    dos2unix -i *.txt</code></pre>
 231
 232 <p>Show only the number of DOS line breaks and Unix line breaks:</p>
 233
 234 <pre><code>    dos2unix -idu *.txt</code></pre>
 235
 236 <p>Show only the byte order mark:</p>
 237
 238 <pre><code>    dos2unix --info=b *.txt</code></pre>
 239
 240 <p>List the files that have DOS line breaks:</p>
 241
 242 <pre><code>    dos2unix -ic *.txt</code></pre>
 243
 244 <p>List the files that have Unix line breaks:</p>
 245
 246 <pre><code>    unix2dos -ic *.txt</code></pre>
 247
 248 </dd>
 249 <dt id="k---keepdate"><b>-k, --keepdate</b></dt>
 250 <dd>
 251
 252 <p>Keep the date stamp of output file same as input file.</p>
 253
 254 </dd>
 255 <dt id="L---license"><b>-L, --license</b></dt>
 256 <dd>
 257
 258 <p>Display program&#39;s license.</p>
 259
 260 </dd>
 261 <dt id="l---newline"><b>-l, --newline</b></dt>
 262 <dd>
 263
 264 <p>Add additional newline.</p>
 265
 266 <p><b>dos2unix</b>: Only DOS line breaks are changed to two Unix line breaks. In Mac mode only Mac line breaks are changed to two Unix line breaks.</p>
 267
 268 <p><b>unix2dos</b>: Only Unix line breaks are changed to two DOS line breaks. In Mac mode Unix line breaks are changed to two Mac line breaks.</p>
 269
 270 </dd>
 271 <dt id="m---add-bom"><b>-m, --add-bom</b></dt>
 272 <dd>
 273
 274 <p>Write a Byte Order Mark (BOM) in the output file. By default an UTF-8 BOM is written.</p>
 275
 276 <p>When the input file is UTF-16, and the option <code>-u</code> is used, an UTF-16 BOM will be written.</p>
 277
 278 <p>Never use this option when the output encoding is other than UTF-8 or UTF-16. See also section UNICODE.</p>
 279
 280 </dd>
 281 <dt id="n---newfile-INFILE-OUTFILE"><b>-n, --newfile INFILE OUTFILE ...</b></dt>
 282 <dd>
 283
 284 <p>New file mode. Convert file INFILE and write output to file OUTFILE. File names must be given in pairs and wildcard names should <i>not</i> be used or you <i>will</i> lose your files.</p>
 285
 286 <p>The person who starts the conversion in new file (paired) mode will be the owner of the converted file. The read/write permissions of the new file will be the permissions of the original file minus the umask(1) of the person who runs the conversion.</p>
 287
 288 </dd>
 289 <dt id="o---oldfile-FILE"><b>-o, --oldfile FILE ...</b></dt>
 290 <dd>
 291
 292 <p>Old file mode. Convert file FILE and overwrite output to it. The program defaults to run in this mode. Wildcard names may be used.</p>
 293
 294 <p>In old file (in-place) mode the converted file gets the same owner, group, and read/write permissions as the original file. Also when the file is converted by another user who has write permissions on the file (e.g. user root). The conversion will be aborted when it is not possible to preserve the original values. Change of owner could mean that the original owner is not able to read the file any more. Change of group could be a security risk, the file could be made readable for persons for whom it is not intended. Preservation of owner, group, and read/write permissions is only supported on Unix.</p>
 295
 296 </dd>
 297 <dt id="q---quiet"><b>-q, --quiet</b></dt>
 298 <dd>
 299
 300 <p>Quiet mode. Suppress all warnings and messages. The return value is zero. Except when wrong command-line options are used.</p>
 301
 302 </dd>
 303 <dt id="r---remove-bom"><b>-r, --remove-bom</b></dt>
 304 <dd>
 305
 306 <p>Remove Byte Order Mark (BOM). Do not write a BOM in the output file. This is the default behavior when converting to Unix line breaks. See also option <code>-b</code>.</p>
 307
 308 </dd>
 309 <dt id="s---safe"><b>-s, --safe</b></dt>
 310 <dd>
 311
 312 <p>Skip binary files (default).</p>
 313
 314 </dd>
 315 <dt id="u---keep-utf16"><b>-u, --keep-utf16</b></dt>
 316 <dd>
 317
 318 <p>Keep the original UTF-16 encoding of the input file. The output file will be written in the same UTF-16 encoding, little or big endian, as the input file. This prevents transformation to UTF-8. An UTF-16 BOM will be written accordingly. This option can be disabled with the <code>-ascii</code> option.</p>
 319
 320 </dd>
 321 <dt id="ul---assume-utf16le"><b>-ul, --assume-utf16le</b></dt>
 322 <dd>
 323
 324 <p>Assume that the input file format is UTF-16LE.</p>
 325
 326 <p>When there is a Byte Order Mark in the input file the BOM has priority over this option.</p>
 327
 328 <p>When you made a wrong assumption (the input file was not in UTF-16LE format) and the conversion succeeded, you will get an UTF-8 output file with wrong text. You can undo the wrong conversion with iconv(1) by converting the UTF-8 output file back to UTF-16LE. This will bring back the original file.</p>
 329
 330 <p>The assumption of UTF-16LE works as a <i>conversion mode</i>. By switching to the default <i>ascii</i> mode the UTF-16LE assumption is turned off.</p>
 331
 332 </dd>
 333 <dt id="ub---assume-utf16be"><b>-ub, --assume-utf16be</b></dt>
 334 <dd>
 335
 336 <p>Assume that the input file format is UTF-16BE.</p>
 337
 338 <p>This option works the same as option <code>-ul</code>.</p>
 339
 340 </dd>
 341 <dt id="v---verbose"><b>-v, --verbose</b></dt>
 342 <dd>
 343
 344 <p>Display verbose messages. Extra information is displayed about Byte Order Marks and the amount of converted line breaks.</p>
 345
 346 </dd>
 347 <dt id="F---follow-symlink"><b>-F, --follow-symlink</b></dt>
 348 <dd>
 349
 350 <p>Follow symbolic links and convert the targets.</p>
 351
 352 </dd>
 353 <dt id="R---replace-symlink"><b>-R, --replace-symlink</b></dt>
 354 <dd>
 355
 356 <p>Replace symbolic links with converted files (original target files remain unchanged).</p>
 357
 358 </dd>
 359 <dt id="S---skip-symlink"><b>-S, --skip-symlink</b></dt>
 360 <dd>
 361
 362 <p>Keep symbolic links and targets unchanged (default).</p>
 363
 364 </dd>
 365 <dt id="V---version"><b>-V, --version</b></dt>
 366 <dd>
 367
 368 <p>Display version information and exit.</p>
 369
 370 </dd>
 371 </dl>
 372
 373 <h1 id="MAC-MODE">MAC MODE</h1>
 374
 375 <p>In normal mode line breaks are converted from DOS to Unix and vice versa. Mac line breaks are not converted.</p>
 376
 377 <p>In Mac mode line breaks are converted from Mac to Unix and vice versa. DOS line breaks are not changed.</p>
 378
 379 <p>To run in Mac mode use the command-line option <code>-c mac</code> or use the commands <code>mac2unix</code> or <code>unix2mac</code>.</p>
 380
 381 <h1 id="CONVERSION-MODES">CONVERSION MODES</h1>
 382
 383 <dl>
 384
 385 <dt id="ascii1"><b>ascii</b></dt>
 386 <dd>
 387
 388 <p>In mode <code>ascii</code> only line breaks are converted. This is the default conversion mode.</p>
 389
 390 <p>Although the name of this mode is ASCII, which is a 7 bit standard, the actual mode is 8 bit. Use always this mode when converting Unicode UTF-8 files.</p>
 391
 392 </dd>
 393 <dt id="bit"><b>7bit</b></dt>
 394 <dd>
 395
 396 <p>In this mode all 8 bit non-ASCII characters (with values from 128 to 255) are converted to a 7 bit space.</p>
 397
 398 </dd>
 399 <dt id="iso1"><b>iso</b></dt>
 400 <dd>
 401
 402 <p>Characters are converted between a DOS character set (code page) and ISO character set ISO-8859-1 (Latin-1) on Unix. DOS characters without ISO-8859-1 equivalent, for which conversion is not possible, are converted to a dot. The same counts for ISO-8859-1 characters without DOS counterpart.</p>
 403
 404 <p>When only option <code>-iso</code> is used dos2unix will try to determine the active code page. When this is not possible dos2unix will use default code page CP437, which is mainly used in the USA. To force a specific code page use options <code>-437</code> (US), <code>-850</code> (Western European), <code>-860</code> (Portuguese), <code>-863</code> (French Canadian), or <code>-865</code> (Nordic). Windows code page CP1252 (Western European) is also supported with option <code>-1252</code>. For other code pages use dos2unix in combination with iconv(1). Iconv can convert between a long list of character encodings.</p>
 405
 406 <p>Never use ISO conversion on Unicode text files. It will corrupt UTF-8 encoded files.</p>
 407
 408 <p>Some examples:</p>
 409
 410 <p>Convert from DOS default code page to Unix Latin-1:</p>
 411
 412 <pre><code>    dos2unix -iso -n in.txt out.txt</code></pre>
 413
 414 <p>Convert from DOS CP850 to Unix Latin-1:</p>
 415
 416 <pre><code>    dos2unix -850 -n in.txt out.txt</code></pre>
 417
 418 <p>Convert from Windows CP1252 to Unix Latin-1:</p>
 419
 420 <pre><code>    dos2unix -1252 -n in.txt out.txt</code></pre>
 421
 422 <p>Convert from Windows CP1252 to Unix UTF-8 (Unicode):</p>
 423
 424 <pre><code>    iconv -f CP1252 -t UTF-8 in.txt | dos2unix &gt; out.txt</code></pre>
 425
 426 <p>Convert from Unix Latin-1 to DOS default code page:</p>
 427
 428 <pre><code>    unix2dos -iso -n in.txt out.txt</code></pre>
 429
 430 <p>Convert from Unix Latin-1 to DOS CP850:</p>
 431
 432 <pre><code>    unix2dos -850 -n in.txt out.txt</code></pre>
 433
 434 <p>Convert from Unix Latin-1 to Windows CP1252:</p>
 435
 436 <pre><code>    unix2dos -1252 -n in.txt out.txt</code></pre>
 437
 438 <p>Convert from Unix UTF-8 (Unicode) to Windows CP1252:</p>
 439
 440 <pre><code>    unix2dos &lt; in.txt | iconv -f UTF-8 -t CP1252 &gt; out.txt</code></pre>
 441
 442 <p>See also <a href="http://czyborra.com/charsets/codepages.html">http://czyborra.com/charsets/codepages.html</a> and <a href="http://czyborra.com/charsets/iso8859.html">http://czyborra.com/charsets/iso8859.html</a>.</p>
 443
 444 </dd>
 445 </dl>
 446
 447 <h1 id="UNICODE">UNICODE</h1>
 448
 449 <h2 id="Encodings">Encodings</h2>
 450
 451 <p>There exist different Unicode encodings. On Unix and Linux Unicode files are typically encoded in UTF-8 encoding. On Windows Unicode text files can be encoded in UTF-8, UTF-16, or UTF-16 big endian, but are mostly encoded in UTF-16 format.</p>
 452
 453 <h2 id="Conversion">Conversion</h2>
 454
 455 <p>Unicode text files can have DOS, Unix or Mac line breaks, like regular text files.</p>
 456
 457 <p>All versions of dos2unix and unix2dos can convert UTF-8 encoded files, because UTF-8 was designed for backward compatibility with ASCII.</p>
 458
 459 <p>Dos2unix and unix2dos with Unicode UTF-16 support, can read little and big endian UTF-16 encoded text files. To see if dos2unix was built with UTF-16 support type <code>dos2unix -V</code>.</p>
 460
 461 <p>On Unix/Linux UTF-16 encoded files are converted to the locale character encoding. Use the locale(1) command to find out what the locale character encoding is. When conversion is not possible a conversion error will occur and the file will be skipped.</p>
 462
 463 <p>On Windows UTF-16 files are by default converted to UTF-8. UTF-8 formatted text files are well supported on both Windows and Unix/Linux.</p>
 464
 465 <p>UTF-16 and UTF-8 encoding are fully compatible, there will no text be lost in the conversion. When an UTF-16 to UTF-8 conversion error occurs, for instance when the UTF-16 input file contains an error, the file will be skipped.</p>
 466
 467 <p>When option <code>-u</code> is used, the output file will be written in the same UTF-16 encoding as the input file. Option <code>-u</code> prevents conversion to UTF-8.</p>
 468
 469 <p>Dos2unix and unix2dos have no option to convert UTF-8 files to UTF-16.</p>
 470
 471 <p>ISO and 7-bit mode conversion do not work on UTF-16 files.</p>
 472
 473 <h2 id="Byte-Order-Mark">Byte Order Mark</h2>
 474
 475 <p>On Windows Unicode text files typically have a Byte Order Mark (BOM), because many Windows programs (including Notepad) add BOMs by default. See also <a href="http://en.wikipedia.org/wiki/Byte_order_mark">http://en.wikipedia.org/wiki/Byte_order_mark</a>.</p>
 476
 477 <p>On Unix Unicode files typically don&#39;t have a BOM. It is assumed that text files are encoded in the locale character encoding.</p>
 478
 479 <p>Dos2unix can only detect if a file is in UTF-16 format if the file has a BOM. When an UTF-16 file doesn&#39;t have a BOM, dos2unix will see the file as a binary file.</p>
 480
 481 <p>Use option <code>-ul</code> or <code>-ub</code> to convert an UTF-16 file without BOM.</p>
 482
 483 <p>Dos2unix writes by default no BOM in the output file. With option <code>-b</code> Dos2unix writes a BOM when the input file has a BOM.</p>
 484
 485 <p>Unix2dos writes by default a BOM in the output file when the input file has a BOM. Use option <code>-r</code> to remove the BOM.</p>
 486
 487 <p>Dos2unix and unix2dos write always a BOM when option <code>-m</code> is used.</p>
 488
 489 <h2 id="Unicode-examples">Unicode examples</h2>
 490
 491 <p>Convert from Windows UTF-16 (with BOM) to Unix UTF-8:</p>
 492
 493 <pre><code>    dos2unix -n in.txt out.txt</code></pre>
 494
 495 <p>Convert from Windows UTF-16LE (without BOM) to Unix UTF-8:</p>
 496
 497 <pre><code>    dos2unix -ul -n in.txt out.txt</code></pre>
 498
 499 <p>Convert from Unix UTF-8 to Windows UTF-8 with BOM:</p>
 500
 501 <pre><code>    unix2dos -m -n in.txt out.txt</code></pre>
 502
 503 <p>Convert from Unix UTF-8 to Windows UTF-16:</p>
 504
 505 <pre><code>    unix2dos &lt; in.txt | iconv -f UTF-8 -t UTF-16 &gt; out.txt</code></pre>
 506
 507 <h1 id="GB18030">GB18030</h1>
 508
 509 <p>GB18030 is a Chinese government standard. A mandatory subset of the GB18030 standard is officially required for all software products sold in China. See also <a href="http://en.wikipedia.org/wiki/GB_18030">http://en.wikipedia.org/wiki/GB_18030</a>.</p>
 510
 511 <p>GB18030 is fully compatible with Unicode, and can be considered an unicode transformation format. Like UTF-8, GB18030 is compatible with ASCII. GB18030 is also compatible with Windows code page 936, also known as GBK.</p>
 512
 513 <p>On Unix/Linux UTF-16 files are converted to GB18030 when the locale encoding is set to GB18030. Note that this will only work if the location is set to China. E.g. in an English British locale setting <code>en_GB.GB18030</code> conversion of UTF-16 to GB18030 will not work, but in a Chinese <code>zh_CN.GB18030</code> locale setting it will work.</p>
 514
 515 <p>On Windows you need to use option <code>-gb</code> to convert UTF-16 files to GB18030.</p>
 516
 517 <p>GB18030 encoded files can have a Byte Order Mark, like Unicode files.</p>
 518
 519 <h1 id="EXAMPLES">EXAMPLES</h1>
 520
 521 <p>Read input from &#39;stdin&#39; and write output to &#39;stdout&#39;:</p>
 522
 523 <pre><code>    dos2unix
 524     dos2unix -l -c mac</code></pre>
 525
 526 <p>Convert and replace a.txt. Convert and replace b.txt:</p>
 527
 528 <pre><code>    dos2unix a.txt b.txt
 529     dos2unix -o a.txt b.txt</code></pre>
 530
 531 <p>Convert and replace a.txt in ascii conversion mode:</p>
 532
 533 <pre><code>    dos2unix a.txt</code></pre>
 534
 535 <p>Convert and replace a.txt in ascii conversion mode, convert and replace b.txt in 7bit conversion mode:</p>
 536
 537 <pre><code>    dos2unix a.txt -c 7bit b.txt
 538     dos2unix -c ascii a.txt -c 7bit b.txt
 539     dos2unix -ascii a.txt -7 b.txt</code></pre>
 540
 541 <p>Convert a.txt from Mac to Unix format:</p>
 542
 543 <pre><code>    dos2unix -c mac a.txt
 544     mac2unix a.txt</code></pre>
 545
 546 <p>Convert a.txt from Unix to Mac format:</p>
 547
 548 <pre><code>    unix2dos -c mac a.txt
 549     unix2mac a.txt</code></pre>
 550
 551 <p>Convert and replace a.txt while keeping original date stamp:</p>
 552
 553 <pre><code>    dos2unix -k a.txt
 554     dos2unix -k -o a.txt</code></pre>
 555
 556 <p>Convert a.txt and write to e.txt:</p>
 557
 558 <pre><code>    dos2unix -n a.txt e.txt</code></pre>
 559
 560 <p>Convert a.txt and write to e.txt, keep date stamp of e.txt same as a.txt:</p>
 561
 562 <pre><code>    dos2unix -k -n a.txt e.txt</code></pre>
 563
 564 <p>Convert and replace a.txt, convert b.txt and write to e.txt:</p>
 565
 566 <pre><code>    dos2unix a.txt -n b.txt e.txt
 567     dos2unix -o a.txt -n b.txt e.txt</code></pre>
 568
 569 <p>Convert c.txt and write to e.txt, convert and replace a.txt, convert and replace b.txt, convert d.txt and write to f.txt:</p>
 570
 571 <pre><code>    dos2unix -n c.txt e.txt -o a.txt b.txt -n d.txt f.txt</code></pre>
 572
 573 <h1 id="RECURSIVE-CONVERSION">RECURSIVE CONVERSION</h1>
 574
 575 <p>Use dos2unix in combination with the find(1) and xargs(1) commands to recursively convert text files in a directory tree structure. For instance to convert all .txt files in the directory tree under the current directory type:</p>
 576
 577 <pre><code>    find . -name *.txt |xargs dos2unix</code></pre>
 578
 579 <h1 id="LOCALIZATION">LOCALIZATION</h1>
 580
 581 <dl>
 582
 583 <dt id="LANG"><b>LANG</b></dt>
 584 <dd>
 585
 586 <p>The primary language is selected with the environment variable LANG. The LANG variable consists out of several parts. The first part is in small letters the language code. The second is optional and is the country code in capital letters, preceded with an underscore. There is also an optional third part: character encoding, preceded with a dot. A few examples for POSIX standard type shells:</p>
 587
 588 <pre><code>    export LANG=nl               Dutch
 589     export LANG=nl_NL            Dutch, The Netherlands
 590     export LANG=nl_BE            Dutch, Belgium
 591     export LANG=es_ES            Spanish, Spain
 592     export LANG=es_MX            Spanish, Mexico
 593     export LANG=en_US.iso88591   English, USA, Latin-1 encoding
 594     export LANG=en_GB.UTF-8      English, UK, UTF-8 encoding</code></pre>
 595
 596 <p>For a complete list of language and country codes see the gettext manual: <a href="http://www.gnu.org/software/gettext/manual/html_node/Usual-Language-Codes.html">http://www.gnu.org/software/gettext/manual/html_node/Usual-Language-Codes.html</a></p>
 597
 598 <p>On Unix systems you can use the command locale(1) to get locale specific information.</p>
 599
 600 </dd>
 601 <dt id="LANGUAGE"><b>LANGUAGE</b></dt>
 602 <dd>
 603
 604 <p>With the LANGUAGE environment variable you can specify a priority list of languages, separated by colons. Dos2unix gives preference to LANGUAGE over LANG. For instance, first Dutch and then German: <code>LANGUAGE=nl:de</code>. You have to first enable localization, by setting LANG (or LC_ALL) to a value other than &quot;C&quot;, before you can use a language priority list through the LANGUAGE variable. See also the gettext manual: <a href="http://www.gnu.org/software/gettext/manual/html_node/The-LANGUAGE-variable.html">http://www.gnu.org/software/gettext/manual/html_node/The-LANGUAGE-variable.html</a></p>
 605
 606 <p>If you select a language which is not available you will get the standard English messages.</p>
 607
 608 </dd>
 609 <dt id="DOS2UNIX_LOCALEDIR"><b>DOS2UNIX_LOCALEDIR</b></dt>
 610 <dd>
 611
 612 <p>With the environment variable DOS2UNIX_LOCALEDIR the LOCALEDIR set during compilation can be overruled. LOCALEDIR is used to find the language files. The GNU default value is <code>/usr/local/share/locale</code>. Option <b>--version</b> will display the LOCALEDIR that is used.</p>
 613
 614 <p>Example (POSIX shell):</p>
 615
 616 <pre><code>    export DOS2UNIX_LOCALEDIR=$HOME/share/locale</code></pre>
 617
 618 </dd>
 619 </dl>
 620
 621 <h1 id="RETURN-VALUE">RETURN VALUE</h1>
 622
 623 <p>On success, zero is returned. When a system error occurs the last system error will be returned. For other errors 1 is returned.</p>
 624
 625 <p>The return value is always zero in quiet mode, except when wrong command-line options are used.</p>
 626
 627 <h1 id="STANDARDS">STANDARDS</h1>
 628
 629 <p><a href="http://en.wikipedia.org/wiki/Text_file">http://en.wikipedia.org/wiki/Text_file</a></p>
 630
 631 <p><a href="http://en.wikipedia.org/wiki/Carriage_return">http://en.wikipedia.org/wiki/Carriage_return</a></p>
 632
 633 <p><a href="http://en.wikipedia.org/wiki/Newline">http://en.wikipedia.org/wiki/Newline</a></p>
 634
 635 <p><a href="http://en.wikipedia.org/wiki/Unicode">http://en.wikipedia.org/wiki/Unicode</a></p>
 636
 637 <h1 id="AUTHORS">AUTHORS</h1>
 638
 639 <p>Benjamin Lin - &lt;blin@socs.uts.edu.au&gt;, Bernd Johannes Wuebben (mac2unix mode) - &lt;wuebben@kde.org&gt;, Christian Wurll (add extra newline) - &lt;wurll@ira.uka.de&gt;, Erwin Waterlander - &lt;waterlan@xs4all.nl&gt; (maintainer)</p>
 640
 641 <p>Project page: <a href="http://waterlan.home.xs4all.nl/dos2unix.html">http://waterlan.home.xs4all.nl/dos2unix.html</a></p>
 642
 643 <p>SourceForge page: <a href="http://sourceforge.net/projects/dos2unix/">http://sourceforge.net/projects/dos2unix/</a></p>
 644
 645 <h1 id="SEE-ALSO">SEE ALSO</h1>
 646
 647 <p>file(1) find(1) iconv(1) locale(1) xargs(1)</p>
 648
 649
 650 </body>
 651
 652 </html>
 653
 654