install the mkubootimage(1) manual

branches: 1.2.4; 1.2.6; 1.2.12;
Default to -Wno-sign-compare -Wno-pointer-sign for clang.
Push -Wno-array-bounds down to the cases that depend on it.
Selectively disable warnings for 3rd party software or non-trivial
issues to be reviewed later to get clang -Werror to build most of the
tree.

branches: 1.1.4;
add mkubootimage(1), a tool for creating u-boot compatible images

Fix tools build

Add support for writing "AArch64 Linux kernel image" format images.

These images begin with a 64-byte header that includes a load offset,
image size, some flags, and a small (2 word) area at the start for
executable code.

These images are compatible with U-Boot's "booti" command, and can be
used to make U-Boot relocate our kernel to a 2MB aligned base address.
After relocation, U-Boot will jump to the code at the beginning of the
header, where we encode a relative branch forward instruction to branch
to the beginning of the kernel at offset +0x40.

PR/57914: Jan-Benedict Glaw: Set reproducible timestamp
Cleanup lint.

branches: 1.4.40;
add missing prototype for crc32v

add support for generating boot.scr scripts with -T script

branches: 1.2.4; 1.2.8; 1.2.10; 1.2.16;
nbtool.h'ify; fixes cross-compilation.

add mkubootimage(1), a tool for creating u-boot compatible images

branches: 1.2.2;
crc32.h: add missing RCS ID

branches: 1.1.2;
PR/57914: Jan-Benedict Glaw: Set reproducible timestamp
Cleanup lint.

mkubootimage.1: improve markup

mkubootimage.1: restore .Ed lost in previous

mkubootimage(1): adjust example output in man page

Refresh to show current output format (an additional field) and address
a "TODO" comment that's been there for over a decade.

mkubootimage(1): adjust usage, etc.

In the tool, reflow and reorder usage() output and also consistently
mark which arguments are optional.

In the man page, add missing -t argument in the synopsis and follow
consistent argument ordering.

mkubootimage(1): add riscv

PR/57914: Jan-Benedict Glaw: Set reproducible timestamp
Cleanup lint.

branches: 1.14.8;
Sync usage with man page, merge single letter options.

Limit program usage line length.

Add -u flag for updating headers in place.

branches: 1.12.4; 1.12.6;
Add support for writing "AArch64 Linux kernel image" format images.

These images begin with a 64-byte header that includes a load offset,
image size, some flags, and a small (2 word) area at the start for
executable code.

These images are compatible with U-Boot's "booti" command, and can be
used to make U-Boot relocate our kernel to a 2MB aligned base address.
After relocation, U-Boot will jump to the code at the beginning of the
header, where we encode a relative branch forward instruction to branch
to the beginning of the kernel at offset +0x40.

add sh arch

branches: 1.10.2;
Remove unnecessary macros. Use standard headers.

Add support for "kernel_noload" image types. This type is the same as the
"kernel" type, except it can run from any load address.

branches: 1.8.8;
Use An in AUTHORS section.

Bump date.

Support arm64, i386 and or1k.

branches: 1.5.2; 1.5.6;
add support for generating boot.scr scripts with -T script

More markup.

Change ULONG_MAX to UINT32_MAX

Sort SYNOPSIS. Remove unnecessary Ns. Punctuation nit.

Add a manual for mkubootimage(1). It was missing.
It had one review on netbsd-docs@.
I didn't add the manual to the Makefile nor distrib set yet --
waiting for more review or improvements first.

mkubootimage.c: consistently use endian.h origin functions

