aboutsummaryrefslogtreecommitdiff
path: root/man/dd.1
diff options
context:
space:
mode:
authorSoccera1 <[email protected]>2026-07-28 16:08:14 +1000
committerSoccera1 <[email protected]>2026-07-28 16:08:48 +1000
commit9846f087eb28bf11df740675ef487657ded39b69 (patch)
treee91dbd19b524f9432da6bcb86b1fc193e0d02e26 /man/dd.1
parent7fa396c9ef22b32a0b05e94aaa0266dd3e7515f8 (diff)
parent6a2f098e72e71437154ec00506e8e736aa8e1026 (diff)
downloadbnu-9846f087eb28bf11df740675ef487657ded39b69.tar.gz
bnu-9846f087eb28bf11df740675ef487657ded39b69.zip
Merge branch 'master' into refactor/single-call-commandsrefactor/single-call-commands
# Conflicts: # README.md
Diffstat (limited to 'man/dd.1')
-rw-r--r--man/dd.1183
1 files changed, 183 insertions, 0 deletions
diff --git a/man/dd.1 b/man/dd.1
new file mode 100644
index 0000000..dbe9163
--- /dev/null
+++ b/man/dd.1
@@ -0,0 +1,183 @@
+.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
+.TH DD "1" "2026-07-28" "BNU 9.11" "BNU Commands"
+.SH NAME
+dd \- convert and copy a file
+.SH SYNOPSIS
+.B dd
+[\fI\,OPERAND\/\fR]...
+.br
+.B dd
+\fI\,OPTION\/\fR
+.SH DESCRIPTION
+.\" This page is derived from GNU Coreutils documentation.
+This page documents BNU, an independent Bun implementation compatible with
+GNU Coreutils 9.11.
+.PP
+Copy a file, converting and formatting according to the operands.
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddbs'\fBbs=BYTES\fP\X'tty: link'
+read and write up to BYTES bytes at a time (default: 512);
+overrides ibs and obs
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcbs'\fBcbs=BYTES\fP\X'tty: link'
+convert BYTES bytes at a time
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddconv'\fBconv=CONVS\fP\X'tty: link'
+convert the file as per the comma separated symbol list
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcount'\fBcount=N\fP\X'tty: link'
+copy only N input blocks
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddibs'\fBibs=BYTES\fP\X'tty: link'
+read up to BYTES bytes at a time (default: 512)
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddif'\fBif=FILE\fP\X'tty: link'
+read from FILE instead of standard input
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddiflag'\fBiflag=FLAGS\fP\X'tty: link'
+read as per the comma separated symbol list
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddobs'\fBobs=BYTES\fP\X'tty: link'
+write BYTES bytes at a time (default: 512)
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddof'\fBof=FILE\fP\X'tty: link'
+write to FILE instead of standard output
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddoflag'\fBoflag=FLAGS\fP\X'tty: link'
+write as per the comma separated symbol list
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddseek'\fBseek=N\fP\X'tty: link'
+(or oseek=N) skip N obs sized output blocks
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddskip'\fBskip=N\fP\X'tty: link'
+(or iseek=N) skip N ibs sized input blocks
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddstatus'\fBstatus=LEVEL\fP\X'tty: link'
+The LEVEL of information to print to standard error;
+\&'none' suppresses everything but error messages,
+\&'noxfer' suppresses the final transfer statistics,
+\&'progress' shows periodic transfer statistics
+.PP
+N and BYTES may be followed by the following multiplicative suffixes:
+c=1, w=2, b=512, kB=1000, K=1024, MB=1000*1000, M=1024*1024, xM=M,
+GB=1000*1000*1000, G=1024*1024*1024, and so on for T, P, E, Z, Y, R, Q.
+Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
+If N ends in 'B', it counts bytes not blocks.
+.PP
+Each CONV symbol may be:
+.TP
+ascii
+from EBCDIC to ASCII
+.TP
+ebcdic
+from ASCII to EBCDIC
+.TP
+ibm
+from ASCII to alternate EBCDIC
+.TP
+block
+pad newline\-terminated records with spaces to cbs\-size
+.TP
+unblock
+replace trailing spaces in cbs\-size records with newline
+.TP
+lcase
+change upper case to lower case
+.TP
+ucase
+change lower case to upper case
+.TP
+sparse
+try to seek rather than write all\-NUL output blocks
+.TP
+swab
+swap every pair of input bytes
+.TP
+sync
+pad every input block with NULs to ibs\-size; when used
+with block or unblock, pad with spaces rather than NULs
+.TP
+excl
+fail if the output file already exists
+.TP
+nocreat
+do not create the output file
+.TP
+notrunc
+do not truncate the output file
+.TP
+noerror
+continue after read errors
+.TP
+fdatasync
+physically write output file data before finishing
+.TP
+fsync
+likewise, but also write metadata
+.PP
+Each FLAG symbol may be:
+.TP
+append
+append mode (makes sense only for output; conv=notrunc suggested)
+.TP
+direct
+use direct I/O for data
+.TP
+directory
+fail unless a directory
+.TP
+dsync
+use synchronized I/O for data
+.TP
+sync
+likewise, but also for metadata
+.TP
+fullblock
+accumulate full blocks of input (iflag only)
+.TP
+nonblock
+use non\-blocking I/O
+.TP
+noatime
+do not update access time
+.TP
+nocache
+Request to drop cache. See also oflag=sync
+.TP
+noctty
+do not assign controlling terminal from file
+.TP
+nofollow
+do not follow symlinks
+.PP
+Sending a USR1 signal to a running 'dd' process makes it
+print I/O statistics to standard error and then resume copying.
+.PP
+Options are:
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/dd#dd--help'\fB\-\-help\fP\X'tty: link'
+display this help and exit
+.TP
+\X'tty: link https://www.gnu.org/software/coreutils/dd#dd--version'\fB\-\-version\fP\X'tty: link'
+output version information and exit
+.SH AUTHORS
+Upstream GNU Coreutils documentation authors:
+Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
+.br
+Adapted for BNU; the BNU implementation is independent.
+.SH "REPORTING BUGS"
+Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
+.br
+For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>.
+.SH COPYRIGHT
+Copyright \(co 2026 Free Software Foundation, Inc.
+.br
+This manual page was adapted for BNU in 2026.
+License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+Upstream documentation <https://www.gnu.org/software/coreutils/dd>
+.br
+BNU documentation is available locally via: info \(aq(bnu) dd invocation\(aq