Man pages sections > man1 > flip

flip, toms, toix - do newline conversions between **IX and MS-DOS

FLIP(1) Linux Programmer's Manual FLIP(1)

NAME

flip, toms, toix - do newline conversions between **IX and MS-DOS

SYNOPSIS

flip -h
 
flip [ -umvtsbz] file ...
 
flip [ -umvtsbz] -
 
toix [ -vtsbz] file ...
 
toms [ -vtsbz] file ...

DESCRIPTION

flip is a file interchange program that converts text file formats between **ix and MS-DOS. It converts lines ending with carriage-return (CR) and linefeed (LF) to lines ending with just linefeed, or vice versa. If the special argument "-" is given, input is read from stdin and written to stdout.
 
flip has the following features:
 
flip will normally refuse to convert binary files. You can override this.
 
When asked to convert a file to the same format that it already has, flip causes no change to the file. Thus to convert all files to **IX format you can type
 
                    flip -u *
 
and all files will end up right, regardless of whether they were in MS-DOS or in **IX format to begin with. This also works in the opposite direction.
 
If a file contains isolated CR characters for underlining or overprinting, flip does not change them.
 
flip preserves file timestamps. You can override this.
 
flip preserves file permissions.
 
flip is written in C and will compile and run under MS-DOS/Turbo C, 4.3BSD, and System V.
 
flip accepts wildcards and multiple filenames on the command line.
 
If a user interrupt aborts flip, it does not leave behind any garbage files or cause corruption of the files being converted.
 
When converting from MS-DOS to **IX format, flip removes any trailing control Z (the last character in the file), but leaves embedded control Z characters unchanged. This minimizes the possibility of accidentally converting a binary file that contains a control Z near the beginning. You can override this and ask flip to recognize the first control Z found as end-of-file.
 
flip can be asked to strip the high (parity) bit as it converts a file.
 
flip is normally invoked as:
               flip -umhvtb file ...
One of -u, -m, or -h is required. Switches may be given separately or combined together after a dash. For example, the three command lines given below are equivalent:
               flip -uvt *.c
               flip -u -v -t *.c
               flip -u -vt *.c
 
On systems that allow a program to know its own name, flip may be renamed (or linked) to a file called toix for conversion to **IX format, or to a file called toms for conversion to MS-DOS format. When invoked with the name toix or toms, flip will act as if it were invoked with the -u or -m option respectively.

OPTIONS

-u
Convert to **IX format (CR LF => LF, lone CR or LF unchanged, trailing control Z removed, embedded control Z unchanged).
-m
Convert to MS-DOS format (lone LF => CR LF, lone CR unchanged).
-h
Give a help message.
-v
Be verbose, print filenames as they are processed.
-t
Touch files (don't preserve timestamps).
-s
Strip high bit.
-b
Convert binary files too (else binary files are left unchanged).
-z
Truncate file at first control Z encountered.

AUTHOR

Rahul Dhesi <dhesi@bsu-cs.bsu.edu>.

SEE ALSO

unix2dos(1), dos2unix(1).
July 20, 2002 Linux 2.0