Skip to contentSkip to conversation

x86, boot: document intermediates more clearly

PATCH In review Kees Cook 3 participants 3 messages Oct 31, 2014 – Nov 1, 2014 x86

lore
Share & tools
lore

Kees Cook

author
#0 lore raw

PATCH 1/1 x86, boot: document intermediates more clearly

This adds a comment detailing the various intermediate files used to build the bootable decompression image for the x86 kernel.

---
 arch/x86/boot/compressed/Makefile | 12 ++++++++++++
 1 file changed, 12 insertions(+)
arch/x86/boot/compressed/Makefile +12 -0
index be1e07d4b596..44a866b85c6f 100644
@@ -3,6 +3,18 @@
 #
 # create a compressed vmlinux image from the original vmlinux
 #
+# vmlinuz is:
+#	decompression code (*.o)
+#	asm globals (piggy.S), including:
+#		vmlinux.bin.(gz|bz2|lzma|...)
+#
+# vmlinux.bin is:
+#	vmlinux stripped of debugging and comments
+# vmlinux.bin.all is:
+#	vmlinux.bin + vmlinux.relocs
+# vmlinux.bin.(gz|bz2|lzma|...) is:
+#	(see scripts/Makefile.lib size_append)
+#	compressed vmlinux.bin.all + u32 size of vmlinux.bin.all
 
 targets := vmlinux vmlinux.bin vmlinux.bin.gz vmlinux.bin.bz2 vmlinux.bin.lzma \
 	vmlinux.bin.xz vmlinux.bin.lzo vmlinux.bin.lz4
Signature · 6 lines
1.9.1


-- 
Kees Cook
Chrome OS Security
Reviewed-by on v1 1/1
#1 lore raw
Quoted 4 lines · Kees Cook

This adds a comment detailing the various intermediate files used to build the bootable decompression image for the x86 kernel.

Definitely the documentation I wish I had long ago when trying to figure out the twisty maze of binaries.

Quoted 33 lines
 arch/x86/boot/compressed/Makefile | 12 ++++++++++++
 1 file changed, 12 insertions(+)
arch/x86/boot/compressed/Makefile +12 -0
index be1e07d4b596..44a866b85c6f 100644
@@ -3,6 +3,18 @@
 #
 # create a compressed vmlinux image from the original vmlinux
 #
+# vmlinuz is:
+#	decompression code (*.o)
+#	asm globals (piggy.S), including:
+#		vmlinux.bin.(gz|bz2|lzma|...)
+#
+# vmlinux.bin is:
+#	vmlinux stripped of debugging and comments
+# vmlinux.bin.all is:
+#	vmlinux.bin + vmlinux.relocs
+# vmlinux.bin.(gz|bz2|lzma|...) is:
+#	(see scripts/Makefile.lib size_append)
+#	compressed vmlinux.bin.all + u32 size of vmlinux.bin.all
 
 targets := vmlinux vmlinux.bin vmlinux.bin.gz vmlinux.bin.bz2 vmlinux.bin.lzma \
 	vmlinux.bin.xz vmlinux.bin.lzo vmlinux.bin.lz4
Signature · 6 lines
1.9.1


-- 
Kees Cook
Chrome OS Security
#2 lore raw

[tip:x86/boot] x86, boot: Document intermediates more clearly

In reply to Kees Cook
x86, boot: Document intermediates more clearly
Commit-ID:  fb7183ef3c016d9067ff83f3ff2455be1818f902
Gitweb:     http://git.kernel.org/tip/fb7183ef3c016d9067ff83f3ff2455be1818f902
Author:     Kees Cook <[email protected]>
AuthorDate: Fri, 31 Oct 2014 09:22:04 -0700
Committer:  Thomas Gleixner <[email protected]>
CommitDate: Sat, 1 Nov 2014 22:46:02 +0100

x86, boot: Document intermediates more clearly

This adds a comment detailing the various intermediate files used to build the bootable decompression image for the x86 kernel.

---
 arch/x86/boot/compressed/Makefile | 12 ++++++++++++
 1 file changed, 12 insertions(+)
arch/x86/boot/compressed/Makefile +12 -0
index 704f58a..8a39181 100644
@@ -3,6 +3,18 @@
 #
 # create a compressed vmlinux image from the original vmlinux
 #
+# vmlinuz is:
+#	decompression code (*.o)
+#	asm globals (piggy.S), including:
+#		vmlinux.bin.(gz|bz2|lzma|...)
+#
+# vmlinux.bin is:
+#	vmlinux stripped of debugging and comments
+# vmlinux.bin.all is:
+#	vmlinux.bin + vmlinux.relocs
+# vmlinux.bin.(gz|bz2|lzma|...) is:
+#	(see scripts/Makefile.lib size_append)
+#	compressed vmlinux.bin.all + u32 size of vmlinux.bin.all
 
 targets := vmlinux vmlinux.bin vmlinux.bin.gz vmlinux.bin.bz2 vmlinux.bin.lzma \
 	vmlinux.bin.xz vmlinux.bin.lzo vmlinux.bin.lz4