Reported by Erik van der Kouwe <vdkouwe at cs.vu.nl>:
[minix.git] / man / man1 / dd.1
blob756ab0eb273e6605245ee7228db0ed9ec79b165a
1 .TH DD 1
2 .SH NAME
3 dd \- convert and copy a file
4 .SH SYNOPSIS
5 \fBdd\fR [\fIoption = value\fR] ...\fR
6 .br
7 .de FL
8 .TP
9 \\fB\\$1\\fR
10 \\$2
12 .de EX
13 .TP 20
14 \\fB\\$1\\fR
15 # \\$2
17 .SH EXAMPLES
18 .EX "dd if=/dev/fd0 of=/dev/fd1" "Copy disk 0 to disk 1"
19 .EX "dd if=x of=y bs=1w skip=4" "Copy \fIx\fP to \fIy\fP, skipping 4 words"
20 .EX "dd if=x of=y count=3" "Copy three 512\-byte blocks"
21 .SH DESCRIPTION
22 .PP
23 This command is intended for copying partial files.
24 The block size, skip count, and number of blocks to copy can be specified.
25 The options are:
26 .PP
27 .ta 0.25i 1.5i
28         \fBif\fR = file \- Input file (default is \fIstdin\fR)
29 .br
30         \fBof\fR = file \- Output file (default is standard output)
31 .br
32         \fBibs\fR = n   \- Input block size (default 512 bytes)
33 .br
34         \fBobs\fR = n   \- Output block size (default is 512 bytes)
35 .br
36         \fBbs\fR = n    \- Block size; sets \fIibs\fP and \fIobs\fP (default is 512 bytes)
37 .br
38         \fBskip\fR = n  \- Skip \fIn\fP input blocks before reading
39 .br
40         \fBseek\fR = n  \- Skip \fIn\fP output blocks before writing
41 .br
42         \fBcount\fR = n \- Copy only \fIn\fP input blocks
43 .br
44         \fBconv = lcase\fR      \- Convert upper case letters to lower case
45 .br
46         \fBconv = ucase\fR      \- Convert lower case letters to upper case
47 .br
48         \fBconv = swab\fR       \- Swap every pair of bytes
49 .br
50         \fBconv = noerror\fR    \- Ignore errors and just keep going
51 .br
52         \fBconv = silent\fR     \- Suppress statistics (MINIX 3 specific flag)
53 .PP
54 Where sizes are expected, they are in bytes.
55 However, the letters \fBw\fR, \fBb\fR, or \fBk\fR may be appended to the
56 number to indicate words (2 bytes), blocks (512 bytes), or K
57 (1024 bytes), respectively.
58 When
59 .I dd
60 is finished, it reports the number of full and partial blocks read and written.
61 .SH "SEE ALSO"
62 .BR vol (1).