Man Linux: Main Page and Category List

NAME

       tofrodos - Converts text files between DOS and Unix formats.

SYNOPSIS

       fromdos [ options ] [file...]
       todos [ options ] [file...]

DESCRIPTION

       DOS  text  files traditionally have carriage return and line feed pairs
       as their newline characters while Unix text files have the line feed as
       their  newline  character.   fromdos  converts  text files from the DOS
       format to the Unix format, while todos converts  text  files  from  the
       Unix format to the DOS format.

       The   programs   accept  multiple  filenames  and  wildcards  as  their
       arguments.  You may also use them in a pipe.  If either  program  finds
       its  input  redirected,  it  will process stdin and place the output on
       stdout.

OPTIONS

       -a     Always convert. If converting from DOS to Unix, this option will
              cause the program to remove ALL carriage returns. The default is
              to remove carriage returns only if they  are  followed  by  line
              feeds.   If  converting from Unix to DOS, this option will cause
              the program to convert ALL linefeeds to carriage  return  pairs.
              The default is to convert linefeeds only if they are not already
              preceded by a carriage return.

       -b     Make a backup of original file. The  original  file  is  renamed
              with the original filename and a .bak extension.

       -d     Convert from DOS to Unix. This forces the program to convert the
              file in a particular direction. By default, if  the  program  is
              named fromdos or dos2unix, it will assume that the input file is
              in a DOS format and convert it to a Unix format. If the  program
              is  named  todos or unix2dos, it will assume that the input file
              is in a Unix format and convert it to a DOS format. Using the -d
              option forces the program to convert from a DOS format to a Unix
              format regardless of how the program is named.  Likewise,  using
              the  -u  option forces the program to convert from a Unix format
              to a DOS format regardless of the name of the program.

       -e     Abort processing on any error in any file. Normally, the program
              will  simply  skip  to process the next file on the command line
              when it encounters any errors. This option causes it to abort on
              errors.

       -f     Force: convert even if the file is not writeable (read-only). By
              default, if fromdos or todos finds that the file does  not  have
              write  permission,  it  will  not process that file. This option
              forces the conversion even if the file is read-only.

       -h     Display a short help screen on the program usage and quit.

       -l<logfile>
              Log error messages to <logfile>. Note that if your command  line
              has  an  error,  such as when you specify an unknown option, the
              error message for the command line option error will  be  issued
              to stderr instead and not logged.

       -o     Overwrite the original file (no backup). This is the default.

       -p     Preserve  file  ownership  and  time. On systems like Linux, the
              file ownership will only be  preserved  if  the  user  is  root,
              otherwise  it  will just set the file time and silently fail the
              change of file ownership. If you want a warning message when the
              file ownership cannot be changed, use -v.

       -u     Convert  from  Unix  to  DOS.  See  the -d option above for more
              information.

       -v     Verbose.

       -V     Show version message and quit.

AUTHOR

       The program and its documentation  are  copyrighted  (c)  1996-2008  by
       Christopher  Heng.  All rights reserved. They are distributed under the
       terms of the GNU General Public License Version 2.

       The latest version of tofrodos can be obtained from
       http://www.thefreecountry.com/tofrodos/index.shtml