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. For
example, a file called "filename.ext" becomes
"filename.ext.bak". Important: the program behaves differently
if it is compiled for DOS (as compared to being compiled for Windows,
Linux, Mac OS X or other systems). In view of the filename restrictions
present on DOS, the DOS executable will strip the original file extension,
if any, from the file before appending the .bak extension. For
example, "filename.ext" becomes "filename.bak".
- -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