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