'\" te
.\" Copyright (c) 2000, Sun Microsystems, Inc.
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
.TH UNIX2DOS 1 "Sep 14, 2000"
.SH NAME
unix2dos \- convert text file from ISO format to DOS format
.SH SYNOPSIS
.LP
.nf
\fBunix2dos\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR]
     [\fB-437\fR | \fB-850\fR | \fB-860\fR | \fB-863\fR | \fB-865\fR] \fIoriginalfile\fR \fIconvertedfile\fR
.fi

.SH DESCRIPTION
.sp
.LP
The \fBunix2dos\fR utility converts \fBISO\fR standard characters to the
corresponding characters in the \fBDOS\fR extended character set.
.sp
.LP
This command may be invoked from either \fBDOS\fR or SunOS. However, the
filenames must conform to the conventions of the environment in which the
command is invoked.
.sp
.LP
If the original file and the converted file are the same,  \fBunix2dos\fR will
rewrite the original file after converting it.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.na
\fB\fB-ascii\fR\fR
.ad
.RS 10n
Adds carriage returns and converts end of file characters in SunOS format text
files to conform to \fBDOS\fR requirements.
.RE

.sp
.ne 2
.na
\fB\fB-iso\fR\fR
.ad
.RS 10n
This is the default. Converts \fBISO\fR standard characters to the
corresponding character in the \fBDOS\fR extended character set.
.RE

.sp
.ne 2
.na
\fB\fB-7\fR\fR
.ad
.RS 10n
Converts 8 bit SunOS characters to 7 bit \fBDOS\fR characters.
.RE

.sp
.LP
On non-i386 systems, \fBunix2dos\fR will attempt to obtain the keyboard type to
determine which code page to use. Otherwise, the default is US. The user may
override the code page with one of the following options:
.sp
.ne 2
.na
\fB\fB-437\fR\fR
.ad
.RS 8n
Use US code page
.RE

.sp
.ne 2
.na
\fB\fB-850\fR\fR
.ad
.RS 8n
Use multilingual code page
.RE

.sp
.ne 2
.na
\fB\fB-860\fR\fR
.ad
.RS 8n
Use Portuguese code page
.RE

.sp
.ne 2
.na
\fB\fB-863\fR\fR
.ad
.RS 8n
Use French Canadian code page
.RE

.sp
.ne 2
.na
\fB\fB-865\fR\fR
.ad
.RS 8n
Use Danish code page
.RE

.SH OPERANDS
.sp
.LP
The following operands are required:
.sp
.ne 2
.na
\fB\fIoriginalfile\fR \fR
.ad
.RS 18n
The original file in \fBISO\fR format that is being converted to \fBDOS\fR
format.
.RE

.sp
.ne 2
.na
\fB\fIconvertedfile\fR \fR
.ad
.RS 18n
The new file in \fBDOS\fR format that has been converted from the original
\fBISO\fR file format.
.RE

.SH SEE ALSO
.sp
.LP
\fBdos2unix\fR(1), \fBls\fR(1), \fBattributes\fR(5)
.SH DIAGNOSTICS
.sp
.ne 2
.na
\fB\fBFile \fIfilename\fR not found, or no read permission\fR\fR
.ad
.sp .6
.RS 4n
The input file you specified does not exist, or you do not have read
permission. Check with the SunOS command, \fBls\fR \fB-l\fR (see \fBls\fR(1)).
.RE

.sp
.ne 2
.na
\fB\fBBad output filename \fIfilename\fR, or no write permission\fR\fR
.ad
.sp .6
.RS 4n
The output file you specified is either invalid, or you do not have write
permission for that file or the directory that contains it. Check also that the
drive or diskette is not write-protected.
.RE

.sp
.ne 2
.na
\fB\fBError while writing to temporary file\fR\fR
.ad
.sp .6
.RS 4n
An error occurred while converting your file, possibly because there is not
enough space on the current drive. Check the amount of space on the current
drive using the \fBDIR\fR command. Also be certain that the default diskette or
drive is write-enabled (not write-protected). Notice that when this error
occurs, the original file remains intact.
.RE

.sp
.ne 2
.na
\fB\fBTranslated tmpfile name = \fIfilename\fR.\fR\fR
.ad
.br
.na
\fB\fBCould not rename tmpfile to \fIfilename\fR.\fR\fR
.ad
.sp .6
.RS 4n
The program could not perform the final step in converting your file. Your
converted file is stored under the name indicated on the second line of this
message.
.RE