unstack, sort: cleanup and improvement
[minix.git] / man / man1 / dd.1
blobfcf15e2f6a974aad0113d5690099aafafcd7dc79
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 .TP 20
19 .B dd if=/dev/fd0 of=/dev/fd1
20 # Copy disk 0 to disk 1
21 .TP 20
22 .B dd if=x of=y bs=1w skip=4
23 # Copy \fIx\fP to \fIy\fP, skipping 4 words
24 .TP 20
25 .B dd if=x of=y count=3
26 # Copy three 512\-byte blocks
27 .SH DESCRIPTION
28 .PP
29 This command is intended for copying partial files.
30 The block size, skip count, and number of blocks to copy can be specified.
31 The options are:
32 .PP
33 .ta 0.25i 1.5i
34         \fBif\fR = file \- Input file (default is \fIstdin\fR)
35 .br
36         \fBof\fR = file \- Output file (default is standard output)
37 .br
38         \fBibs\fR = n   \- Input block size (default 512 bytes)
39 .br
40         \fBobs\fR = n   \- Output block size (default is 512 bytes)
41 .br
42         \fBbs\fR = n    \- Block size; sets \fIibs\fP and \fIobs\fP (default is 512 bytes)
43 .br
44         \fBskip\fR = n  \- Skip \fIn\fP input blocks before reading
45 .br
46         \fBseek\fR = n  \- Skip \fIn\fP output blocks before writing
47 .br
48         \fBcount\fR = n \- Copy only \fIn\fP input blocks
49 .br
50         \fBconv = lcase\fR      \- Convert upper case letters to lower case
51 .br
52         \fBconv = ucase\fR      \- Convert lower case letters to upper case
53 .br
54         \fBconv = swab\fR       \- Swap every pair of bytes
55 .br
56         \fBconv = noerror\fR    \- Ignore errors and just keep going
57 .br
58         \fBconv = notrunc\fR    \- Do not truncate unmodified blocks
59 .br
60         \fBconv = silent\fR     \- Suppress statistics (MINIX 3 specific flag)
61 .PP
62 Where sizes are expected, they are in bytes.
63 However, the letters \fBw\fR, \fBb\fR, or \fBk\fR may be appended to the
64 number to indicate words (2 bytes), blocks (512 bytes), or K
65 (1024 bytes), respectively.
66 When
67 .I dd
68 is finished, it reports the number of full and partial blocks read and written.
69 .SH "SEE ALSO"
70 .BR vol (1).