Man Linux: Main Page and Category List

NAME

       dos2unix - DOS/MAC to UNIX text file format converter

SYNOPSYS

       dos2unix  [options] [-c convmode] [-o file ...] [-n infile outfile ...]

       Options:

       [-fhkLlqV]  [--force]  [--help]  [--keepdate]  [--license]  [--newline]
       [--quiet] [--version]

DESCRIPTION

       Dos2unix  converts  plain  text files in DOS/MAC format to UNIX format.
       Binary  files  and  non-regular  files,  such  as   soft   links,   are
       automatically skipped, unless conversion is forced.

       Dos2unix   has  a  few  conversion  modes  similar  to  dos2unix  under
       SunOS/Solaris.

       In DOS/Windows text files line endings exist out of  a  combination  of
       two  characters:  a  Carriage Return (CR) followed by a Line Feed (LF).
       In Unix text  files  line  endings  exists  out  of  a  single  Newline
       character  which  is  equal  to a DOS Line Feed (LF) character.  In Mac
       text files, prior to Mac OS X, line  endings  exist  out  of  a  single
       Carriage Return character. Mac OS X is Unix based and has the same line
       endings as Unix.

OPTIONS

       The following options are available:

       -c --convmode convmode
              Set conversion mode. Where convmode is one of: ascii, 7bit, iso,
              mac with ascii being the default.

       -f --force
              Force conversion of all files. Also binary files.

       -h --help
              Display online help.

       -k --keepdate
              Keep the date stamp of output file same as input file.

       -L --license
              Display software license.

       -l --newline
              Add  additional  newline.   Only DOS line endings are changed to
              two Unix line endings.  In Mac mode only Mac  line  endings  are
              changed to two Unix line endings.

       -n --newfile infile outfile ...
              New  file  mode. Convert the infile and write output to outfile.
              File names must be given in pairs and wildcard names should  NOT
              be used or you WILL lose your files.

       -o --oldfile file ...
              Old  file  mode.  Convert  the  file and write output to it. The
              program default to run in this mode. Wildcard names may be used.

       -q --quiet
              Quiet mode. Suppress all warning and messages.

       -V --version
              Display version information.

CONVERSION MODES

       Conversion  modes  ascii  ,  7bit  ,  and  iso  are similar to those of
       dos2unix under SunOS/Solaris.

       ascii  In this mode  DOS  line  endings  are  converted  to  Unix  line
              endings.  Unix and Mac line endings are not changed.

              Although  the  name  of  this  mode  is  ASCII, which is a 7 bit
              standard, the actual mode is 8 bit.

       mac    In this mode  Mac  line  endings  are  converted  to  Unix  line
              endings.  DOS and Unix line endigs are not changed.

       7bit   In  this  mode  DOS  line  endings  are  converted  to Unix line
              endings.  All 8 bit non-ASCII characters (with values  from  128
              to 255) are converted to a space.

       iso    In  this  mode  DOS  line  endings  are  converted  to Unix line
              endings.  Characters are converted from DOS character set  (code
              page)  CP437  to  ISO character set ISO-8859-1. CP437 characters
              without ISO-8859-1  equivalent,  for  which  conversion  is  not
              possible,  are  converted to a dot.  CP437 is mainly used in the
              USA. In Western Europe CP850 is more standard.

              Another option to convert text files between different encodings
              is  to  use  dos2unix  in  combination  with iconv(1). Iconv can
              convert  between  a  long  list  of  character  encodings.  Some
              examples:

              Convert from DOS DOSLatinUS to Unix Latin-1

              iconv -f CP437 -t ISO-8859-1 in.txt | dos2unix > out.txt

              Convert from DOS DOSLatin1 to Unix Latin-1

              iconv -f CP850 -t ISO-8859-1 in.txt | dos2unix > out.txt

              Convert from Windows WinLatin1 to Unix Latin-1

              iconv -f CP1252 -t ISO-8859-1 in.txt | dos2unix > out.txt

              Convert from Windows WinLatin1 to Unix UTF-8 (Unicode)

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

              Convert from Windows UTF-16 (Unicode) to Unix UTF-8 (Unicode)

              iconv -f UTF-16 -t UTF-8 in.txt | dos2unix > out.txt

              See also <http://czyborra.com/charsets/codepages.html>
              and <http://czyborra.com/charsets/iso88.html>.

UNICODE

       Unicode  files  can  be  encoded  in different encodings. On Unix/Linux
       Unicode files are mostly encoded in  UTF-8  encoding.  UTF-8  is  ASCII
       compatible.  UTF-8  files can be in DOS, Unix or Mac format. It is safe
       to run dos2unix/unix2dos on UTF-8  encoded  files.  On  Windows  mostly
       UTF-16 encoding is used for Unicode files. Dos2unix/unix2dos should not
       be run on UTF-16 files. UTF-16 files are automatically skipped, because
       it are binary files.

EXAMPLES

       Get input from stdin and write output to stdout.

              dos2unix

       Convert and replace a.txt. Convert and replace b.txt.

              dos2unix a.txt b.txt

              dos2unix -o a.txt b.txt

       Convert and replace a.txt in ascii conversion mode.

              dos2unix a.txt

       Convert  and  replace  a.txt  in  ascii  conversion  mode.  Convert and
       replace b.txt in 7bit conversion mode.

              dos2unix a.txt -c 7bit b.txt

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

       Convert a.txt from Mac to Unix format.

              dos2unix -c mac a.txt

              mac2unix a.txt

       Convert and replace a.txt while keeping original date stamp.

              dos2unix -k a.txt

              dos2unix -k -o a.txt

       Convert a.txt and write to e.txt.

              dos2unix -n a.txt e.txt

       Convert a.txt and write to e.txt, keep date  stamp  of  e.txt  same  as
       a.txt.

              dos2unix -k -n a.txt e.txt

       Convert and replace a.txt. Convert b.txt and write to e.txt.

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

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

       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.

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

AUTHORS

       Benjamin Lin - <blin@socs.uts.edu.au>

       Bernd Johannes Wuebben (mac2unix mode) - <wuebben@kde.org>

       Erwin Waterlander - <waterlan@xs4all.nl>

       Project page: http://www.xs4all.nl/~waterlan/dos2unix.html

       SourceForge page: http://sourceforge.net/projects/dos2unix/

       Freshmeat: http://freshmeat.net/projects/dos2unix

SEE ALSO

       unix2dos(1) mac2unix(1) iconv(1)