usr/src/man/man1/unix2dos.1

   1 '\" te
   2 .\" Copyright (c) 2000, Sun Microsystems, Inc.
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH UNIX2DOS 1 "Sep 14, 2000"
   7 .SH NAME
   8 unix2dos \- convert text file from ISO format to DOS format
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBunix2dos\fR [\fB-ascii\fR] [\fB-iso\fR] [\fB-7\fR]
  13      [\fB-437\fR | \fB-850\fR | \fB-860\fR | \fB-863\fR | \fB-865\fR] \fIoriginalfile\fR \fIconvertedfile\fR
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBunix2dos\fR utility converts \fBISO\fR standard characters to the
  20 corresponding characters in the \fBDOS\fR extended character set.
  21 .sp
  22 .LP
  23 This command may be invoked from either \fBDOS\fR or SunOS. However, the
  24 filenames must conform to the conventions of the environment in which the
  25 command is invoked.
  26 .sp
  27 .LP
  28 If the original file and the converted file are the same,  \fBunix2dos\fR will
  29 rewrite the original file after converting it.
  30 .SH OPTIONS
  31 .sp
  32 .LP
  33 The following options are supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fB-ascii\fR\fR
  38 .ad
  39 .RS 10n
  40 Adds carriage returns and converts end of file characters in SunOS format text
  41 files to conform to \fBDOS\fR requirements.
  42 .RE
  43
  44 .sp
  45 .ne 2
  46 .na
  47 \fB\fB-iso\fR\fR
  48 .ad
  49 .RS 10n
  50 This is the default. Converts \fBISO\fR standard characters to the
  51 corresponding character in the \fBDOS\fR extended character set.
  52 .RE
  53
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-7\fR\fR
  58 .ad
  59 .RS 10n
  60 Converts 8 bit SunOS characters to 7 bit \fBDOS\fR characters.
  61 .RE
  62
  63 .sp
  64 .LP
  65 On non-i386 systems, \fBunix2dos\fR will attempt to obtain the keyboard type to
  66 determine which code page to use. Otherwise, the default is US. The user may
  67 override the code page with one of the following options:
  68 .sp
  69 .ne 2
  70 .na
  71 \fB\fB-437\fR\fR
  72 .ad
  73 .RS 8n
  74 Use US code page
  75 .RE
  76
  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fB-850\fR\fR
  81 .ad
  82 .RS 8n
  83 Use multilingual code page
  84 .RE
  85
  86 .sp
  87 .ne 2
  88 .na
  89 \fB\fB-860\fR\fR
  90 .ad
  91 .RS 8n
  92 Use Portuguese code page
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-863\fR\fR
  99 .ad
 100 .RS 8n
 101 Use French Canadian code page
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB-865\fR\fR
 108 .ad
 109 .RS 8n
 110 Use Danish code page
 111 .RE
 112
 113 .SH OPERANDS
 114 .sp
 115 .LP
 116 The following operands are required:
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fIoriginalfile\fR \fR
 121 .ad
 122 .RS 18n
 123 The original file in \fBISO\fR format that is being converted to \fBDOS\fR
 124 format.
 125 .RE
 126
 127 .sp
 128 .ne 2
 129 .na
 130 \fB\fIconvertedfile\fR \fR
 131 .ad
 132 .RS 18n
 133 The new file in \fBDOS\fR format that has been converted from the original
 134 \fBISO\fR file format.
 135 .RE
 136
 137 .SH SEE ALSO
 138 .sp
 139 .LP
 140 \fBdos2unix\fR(1), \fBls\fR(1), \fBattributes\fR(5)
 141 .SH DIAGNOSTICS
 142 .sp
 143 .ne 2
 144 .na
 145 \fB\fBFile \fIfilename\fR not found, or no read permission\fR\fR
 146 .ad
 147 .sp .6
 148 .RS 4n
 149 The input file you specified does not exist, or you do not have read
 150 permission. Check with the SunOS command, \fBls\fR \fB-l\fR (see \fBls\fR(1)).
 151 .RE
 152
 153 .sp
 154 .ne 2
 155 .na
 156 \fB\fBBad output filename \fIfilename\fR, or no write permission\fR\fR
 157 .ad
 158 .sp .6
 159 .RS 4n
 160 The output file you specified is either invalid, or you do not have write
 161 permission for that file or the directory that contains it. Check also that the
 162 drive or diskette is not write-protected.
 163 .RE
 164
 165 .sp
 166 .ne 2
 167 .na
 168 \fB\fBError while writing to temporary file\fR\fR
 169 .ad
 170 .sp .6
 171 .RS 4n
 172 An error occurred while converting your file, possibly because there is not
 173 enough space on the current drive. Check the amount of space on the current
 174 drive using the \fBDIR\fR command. Also be certain that the default diskette or
 175 drive is write-enabled (not write-protected). Notice that when this error
 176 occurs, the original file remains intact.
 177 .RE
 178
 179 .sp
 180 .ne 2
 181 .na
 182 \fB\fBTranslated tmpfile name = \fIfilename\fR.\fR\fR
 183 .ad
 184 .br
 185 .na
 186 \fB\fBCould not rename tmpfile to \fIfilename\fR.\fR\fR
 187 .ad
 188 .sp .6
 189 .RS 4n
 190 The program could not perform the final step in converting your file. Your
 191 converted file is stored under the name indicated on the second line of this
 192 message.
 193 .RE
 194