Since this already uses bswap32(3), le64toh(3), etc., switch to also
use htobe32(3) and be32toh(3) instead of htonl(3) and ntohl(3). This
seems the best way to fix build breakages under recent Linux distros
where GCC objects to missing prototypes (since otherwise we'd need to
include arpa/inet.h, which wasn't declared). Another issue related to
PR lib/58674.

Confirmed this fixes builds on Fedora 40 (since all these functions are
provided by NetBSD compat). No changes noted to resulting installation
images generated for armv7hf on a NetBSD build.

branches: 1.33.2;
mkubootimage(1): adjust usage, etc.

In the tool, reflow and reorder usage() output and also consistently
mark which arguments are optional.

In the man page, add missing -t argument in the synopsis and follow
consistent argument ordering.

mkubootimage(1): add riscv

PR/57914: Jan-Benedict Glaw: Set reproducible timestamp
Cleanup lint.

branches: 1.30.8;
arm64_image_header->image_size must be included size of arm64_image_header.

with -u option, image_size should be binary (file) size (header included).
without -u option, image_size should be binary (file) size + header size.

Avoid mixing signed/unsigned arguments to the ? operator.

Adjust image size appropriately when using update_image

OK jmcneill

Sync usage with man page, merge single letter options.

Limit program usage line length.

Fix signed/unsigned comparison

Add -u flag for updating headers in place.

branches: 1.24.4; 1.24.6;
Fix tools build

Add support for writing "AArch64 Linux kernel image" format images.

These images begin with a 64-byte header that includes a load offset,
image size, some flags, and a small (2 word) area at the start for
executable code.

These images are compatible with U-Boot's "booti" command, and can be
used to make U-Boot relocate our kernel to a 2MB aligned base address.
After relocation, U-Boot will jump to the code at the beginning of the
header, where we encode a relative branch forward instruction to branch
to the beginning of the kernel at offset +0x40.

add missing break after -m case

add sh arch

branches: 1.20.2;
Add support for "kernel_noload" image types. This type is the same as the
"kernel" type, except it can run from any load address.

Load address is not required for "ramdisk" images.

branches: 1.18.8;
Support arm64, i386 and or1k.

add support for generating boot.scr scripts with -T script

branches: 1.16.2;
Avoid signed/unsigned comparision.

Let address/entry be 64bit if they are just sign-extended 32-bit values.
(change pulled up from matt-nb5-mips64).

branches: 1.14.2;
Sprinkle one more static and a bunch of consts.

static + __dead

Add lzma and lzo to usage. From Elie De Brauwer in PR 45219.

Add O_TRUNC to the open of the image file (in case the size decreases).

Add lzma and lzo compression types

Add -E entrypoint for "byteswapped" entry-points.

Add an -m flag to mkubootimage, for specifying an alternate magic
value.

branches: 1.7.2;
When printing the header, convert values to names:
Use strlcpy to copy the name, not strncpy.

magic: 0x27051956
time: Tue Jun 7 15:58:41 2011
size: 2482203
load addr: 0x00020000
entry point: 0x00020000
data crc: 0x700fdf53
os: 2 (netbsd)
arch: 7 (powerpc)
type: 2 (kernel)
comp: 1 (gz)
name: NetBSD/evbppc 5.99.52 (INSTALL_
header crc: 0x94ea96cf

branches: 1.6.2; 1.6.4;
Add the -O option to set the OS type, which defaults to NetBSD when missing.
This is needed, because some vendors have stripped U-Boot so much that it
only accepts Linux kernel modules.
Also allow 'standalone' as module type.

Add mips/mips64 support.

branches: 1.4.2;
Change '-e' to optional. Use load addr(-a), if '-e' not specify.
Just like u-boot's mkimage.

s/mkuboot/mkubootimage/ in usage().

nbtool.h'ify; fixes cross-compilation.

add mkubootimage(1), a tool for creating u-boot compatible images

mkubootimage(1): add riscv

add sh arch

branches: 1.7.2;
Add support for "kernel_noload" image types. This type is the same as the
"kernel" type, except it can run from any load address.

branches: 1.6.8;
Support arm64, i386 and or1k.

add support for generating boot.scr scripts with -T script

branches: 1.4.2; 1.4.8;
Add lzma and lzo compression types

branches: 1.3.2; 1.3.6;
Add the -O option to set the OS type, which defaults to NetBSD when missing.
This is needed, because some vendors have stripped U-Boot so much that it
only accepts Linux kernel modules.
Also allow 'standalone' as module type.

Add mips/mips64 support.

branches: 1.1.2;
add mkubootimage(1), a tool for creating u-boot compatible images