mirror of
https://github.com/torvalds/linux.git
synced 2024-11-22 12:11:40 +00:00
c6f371bab2
XZ_EXTERN was used to make internal functions static in the preboot code. However, in other decompressors this hasn't been done. On x86-64, this makes no difference to the kernel image size. Omit XZ_EXTERN and let some of the internal functions be extern in the preboot code. Omitting XZ_EXTERN from include/linux/xz.h fixes warnings in "make htmldocs" and makes the intradocument links to xz_dec functions work in Documentation/staging/xz.rst. The alternative would have been to add "XZ_EXTERN" to c_id_attributes in Documentation/conf.py but omitting XZ_EXTERN seemed cleaner. Link: https://lore.kernel.org/lkml/20240723205437.3c0664b0@kaneli/ Link: https://lkml.kernel.org/r/20240724110544.16430-1-lasse.collin@tukaani.org Signed-off-by: Lasse Collin <lasse.collin@tukaani.org> Tested-by: Michael Ellerman <mpe@ellerman.id.au> (powerpc) Cc: Jonathan Corbet <corbet@lwn.net> Cc: Sam James <sam@gentoo.org> Cc: Albert Ou <aou@eecs.berkeley.edu> Cc: Catalin Marinas <catalin.marinas@arm.com> Cc: Emil Renner Berthing <emil.renner.berthing@canonical.com> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: Herbert Xu <herbert@gondor.apana.org.au> Cc: Joel Stanley <joel@jms.id.au> Cc: Jubin Zhong <zhongjubin@huawei.com> Cc: Jules Maselbas <jmaselbas@zdiv.net> Cc: Krzysztof Kozlowski <krzk@kernel.org> Cc: Palmer Dabbelt <palmer@dabbelt.com> Cc: Paul Walmsley <paul.walmsley@sifive.com> Cc: Randy Dunlap <rdunlap@infradead.org> Cc: Rui Li <me@lirui.org> Cc: Simon Glass <sjg@chromium.org> Cc: Thomas Gleixner <tglx@linutronix.de> Cc: Will Deacon <will@kernel.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
162 lines
4.5 KiB
C
162 lines
4.5 KiB
C
/* SPDX-License-Identifier: 0BSD */
|
|
|
|
/*
|
|
* Private includes and definitions
|
|
*
|
|
* Author: Lasse Collin <lasse.collin@tukaani.org>
|
|
*/
|
|
|
|
#ifndef XZ_PRIVATE_H
|
|
#define XZ_PRIVATE_H
|
|
|
|
#ifdef __KERNEL__
|
|
# include <linux/xz.h>
|
|
# include <linux/kernel.h>
|
|
# include <asm/unaligned.h>
|
|
/* XZ_PREBOOT may be defined only via decompress_unxz.c. */
|
|
# ifndef XZ_PREBOOT
|
|
# include <linux/slab.h>
|
|
# include <linux/vmalloc.h>
|
|
# include <linux/string.h>
|
|
# ifdef CONFIG_XZ_DEC_X86
|
|
# define XZ_DEC_X86
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_POWERPC
|
|
# define XZ_DEC_POWERPC
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_IA64
|
|
# define XZ_DEC_IA64
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_ARM
|
|
# define XZ_DEC_ARM
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_ARMTHUMB
|
|
# define XZ_DEC_ARMTHUMB
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_SPARC
|
|
# define XZ_DEC_SPARC
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_ARM64
|
|
# define XZ_DEC_ARM64
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_RISCV
|
|
# define XZ_DEC_RISCV
|
|
# endif
|
|
# ifdef CONFIG_XZ_DEC_MICROLZMA
|
|
# define XZ_DEC_MICROLZMA
|
|
# endif
|
|
# define memeq(a, b, size) (memcmp(a, b, size) == 0)
|
|
# define memzero(buf, size) memset(buf, 0, size)
|
|
# endif
|
|
# define get_le32(p) le32_to_cpup((const uint32_t *)(p))
|
|
#else
|
|
/*
|
|
* For userspace builds, use a separate header to define the required
|
|
* macros and functions. This makes it easier to adapt the code into
|
|
* different environments and avoids clutter in the Linux kernel tree.
|
|
*/
|
|
# include "xz_config.h"
|
|
#endif
|
|
|
|
/* If no specific decoding mode is requested, enable support for all modes. */
|
|
#if !defined(XZ_DEC_SINGLE) && !defined(XZ_DEC_PREALLOC) \
|
|
&& !defined(XZ_DEC_DYNALLOC)
|
|
# define XZ_DEC_SINGLE
|
|
# define XZ_DEC_PREALLOC
|
|
# define XZ_DEC_DYNALLOC
|
|
#endif
|
|
|
|
/*
|
|
* The DEC_IS_foo(mode) macros are used in "if" statements. If only some
|
|
* of the supported modes are enabled, these macros will evaluate to true or
|
|
* false at compile time and thus allow the compiler to omit unneeded code.
|
|
*/
|
|
#ifdef XZ_DEC_SINGLE
|
|
# define DEC_IS_SINGLE(mode) ((mode) == XZ_SINGLE)
|
|
#else
|
|
# define DEC_IS_SINGLE(mode) (false)
|
|
#endif
|
|
|
|
#ifdef XZ_DEC_PREALLOC
|
|
# define DEC_IS_PREALLOC(mode) ((mode) == XZ_PREALLOC)
|
|
#else
|
|
# define DEC_IS_PREALLOC(mode) (false)
|
|
#endif
|
|
|
|
#ifdef XZ_DEC_DYNALLOC
|
|
# define DEC_IS_DYNALLOC(mode) ((mode) == XZ_DYNALLOC)
|
|
#else
|
|
# define DEC_IS_DYNALLOC(mode) (false)
|
|
#endif
|
|
|
|
#if !defined(XZ_DEC_SINGLE)
|
|
# define DEC_IS_MULTI(mode) (true)
|
|
#elif defined(XZ_DEC_PREALLOC) || defined(XZ_DEC_DYNALLOC)
|
|
# define DEC_IS_MULTI(mode) ((mode) != XZ_SINGLE)
|
|
#else
|
|
# define DEC_IS_MULTI(mode) (false)
|
|
#endif
|
|
|
|
/*
|
|
* If any of the BCJ filter decoders are wanted, define XZ_DEC_BCJ.
|
|
* XZ_DEC_BCJ is used to enable generic support for BCJ decoders.
|
|
*/
|
|
#ifndef XZ_DEC_BCJ
|
|
# if defined(XZ_DEC_X86) || defined(XZ_DEC_POWERPC) \
|
|
|| defined(XZ_DEC_IA64) \
|
|
|| defined(XZ_DEC_ARM) || defined(XZ_DEC_ARMTHUMB) \
|
|
|| defined(XZ_DEC_SPARC) || defined(XZ_DEC_ARM64) \
|
|
|| defined(XZ_DEC_RISCV)
|
|
# define XZ_DEC_BCJ
|
|
# endif
|
|
#endif
|
|
|
|
/*
|
|
* Allocate memory for LZMA2 decoder. xz_dec_lzma2_reset() must be used
|
|
* before calling xz_dec_lzma2_run().
|
|
*/
|
|
struct xz_dec_lzma2 *xz_dec_lzma2_create(enum xz_mode mode, uint32_t dict_max);
|
|
|
|
/*
|
|
* Decode the LZMA2 properties (one byte) and reset the decoder. Return
|
|
* XZ_OK on success, XZ_MEMLIMIT_ERROR if the preallocated dictionary is not
|
|
* big enough, and XZ_OPTIONS_ERROR if props indicates something that this
|
|
* decoder doesn't support.
|
|
*/
|
|
enum xz_ret xz_dec_lzma2_reset(struct xz_dec_lzma2 *s, uint8_t props);
|
|
|
|
/* Decode raw LZMA2 stream from b->in to b->out. */
|
|
enum xz_ret xz_dec_lzma2_run(struct xz_dec_lzma2 *s, struct xz_buf *b);
|
|
|
|
/* Free the memory allocated for the LZMA2 decoder. */
|
|
void xz_dec_lzma2_end(struct xz_dec_lzma2 *s);
|
|
|
|
#ifdef XZ_DEC_BCJ
|
|
/*
|
|
* Allocate memory for BCJ decoders. xz_dec_bcj_reset() must be used before
|
|
* calling xz_dec_bcj_run().
|
|
*/
|
|
struct xz_dec_bcj *xz_dec_bcj_create(bool single_call);
|
|
|
|
/*
|
|
* Decode the Filter ID of a BCJ filter. This implementation doesn't
|
|
* support custom start offsets, so no decoding of Filter Properties
|
|
* is needed. Returns XZ_OK if the given Filter ID is supported.
|
|
* Otherwise XZ_OPTIONS_ERROR is returned.
|
|
*/
|
|
enum xz_ret xz_dec_bcj_reset(struct xz_dec_bcj *s, uint8_t id);
|
|
|
|
/*
|
|
* Decode raw BCJ + LZMA2 stream. This must be used only if there actually is
|
|
* a BCJ filter in the chain. If the chain has only LZMA2, xz_dec_lzma2_run()
|
|
* must be called directly.
|
|
*/
|
|
enum xz_ret xz_dec_bcj_run(struct xz_dec_bcj *s, struct xz_dec_lzma2 *lzma2,
|
|
struct xz_buf *b);
|
|
|
|
/* Free the memory allocated for the BCJ filters. */
|
|
#define xz_dec_bcj_end(s) kfree(s)
|
|
#endif
|
|
|
|
#endif
|