Bug 253874

Summary:	dd bs= arg variants
Product:	Documentation	Reporter:	Bruce Lilly <bruce.lilly>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed Not Accepted
Severity:	Affects Many People	CC:	carlavilla, pauamma, ygy
Priority:	---	Keywords:	needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
Bug Depends on:
Bug Blocks:	263315

Description Bruce Lilly 2021-02-26 16:16:54 UTC

https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-pre
Specifically, section 2.3.1.1.

There is considerable verbiage about syntax variations and "1m" vs. "1M".
As the unit for bs is bytes, it would be simpler to specify bs=1048576,
which will work with all dd variants.

As an aside, it could be pointed out that 1048576 is 1 mebibyte, i.e.
1024 * 1024 bytes (optionally referencing SI prefixes
   https://www.bipm.org/en/publications/si-brochure
   https://www.nist.gov/pml/weights-and-measures/metric-si-prefixes
and IEC binary power prefixes
   https://www.nist.gov/pml/special-publication-330/sp-330-section-3
   https://en.wikipedia.org/wiki/IEC_60027 ).

Comment 1 Pau Amma 2022-04-10 01:09:12 UTC

While there, s/Write the Image/write the image/ in text.

Comment 2 commit-hook freebsd_committer

2023-08-30 15:36:05 UTC

A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=63c762bef3257c103ac998f014facfd27bf1f382

commit 63c762bef3257c103ac998f014facfd27bf1f382
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-08-30 15:35:01 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-08-30 15:35:01 +0000

    Handbook - bsdinstall: Fix typo

    PR:             253874
    Reported by:    Pau Amma <pauamma@gundo.com>

 documentation/content/en/books/handbook/bsdinstall/_index.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Comment 3 Sergio Carlavilla Delgado freebsd_committer

2023-08-30 15:38:21 UTC

I fixed the typo reported by Pau Amma, but I think it's better to have 1M instead of bs=1048576.
If you copy it by hand, an error is more likely to occur.