fromdos - Online in the Cloud

PROGRAM:

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 ASCII and Unicode UTF-8 text files from the DOS format to the Unix format, while
todos converts them 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 This option is deprecated. Do not use it unless you know what you're doing. By
default, Tofrodos does the expected thing for text files. That is, when converting
from DOS to Unix, it will remove carriage returns only if they are followed by line
feeds. When converting from Unix to DOS, it will add carriage returns only if the
linefeeds are not already preceeded by carriage returns. When Tofrodos is run on a
normal text file that has already been converted, the resulting file should be
identical to the original. However, if you use this option, the program will always
remove carriage returns in the DOS to Unix mode and always add carriage returns in
the Unix to DOS mode even if it is not appropriate.

-b Make a backup of original file. The original file with a .bak extension appended to
the original filename, silently replacing any existing file of that name. For
example, a file called "filename.ext" becomes "filename.ext.bak" replacing any
existing file having the name "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 the
program 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 Unix-type systems (like Linux). On Windows and
MSDOS, it only preserves the file time. Note that on many Unix-type systems,
including Linux, the file ownership will only be preserved if the program is run as
root, otherwise it will just set the file time and silently fail the change of file
ownership. On such systems, if you want a warning message when the file ownership
cannot be changed, use -v (the verbose flag) as well.

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

-v Verbose.

-V Show version message and quit.

EXIT CODE

Tofrodos terminates with an exit code of 0 on success and 1 on error.

If the program is invoked with multiple files on the command line, the default behaviour
is to skip to the next file in the list if an error is encountered with any file. In such
a case, the exit code returned will the status of the last file processed (ie, 0 on
success, 1 on failure). If this is not desirable, use the -e option, which will force the
program to abort immediately with the appropriate exit code on encountering any error.

Use fromdos online using onworks.net services