mirror of
https://codeberg.org/libreboot/lbmk.git
synced 2026-03-25 13:29:03 +02:00
e9a910b33c
i currently use the output of sha512sum in several places of xbmk, which is a bit unreliable in case output changes. other cases where i use util outputs in variables are probably reliable, because i'm using mostly posix utilities in those. to mitigate this, i now import suckless sbase, which has a reasonable sha512sum implementation. *every* binary it builds is being placed in build.list, because i'll probably start using more of them. for example, i may start modifying the "date" implementation, adding the GNU-specific options that i need as mentioned on init.sh i'm importing it in util/ because the sha512sum util is needed for verifying project sources, so if sbase itself is a "project source", that means we can into a chicken and egg bootstrapping problem. this is sbase at revision: 055cc1ae1b3a13c3d8f25af0a4a3316590efcd48 Signed-off-by: Leah Rowe <leah@libreboot.org>
92 lines
1.9 KiB
Groff
92 lines
1.9 KiB
Groff
.Dd April 28, 2020
|
|
.Dt DD 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm dd
|
|
.Nd convert and copy a file
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Ar operand Ns ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
copies its input to its output, possibly after conversion, using
|
|
the specified block sizes,
|
|
.Pp
|
|
The following operands are available:
|
|
.Bl -tag -width ibs=expr
|
|
.It Cm if= Ns Ar file
|
|
Read from the file named by
|
|
.Ar file
|
|
instead of standard input.
|
|
.It Cm of= Ns Ar file
|
|
Write to the file named by
|
|
.Ar file
|
|
instead of standard output.
|
|
.It Cm ibs= Ns Ar expr
|
|
Set the input block size to
|
|
.Ar expr
|
|
(defaults to 512).
|
|
.It Cm obs= Ns Ar expr
|
|
Set the output block size to
|
|
.Ar expr
|
|
(defaults to 512).
|
|
.It Cm bs= Ns Ar expr
|
|
Set the input and output block sizes to
|
|
.Ar expr .
|
|
Additionally, if no conversion other than
|
|
.Cm noerror ,
|
|
.Cm notrunc ,
|
|
or
|
|
.Cm sync
|
|
is specified, input blocks are copied as single output blocks, even
|
|
when the input block is short.
|
|
.It Cm skip= Ns Ar n
|
|
Skip
|
|
.Ar n
|
|
input blocks before starting to copy.
|
|
.It Cm seek= Ns Ar n
|
|
Skip
|
|
.Ar n
|
|
output blocks before starting to copy.
|
|
.It Cm count= Ns Ar n
|
|
Copy at most
|
|
.Ar n
|
|
input blocks.
|
|
.It Cm conv= Ns Ar value Ns Op , Ns Ar value Ns ...
|
|
Apply the conversions specified by
|
|
.Ar value .
|
|
.Bl -tag -width Ds
|
|
.It Cm lcase
|
|
Map uppercase characters to the corresponding lowercase character
|
|
using
|
|
.Fn tolower .
|
|
.It Cm ucase
|
|
Map lowercase characters to the corresponding uppercase character
|
|
using
|
|
.Fn toupper .
|
|
.It Cm swab
|
|
Swap each pair of bytes in the input block.
|
|
If there is an odd number of bytes in a block, the last one is
|
|
unmodified.
|
|
.It Cm noerror
|
|
In case of an error reading from the input, do not fail.
|
|
Instead, print a diagnostic message and a summary of the current
|
|
status.
|
|
.It Cm notrunc
|
|
Do not truncate the output file.
|
|
.It Cm sync
|
|
In case of a partial input block, pad with null bytes to form a
|
|
complete block.
|
|
.El
|
|
.El
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2008
|
|
specification, except that it does not implement the
|
|
.Cm block
|
|
and
|
|
.Cm unblock
|
|
conversions.
|