BSD 4_3 release

[unix-history] / usr / man / man1 / dd.1

diff --git a/usr/man/man1/dd.1 b/usr/man/man1/dd.1
index b16addf..4927676 100644 (file)
--- a/usr/man/man1/dd.1
+++ b/usr/man/man1/dd.1
@@ -1,4 +1,11 @@
-.TH DD 1 
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)dd.1        6.1 (Berkeley) 4/29/85
+.\"
+.TH DD 1 "April 29, 1985"
+.UC 4

 .SH NAME
 dd \- convert and copy a file
 .SH SYNOPSIS
 .SH NAME
 dd \- convert and copy a file
 .SH SYNOPSIS


@@ -67,9 +74,10 @@ input records before starting copy
 .ns
 .TP
 .RI files= n
 .ns
 .TP
 .RI files= n

-skip
+copy

 .I n
 .I n

-input files before starting copy
+input files before terminating (makes sense only
+where input is a magtape or similar device).

 .br
 .ns
 .TP 
 .br
 .ns
 .TP 


@@ -100,6 +108,14 @@ convert ASCII to EBCDIC
 slightly different map of ASCII to EBCDIC
 .br
 .ns
 slightly different map of ASCII to EBCDIC
 .br
 .ns

+.IP \*hblock
+convert variable length records to fixed length
+.br
+.ns
+.IP \*hunblock
+convert fixed length records to variable length
+.br
+.ns

 .IP \*hlcase
 map alphabetics to lower case
 .br
 .IP \*hlcase
 map alphabetics to lower case
 .br


@@ -139,17 +155,21 @@ to indicate a product.
 .PP
 .I Cbs
 is used only if
 .PP
 .I Cbs
 is used only if

-.I ascii
+.I ascii,
+.I unblock,
+.I ebcdic,
+.I ibm,

 or
 or

-.I ebcdic
+.I block

 conversion is specified.
 conversion is specified.

-In the former case
+In the first two cases,

 .I cbs
 .I cbs

-characters are placed into the conversion buffer, converted to
-ASCII, and trailing blanks trimmed and new-line added
+characters are placed into the conversion buffer, any specified
+character mapping is done,
+trailing blanks trimmed and new-line added

 before sending the line to the output.
 before sending the line to the output.

-In the latter case ASCII characters are read into the
-conversion buffer, converted to EBCDIC, and blanks added
+In the latter three cases, characters are read into the
+conversion buffer, and blanks added

 to make up an
 output record of size
 .IR cbs .
 to make up an
 output record of size
 .IR cbs .


@@ -184,7 +204,24 @@ the CACM Nov, 1968.
 The `ibm' conversion, while less blessed as a standard,
 corresponds better to certain IBM print train conventions.
 There is no universal solution.
 The `ibm' conversion, while less blessed as a standard,
 corresponds better to certain IBM print train conventions.
 There is no universal solution.

+.br
+One must specify ``conv=noerror,sync'' when copying
+raw disks with bad sectors to insure 
+.I dd
+stays synchronized.

 .PP
 .PP

-Newlines are inserted only on conversion to ASCII;
-padding is done only on conversion to EBCDIC.
-These should be separate options.
+Certain combinations of arguments to 
+.I conv=
+are permitted.
+However, the
+.I block
+or
+.I unblock
+option cannot be combined with
+.IR ascii ,
+.IR ebcdic ""
+or
+.IR ibm .
+Invalid combinations
+.I "silently ignore"
+all but the last mutually-exclusive keyword.